@ai-devkit/agent-manager 0.36.0 → 0.37.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 (618) hide show
  1. package/dist/AgentManager.d.ts +9 -4
  2. package/dist/AgentManager.d.ts.map +1 -1
  3. package/dist/AgentManager.js +21 -2
  4. package/dist/AgentManager.js.map +1 -1
  5. package/dist/__tests__/AgentManager.test.js +151 -3
  6. package/dist/__tests__/AgentManager.test.js.map +1 -1
  7. package/dist/__tests__/adapters/IncrementalSessionRefresh.test.js +486 -0
  8. package/dist/__tests__/adapters/IncrementalSessionRefresh.test.js.map +1 -0
  9. package/dist/__tests__/adapters/adapterProcessImports.test.js +52 -0
  10. package/dist/__tests__/adapters/adapterProcessImports.test.js.map +1 -0
  11. package/dist/__tests__/adapters/adapterSnapshotCandidates.test.js +247 -0
  12. package/dist/__tests__/adapters/adapterSnapshotCandidates.test.js.map +1 -0
  13. package/dist/__tests__/capacity/openai.test.js +12 -14
  14. package/dist/__tests__/capacity/openai.test.js.map +1 -1
  15. package/dist/__tests__/harnesses/BoundedSummarySkip.test.js +568 -0
  16. package/dist/__tests__/harnesses/BoundedSummarySkip.test.js.map +1 -0
  17. package/dist/__tests__/harnesses/SessionSummaryEquivalence.test.js +1089 -0
  18. package/dist/__tests__/harnesses/SessionSummaryEquivalence.test.js.map +1 -0
  19. package/dist/__tests__/harnesses/antigravity/AntigravityCliAdapter.subprocess.test.js +143 -0
  20. package/dist/__tests__/harnesses/antigravity/AntigravityCliAdapter.subprocess.test.js.map +1 -0
  21. package/dist/__tests__/{adapters → harnesses/antigravity}/AntigravityCliAdapter.test.js +103 -22
  22. package/dist/__tests__/harnesses/antigravity/AntigravityCliAdapter.test.js.map +1 -0
  23. package/dist/__tests__/harnesses/builtinAdapters.test.js +33 -0
  24. package/dist/__tests__/harnesses/builtinAdapters.test.js.map +1 -0
  25. package/dist/__tests__/{providers → harnesses}/claude/ClaudeAgentMapper.test.js +4 -4
  26. package/dist/__tests__/harnesses/claude/ClaudeAgentMapper.test.js.map +1 -0
  27. package/dist/__tests__/{adapters → harnesses/claude}/ClaudeCodeAdapter.test.js +47 -19
  28. package/dist/__tests__/harnesses/claude/ClaudeCodeAdapter.test.js.map +1 -0
  29. package/dist/__tests__/{providers → harnesses}/claude/ClaudeSessionLocator.test.js +1 -12
  30. package/dist/__tests__/{providers → harnesses}/claude/ClaudeSessionLocator.test.js.map +1 -1
  31. package/dist/__tests__/{utils → harnesses/claude}/ClaudeSessionParser.test.js +2 -2
  32. package/dist/__tests__/harnesses/claude/ClaudeSessionParser.test.js.map +1 -0
  33. package/dist/__tests__/{print → harnesses/claude/durable}/ClaudeCliProbe.test.js +1 -1
  34. package/dist/__tests__/harnesses/claude/durable/ClaudeCliProbe.test.js.map +1 -0
  35. package/dist/__tests__/{print → harnesses/claude/durable}/ClaudePrintAgent.integration.test.js +1 -1
  36. package/dist/__tests__/harnesses/claude/durable/ClaudePrintAgent.integration.test.js.map +1 -0
  37. package/dist/__tests__/{print → harnesses/claude/durable}/ClaudePrintAgentService.test.js +4 -4
  38. package/dist/__tests__/harnesses/claude/durable/ClaudePrintAgentService.test.js.map +1 -0
  39. package/dist/__tests__/{print → harnesses/claude/durable}/ClaudePrintRunner.test.js +1 -1
  40. package/dist/__tests__/harnesses/claude/durable/ClaudePrintRunner.test.js.map +1 -0
  41. package/dist/__tests__/{adapters → harnesses/codex}/CodexAdapter.test.js +304 -10
  42. package/dist/__tests__/harnesses/codex/CodexAdapter.test.js.map +1 -0
  43. package/dist/__tests__/harnesses/codex/CodexSessionLocator.test.js +463 -0
  44. package/dist/__tests__/harnesses/codex/CodexSessionLocator.test.js.map +1 -0
  45. package/dist/__tests__/{providers → harnesses}/codex/CodexSessionMapping.test.js +1 -1
  46. package/dist/__tests__/{providers → harnesses}/codex/CodexSessionMapping.test.js.map +1 -1
  47. package/dist/__tests__/{providers → harnesses}/codex/CodexSessionParser.test.js +1 -1
  48. package/dist/__tests__/{providers → harnesses}/codex/CodexSessionParser.test.js.map +1 -1
  49. package/dist/__tests__/{durable → harnesses/codex/durable}/CodexCliProbe.test.js +4 -4
  50. package/dist/__tests__/harnesses/codex/durable/CodexCliProbe.test.js.map +1 -0
  51. package/dist/__tests__/{durable → harnesses/codex/durable}/CodexDurableAgentRepository.test.js +1 -1
  52. package/dist/__tests__/harnesses/codex/durable/CodexDurableAgentRepository.test.js.map +1 -0
  53. package/dist/__tests__/{durable → harnesses/codex/durable}/CodexPrintAgent.integration.test.js +1 -1
  54. package/dist/__tests__/harnesses/codex/durable/CodexPrintAgent.integration.test.js.map +1 -0
  55. package/dist/__tests__/{durable → harnesses/codex/durable}/CodexPrintAgentService.test.js +8 -18
  56. package/dist/__tests__/harnesses/codex/durable/CodexPrintAgentService.test.js.map +1 -0
  57. package/dist/__tests__/{durable → harnesses/codex/durable}/CodexPrintRunner.test.js +2 -7
  58. package/dist/__tests__/harnesses/codex/durable/CodexPrintRunner.test.js.map +1 -0
  59. package/dist/__tests__/{providers → harnesses}/copilot/CopilotAdapter.test.js +1 -1
  60. package/dist/__tests__/{providers → harnesses}/copilot/CopilotAdapter.test.js.map +1 -1
  61. package/dist/__tests__/harnesses/copilot/CopilotRefreshIO.test.js +290 -0
  62. package/dist/__tests__/harnesses/copilot/CopilotRefreshIO.test.js.map +1 -0
  63. package/dist/__tests__/{providers → harnesses}/gemini/GeminiCliAdapter.test.js +34 -25
  64. package/dist/__tests__/harnesses/gemini/GeminiCliAdapter.test.js.map +1 -0
  65. package/dist/__tests__/harnesses/gemini/GeminiSessionJsonl.test.js +491 -0
  66. package/dist/__tests__/harnesses/gemini/GeminiSessionJsonl.test.js.map +1 -0
  67. package/dist/__tests__/harnesses/gemini/GeminiSessionLocator.test.js +399 -0
  68. package/dist/__tests__/harnesses/gemini/GeminiSessionLocator.test.js.map +1 -0
  69. package/dist/__tests__/{providers → harnesses}/grok/GrokAgentMapper.test.js +1 -1
  70. package/dist/__tests__/{providers → harnesses}/grok/GrokAgentMapper.test.js.map +1 -1
  71. package/dist/__tests__/{providers → harnesses}/grok/GrokCliAdapter.test.js +1 -1
  72. package/dist/__tests__/{providers → harnesses}/grok/GrokCliAdapter.test.js.map +1 -1
  73. package/dist/__tests__/harnesses/grok/GrokIncrementalRefresh.test.js +167 -0
  74. package/dist/__tests__/harnesses/grok/GrokIncrementalRefresh.test.js.map +1 -0
  75. package/dist/__tests__/{providers → harnesses}/grok/GrokSessionLocator.test.js +1 -1
  76. package/dist/__tests__/{providers → harnesses}/grok/GrokSessionLocator.test.js.map +1 -1
  77. package/dist/__tests__/harnesses/grok/GrokSessionParser.test.js +301 -0
  78. package/dist/__tests__/harnesses/grok/GrokSessionParser.test.js.map +1 -0
  79. package/dist/__tests__/{adapters → harnesses/kiro}/KiroAdapter.test.js +137 -82
  80. package/dist/__tests__/harnesses/kiro/KiroAdapter.test.js.map +1 -0
  81. package/dist/__tests__/{providers → harnesses}/opencode/OpenCodeAdapter.test.js +1 -1
  82. package/dist/__tests__/{providers → harnesses}/opencode/OpenCodeAdapter.test.js.map +1 -1
  83. package/dist/__tests__/{providers → harnesses}/opencode/OpenCodeAgentMapper.test.js +1 -1
  84. package/dist/__tests__/{providers → harnesses}/opencode/OpenCodeAgentMapper.test.js.map +1 -1
  85. package/dist/__tests__/{providers → harnesses}/opencode/OpenCodeSessionLocator.test.js +2 -2
  86. package/dist/__tests__/{providers → harnesses}/opencode/OpenCodeSessionLocator.test.js.map +1 -1
  87. package/dist/__tests__/{providers → harnesses}/opencode/OpenCodeSessionParser.test.js +1 -1
  88. package/dist/__tests__/{providers → harnesses}/opencode/OpenCodeSessionParser.test.js.map +1 -1
  89. package/dist/__tests__/{providers → harnesses}/pi/PiAdapter.test.js +1 -1
  90. package/dist/__tests__/{providers → harnesses}/pi/PiAdapter.test.js.map +1 -1
  91. package/dist/__tests__/harnesses/pi/PiDiscoveryIO.test.js +382 -0
  92. package/dist/__tests__/harnesses/pi/PiDiscoveryIO.test.js.map +1 -0
  93. package/dist/__tests__/{providers → harnesses}/pi/PiSessionParser.test.js +171 -1
  94. package/dist/__tests__/harnesses/pi/PiSessionParser.test.js.map +1 -0
  95. package/dist/__tests__/{providers → harnesses}/pi/PiSessionTracker.test.js +1 -1
  96. package/dist/__tests__/{providers → harnesses}/pi/PiSessionTracker.test.js.map +1 -1
  97. package/dist/__tests__/{providers → harnesses}/pi/durable/PiCliProbe.test.js.map +1 -1
  98. package/dist/__tests__/{providers → harnesses}/pi/durable/PiDurableAgentRepository.test.js.map +1 -1
  99. package/dist/__tests__/{providers → harnesses}/pi/durable/PiPrintAgentService.test.js.map +1 -1
  100. package/dist/__tests__/{providers → harnesses}/pi/durable/PiPrintProtocol.test.js +1 -1
  101. package/dist/__tests__/{providers → harnesses}/pi/durable/PiPrintProtocol.test.js.map +1 -1
  102. package/dist/__tests__/{providers → harnesses}/pi/durable/PiPrintRunner.test.js.map +1 -1
  103. package/dist/__tests__/{providers → harnesses}/pi/durable/PiStreamParser.test.js +1 -1
  104. package/dist/__tests__/{providers → harnesses}/pi/durable/PiStreamParser.test.js.map +1 -1
  105. package/dist/__tests__/readiness/AgentReadiness.test.js +20 -0
  106. package/dist/__tests__/readiness/AgentReadiness.test.js.map +1 -1
  107. package/dist/__tests__/runtime/ManagedAgentRuntime.test.js +49 -0
  108. package/dist/__tests__/runtime/ManagedAgentRuntime.test.js.map +1 -1
  109. package/dist/__tests__/utils/IncrementalJsonlSummary.test.js +650 -0
  110. package/dist/__tests__/utils/IncrementalJsonlSummary.test.js.map +1 -0
  111. package/dist/__tests__/utils/agents.test.js +66 -2
  112. package/dist/__tests__/utils/agents.test.js.map +1 -1
  113. package/dist/__tests__/utils/conversationTail.bench.test.js +258 -0
  114. package/dist/__tests__/utils/conversationTail.bench.test.js.map +1 -0
  115. package/dist/__tests__/utils/conversationTailParity.test.js +588 -0
  116. package/dist/__tests__/utils/conversationTailParity.test.js.map +1 -0
  117. package/dist/__tests__/utils/jsonlTail.test.js +360 -0
  118. package/dist/__tests__/utils/jsonlTail.test.js.map +1 -0
  119. package/dist/__tests__/utils/matchingConstants.test.js +35 -0
  120. package/dist/__tests__/utils/matchingConstants.test.js.map +1 -0
  121. package/dist/__tests__/utils/process.test.js +436 -2
  122. package/dist/__tests__/utils/process.test.js.map +1 -1
  123. package/dist/adapters/AgentAdapter.d.ts +25 -6
  124. package/dist/adapters/AgentAdapter.d.ts.map +1 -1
  125. package/dist/adapters/AgentAdapter.js +12 -3
  126. package/dist/adapters/AgentAdapter.js.map +1 -1
  127. package/dist/capacity/openai.d.ts +0 -1
  128. package/dist/capacity/openai.d.ts.map +1 -1
  129. package/dist/capacity/openai.js +0 -5
  130. package/dist/capacity/openai.js.map +1 -1
  131. package/dist/harnesses/antigravity/AntigravityAgentMapper.d.ts +13 -0
  132. package/dist/harnesses/antigravity/AntigravityAgentMapper.d.ts.map +1 -0
  133. package/dist/harnesses/antigravity/AntigravityAgentMapper.js +30 -0
  134. package/dist/harnesses/antigravity/AntigravityAgentMapper.js.map +1 -0
  135. package/dist/harnesses/antigravity/AntigravityCliAdapter.d.ts +32 -0
  136. package/dist/harnesses/antigravity/AntigravityCliAdapter.d.ts.map +1 -0
  137. package/dist/harnesses/antigravity/AntigravityCliAdapter.js +97 -0
  138. package/dist/harnesses/antigravity/AntigravityCliAdapter.js.map +1 -0
  139. package/dist/harnesses/antigravity/AntigravitySessionLocator.d.ts +30 -0
  140. package/dist/harnesses/antigravity/AntigravitySessionLocator.d.ts.map +1 -0
  141. package/dist/harnesses/antigravity/AntigravitySessionLocator.js +56 -0
  142. package/dist/harnesses/antigravity/AntigravitySessionLocator.js.map +1 -0
  143. package/dist/harnesses/antigravity/AntigravitySessionParser.d.ts +75 -0
  144. package/dist/harnesses/antigravity/AntigravitySessionParser.d.ts.map +1 -0
  145. package/dist/harnesses/antigravity/AntigravitySessionParser.js +174 -0
  146. package/dist/harnesses/antigravity/AntigravitySessionParser.js.map +1 -0
  147. package/dist/{providers → harnesses}/claude/ClaudeAgentMapper.d.ts.map +1 -1
  148. package/dist/{providers → harnesses}/claude/ClaudeAgentMapper.js +4 -10
  149. package/dist/harnesses/claude/ClaudeAgentMapper.js.map +1 -0
  150. package/dist/{providers → harnesses}/claude/ClaudeCodeAdapter.d.ts +5 -6
  151. package/dist/harnesses/claude/ClaudeCodeAdapter.d.ts.map +1 -0
  152. package/dist/{providers → harnesses}/claude/ClaudeCodeAdapter.js +17 -15
  153. package/dist/harnesses/claude/ClaudeCodeAdapter.js.map +1 -0
  154. package/dist/{providers → harnesses}/claude/ClaudeSessionLocator.d.ts.map +1 -1
  155. package/dist/{providers → harnesses}/claude/ClaudeSessionLocator.js +3 -3
  156. package/dist/harnesses/claude/ClaudeSessionLocator.js.map +1 -0
  157. package/dist/{providers → harnesses}/claude/ClaudeSessionParser.d.ts +40 -6
  158. package/dist/harnesses/claude/ClaudeSessionParser.d.ts.map +1 -0
  159. package/dist/{providers → harnesses}/claude/ClaudeSessionParser.js +141 -85
  160. package/dist/harnesses/claude/ClaudeSessionParser.js.map +1 -0
  161. package/dist/{providers → harnesses}/claude/durable/ClaudeCliProbe.d.ts.map +1 -1
  162. package/dist/{providers → harnesses}/claude/durable/ClaudeCliProbe.js.map +1 -1
  163. package/dist/{providers → harnesses}/claude/durable/ClaudePrintAgentService.d.ts.map +1 -1
  164. package/dist/{providers → harnesses}/claude/durable/ClaudePrintAgentService.js.map +1 -1
  165. package/dist/{providers → harnesses}/claude/durable/ClaudePrintRunner.d.ts.map +1 -1
  166. package/dist/{providers → harnesses}/claude/durable/ClaudePrintRunner.js.map +1 -1
  167. package/dist/{providers → harnesses}/claude/durable/ClaudeStreamParser.d.ts.map +1 -1
  168. package/dist/{providers → harnesses}/claude/durable/ClaudeStreamParser.js.map +1 -1
  169. package/dist/{providers → harnesses}/codex/CodexAdapter.d.ts +5 -4
  170. package/dist/harnesses/codex/CodexAdapter.d.ts.map +1 -0
  171. package/dist/{providers → harnesses}/codex/CodexAdapter.js +139 -19
  172. package/dist/harnesses/codex/CodexAdapter.js.map +1 -0
  173. package/dist/{providers → harnesses}/codex/CodexAgentMapper.d.ts.map +1 -1
  174. package/dist/{providers → harnesses}/codex/CodexAgentMapper.js +4 -11
  175. package/dist/harnesses/codex/CodexAgentMapper.js.map +1 -0
  176. package/dist/harnesses/codex/CodexSessionLocator.d.ts +74 -0
  177. package/dist/harnesses/codex/CodexSessionLocator.d.ts.map +1 -0
  178. package/dist/harnesses/codex/CodexSessionLocator.js +359 -0
  179. package/dist/harnesses/codex/CodexSessionLocator.js.map +1 -0
  180. package/dist/{providers → harnesses}/codex/CodexSessionMapping.d.ts.map +1 -1
  181. package/dist/{providers → harnesses}/codex/CodexSessionMapping.js +3 -3
  182. package/dist/harnesses/codex/CodexSessionMapping.js.map +1 -0
  183. package/dist/harnesses/codex/CodexSessionParser.d.ts +89 -0
  184. package/dist/harnesses/codex/CodexSessionParser.d.ts.map +1 -0
  185. package/dist/{providers → harnesses}/codex/CodexSessionParser.js +124 -78
  186. package/dist/harnesses/codex/CodexSessionParser.js.map +1 -0
  187. package/dist/{providers → harnesses}/codex/durable/CodexCliProbe.d.ts.map +1 -1
  188. package/dist/{providers → harnesses}/codex/durable/CodexCliProbe.js.map +1 -1
  189. package/dist/{providers → harnesses}/codex/durable/CodexPrintAgentService.d.ts.map +1 -1
  190. package/dist/{providers → harnesses}/codex/durable/CodexPrintAgentService.js.map +1 -1
  191. package/dist/{providers → harnesses}/codex/durable/CodexPrintRunner.d.ts.map +1 -1
  192. package/dist/{providers → harnesses}/codex/durable/CodexPrintRunner.js.map +1 -1
  193. package/dist/{providers → harnesses}/codex/durable/CodexStreamParser.d.ts.map +1 -1
  194. package/dist/{providers → harnesses}/codex/durable/CodexStreamParser.js.map +1 -1
  195. package/dist/{providers → harnesses}/copilot/CopilotAdapter.d.ts +7 -6
  196. package/dist/harnesses/copilot/CopilotAdapter.d.ts.map +1 -0
  197. package/dist/{providers → harnesses}/copilot/CopilotAdapter.js +19 -14
  198. package/dist/harnesses/copilot/CopilotAdapter.js.map +1 -0
  199. package/dist/{providers → harnesses}/copilot/CopilotAgentMapper.d.ts.map +1 -1
  200. package/dist/{providers → harnesses}/copilot/CopilotAgentMapper.js +4 -11
  201. package/dist/harnesses/copilot/CopilotAgentMapper.js.map +1 -0
  202. package/dist/harnesses/copilot/CopilotSessionLocator.d.ts +42 -0
  203. package/dist/harnesses/copilot/CopilotSessionLocator.d.ts.map +1 -0
  204. package/dist/harnesses/copilot/CopilotSessionLocator.js +126 -0
  205. package/dist/harnesses/copilot/CopilotSessionLocator.js.map +1 -0
  206. package/dist/harnesses/copilot/CopilotSessionParser.d.ts +62 -0
  207. package/dist/harnesses/copilot/CopilotSessionParser.d.ts.map +1 -0
  208. package/dist/harnesses/copilot/CopilotSessionParser.js +236 -0
  209. package/dist/harnesses/copilot/CopilotSessionParser.js.map +1 -0
  210. package/dist/{providers → harnesses}/gemini/GeminiAgentMapper.d.ts.map +1 -1
  211. package/dist/{providers → harnesses}/gemini/GeminiAgentMapper.js +4 -11
  212. package/dist/harnesses/gemini/GeminiAgentMapper.js.map +1 -0
  213. package/dist/{providers → harnesses}/gemini/GeminiCliAdapter.d.ts +4 -5
  214. package/dist/harnesses/gemini/GeminiCliAdapter.d.ts.map +1 -0
  215. package/dist/{providers → harnesses}/gemini/GeminiCliAdapter.js +6 -7
  216. package/dist/harnesses/gemini/GeminiCliAdapter.js.map +1 -0
  217. package/dist/harnesses/gemini/GeminiSessionLocator.d.ts +72 -0
  218. package/dist/harnesses/gemini/GeminiSessionLocator.d.ts.map +1 -0
  219. package/dist/harnesses/gemini/GeminiSessionLocator.js +300 -0
  220. package/dist/harnesses/gemini/GeminiSessionLocator.js.map +1 -0
  221. package/dist/{providers → harnesses}/gemini/GeminiSessionParser.d.ts +34 -7
  222. package/dist/harnesses/gemini/GeminiSessionParser.d.ts.map +1 -0
  223. package/dist/harnesses/gemini/GeminiSessionParser.js +272 -0
  224. package/dist/harnesses/gemini/GeminiSessionParser.js.map +1 -0
  225. package/dist/harnesses/gemini/fileSignature.d.ts +8 -0
  226. package/dist/harnesses/gemini/fileSignature.d.ts.map +1 -0
  227. package/dist/harnesses/gemini/fileSignature.js +9 -0
  228. package/dist/harnesses/gemini/fileSignature.js.map +1 -0
  229. package/dist/{providers → harnesses}/grok/GrokAgentMapper.d.ts.map +1 -1
  230. package/dist/{providers → harnesses}/grok/GrokAgentMapper.js +4 -10
  231. package/dist/harnesses/grok/GrokAgentMapper.js.map +1 -0
  232. package/dist/{providers → harnesses}/grok/GrokCliAdapter.d.ts +5 -5
  233. package/dist/harnesses/grok/GrokCliAdapter.d.ts.map +1 -0
  234. package/dist/{providers → harnesses}/grok/GrokCliAdapter.js +14 -10
  235. package/dist/harnesses/grok/GrokCliAdapter.js.map +1 -0
  236. package/dist/{providers → harnesses}/grok/GrokSessionLocator.d.ts.map +1 -1
  237. package/dist/{providers → harnesses}/grok/GrokSessionLocator.js +2 -2
  238. package/dist/harnesses/grok/GrokSessionLocator.js.map +1 -0
  239. package/dist/harnesses/grok/GrokSessionParser.d.ts +87 -0
  240. package/dist/harnesses/grok/GrokSessionParser.d.ts.map +1 -0
  241. package/dist/harnesses/grok/GrokSessionParser.js +185 -0
  242. package/dist/harnesses/grok/GrokSessionParser.js.map +1 -0
  243. package/dist/harnesses/index.d.ts +7 -0
  244. package/dist/harnesses/index.d.ts.map +1 -0
  245. package/dist/harnesses/index.js +27 -0
  246. package/dist/harnesses/index.js.map +1 -0
  247. package/dist/harnesses/kiro/KiroAdapter.d.ts +31 -0
  248. package/dist/harnesses/kiro/KiroAdapter.d.ts.map +1 -0
  249. package/dist/harnesses/kiro/KiroAdapter.js +125 -0
  250. package/dist/harnesses/kiro/KiroAdapter.js.map +1 -0
  251. package/dist/harnesses/kiro/KiroAgentMapper.d.ts +13 -0
  252. package/dist/harnesses/kiro/KiroAgentMapper.d.ts.map +1 -0
  253. package/dist/harnesses/kiro/KiroAgentMapper.js +29 -0
  254. package/dist/harnesses/kiro/KiroAgentMapper.js.map +1 -0
  255. package/dist/harnesses/kiro/KiroSessionLocator.d.ts +38 -0
  256. package/dist/harnesses/kiro/KiroSessionLocator.d.ts.map +1 -0
  257. package/dist/harnesses/kiro/KiroSessionLocator.js +95 -0
  258. package/dist/harnesses/kiro/KiroSessionLocator.js.map +1 -0
  259. package/dist/harnesses/kiro/KiroSessionParser.d.ts +81 -0
  260. package/dist/harnesses/kiro/KiroSessionParser.d.ts.map +1 -0
  261. package/dist/harnesses/kiro/KiroSessionParser.js +251 -0
  262. package/dist/harnesses/kiro/KiroSessionParser.js.map +1 -0
  263. package/dist/{providers → harnesses}/opencode/OpenCodeAdapter.d.ts +2 -4
  264. package/dist/harnesses/opencode/OpenCodeAdapter.d.ts.map +1 -0
  265. package/dist/{providers → harnesses}/opencode/OpenCodeAdapter.js +4 -7
  266. package/dist/harnesses/opencode/OpenCodeAdapter.js.map +1 -0
  267. package/dist/{providers → harnesses}/opencode/OpenCodeAgentMapper.d.ts.map +1 -1
  268. package/dist/{providers → harnesses}/opencode/OpenCodeAgentMapper.js +5 -13
  269. package/dist/harnesses/opencode/OpenCodeAgentMapper.js.map +1 -0
  270. package/dist/{providers → harnesses}/opencode/OpenCodeSessionLocator.d.ts.map +1 -1
  271. package/dist/{providers → harnesses}/opencode/OpenCodeSessionLocator.js +2 -2
  272. package/dist/harnesses/opencode/OpenCodeSessionLocator.js.map +1 -0
  273. package/dist/{providers → harnesses}/opencode/OpenCodeSessionParser.d.ts +2 -4
  274. package/dist/harnesses/opencode/OpenCodeSessionParser.d.ts.map +1 -0
  275. package/dist/{providers → harnesses}/opencode/OpenCodeSessionParser.js +2 -1
  276. package/dist/harnesses/opencode/OpenCodeSessionParser.js.map +1 -0
  277. package/dist/{providers → harnesses}/pi/PiAdapter.d.ts +5 -4
  278. package/dist/harnesses/pi/PiAdapter.d.ts.map +1 -0
  279. package/dist/{providers → harnesses}/pi/PiAdapter.js +16 -12
  280. package/dist/harnesses/pi/PiAdapter.js.map +1 -0
  281. package/dist/{providers → harnesses}/pi/PiAgentMapper.d.ts.map +1 -1
  282. package/dist/{providers → harnesses}/pi/PiAgentMapper.js +4 -11
  283. package/dist/harnesses/pi/PiAgentMapper.js.map +1 -0
  284. package/dist/harnesses/pi/PiSessionLocator.d.ts +61 -0
  285. package/dist/harnesses/pi/PiSessionLocator.d.ts.map +1 -0
  286. package/dist/harnesses/pi/PiSessionLocator.js +212 -0
  287. package/dist/harnesses/pi/PiSessionLocator.js.map +1 -0
  288. package/dist/harnesses/pi/PiSessionParser.d.ts +88 -0
  289. package/dist/harnesses/pi/PiSessionParser.d.ts.map +1 -0
  290. package/dist/harnesses/pi/PiSessionParser.js +318 -0
  291. package/dist/harnesses/pi/PiSessionParser.js.map +1 -0
  292. package/dist/{providers → harnesses}/pi/PiSessionTracker.d.ts.map +1 -1
  293. package/dist/{providers → harnesses}/pi/PiSessionTracker.js +2 -2
  294. package/dist/harnesses/pi/PiSessionTracker.js.map +1 -0
  295. package/dist/{providers → harnesses}/pi/durable/PiCliProbe.d.ts.map +1 -1
  296. package/dist/{providers → harnesses}/pi/durable/PiCliProbe.js.map +1 -1
  297. package/dist/{providers → harnesses}/pi/durable/PiPrintAgentService.d.ts.map +1 -1
  298. package/dist/{providers → harnesses}/pi/durable/PiPrintAgentService.js.map +1 -1
  299. package/dist/{providers → harnesses}/pi/durable/PiPrintProtocol.d.ts.map +1 -1
  300. package/dist/{providers → harnesses}/pi/durable/PiPrintProtocol.js.map +1 -1
  301. package/dist/{providers → harnesses}/pi/durable/PiPrintRunner.d.ts.map +1 -1
  302. package/dist/{providers → harnesses}/pi/durable/PiPrintRunner.js.map +1 -1
  303. package/dist/{providers → harnesses}/pi/durable/PiStreamParser.d.ts.map +1 -1
  304. package/dist/{providers → harnesses}/pi/durable/PiStreamParser.js.map +1 -1
  305. package/dist/harnesses/shared.d.ts +41 -0
  306. package/dist/harnesses/shared.d.ts.map +1 -0
  307. package/dist/harnesses/shared.js +71 -0
  308. package/dist/harnesses/shared.js.map +1 -0
  309. package/dist/index.d.ts +26 -25
  310. package/dist/index.d.ts.map +1 -1
  311. package/dist/index.js +18 -17
  312. package/dist/index.js.map +1 -1
  313. package/dist/utils/IncrementalJsonlSummary.d.ts +100 -0
  314. package/dist/utils/IncrementalJsonlSummary.d.ts.map +1 -0
  315. package/dist/utils/IncrementalJsonlSummary.js +209 -0
  316. package/dist/utils/IncrementalJsonlSummary.js.map +1 -0
  317. package/dist/utils/agents.d.ts +3 -2
  318. package/dist/utils/agents.d.ts.map +1 -1
  319. package/dist/utils/agents.js +50 -15
  320. package/dist/utils/agents.js.map +1 -1
  321. package/dist/utils/index.d.ts +2 -1
  322. package/dist/utils/index.d.ts.map +1 -1
  323. package/dist/utils/index.js +1 -1
  324. package/dist/utils/index.js.map +1 -1
  325. package/dist/utils/jsonlTail.d.ts +73 -0
  326. package/dist/utils/jsonlTail.d.ts.map +1 -0
  327. package/dist/utils/jsonlTail.js +238 -0
  328. package/dist/utils/jsonlTail.js.map +1 -0
  329. package/dist/utils/matching.d.ts +2 -0
  330. package/dist/utils/matching.d.ts.map +1 -1
  331. package/dist/utils/matching.js +3 -2
  332. package/dist/utils/matching.js.map +1 -1
  333. package/dist/utils/matchingConstants.d.ts +15 -0
  334. package/dist/utils/matchingConstants.d.ts.map +1 -0
  335. package/dist/utils/matchingConstants.js +14 -0
  336. package/dist/utils/matchingConstants.js.map +1 -0
  337. package/dist/utils/process.d.ts +38 -2
  338. package/dist/utils/process.d.ts.map +1 -1
  339. package/dist/utils/process.js +131 -43
  340. package/dist/utils/process.js.map +1 -1
  341. package/package.json +2 -1
  342. package/scripts/benchmark-cold-start.mjs +350 -0
  343. package/src/AgentManager.ts +26 -5
  344. package/src/__tests__/AgentManager.test.ts +141 -3
  345. package/src/__tests__/adapters/IncrementalSessionRefresh.test.ts +437 -0
  346. package/src/__tests__/adapters/adapterProcessImports.test.ts +58 -0
  347. package/src/__tests__/adapters/adapterSnapshotCandidates.test.ts +243 -0
  348. package/src/__tests__/capacity/openai.test.ts +5 -15
  349. package/src/__tests__/harnesses/BoundedSummarySkip.test.ts +496 -0
  350. package/src/__tests__/harnesses/SessionSummaryEquivalence.test.ts +726 -0
  351. package/src/__tests__/harnesses/antigravity/AntigravityCliAdapter.subprocess.test.ts +133 -0
  352. package/src/__tests__/{adapters → harnesses/antigravity}/AntigravityCliAdapter.test.ts +97 -25
  353. package/src/__tests__/harnesses/builtinAdapters.test.ts +33 -0
  354. package/src/__tests__/{providers → harnesses}/claude/ClaudeAgentMapper.test.ts +5 -5
  355. package/src/__tests__/{adapters → harnesses/claude}/ClaudeCodeAdapter.test.ts +54 -24
  356. package/src/__tests__/{providers → harnesses}/claude/ClaudeSessionLocator.test.ts +1 -12
  357. package/src/__tests__/{utils → harnesses/claude}/ClaudeSessionParser.test.ts +2 -2
  358. package/src/__tests__/{print → harnesses/claude/durable}/ClaudeCliProbe.test.ts +1 -1
  359. package/src/__tests__/{print → harnesses/claude/durable}/ClaudePrintAgent.integration.test.ts +1 -1
  360. package/src/__tests__/{print → harnesses/claude/durable}/ClaudePrintAgentService.test.ts +4 -4
  361. package/src/__tests__/{print → harnesses/claude/durable}/ClaudePrintRunner.test.ts +2 -2
  362. package/src/__tests__/{adapters → harnesses/codex}/CodexAdapter.test.ts +277 -12
  363. package/src/__tests__/harnesses/codex/CodexSessionLocator.test.ts +419 -0
  364. package/src/__tests__/{providers → harnesses}/codex/CodexSessionMapping.test.ts +1 -1
  365. package/src/__tests__/{providers → harnesses}/codex/CodexSessionParser.test.ts +1 -1
  366. package/src/__tests__/{durable → harnesses/codex/durable}/CodexCliProbe.test.ts +4 -4
  367. package/src/__tests__/{durable → harnesses/codex/durable}/CodexDurableAgentRepository.test.ts +1 -1
  368. package/src/__tests__/{durable → harnesses/codex/durable}/CodexPrintAgent.integration.test.ts +1 -1
  369. package/src/__tests__/{durable → harnesses/codex/durable}/CodexPrintAgentService.test.ts +8 -18
  370. package/src/__tests__/{durable → harnesses/codex/durable}/CodexPrintRunner.test.ts +3 -9
  371. package/src/__tests__/{providers → harnesses}/copilot/CopilotAdapter.test.ts +1 -1
  372. package/src/__tests__/harnesses/copilot/CopilotRefreshIO.test.ts +270 -0
  373. package/src/__tests__/{providers → harnesses}/gemini/GeminiCliAdapter.test.ts +27 -23
  374. package/src/__tests__/harnesses/gemini/GeminiSessionJsonl.test.ts +402 -0
  375. package/src/__tests__/harnesses/gemini/GeminiSessionLocator.test.ts +396 -0
  376. package/src/__tests__/{providers → harnesses}/grok/GrokAgentMapper.test.ts +2 -2
  377. package/src/__tests__/{providers → harnesses}/grok/GrokCliAdapter.test.ts +1 -1
  378. package/src/__tests__/harnesses/grok/GrokIncrementalRefresh.test.ts +170 -0
  379. package/src/__tests__/{providers → harnesses}/grok/GrokSessionLocator.test.ts +1 -1
  380. package/src/__tests__/harnesses/grok/GrokSessionParser.test.ts +230 -0
  381. package/src/__tests__/{adapters → harnesses/kiro}/KiroAdapter.test.ts +127 -109
  382. package/src/__tests__/{providers → harnesses}/opencode/OpenCodeAdapter.test.ts +1 -1
  383. package/src/__tests__/{providers → harnesses}/opencode/OpenCodeAgentMapper.test.ts +1 -1
  384. package/src/__tests__/{providers → harnesses}/opencode/OpenCodeSessionLocator.test.ts +2 -2
  385. package/src/__tests__/{providers → harnesses}/opencode/OpenCodeSessionParser.test.ts +1 -1
  386. package/src/__tests__/{providers → harnesses}/pi/PiAdapter.test.ts +1 -1
  387. package/src/__tests__/harnesses/pi/PiDiscoveryIO.test.ts +337 -0
  388. package/src/__tests__/{providers → harnesses}/pi/PiSessionParser.test.ts +91 -1
  389. package/src/__tests__/{providers → harnesses}/pi/PiSessionTracker.test.ts +1 -1
  390. package/src/__tests__/{providers → harnesses}/pi/durable/PiPrintProtocol.test.ts +1 -1
  391. package/src/__tests__/{providers → harnesses}/pi/durable/PiStreamParser.test.ts +1 -1
  392. package/src/__tests__/readiness/AgentReadiness.test.ts +16 -0
  393. package/src/__tests__/runtime/ManagedAgentRuntime.test.ts +30 -0
  394. package/src/__tests__/utils/IncrementalJsonlSummary.test.ts +414 -0
  395. package/src/__tests__/utils/agents.test.ts +76 -2
  396. package/src/__tests__/utils/conversationTail.bench.test.ts +193 -0
  397. package/src/__tests__/utils/conversationTailParity.test.ts +365 -0
  398. package/src/__tests__/utils/jsonlTail.test.ts +317 -0
  399. package/src/__tests__/utils/matchingConstants.test.ts +40 -0
  400. package/src/__tests__/utils/process.test.ts +254 -0
  401. package/src/adapters/AgentAdapter.ts +37 -14
  402. package/src/capacity/openai.ts +0 -6
  403. package/src/harnesses/antigravity/AntigravityAgentMapper.ts +34 -0
  404. package/src/harnesses/antigravity/AntigravityCliAdapter.ts +126 -0
  405. package/src/harnesses/antigravity/AntigravitySessionLocator.ts +75 -0
  406. package/src/harnesses/antigravity/AntigravitySessionParser.ts +252 -0
  407. package/src/{providers → harnesses}/claude/ClaudeAgentMapper.ts +2 -10
  408. package/src/{providers → harnesses}/claude/ClaudeCodeAdapter.ts +22 -20
  409. package/src/{providers → harnesses}/claude/ClaudeSessionLocator.ts +3 -3
  410. package/src/{providers → harnesses}/claude/ClaudeSessionParser.ts +189 -97
  411. package/src/{providers → harnesses}/codex/CodexAdapter.ts +153 -29
  412. package/src/{providers → harnesses}/codex/CodexAgentMapper.ts +2 -11
  413. package/src/harnesses/codex/CodexSessionLocator.ts +509 -0
  414. package/src/{providers → harnesses}/codex/CodexSessionMapping.ts +3 -3
  415. package/src/{providers → harnesses}/codex/CodexSessionParser.ts +169 -92
  416. package/src/{providers → harnesses}/copilot/CopilotAdapter.ts +22 -22
  417. package/src/{providers → harnesses}/copilot/CopilotAgentMapper.ts +2 -11
  418. package/src/harnesses/copilot/CopilotSessionLocator.ts +161 -0
  419. package/src/harnesses/copilot/CopilotSessionParser.ts +380 -0
  420. package/src/{providers → harnesses}/gemini/GeminiAgentMapper.ts +2 -11
  421. package/src/{providers → harnesses}/gemini/GeminiCliAdapter.ts +7 -9
  422. package/src/harnesses/gemini/GeminiSessionLocator.ts +394 -0
  423. package/src/{providers → harnesses}/gemini/GeminiSessionParser.ts +155 -31
  424. package/src/harnesses/gemini/fileSignature.ts +10 -0
  425. package/src/{providers → harnesses}/grok/GrokAgentMapper.ts +2 -11
  426. package/src/{providers → harnesses}/grok/GrokCliAdapter.ts +16 -15
  427. package/src/{providers → harnesses}/grok/GrokSessionLocator.ts +2 -2
  428. package/src/harnesses/grok/GrokSessionParser.ts +251 -0
  429. package/src/harnesses/index.ts +28 -0
  430. package/src/harnesses/kiro/KiroAdapter.ts +143 -0
  431. package/src/harnesses/kiro/KiroAgentMapper.ts +34 -0
  432. package/src/harnesses/kiro/KiroSessionLocator.ts +143 -0
  433. package/src/harnesses/kiro/KiroSessionParser.ts +376 -0
  434. package/src/{providers → harnesses}/opencode/OpenCodeAdapter.ts +5 -11
  435. package/src/{providers → harnesses}/opencode/OpenCodeAgentMapper.ts +3 -13
  436. package/src/{providers → harnesses}/opencode/OpenCodeSessionLocator.ts +2 -2
  437. package/src/{providers → harnesses}/opencode/OpenCodeSessionParser.ts +4 -3
  438. package/src/{providers → harnesses}/pi/PiAdapter.ts +20 -18
  439. package/src/{providers → harnesses}/pi/PiAgentMapper.ts +2 -11
  440. package/src/harnesses/pi/PiSessionLocator.ts +288 -0
  441. package/src/harnesses/pi/PiSessionParser.ts +488 -0
  442. package/src/{providers → harnesses}/pi/PiSessionTracker.ts +2 -2
  443. package/src/harnesses/shared.ts +119 -0
  444. package/src/index.ts +26 -24
  445. package/src/utils/IncrementalJsonlSummary.ts +306 -0
  446. package/src/utils/agents.ts +60 -28
  447. package/src/utils/index.ts +2 -0
  448. package/src/utils/jsonlTail.ts +349 -0
  449. package/src/utils/matching.ts +3 -3
  450. package/src/utils/matchingConstants.ts +15 -0
  451. package/src/utils/process.ts +189 -45
  452. package/dist/__tests__/adapters/AntigravityCliAdapter.test.js.map +0 -1
  453. package/dist/__tests__/adapters/ClaudeCodeAdapter.test.js.map +0 -1
  454. package/dist/__tests__/adapters/CodexAdapter.test.js.map +0 -1
  455. package/dist/__tests__/adapters/KiroAdapter.test.js.map +0 -1
  456. package/dist/__tests__/durable/CodexCliProbe.test.js.map +0 -1
  457. package/dist/__tests__/durable/CodexDurableAgentRepository.test.js.map +0 -1
  458. package/dist/__tests__/durable/CodexPrintAgent.integration.test.js.map +0 -1
  459. package/dist/__tests__/durable/CodexPrintAgentService.test.js.map +0 -1
  460. package/dist/__tests__/durable/CodexPrintRunner.test.js.map +0 -1
  461. package/dist/__tests__/print/ClaudeCliProbe.test.js.map +0 -1
  462. package/dist/__tests__/print/ClaudePrintAgent.integration.test.js.map +0 -1
  463. package/dist/__tests__/print/ClaudePrintAgentService.test.js.map +0 -1
  464. package/dist/__tests__/print/ClaudePrintRunner.test.js.map +0 -1
  465. package/dist/__tests__/providers/claude/ClaudeAgentMapper.test.js.map +0 -1
  466. package/dist/__tests__/providers/codex/CodexSessionLocator.test.js +0 -194
  467. package/dist/__tests__/providers/codex/CodexSessionLocator.test.js.map +0 -1
  468. package/dist/__tests__/providers/gemini/GeminiCliAdapter.test.js.map +0 -1
  469. package/dist/__tests__/providers/pi/PiSessionParser.test.js.map +0 -1
  470. package/dist/__tests__/utils/ClaudeSessionParser.test.js.map +0 -1
  471. package/dist/adapters/AntigravityCliAdapter.d.ts +0 -57
  472. package/dist/adapters/AntigravityCliAdapter.d.ts.map +0 -1
  473. package/dist/adapters/AntigravityCliAdapter.js +0 -273
  474. package/dist/adapters/AntigravityCliAdapter.js.map +0 -1
  475. package/dist/adapters/KiroAdapter.d.ts +0 -46
  476. package/dist/adapters/KiroAdapter.d.ts.map +0 -1
  477. package/dist/adapters/KiroAdapter.js +0 -344
  478. package/dist/adapters/KiroAdapter.js.map +0 -1
  479. package/dist/adapters/index.d.ts +0 -12
  480. package/dist/adapters/index.d.ts.map +0 -1
  481. package/dist/adapters/index.js +0 -12
  482. package/dist/adapters/index.js.map +0 -1
  483. package/dist/providers/claude/ClaudeAgentMapper.js.map +0 -1
  484. package/dist/providers/claude/ClaudeCodeAdapter.d.ts.map +0 -1
  485. package/dist/providers/claude/ClaudeCodeAdapter.js.map +0 -1
  486. package/dist/providers/claude/ClaudeSessionLocator.js.map +0 -1
  487. package/dist/providers/claude/ClaudeSessionParser.d.ts.map +0 -1
  488. package/dist/providers/claude/ClaudeSessionParser.js.map +0 -1
  489. package/dist/providers/codex/CodexAdapter.d.ts.map +0 -1
  490. package/dist/providers/codex/CodexAdapter.js.map +0 -1
  491. package/dist/providers/codex/CodexAgentMapper.js.map +0 -1
  492. package/dist/providers/codex/CodexSessionLocator.d.ts +0 -44
  493. package/dist/providers/codex/CodexSessionLocator.d.ts.map +0 -1
  494. package/dist/providers/codex/CodexSessionLocator.js +0 -207
  495. package/dist/providers/codex/CodexSessionLocator.js.map +0 -1
  496. package/dist/providers/codex/CodexSessionMapping.js.map +0 -1
  497. package/dist/providers/codex/CodexSessionParser.d.ts +0 -58
  498. package/dist/providers/codex/CodexSessionParser.d.ts.map +0 -1
  499. package/dist/providers/codex/CodexSessionParser.js.map +0 -1
  500. package/dist/providers/copilot/CopilotAdapter.d.ts.map +0 -1
  501. package/dist/providers/copilot/CopilotAdapter.js.map +0 -1
  502. package/dist/providers/copilot/CopilotAgentMapper.js.map +0 -1
  503. package/dist/providers/copilot/CopilotSessionLocator.d.ts +0 -20
  504. package/dist/providers/copilot/CopilotSessionLocator.d.ts.map +0 -1
  505. package/dist/providers/copilot/CopilotSessionLocator.js +0 -49
  506. package/dist/providers/copilot/CopilotSessionLocator.js.map +0 -1
  507. package/dist/providers/copilot/CopilotSessionParser.d.ts +0 -30
  508. package/dist/providers/copilot/CopilotSessionParser.d.ts.map +0 -1
  509. package/dist/providers/copilot/CopilotSessionParser.js +0 -181
  510. package/dist/providers/copilot/CopilotSessionParser.js.map +0 -1
  511. package/dist/providers/gemini/GeminiAgentMapper.js.map +0 -1
  512. package/dist/providers/gemini/GeminiCliAdapter.d.ts.map +0 -1
  513. package/dist/providers/gemini/GeminiCliAdapter.js.map +0 -1
  514. package/dist/providers/gemini/GeminiSessionLocator.d.ts +0 -30
  515. package/dist/providers/gemini/GeminiSessionLocator.d.ts.map +0 -1
  516. package/dist/providers/gemini/GeminiSessionLocator.js +0 -142
  517. package/dist/providers/gemini/GeminiSessionLocator.js.map +0 -1
  518. package/dist/providers/gemini/GeminiSessionParser.d.ts.map +0 -1
  519. package/dist/providers/gemini/GeminiSessionParser.js +0 -166
  520. package/dist/providers/gemini/GeminiSessionParser.js.map +0 -1
  521. package/dist/providers/grok/GrokAgentMapper.js.map +0 -1
  522. package/dist/providers/grok/GrokCliAdapter.d.ts.map +0 -1
  523. package/dist/providers/grok/GrokCliAdapter.js.map +0 -1
  524. package/dist/providers/grok/GrokSessionLocator.js.map +0 -1
  525. package/dist/providers/grok/GrokSessionParser.d.ts +0 -54
  526. package/dist/providers/grok/GrokSessionParser.d.ts.map +0 -1
  527. package/dist/providers/grok/GrokSessionParser.js +0 -122
  528. package/dist/providers/grok/GrokSessionParser.js.map +0 -1
  529. package/dist/providers/opencode/OpenCodeAdapter.d.ts.map +0 -1
  530. package/dist/providers/opencode/OpenCodeAdapter.js.map +0 -1
  531. package/dist/providers/opencode/OpenCodeAgentMapper.js.map +0 -1
  532. package/dist/providers/opencode/OpenCodeSessionLocator.js.map +0 -1
  533. package/dist/providers/opencode/OpenCodeSessionParser.d.ts.map +0 -1
  534. package/dist/providers/opencode/OpenCodeSessionParser.js.map +0 -1
  535. package/dist/providers/pi/PiAdapter.d.ts.map +0 -1
  536. package/dist/providers/pi/PiAdapter.js.map +0 -1
  537. package/dist/providers/pi/PiAgentMapper.js.map +0 -1
  538. package/dist/providers/pi/PiSessionLocator.d.ts +0 -24
  539. package/dist/providers/pi/PiSessionLocator.d.ts.map +0 -1
  540. package/dist/providers/pi/PiSessionLocator.js +0 -86
  541. package/dist/providers/pi/PiSessionLocator.js.map +0 -1
  542. package/dist/providers/pi/PiSessionParser.d.ts +0 -36
  543. package/dist/providers/pi/PiSessionParser.d.ts.map +0 -1
  544. package/dist/providers/pi/PiSessionParser.js +0 -191
  545. package/dist/providers/pi/PiSessionParser.js.map +0 -1
  546. package/dist/providers/pi/PiSessionTracker.js.map +0 -1
  547. package/src/__tests__/fixtures/fake-claude.cjs +0 -31
  548. package/src/__tests__/fixtures/fake-codex.cjs +0 -56
  549. package/src/__tests__/providers/codex/CodexSessionLocator.test.ts +0 -182
  550. package/src/adapters/AntigravityCliAdapter.ts +0 -356
  551. package/src/adapters/KiroAdapter.ts +0 -456
  552. package/src/adapters/index.ts +0 -17
  553. package/src/providers/codex/CodexSessionLocator.ts +0 -279
  554. package/src/providers/copilot/CopilotSessionLocator.ts +0 -63
  555. package/src/providers/copilot/CopilotSessionParser.ts +0 -289
  556. package/src/providers/gemini/GeminiSessionLocator.ts +0 -183
  557. package/src/providers/grok/GrokSessionParser.ts +0 -166
  558. package/src/providers/pi/PiSessionLocator.ts +0 -110
  559. package/src/providers/pi/PiSessionParser.ts +0 -284
  560. /package/dist/__tests__/{providers → harnesses}/pi/durable/PiCliProbe.test.js +0 -0
  561. /package/dist/__tests__/{providers → harnesses}/pi/durable/PiDurableAgentRepository.test.js +0 -0
  562. /package/dist/__tests__/{providers → harnesses}/pi/durable/PiPrintAgentService.test.js +0 -0
  563. /package/dist/__tests__/{providers → harnesses}/pi/durable/PiPrintRunner.test.js +0 -0
  564. /package/dist/{providers → harnesses}/claude/ClaudeAgentMapper.d.ts +0 -0
  565. /package/dist/{providers → harnesses}/claude/ClaudeSessionLocator.d.ts +0 -0
  566. /package/dist/{providers → harnesses}/claude/durable/ClaudeCliProbe.d.ts +0 -0
  567. /package/dist/{providers → harnesses}/claude/durable/ClaudeCliProbe.js +0 -0
  568. /package/dist/{providers → harnesses}/claude/durable/ClaudePrintAgentService.d.ts +0 -0
  569. /package/dist/{providers → harnesses}/claude/durable/ClaudePrintAgentService.js +0 -0
  570. /package/dist/{providers → harnesses}/claude/durable/ClaudePrintRunner.d.ts +0 -0
  571. /package/dist/{providers → harnesses}/claude/durable/ClaudePrintRunner.js +0 -0
  572. /package/dist/{providers → harnesses}/claude/durable/ClaudeStreamParser.d.ts +0 -0
  573. /package/dist/{providers → harnesses}/claude/durable/ClaudeStreamParser.js +0 -0
  574. /package/dist/{providers → harnesses}/codex/CodexAgentMapper.d.ts +0 -0
  575. /package/dist/{providers → harnesses}/codex/CodexSessionMapping.d.ts +0 -0
  576. /package/dist/{providers → harnesses}/codex/durable/CodexCliProbe.d.ts +0 -0
  577. /package/dist/{providers → harnesses}/codex/durable/CodexCliProbe.js +0 -0
  578. /package/dist/{providers → harnesses}/codex/durable/CodexPrintAgentService.d.ts +0 -0
  579. /package/dist/{providers → harnesses}/codex/durable/CodexPrintAgentService.js +0 -0
  580. /package/dist/{providers → harnesses}/codex/durable/CodexPrintRunner.d.ts +0 -0
  581. /package/dist/{providers → harnesses}/codex/durable/CodexPrintRunner.js +0 -0
  582. /package/dist/{providers → harnesses}/codex/durable/CodexStreamParser.d.ts +0 -0
  583. /package/dist/{providers → harnesses}/codex/durable/CodexStreamParser.js +0 -0
  584. /package/dist/{providers → harnesses}/copilot/CopilotAgentMapper.d.ts +0 -0
  585. /package/dist/{providers → harnesses}/gemini/GeminiAgentMapper.d.ts +0 -0
  586. /package/dist/{providers → harnesses}/grok/GrokAgentMapper.d.ts +0 -0
  587. /package/dist/{providers → harnesses}/grok/GrokSessionLocator.d.ts +0 -0
  588. /package/dist/{providers → harnesses}/opencode/OpenCodeAgentMapper.d.ts +0 -0
  589. /package/dist/{providers → harnesses}/opencode/OpenCodeSessionLocator.d.ts +0 -0
  590. /package/dist/{providers → harnesses}/pi/PiAgentMapper.d.ts +0 -0
  591. /package/dist/{providers → harnesses}/pi/PiSessionTracker.d.ts +0 -0
  592. /package/dist/{providers → harnesses}/pi/durable/PiCliProbe.d.ts +0 -0
  593. /package/dist/{providers → harnesses}/pi/durable/PiCliProbe.js +0 -0
  594. /package/dist/{providers → harnesses}/pi/durable/PiPrintAgentService.d.ts +0 -0
  595. /package/dist/{providers → harnesses}/pi/durable/PiPrintAgentService.js +0 -0
  596. /package/dist/{providers → harnesses}/pi/durable/PiPrintProtocol.d.ts +0 -0
  597. /package/dist/{providers → harnesses}/pi/durable/PiPrintProtocol.js +0 -0
  598. /package/dist/{providers → harnesses}/pi/durable/PiPrintRunner.d.ts +0 -0
  599. /package/dist/{providers → harnesses}/pi/durable/PiPrintRunner.js +0 -0
  600. /package/dist/{providers → harnesses}/pi/durable/PiStreamParser.d.ts +0 -0
  601. /package/dist/{providers → harnesses}/pi/durable/PiStreamParser.js +0 -0
  602. /package/src/__tests__/{providers → harnesses}/pi/durable/PiCliProbe.test.ts +0 -0
  603. /package/src/__tests__/{providers → harnesses}/pi/durable/PiDurableAgentRepository.test.ts +0 -0
  604. /package/src/__tests__/{providers → harnesses}/pi/durable/PiPrintAgentService.test.ts +0 -0
  605. /package/src/__tests__/{providers → harnesses}/pi/durable/PiPrintRunner.test.ts +0 -0
  606. /package/src/{providers → harnesses}/claude/durable/ClaudeCliProbe.ts +0 -0
  607. /package/src/{providers → harnesses}/claude/durable/ClaudePrintAgentService.ts +0 -0
  608. /package/src/{providers → harnesses}/claude/durable/ClaudePrintRunner.ts +0 -0
  609. /package/src/{providers → harnesses}/claude/durable/ClaudeStreamParser.ts +0 -0
  610. /package/src/{providers → harnesses}/codex/durable/CodexCliProbe.ts +0 -0
  611. /package/src/{providers → harnesses}/codex/durable/CodexPrintAgentService.ts +0 -0
  612. /package/src/{providers → harnesses}/codex/durable/CodexPrintRunner.ts +0 -0
  613. /package/src/{providers → harnesses}/codex/durable/CodexStreamParser.ts +0 -0
  614. /package/src/{providers → harnesses}/pi/durable/PiCliProbe.ts +0 -0
  615. /package/src/{providers → harnesses}/pi/durable/PiPrintAgentService.ts +0 -0
  616. /package/src/{providers → harnesses}/pi/durable/PiPrintProtocol.ts +0 -0
  617. /package/src/{providers → harnesses}/pi/durable/PiPrintRunner.ts +0 -0
  618. /package/src/{providers → harnesses}/pi/durable/PiStreamParser.ts +0 -0
@@ -0,0 +1 @@
1
+ {"version":3,"file":"AntigravitySessionParser.d.ts","sourceRoot":"","sources":["../../../src/harnesses/antigravity/AntigravitySessionParser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAC/F,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAC7D,OAAO,EAGL,KAAK,kBAAkB,EAExB,MAAM,wCAAwC,CAAC;AAwBhD,8CAA8C;AAC9C,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,IAAI,CAAC;IACnB,UAAU,EAAE,IAAI,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,mBAAmB,CAAC,MAAM,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,+BAA+B;IAC9C,yFAAyF;IACzF,aAAa,CAAC,EAAE,kBAAkB,GAAG,KAAK,CAAC;CAC5C;AAED,qBAAa,wBAAwB;IACnC,8DAA8D;IAC9D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAyB;IAEpD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAmD;gBAEpE,OAAO,GAAE,+BAAoC;IAMzD;;;;OAIG;IACH,WAAW,CACT,cAAc,EAAE,MAAM,EACtB,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,MAAM,GAClB,kBAAkB,GAAG,IAAI;IAS5B;;;;;;;OAOG;IACH,sBAAsB,CACpB,cAAc,EAAE,MAAM,EACtB,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,MAAM,GAClB,kBAAkB,GAAG,IAAI;IAgB5B,0EAA0E;IAC1E,iBAAiB,IAAI,IAAI;IAIzB,eAAe,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,mBAAmB,EAAE;IAoB7F;;;;OAIG;IACH,eAAe,CAAC,OAAO,EAAE,kBAAkB,GAAG,WAAW;IAUzD;;;;;;;;OAQG;IACH,OAAO,CAAC,QAAQ,CAAC,cAAc,CAyB7B;IAEF,OAAO,CAAC,SAAS;IAoBjB,wEAAwE;IACxE,OAAO,CAAC,eAAe;IAavB,OAAO,CAAC,WAAW;IASnB;;;;;OAKG;IACH,OAAO,CAAC,eAAe;IAWvB;;;OAGG;IACH,OAAO,CAAC,kBAAkB;CAK3B"}
@@ -0,0 +1,174 @@
1
+ import { AgentStatus } from "../../adapters/AgentAdapter.js";
2
+ import { IncrementalJsonlSummary, reduceJsonlContent } from "../../utils/IncrementalJsonlSummary.js";
3
+ import { JsonlTailReader, normalizeTail } from "../../utils/jsonlTail.js";
4
+ import { safeReadFile, safeStat } from "../../utils/session.js";
5
+ import { flattenTextBlocks, isIdle, parseTimestamp } from "../shared.js";
6
+ export class AntigravitySessionParser {
7
+ /** Incremental reader backing `getConversation({ tail })`. */ tailReader = new JsonlTailReader();
8
+ sessionCache;
9
+ constructor(options = {}){
10
+ this.sessionCache = new IncrementalJsonlSummary(this.summaryReducer, {
11
+ bounds: options.summaryBounds
12
+ });
13
+ }
14
+ /**
15
+ * Parse a conversation's transcript.jsonl into an {@link AntigravitySession}.
16
+ * Returns null when the transcript is missing — there is no real session to
17
+ * surface.
18
+ */ readSession(conversationId, transcriptPath, projectPath) {
19
+ const stat = safeStat(transcriptPath);
20
+ if (!stat) return null;
21
+ const content = safeReadFile(transcriptPath);
22
+ const state = content === undefined ? {} : reduceJsonlContent(this.summaryReducer, content);
23
+ return this.toSession(conversationId, transcriptPath, projectPath, stat, stat.mtime, state);
24
+ }
25
+ /**
26
+ * Same result as `readSession`, but backed by a per-instance incremental
27
+ * cache so repeated refreshes only parse bytes appended since the last call.
28
+ * Call `pruneSessionCache()` once per refresh to evict files no longer read.
29
+ *
30
+ * The first read of a large transcript is a bounded head + tail scan (see
31
+ * `summaryReducer.skip`).
32
+ */ readSessionIncremental(conversationId, transcriptPath, projectPath) {
33
+ const stat = safeStat(transcriptPath);
34
+ if (!stat) return null;
35
+ // Present but unreadable: surface the session without a summary, like readSession.
36
+ const result = this.sessionCache.read(transcriptPath);
37
+ return this.toSession(conversationId, transcriptPath, projectPath, stat, result?.mtime ?? stat.mtime, result?.state ?? {});
38
+ }
39
+ /** Evict cached summaries for files not read since the previous prune. */ pruneSessionCache() {
40
+ this.sessionCache.prune();
41
+ }
42
+ getConversation(transcriptPath, options) {
43
+ const verbose = options?.verbose ?? false;
44
+ const tail = normalizeTail(options?.tail);
45
+ if (tail === undefined) {
46
+ return this.parseTranscript(transcriptPath, verbose);
47
+ }
48
+ return this.tailReader.read(transcriptPath, tail, {
49
+ parseLine: (line)=>{
50
+ const record = this.parseRecord(line);
51
+ return record ? this.recordToMessage(record, verbose) : null;
52
+ }
53
+ }, String(verbose));
54
+ }
55
+ /**
56
+ * - past the idle threshold → IDLE
57
+ * - last turn is an assistant reply → WAITING (awaiting user)
58
+ * - otherwise (last turn was a user message, or unknown) → RUNNING
59
+ */ determineStatus(session) {
60
+ if (isIdle(session.lastActive)) {
61
+ return AgentStatus.IDLE;
62
+ }
63
+ if (session.lastRole === "assistant") {
64
+ return AgentStatus.WAITING;
65
+ }
66
+ return AgentStatus.RUNNING;
67
+ }
68
+ /**
69
+ * Fold one transcript record into the O(1) summary: first/last user request,
70
+ * the role of the last user/assistant turn, and the latest `created_at`.
71
+ * Uses the same record rules as `getConversation` (see `recordToMessage`).
72
+ *
73
+ * `skip` (bounded cold start) keeps the head's first user request and resets
74
+ * the latest fields, so those come from the tail only; without a timestamp in
75
+ * the tail, `lastActive` falls back to the file mtime.
76
+ */ summaryReducer = {
77
+ initial: ()=>({}),
78
+ reduce: (state, value)=>{
79
+ if (value === null || value === undefined) return state;
80
+ const record = value;
81
+ let next = state;
82
+ const atMs = parseTimestamp(record.created_at)?.getTime();
83
+ if (atMs !== undefined && (next.lastActiveMs === undefined || atMs > next.lastActiveMs)) {
84
+ next = {
85
+ ...next,
86
+ lastActiveMs: atMs
87
+ };
88
+ }
89
+ const message = this.recordToMessage(record, false);
90
+ if (message?.role === "user") {
91
+ return {
92
+ ...next,
93
+ firstUserMessage: next.firstUserMessage ?? (next.pastHead ? undefined : message.content),
94
+ lastUserMessage: message.content,
95
+ lastRole: "user"
96
+ };
97
+ }
98
+ if (message?.role === "assistant") return {
99
+ ...next,
100
+ lastRole: "assistant"
101
+ };
102
+ return next;
103
+ },
104
+ skip: (state)=>({
105
+ pastHead: true,
106
+ firstUserMessage: state.firstUserMessage
107
+ })
108
+ };
109
+ toSession(conversationId, transcriptPath, projectPath, stat, mtime, state) {
110
+ return {
111
+ sessionId: conversationId,
112
+ projectPath,
113
+ sessionFilePath: transcriptPath,
114
+ sessionStart: stat.birthtime,
115
+ lastActive: state.lastActiveMs === undefined ? mtime : new Date(state.lastActiveMs),
116
+ firstUserMessage: state.firstUserMessage,
117
+ lastUserMessage: state.lastUserMessage,
118
+ lastRole: state.lastRole
119
+ };
120
+ }
121
+ /** Full pass over transcript.jsonl building every conversation turn. */ parseTranscript(transcriptPath, verbose) {
122
+ const content = safeReadFile(transcriptPath);
123
+ if (content === undefined) return [];
124
+ const messages = [];
125
+ for (const line of content.trim().split("\n")){
126
+ const record = this.parseRecord(line);
127
+ const message = record ? this.recordToMessage(record, verbose) : null;
128
+ if (message) messages.push(message);
129
+ }
130
+ return messages;
131
+ }
132
+ parseRecord(line) {
133
+ if (!line.trim()) return null;
134
+ try {
135
+ return JSON.parse(line);
136
+ } catch {
137
+ return null;
138
+ }
139
+ }
140
+ /**
141
+ * USER_INPUT records are user turns and PLANNER_RESPONSE records are the
142
+ * model's reply. Everything else — MODEL tool calls (RUN_COMMAND, ...) and
143
+ * SYSTEM records (history, checkpoints) — is execution detail, shown as a
144
+ * system message only in verbose mode.
145
+ */ recordToMessage(record, verbose) {
146
+ const text = flattenTextBlocks(record.content);
147
+ if (record.type === "USER_INPUT") {
148
+ const request = this.extractUserRequest(text);
149
+ return request === null ? null : {
150
+ role: "user",
151
+ content: request
152
+ };
153
+ }
154
+ if (!text) return null;
155
+ if (record.type === "PLANNER_RESPONSE") return {
156
+ role: "assistant",
157
+ content: text
158
+ };
159
+ return verbose ? {
160
+ role: "system",
161
+ content: text
162
+ } : null;
163
+ }
164
+ /**
165
+ * The prompt inside <USER_REQUEST>...</USER_REQUEST>, or the whole trimmed
166
+ * text when the record has no wrapper. Null for an unwrapped blank record.
167
+ */ extractUserRequest(text) {
168
+ const match = text.match(/<USER_REQUEST>\s*([\s\S]*?)\s*<\/USER_REQUEST>/);
169
+ if (match) return match[1].trim();
170
+ return text.trim() || null;
171
+ }
172
+ }
173
+
174
+ //# sourceMappingURL=AntigravitySessionParser.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../../src/harnesses/antigravity/AntigravitySessionParser.ts"],"sourcesContent":["import type { ConversationMessage, ConversationOptions } from \"../../adapters/AgentAdapter.js\";\nimport { AgentStatus } from \"../../adapters/AgentAdapter.js\";\nimport {\n IncrementalJsonlSummary,\n reduceJsonlContent,\n type JsonlSummaryBounds,\n type JsonlSummaryReducer,\n} from \"../../utils/IncrementalJsonlSummary.js\";\nimport { JsonlTailReader, normalizeTail } from \"../../utils/jsonlTail.js\";\nimport { safeReadFile, safeStat } from \"../../utils/session.js\";\nimport { flattenTextBlocks, isIdle, parseTimestamp } from \"../shared.js\";\n\n/** One line of transcript.jsonl. */\ninterface TranscriptRecord {\n source?: string;\n type?: string;\n created_at?: string;\n content?: unknown;\n}\n\n/** O(1) running summary folded from transcript records, never the turns themselves. */\ninterface AntigravitySummaryState {\n /** A bounded cold start skipped the middle: later lines are not the session's first. */\n pastHead?: boolean;\n firstUserMessage?: string;\n lastUserMessage?: string;\n lastRole?: ConversationMessage[\"role\"];\n /** Latest `created_at` seen, in epoch ms. */\n lastActiveMs?: number;\n}\n\n/** Parsed state for a single conversation. */\nexport interface AntigravitySession {\n sessionId: string;\n projectPath: string;\n sessionFilePath: string;\n sessionStart: Date;\n lastActive: Date;\n firstUserMessage?: string;\n lastUserMessage?: string;\n lastRole?: ConversationMessage[\"role\"];\n}\n\nexport interface AntigravitySessionParserOptions {\n /** Cold-start scan bounds for `readSessionIncremental` (see IncrementalJsonlSummary). */\n summaryBounds?: JsonlSummaryBounds | false;\n}\n\nexport class AntigravitySessionParser {\n /** Incremental reader backing `getConversation({ tail })`. */\n private readonly tailReader = new JsonlTailReader();\n\n private readonly sessionCache: IncrementalJsonlSummary<AntigravitySummaryState>;\n\n constructor(options: AntigravitySessionParserOptions = {}) {\n this.sessionCache = new IncrementalJsonlSummary(this.summaryReducer, {\n bounds: options.summaryBounds,\n });\n }\n\n /**\n * Parse a conversation's transcript.jsonl into an {@link AntigravitySession}.\n * Returns null when the transcript is missing — there is no real session to\n * surface.\n */\n readSession(\n conversationId: string,\n transcriptPath: string,\n projectPath: string,\n ): AntigravitySession | null {\n const stat = safeStat(transcriptPath);\n if (!stat) return null;\n\n const content = safeReadFile(transcriptPath);\n const state = content === undefined ? {} : reduceJsonlContent(this.summaryReducer, content);\n return this.toSession(conversationId, transcriptPath, projectPath, stat, stat.mtime, state);\n }\n\n /**\n * Same result as `readSession`, but backed by a per-instance incremental\n * cache so repeated refreshes only parse bytes appended since the last call.\n * Call `pruneSessionCache()` once per refresh to evict files no longer read.\n *\n * The first read of a large transcript is a bounded head + tail scan (see\n * `summaryReducer.skip`).\n */\n readSessionIncremental(\n conversationId: string,\n transcriptPath: string,\n projectPath: string,\n ): AntigravitySession | null {\n const stat = safeStat(transcriptPath);\n if (!stat) return null;\n\n // Present but unreadable: surface the session without a summary, like readSession.\n const result = this.sessionCache.read(transcriptPath);\n return this.toSession(\n conversationId,\n transcriptPath,\n projectPath,\n stat,\n result?.mtime ?? stat.mtime,\n result?.state ?? {},\n );\n }\n\n /** Evict cached summaries for files not read since the previous prune. */\n pruneSessionCache(): void {\n this.sessionCache.prune();\n }\n\n getConversation(transcriptPath: string, options?: ConversationOptions): ConversationMessage[] {\n const verbose = options?.verbose ?? false;\n const tail = normalizeTail(options?.tail);\n if (tail === undefined) {\n return this.parseTranscript(transcriptPath, verbose);\n }\n\n return this.tailReader.read(\n transcriptPath,\n tail,\n {\n parseLine: (line) => {\n const record = this.parseRecord(line);\n return record ? this.recordToMessage(record, verbose) : null;\n },\n },\n String(verbose),\n );\n }\n\n /**\n * - past the idle threshold → IDLE\n * - last turn is an assistant reply → WAITING (awaiting user)\n * - otherwise (last turn was a user message, or unknown) → RUNNING\n */\n determineStatus(session: AntigravitySession): AgentStatus {\n if (isIdle(session.lastActive)) {\n return AgentStatus.IDLE;\n }\n if (session.lastRole === \"assistant\") {\n return AgentStatus.WAITING;\n }\n return AgentStatus.RUNNING;\n }\n\n /**\n * Fold one transcript record into the O(1) summary: first/last user request,\n * the role of the last user/assistant turn, and the latest `created_at`.\n * Uses the same record rules as `getConversation` (see `recordToMessage`).\n *\n * `skip` (bounded cold start) keeps the head's first user request and resets\n * the latest fields, so those come from the tail only; without a timestamp in\n * the tail, `lastActive` falls back to the file mtime.\n */\n private readonly summaryReducer: JsonlSummaryReducer<AntigravitySummaryState> = {\n initial: () => ({}),\n reduce: (state, value) => {\n if (value === null || value === undefined) return state;\n const record = value as TranscriptRecord;\n\n let next = state;\n const atMs = parseTimestamp(record.created_at)?.getTime();\n if (atMs !== undefined && (next.lastActiveMs === undefined || atMs > next.lastActiveMs)) {\n next = { ...next, lastActiveMs: atMs };\n }\n\n const message = this.recordToMessage(record, false);\n if (message?.role === \"user\") {\n return {\n ...next,\n firstUserMessage: next.firstUserMessage ?? (next.pastHead ? undefined : message.content),\n lastUserMessage: message.content,\n lastRole: \"user\",\n };\n }\n if (message?.role === \"assistant\") return { ...next, lastRole: \"assistant\" };\n return next;\n },\n skip: (state) => ({ pastHead: true, firstUserMessage: state.firstUserMessage }),\n };\n\n private toSession(\n conversationId: string,\n transcriptPath: string,\n projectPath: string,\n stat: { birthtime: Date },\n mtime: Date,\n state: AntigravitySummaryState,\n ): AntigravitySession {\n return {\n sessionId: conversationId,\n projectPath,\n sessionFilePath: transcriptPath,\n sessionStart: stat.birthtime,\n lastActive: state.lastActiveMs === undefined ? mtime : new Date(state.lastActiveMs),\n firstUserMessage: state.firstUserMessage,\n lastUserMessage: state.lastUserMessage,\n lastRole: state.lastRole,\n };\n }\n\n /** Full pass over transcript.jsonl building every conversation turn. */\n private parseTranscript(transcriptPath: string, verbose: boolean): ConversationMessage[] {\n const content = safeReadFile(transcriptPath);\n if (content === undefined) return [];\n\n const messages: ConversationMessage[] = [];\n for (const line of content.trim().split(\"\\n\")) {\n const record = this.parseRecord(line);\n const message = record ? this.recordToMessage(record, verbose) : null;\n if (message) messages.push(message);\n }\n return messages;\n }\n\n private parseRecord(line: string): TranscriptRecord | null {\n if (!line.trim()) return null;\n try {\n return JSON.parse(line) as TranscriptRecord;\n } catch {\n return null;\n }\n }\n\n /**\n * USER_INPUT records are user turns and PLANNER_RESPONSE records are the\n * model's reply. Everything else — MODEL tool calls (RUN_COMMAND, ...) and\n * SYSTEM records (history, checkpoints) — is execution detail, shown as a\n * system message only in verbose mode.\n */\n private recordToMessage(record: TranscriptRecord, verbose: boolean): ConversationMessage | null {\n const text = flattenTextBlocks(record.content);\n if (record.type === \"USER_INPUT\") {\n const request = this.extractUserRequest(text);\n return request === null ? null : { role: \"user\", content: request };\n }\n if (!text) return null;\n if (record.type === \"PLANNER_RESPONSE\") return { role: \"assistant\", content: text };\n return verbose ? { role: \"system\", content: text } : null;\n }\n\n /**\n * The prompt inside <USER_REQUEST>...</USER_REQUEST>, or the whole trimmed\n * text when the record has no wrapper. Null for an unwrapped blank record.\n */\n private extractUserRequest(text: string): string | null {\n const match = text.match(/<USER_REQUEST>\\s*([\\s\\S]*?)\\s*<\\/USER_REQUEST>/);\n if (match) return match[1].trim();\n return text.trim() || null;\n }\n}\n"],"names":["AgentStatus","IncrementalJsonlSummary","reduceJsonlContent","JsonlTailReader","normalizeTail","safeReadFile","safeStat","flattenTextBlocks","isIdle","parseTimestamp","AntigravitySessionParser","tailReader","sessionCache","options","summaryReducer","bounds","summaryBounds","readSession","conversationId","transcriptPath","projectPath","stat","content","state","undefined","toSession","mtime","readSessionIncremental","result","read","pruneSessionCache","prune","getConversation","verbose","tail","parseTranscript","parseLine","line","record","parseRecord","recordToMessage","String","determineStatus","session","lastActive","IDLE","lastRole","WAITING","RUNNING","initial","reduce","value","next","atMs","created_at","getTime","lastActiveMs","message","role","firstUserMessage","pastHead","lastUserMessage","skip","sessionId","sessionFilePath","sessionStart","birthtime","Date","messages","trim","split","push","JSON","parse","text","type","request","extractUserRequest","match"],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"ClaudeAgentMapper.d.ts","sourceRoot":"","sources":["../../../src/providers/claude/ClaudeAgentMapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAC7E,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAE7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,KAAK,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEnF,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,WAAW,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,aAAa,CAAC;IACvB,WAAW,EAAE,WAAW,CAAC;IACzB,WAAW,EAAE,WAAW,CAAC;IACzB,QAAQ,CAAC,EAAE,mBAAmB,CAAC;CAChC;AAED,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,GAAE,mBAA+C;IAEpF,iBAAiB,CAAC,EAChB,OAAO,EACP,WAAW,EACX,WAAW,EACX,QAAQ,GACT,EAAE,uBAAuB,GAAG,SAAS;IAwBtC,mBAAmB,CAAC,WAAW,EAAE,WAAW,GAAG,SAAS;CAYzD"}
1
+ {"version":3,"file":"ClaudeAgentMapper.d.ts","sourceRoot":"","sources":["../../../src/harnesses/claude/ClaudeAgentMapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAC7E,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAE7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,KAAK,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAGnF,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,WAAW,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,aAAa,CAAC;IACvB,WAAW,EAAE,WAAW,CAAC;IACzB,WAAW,EAAE,WAAW,CAAC;IACzB,QAAQ,CAAC,EAAE,mBAAmB,CAAC;CAChC;AAED,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,GAAE,mBAA+C;IAEpF,iBAAiB,CAAC,EAChB,OAAO,EACP,WAAW,EACX,WAAW,EACX,QAAQ,GACT,EAAE,uBAAuB,GAAG,SAAS;IAwBtC,mBAAmB,CAAC,WAAW,EAAE,WAAW,GAAG,SAAS;CAGzD"}
@@ -1,6 +1,7 @@
1
1
  import { AgentStatus } from "../../adapters/AgentAdapter.js";
2
2
  import { generateAgentName } from "../../utils/matching.js";
3
3
  import { ClaudeSessionParser } from "./ClaudeSessionParser.js";
4
+ import { processOnlyAgent } from "../shared.js";
4
5
  export class ClaudeAgentMapper {
5
6
  parser;
6
7
  constructor(parser = new ClaudeSessionParser()){
@@ -26,16 +27,9 @@ export class ClaudeAgentMapper {
26
27
  };
27
28
  }
28
29
  mapProcessOnlyAgent(processInfo) {
29
- return {
30
- name: generateAgentName(processInfo.cwd || "", processInfo.pid),
31
- type: "claude",
32
- status: AgentStatus.IDLE,
33
- summary: "Unknown",
34
- pid: processInfo.pid,
35
- projectPath: processInfo.cwd || "",
36
- sessionId: `pid-${processInfo.pid}`,
37
- lastActive: new Date()
38
- };
30
+ return processOnlyAgent("claude", processInfo, {
31
+ summary: "Claude Code process running"
32
+ });
39
33
  }
40
34
  }
41
35
 
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../../src/harnesses/claude/ClaudeAgentMapper.ts"],"sourcesContent":["import type { AgentInfo, ProcessInfo } from \"../../adapters/AgentAdapter.js\";\nimport { AgentStatus } from \"../../adapters/AgentAdapter.js\";\nimport { generateAgentName } from \"../../utils/matching.js\";\nimport type { SessionFile } from \"../../utils/session.js\";\nimport { ClaudeSessionParser, type ClaudeSession } from \"./ClaudeSessionParser.js\";\nimport { processOnlyAgent } from \"../shared.js\";\n\nexport interface ClaudeAgentLiveInfo {\n pidStatus?: AgentStatus;\n waitingFor?: string;\n}\n\nexport interface ClaudeSessionAgentInput {\n session: ClaudeSession;\n processInfo: ProcessInfo;\n sessionFile: SessionFile;\n liveInfo?: ClaudeAgentLiveInfo;\n}\n\nexport class ClaudeAgentMapper {\n constructor(private readonly parser: ClaudeSessionParser = new ClaudeSessionParser()) {}\n\n mapSessionToAgent({\n session,\n processInfo,\n sessionFile,\n liveInfo,\n }: ClaudeSessionAgentInput): AgentInfo {\n // Live PID-file status is authoritative when present — JSONL-derived\n // status mis-classifies sessions whose latest entry is a UI-state\n // event like `permission-mode` or `ai-title`.\n const status = liveInfo?.pidStatus ?? this.parser.determineStatus(session);\n const baseSummary = session.lastUserMessage || \"Session started\";\n const summary =\n status === AgentStatus.WAITING && liveInfo?.waitingFor\n ? `${baseSummary} — waiting for ${liveInfo.waitingFor}`\n : baseSummary;\n\n return {\n name: generateAgentName(processInfo.cwd, processInfo.pid),\n type: \"claude\",\n status,\n summary,\n pid: processInfo.pid,\n projectPath: sessionFile.resolvedCwd || processInfo.cwd || \"\",\n sessionId: sessionFile.sessionId,\n lastActive: session.lastActive,\n sessionFilePath: sessionFile.filePath,\n };\n }\n\n mapProcessOnlyAgent(processInfo: ProcessInfo): AgentInfo {\n return processOnlyAgent(\"claude\", processInfo, { summary: \"Claude Code process running\" });\n }\n}\n"],"names":["AgentStatus","generateAgentName","ClaudeSessionParser","processOnlyAgent","ClaudeAgentMapper","parser","mapSessionToAgent","session","processInfo","sessionFile","liveInfo","status","pidStatus","determineStatus","baseSummary","lastUserMessage","summary","WAITING","waitingFor","name","cwd","pid","type","projectPath","resolvedCwd","sessionId","lastActive","sessionFilePath","filePath","mapProcessOnlyAgent"],"mappings":"AACA,SAASA,WAAW,QAAQ,iCAAiC;AAC7D,SAASC,iBAAiB,QAAQ,0BAA0B;AAE5D,SAASC,mBAAmB,QAA4B,2BAA2B;AACnF,SAASC,gBAAgB,QAAQ,eAAe;AAchD,OAAO,MAAMC;;IACX,YAAY,AAAiBC,SAA8B,IAAIH,qBAAqB,CAAE;aAAzDG,SAAAA;IAA0D;IAEvFC,kBAAkB,EAChBC,OAAO,EACPC,WAAW,EACXC,WAAW,EACXC,QAAQ,EACgB,EAAa;QACrC,qEAAqE;QACrE,kEAAkE;QAClE,8CAA8C;QAC9C,MAAMC,SAASD,UAAUE,aAAa,IAAI,CAACP,MAAM,CAACQ,eAAe,CAACN;QAClE,MAAMO,cAAcP,QAAQQ,eAAe,IAAI;QAC/C,MAAMC,UACJL,WAAWX,YAAYiB,OAAO,IAAIP,UAAUQ,aACxC,GAAGJ,YAAY,eAAe,EAAEJ,SAASQ,UAAU,EAAE,GACrDJ;QAEN,OAAO;YACLK,MAAMlB,kBAAkBO,YAAYY,GAAG,EAAEZ,YAAYa,GAAG;YACxDC,MAAM;YACNX;YACAK;YACAK,KAAKb,YAAYa,GAAG;YACpBE,aAAad,YAAYe,WAAW,IAAIhB,YAAYY,GAAG,IAAI;YAC3DK,WAAWhB,YAAYgB,SAAS;YAChCC,YAAYnB,QAAQmB,UAAU;YAC9BC,iBAAiBlB,YAAYmB,QAAQ;QACvC;IACF;IAEAC,oBAAoBrB,WAAwB,EAAa;QACvD,OAAOL,iBAAiB,UAAUK,aAAa;YAAEQ,SAAS;QAA8B;IAC1F;AACF"}
@@ -1,4 +1,4 @@
1
- import type { AgentAdapter, AgentInfo, ProcessInfo, ConversationMessage, SessionSummary, ListSessionsOptions, AgentDetectionContext } from "../../adapters/AgentAdapter.js";
1
+ import type { AgentAdapter, AgentInfo, ProcessInfo, ConversationMessage, ConversationOptions, SessionSummary, ListSessionsOptions, AgentDetectionContext } from "../../adapters/AgentAdapter.js";
2
2
  /**
3
3
  * Claude Code Adapter
4
4
  *
@@ -7,7 +7,8 @@ import type { AgentAdapter, AgentInfo, ProcessInfo, ConversationMessage, Session
7
7
  * 2. Using snapshot CWD and start-time enrichment
8
8
  * 3. Attempting authoritative PID-file matching via ~/.claude/sessions/<pid>.json
9
9
  * 4. Falling back to CWD+birthtime heuristic (matchProcessesToSessions) for processes without a PID file
10
- * 5. Extracting summary from last user message in session JSONL
10
+ * 5. Extracting summary from last user message in session JSONL (incrementally
11
+ * cached across refreshes, so unchanged transcripts are not re-read)
11
12
  */
12
13
  export declare class ClaudeCodeAdapter implements AgentAdapter {
13
14
  readonly type: "claude";
@@ -18,12 +19,10 @@ export declare class ClaudeCodeAdapter implements AgentAdapter {
18
19
  private sessionsDir;
19
20
  constructor();
20
21
  canHandle(processInfo: ProcessInfo): boolean;
21
- private isClaudeExecutable;
22
22
  detectAgents(context?: AgentDetectionContext): Promise<AgentInfo[]>;
23
+ private detectRunningAgents;
23
24
  private createLocator;
24
- getConversation(sessionFilePath: string, options?: {
25
- verbose?: boolean;
26
- }): ConversationMessage[];
25
+ getConversation(sessionFilePath: string, options?: ConversationOptions): ConversationMessage[];
27
26
  listSessions(opts?: ListSessionsOptions): Promise<SessionSummary[]>;
28
27
  findSessionsById(sessionId: string): Promise<SessionSummary[]>;
29
28
  private toSessionSummary;
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ClaudeCodeAdapter.d.ts","sourceRoot":"","sources":["../../../src/harnesses/claude/ClaudeCodeAdapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,YAAY,EACZ,SAAS,EACT,WAAW,EACX,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACd,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,gCAAgC,CAAC;AAOxC;;;;;;;;;;GAUG;AACH,qBAAa,iBAAkB,YAAW,YAAY;IACpD,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAU;IAClC,QAAQ,CAAC,YAAY,sBAAuB;IAE5C,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAS;;IAS5B,SAAS,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO;IAItC,YAAY,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;YAS3D,mBAAmB;IAoEjC,OAAO,CAAC,aAAa;IAOrB,eAAe,CAAC,eAAe,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,mBAAmB,EAAE;IAIxF,YAAY,CAAC,IAAI,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAenE,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAOpE,OAAO,CAAC,gBAAgB;CAgBzB"}
@@ -1,9 +1,9 @@
1
1
  import * as path from "path";
2
- import { captureProcessSnapshot, executableBasename, filterByProcessNames } from "../../utils/process.js";
3
2
  import { safeStat } from "../../utils/session.js";
4
3
  import { ClaudeSessionParser } from "./ClaudeSessionParser.js";
5
4
  import { ClaudeAgentMapper } from "./ClaudeAgentMapper.js";
6
5
  import { ClaudeSessionLocator } from "./ClaudeSessionLocator.js";
6
+ import { findHarnessProcesses, homeDir, matchesExecutable } from "../shared.js";
7
7
  /**
8
8
  * Claude Code Adapter
9
9
  *
@@ -12,7 +12,8 @@ import { ClaudeSessionLocator } from "./ClaudeSessionLocator.js";
12
12
  * 2. Using snapshot CWD and start-time enrichment
13
13
  * 3. Attempting authoritative PID-file matching via ~/.claude/sessions/<pid>.json
14
14
  * 4. Falling back to CWD+birthtime heuristic (matchProcessesToSessions) for processes without a PID file
15
- * 5. Extracting summary from last user message in session JSONL
15
+ * 5. Extracting summary from last user message in session JSONL (incrementally
16
+ * cached across refreshes, so unchanged transcripts are not re-read)
16
17
  */ export class ClaudeCodeAdapter {
17
18
  type = "claude";
18
19
  processNames = [
@@ -23,23 +24,24 @@ import { ClaudeSessionLocator } from "./ClaudeSessionLocator.js";
23
24
  projectsDir;
24
25
  sessionsDir;
25
26
  constructor(){
26
- const homeDir = process.env.HOME || process.env.USERPROFILE || "";
27
- this.projectsDir = path.join(homeDir, ".claude", "projects");
28
- this.sessionsDir = path.join(homeDir, ".claude", "sessions");
27
+ this.projectsDir = path.join(homeDir(), ".claude", "projects");
28
+ this.sessionsDir = path.join(homeDir(), ".claude", "sessions");
29
29
  this.parser = new ClaudeSessionParser();
30
30
  this.mapper = new ClaudeAgentMapper(this.parser);
31
31
  }
32
32
  canHandle(processInfo) {
33
- return this.isClaudeExecutable(processInfo.command);
34
- }
35
- isClaudeExecutable(command) {
36
- const base = executableBasename(command);
37
- return base === "claude" || base === "claude.exe";
33
+ return matchesExecutable(processInfo.command, "claude");
38
34
  }
39
35
  async detectAgents(context) {
40
- const snapshot = context?.processes ?? await captureProcessSnapshot(this.processNames);
41
- const relevant = filterByProcessNames(snapshot, this.processNames);
42
- const processes = relevant.filter((process1)=>this.canHandle(process1));
36
+ try {
37
+ return await this.detectRunningAgents(context);
38
+ } finally{
39
+ // Drop cached summaries for sessions that were not part of this refresh
40
+ this.parser.pruneSessionCache();
41
+ }
42
+ }
43
+ async detectRunningAgents(context) {
44
+ const { processes } = await findHarnessProcesses(this, context);
43
45
  if (processes.length === 0) {
44
46
  return [];
45
47
  }
@@ -52,7 +54,7 @@ import { ClaudeSessionLocator } from "./ClaudeSessionLocator.js";
52
54
  // Build agents from direct (resume + PID-file) matches
53
55
  for (const match of direct){
54
56
  const { process: proc, sessionFile } = match;
55
- const sessionData = this.parser.readSession(sessionFile.filePath, sessionFile.resolvedCwd);
57
+ const sessionData = this.parser.readSessionIncremental(sessionFile.filePath, sessionFile.resolvedCwd);
56
58
  if (sessionData) {
57
59
  agents.push(this.mapper.mapSessionToAgent({
58
60
  session: sessionData,
@@ -69,7 +71,7 @@ import { ClaudeSessionLocator } from "./ClaudeSessionLocator.js";
69
71
  }
70
72
  // Build agents from legacy matches
71
73
  for (const match of legacyMatches){
72
- const sessionData = this.parser.readSession(match.session.filePath, match.session.resolvedCwd);
74
+ const sessionData = this.parser.readSessionIncremental(match.session.filePath, match.session.resolvedCwd);
73
75
  if (sessionData) {
74
76
  agents.push(this.mapper.mapSessionToAgent({
75
77
  session: sessionData,
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../../src/harnesses/claude/ClaudeCodeAdapter.ts"],"sourcesContent":["import * as path from \"path\";\nimport type {\n AgentAdapter,\n AgentInfo,\n ProcessInfo,\n ConversationMessage,\n ConversationOptions,\n SessionSummary,\n ListSessionsOptions,\n AgentDetectionContext,\n} from \"../../adapters/AgentAdapter.js\";\nimport { safeStat } from \"../../utils/session.js\";\nimport { ClaudeSessionParser } from \"./ClaudeSessionParser.js\";\nimport { ClaudeAgentMapper } from \"./ClaudeAgentMapper.js\";\nimport { ClaudeSessionLocator } from \"./ClaudeSessionLocator.js\";\nimport { findHarnessProcesses, homeDir, matchesExecutable } from \"../shared.js\";\n\n/**\n * Claude Code Adapter\n *\n * Detects Claude Code agents by:\n * 1. Filtering Claude processes from a shared asynchronous process snapshot\n * 2. Using snapshot CWD and start-time enrichment\n * 3. Attempting authoritative PID-file matching via ~/.claude/sessions/<pid>.json\n * 4. Falling back to CWD+birthtime heuristic (matchProcessesToSessions) for processes without a PID file\n * 5. Extracting summary from last user message in session JSONL (incrementally\n * cached across refreshes, so unchanged transcripts are not re-read)\n */\nexport class ClaudeCodeAdapter implements AgentAdapter {\n readonly type = \"claude\" as const;\n readonly processNames = [\"claude\"] as const;\n\n private parser: ClaudeSessionParser;\n private mapper: ClaudeAgentMapper;\n private projectsDir: string;\n private sessionsDir: string;\n\n constructor() {\n this.projectsDir = path.join(homeDir(), \".claude\", \"projects\");\n this.sessionsDir = path.join(homeDir(), \".claude\", \"sessions\");\n this.parser = new ClaudeSessionParser();\n this.mapper = new ClaudeAgentMapper(this.parser);\n }\n\n canHandle(processInfo: ProcessInfo): boolean {\n return matchesExecutable(processInfo.command, \"claude\");\n }\n\n async detectAgents(context?: AgentDetectionContext): Promise<AgentInfo[]> {\n try {\n return await this.detectRunningAgents(context);\n } finally {\n // Drop cached summaries for sessions that were not part of this refresh\n this.parser.pruneSessionCache();\n }\n }\n\n private async detectRunningAgents(context?: AgentDetectionContext): Promise<AgentInfo[]> {\n const { processes } = await findHarnessProcesses(this, context);\n if (processes.length === 0) {\n return [];\n }\n\n const { direct, legacyMatches } = this.createLocator().matchRunningProcesses(processes);\n\n const matchedPids = new Set([\n ...direct.map((d) => d.process.pid),\n ...legacyMatches.map((m) => m.process.pid),\n ]);\n\n const agents: AgentInfo[] = [];\n\n // Build agents from direct (resume + PID-file) matches\n for (const match of direct) {\n const { process: proc, sessionFile } = match;\n const sessionData = this.parser.readSessionIncremental(\n sessionFile.filePath,\n sessionFile.resolvedCwd,\n );\n if (sessionData) {\n agents.push(\n this.mapper.mapSessionToAgent({\n session: sessionData,\n processInfo: proc,\n sessionFile,\n liveInfo: {\n pidStatus: match.pidStatus,\n waitingFor: match.waitingFor,\n },\n }),\n );\n } else {\n matchedPids.delete(proc.pid);\n }\n }\n\n // Build agents from legacy matches\n for (const match of legacyMatches) {\n const sessionData = this.parser.readSessionIncremental(\n match.session.filePath,\n match.session.resolvedCwd,\n );\n if (sessionData) {\n agents.push(\n this.mapper.mapSessionToAgent({\n session: sessionData,\n processInfo: match.process,\n sessionFile: match.session,\n }),\n );\n } else {\n matchedPids.delete(match.process.pid);\n }\n }\n\n // Any process with no match (direct or legacy) appears as IDLE\n for (const proc of processes) {\n if (!matchedPids.has(proc.pid)) {\n agents.push(this.mapper.mapProcessOnlyAgent(proc));\n }\n }\n\n return agents;\n }\n\n private createLocator(): ClaudeSessionLocator {\n return new ClaudeSessionLocator({\n projectsDir: this.projectsDir,\n sessionsDir: this.sessionsDir,\n });\n }\n\n getConversation(sessionFilePath: string, options?: ConversationOptions): ConversationMessage[] {\n return this.parser.getConversation(sessionFilePath, options);\n }\n\n async listSessions(opts?: ListSessionsOptions): Promise<SessionSummary[]> {\n const filterCwd = opts?.cwd;\n const candidates = this.createLocator().discoverHistoricalSessionFiles();\n const summaries: SessionSummary[] = [];\n\n for (const { filePath, defaultCwd } of candidates) {\n const summary = this.toSessionSummary(filePath, defaultCwd);\n if (!summary) continue;\n if (filterCwd !== undefined && summary.cwd !== filterCwd) continue;\n summaries.push(summary);\n }\n\n return summaries;\n }\n\n async findSessionsById(sessionId: string): Promise<SessionSummary[]> {\n return this.createLocator()\n .findHistoricalSessionFilesById(sessionId)\n .map(({ filePath, defaultCwd }) => this.toSessionSummary(filePath, defaultCwd))\n .filter((summary): summary is SessionSummary => summary?.sessionId === sessionId);\n }\n\n private toSessionSummary(filePath: string, defaultCwd: string): SessionSummary | null {\n const session = this.parser.readSession(filePath, defaultCwd);\n if (!session?.lastEntryType) return null;\n\n const recordedCwd = session.lastCwd || defaultCwd;\n const stat = safeStat(filePath);\n return {\n type: \"claude\",\n sessionId: session.sessionId,\n cwd: recordedCwd,\n firstUserMessage: session.firstUserMessage || \"\",\n lastActive: session.lastActive ?? stat?.mtime ?? new Date(),\n startedAt: session.sessionStart ?? stat?.birthtime ?? stat?.mtime ?? new Date(),\n sessionFilePath: filePath,\n };\n }\n}\n"],"names":["path","safeStat","ClaudeSessionParser","ClaudeAgentMapper","ClaudeSessionLocator","findHarnessProcesses","homeDir","matchesExecutable","ClaudeCodeAdapter","type","processNames","parser","mapper","projectsDir","sessionsDir","join","canHandle","processInfo","command","detectAgents","context","detectRunningAgents","pruneSessionCache","processes","length","direct","legacyMatches","createLocator","matchRunningProcesses","matchedPids","Set","map","d","process","pid","m","agents","match","proc","sessionFile","sessionData","readSessionIncremental","filePath","resolvedCwd","push","mapSessionToAgent","session","liveInfo","pidStatus","waitingFor","delete","has","mapProcessOnlyAgent","getConversation","sessionFilePath","options","listSessions","opts","filterCwd","cwd","candidates","discoverHistoricalSessionFiles","summaries","defaultCwd","summary","toSessionSummary","undefined","findSessionsById","sessionId","findHistoricalSessionFilesById","filter","readSession","lastEntryType","recordedCwd","lastCwd","stat","firstUserMessage","lastActive","mtime","Date","startedAt","sessionStart","birthtime"],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"ClaudeSessionLocator.d.ts","sourceRoot":"","sources":["../../../src/providers/claude/ClaudeSessionLocator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAC7D,OAAO,EAA4B,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACrF,OAAO,EAOL,KAAK,WAAW,EACjB,MAAM,wBAAwB,CAAC;AAyBhC;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,WAAW,CAAC;IACrB,WAAW,EAAE,WAAW,CAAC;IACzB,SAAS,CAAC,EAAE,WAAW,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,2BAA2B;IAC1C,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAC5B,aAAa,EAAE,WAAW,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,2BAA2B;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAKD,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAEzB,OAAO,GAAE,2BAAgC;IAMrD;;;;;;;;;OASG;IACH,qBAAqB,CAAC,SAAS,EAAE,WAAW,EAAE,GAAG,2BAA2B;IAe5E;;;;;;;;;;OAUG;IACH,8BAA8B,IAAI,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAsBjF,8BAA8B,CAC5B,SAAS,EAAE,MAAM,GAChB,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAiBlD;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,aAAa;IAKrB;;;;;;OAMG;IACH,oBAAoB,CAAC,SAAS,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE;IA6B7D;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;IA8CzB,OAAO,CAAC,sBAAsB;IAK9B;;;;;;;;OAQG;IACH,OAAO,CAAC,mBAAmB;IAkB3B;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IAapB;;;;;;;;;OASG;IACH,OAAO,CAAC,kBAAkB;CAsC3B"}
1
+ {"version":3,"file":"ClaudeSessionLocator.d.ts","sourceRoot":"","sources":["../../../src/harnesses/claude/ClaudeSessionLocator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAC7D,OAAO,EAA4B,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACrF,OAAO,EAOL,KAAK,WAAW,EACjB,MAAM,wBAAwB,CAAC;AA0BhC;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,WAAW,CAAC;IACrB,WAAW,EAAE,WAAW,CAAC;IACzB,SAAS,CAAC,EAAE,WAAW,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,2BAA2B;IAC1C,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAC5B,aAAa,EAAE,WAAW,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,2BAA2B;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAKD,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAEzB,OAAO,GAAE,2BAAgC;IAKrD;;;;;;;;;OASG;IACH,qBAAqB,CAAC,SAAS,EAAE,WAAW,EAAE,GAAG,2BAA2B;IAe5E;;;;;;;;;;OAUG;IACH,8BAA8B,IAAI,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAsBjF,8BAA8B,CAC5B,SAAS,EAAE,MAAM,GAChB,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAiBlD;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,aAAa;IAKrB;;;;;;OAMG;IACH,oBAAoB,CAAC,SAAS,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE;IA6B7D;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;IA8CzB,OAAO,CAAC,sBAAsB;IAK9B;;;;;;;;OAQG;IACH,OAAO,CAAC,mBAAmB;IAkB3B;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IAapB;;;;;;;;;OASG;IACH,OAAO,CAAC,kBAAkB;CAsC3B"}
@@ -3,14 +3,14 @@ import * as path from "path";
3
3
  import { AgentStatus } from "../../adapters/AgentAdapter.js";
4
4
  import { matchProcessesToSessions } from "../../utils/matching.js";
5
5
  import { batchGetSessionFileBirthtimes, isDirectory, isSafePathSegment, listJsonl, safeReaddir, safeStat } from "../../utils/session.js";
6
+ import { homeDir } from "../shared.js";
6
7
  /** Maximum allowed delta (ms) between process start time and PID file startedAt. */ const PID_FILE_STALENESS_MS = 60000;
7
8
  export class ClaudeSessionLocator {
8
9
  projectsDir;
9
10
  sessionsDir;
10
11
  constructor(options = {}){
11
- const homeDir = process.env.HOME || process.env.USERPROFILE || "";
12
- this.projectsDir = options.projectsDir ?? path.join(homeDir, ".claude", "projects");
13
- this.sessionsDir = options.sessionsDir ?? path.join(homeDir, ".claude", "sessions");
12
+ this.projectsDir = options.projectsDir ?? path.join(homeDir(), ".claude", "projects");
13
+ this.sessionsDir = options.sessionsDir ?? path.join(homeDir(), ".claude", "sessions");
14
14
  }
15
15
  /**
16
16
  * Pair live Claude processes with their session files.
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../../src/harnesses/claude/ClaudeSessionLocator.ts"],"sourcesContent":["import * as fs from \"fs\";\nimport * as path from \"path\";\nimport type { ProcessInfo } from \"../../adapters/AgentAdapter.js\";\nimport { AgentStatus } from \"../../adapters/AgentAdapter.js\";\nimport { matchProcessesToSessions, type MatchResult } from \"../../utils/matching.js\";\nimport {\n batchGetSessionFileBirthtimes,\n isDirectory,\n isSafePathSegment,\n listJsonl,\n safeReaddir,\n safeStat,\n type SessionFile,\n} from \"../../utils/session.js\";\nimport { homeDir } from \"../shared.js\";\n\n/**\n * Entry in ~/.claude/sessions/<pid>.json written by Claude Code.\n * Maps a running process to its session file via PID.\n */\ninterface PidFileEntry {\n pid: number;\n sessionId: string;\n cwd: string;\n /** Epoch milliseconds when the Claude Code process started */\n startedAt: number;\n kind: string;\n entrypoint: string;\n /**\n * Authoritative live status published by the Claude Code process\n * (e.g., 'running', 'waiting', 'idle'). Preferred over JSONL-derived\n * status because trailing entries like 'permission-mode' / 'ai-title'\n * can mask the real conversational state.\n */\n status?: string;\n /** Short description of what the agent is waiting on (e.g., \"approve Read\"). */\n waitingFor?: string;\n}\n\n/**\n * A process directly matched to a session via PID file (authoritative path).\n *\n * When the matching PID file also exposes live status/waitingFor metadata,\n * those values are carried here so the agent mapper can prefer them over\n * the JSONL-derived heuristic.\n */\nexport interface ClaudeDirectMatch {\n process: ProcessInfo;\n sessionFile: SessionFile;\n pidStatus?: AgentStatus;\n waitingFor?: string;\n}\n\nexport interface ClaudeProcessSessionMatches {\n direct: ClaudeDirectMatch[];\n legacyMatches: MatchResult[];\n}\n\nexport interface ClaudeSessionLocatorOptions {\n projectsDir?: string;\n sessionsDir?: string;\n}\n\n/** Maximum allowed delta (ms) between process start time and PID file startedAt. */\nconst PID_FILE_STALENESS_MS = 60000;\n\nexport class ClaudeSessionLocator {\n private readonly projectsDir: string;\n private readonly sessionsDir: string;\n\n constructor(options: ClaudeSessionLocatorOptions = {}) {\n this.projectsDir = options.projectsDir ?? path.join(homeDir(), \".claude\", \"projects\");\n this.sessionsDir = options.sessionsDir ?? path.join(homeDir(), \".claude\", \"sessions\");\n }\n\n /**\n * Pair live Claude processes with their session files.\n *\n * Runs three staged strategies, each handing its unmatched processes\n * to the next:\n * 1. `--resume <id>` on the command line — authoritative for resumed\n * sessions whose JSONL predates the process.\n * 2. PID-file matching via ~/.claude/sessions/<pid>.json.\n * 3. Legacy CWD+birthtime heuristic, for processes with no PID file.\n */\n matchRunningProcesses(processes: ProcessInfo[]): ClaudeProcessSessionMatches {\n const { direct: resumeDirect, fallback: noResume } = this.tryResumeMatching(processes);\n const { direct: pidDirect, fallback } = this.tryPidFileMatching(noResume);\n const legacySessions = this.discoverLiveSessions(fallback);\n const legacyMatches =\n fallback.length > 0 && legacySessions.length > 0\n ? matchProcessesToSessions(fallback, legacySessions)\n : [];\n\n return {\n direct: [...resumeDirect, ...pidDirect],\n legacyMatches,\n };\n }\n\n /**\n * Discover candidate session files for listing historical sessions.\n *\n * Always walks every subdirectory of `projectsDir`. We can't use the\n * encoded-dir shortcut for the cwd-scoped path because Claude Code\n * indexes session files by where the *process was launched*, not by\n * the recorded `cwd` field inside the session — these diverge in\n * worktrees and similar setups. The cwd filter is applied later\n * against `session.lastCwd` so callers see exactly the sessions whose\n * recorded cwd matches.\n */\n discoverHistoricalSessionFiles(): Array<{ filePath: string; defaultCwd: string }> {\n const out: Array<{ filePath: string; defaultCwd: string }> = [];\n\n if (!isDirectory(this.projectsDir)) return out;\n\n for (const dirName of safeReaddir(this.projectsDir)) {\n const projectDir = path.join(this.projectsDir, dirName);\n if (!isDirectory(projectDir)) continue;\n\n // Best-effort decode for the rare case session content has no\n // recorded cwd: '-Users-foo-bar' → '/Users/foo/bar'. Lossy for\n // paths containing '-'; session content's lastCwd overrides\n // this when available.\n const decoded = dirName.replace(/-/g, \"/\");\n for (const name of listJsonl(projectDir)) {\n out.push({ filePath: path.join(projectDir, name), defaultCwd: decoded });\n }\n }\n\n return out;\n }\n\n findHistoricalSessionFilesById(\n sessionId: string,\n ): Array<{ filePath: string; defaultCwd: string }> {\n if (!isSafePathSegment(sessionId) || !isDirectory(this.projectsDir)) {\n return [];\n }\n\n const matches: Array<{ filePath: string; defaultCwd: string }> = [];\n for (const dirName of safeReaddir(this.projectsDir)) {\n const projectDir = path.join(this.projectsDir, dirName);\n if (!isDirectory(projectDir)) continue;\n\n const filePath = path.join(projectDir, `${sessionId}.jsonl`);\n if (!safeStat(filePath)?.isFile()) continue;\n matches.push({ filePath, defaultCwd: dirName.replace(/-/g, \"/\") });\n }\n return matches;\n }\n\n /**\n * Derive the Claude Code project directory for a given CWD.\n *\n * Claude Code encodes paths by replacing every non-alphanumeric\n * character with '-', so '/', '_', '.', spaces, etc. all collapse:\n * /Users/foo/bar → -Users-foo-bar\n * /Users/foo/my_project → -Users-foo-my-project\n * /Users/foo/.worktrees/x → -Users-foo--worktrees-x\n *\n * The encoding is lossy — multiple real paths can collide on the\n * same encoded dir. Callers that need to disambiguate must read the\n * `cwd` field inside each session JSONL.\n */\n private getProjectDir(cwd: string): string {\n const encoded = cwd.replace(/[^a-zA-Z0-9]/g, \"-\");\n return path.join(this.projectsDir, encoded);\n }\n\n /**\n * Discover session files for the given processes.\n *\n * For each unique process CWD, encodes it to derive the expected\n * ~/.claude/projects/<encoded>/ directory, then gets session file birthtimes\n * via a single batched stat call across all directories.\n */\n discoverLiveSessions(processes: ProcessInfo[]): SessionFile[] {\n const dirToCwd = new Map<string, string>();\n\n for (const proc of processes) {\n if (!proc.cwd) continue;\n\n const projectDir = this.getProjectDir(proc.cwd);\n if (dirToCwd.has(projectDir)) continue;\n\n try {\n if (!fs.statSync(projectDir).isDirectory()) continue;\n } catch {\n continue;\n }\n\n dirToCwd.set(projectDir, proc.cwd);\n }\n\n if (dirToCwd.size === 0) return [];\n\n const files = batchGetSessionFileBirthtimes([...dirToCwd.keys()]);\n\n for (const file of files) {\n file.resolvedCwd = dirToCwd.get(file.projectDir) || \"\";\n }\n\n return files;\n }\n\n /**\n * Match processes via `claude --resume <uuid>` in their command line.\n * This works for resumed sessions, where the JSONL was created earlier\n * (so its birthtime is far from the process startTime and the legacy\n * matcher can't pair them) and the PID file may also be misaligned.\n */\n private tryResumeMatching(processes: ProcessInfo[]): {\n direct: ClaudeDirectMatch[];\n fallback: ProcessInfo[];\n } {\n const direct: ClaudeDirectMatch[] = [];\n const fallback: ProcessInfo[] = [];\n\n for (const proc of processes) {\n const sessionId = this.extractResumeSessionId(proc.command);\n if (!sessionId || !proc.cwd) {\n fallback.push(proc);\n continue;\n }\n\n const projectDir = this.getProjectDir(proc.cwd);\n const jsonlPath = path.join(projectDir, `${sessionId}.jsonl`);\n\n const stat = safeStat(jsonlPath);\n if (!stat) {\n fallback.push(proc);\n continue;\n }\n\n // Best-effort: the PID file (if present for this proc) is the\n // authoritative source of live status. We still match the session\n // via --resume, but we read the PID file alongside to capture\n // status/waitingFor.\n const pidEntry = this.readMatchingPidFile(proc.pid, proc.startTime);\n\n direct.push({\n process: proc,\n sessionFile: {\n sessionId,\n filePath: jsonlPath,\n projectDir,\n birthtimeMs: stat.birthtimeMs,\n resolvedCwd: proc.cwd,\n },\n pidStatus: this.mapPidStatus(pidEntry?.status),\n waitingFor: pidEntry?.waitingFor,\n });\n }\n\n return { direct, fallback };\n }\n\n private extractResumeSessionId(command: string): string | null {\n const match = command.match(/--resume\\s+([0-9a-f-]{36})/i);\n return match?.[1] ?? null;\n }\n\n /**\n * Read and parse ~/.claude/sessions/<pid>.json, returning null on any\n * I/O / parse failure or when the file is stale relative to the live\n * process.\n *\n * \"Stale\" means the PID file's startedAt diverges from the process's\n * start time by more than {@link PID_FILE_STALENESS_MS} — typically\n * a previous Claude Code process recycled the same PID without cleanup.\n */\n private readMatchingPidFile(pid: number, procStartTime?: Date): PidFileEntry | null {\n const pidFilePath = path.join(this.sessionsDir, `${pid}.json`);\n try {\n const entry = JSON.parse(fs.readFileSync(pidFilePath, \"utf-8\")) as PidFileEntry;\n\n if (procStartTime) {\n const deltaMs = Math.abs(procStartTime.getTime() - entry.startedAt);\n if (deltaMs > PID_FILE_STALENESS_MS) {\n return null;\n }\n }\n\n return entry;\n } catch {\n return null;\n }\n }\n\n /**\n * Map the PID file's live status string to {@link AgentStatus}.\n *\n * Returns undefined for missing / unrecognized values so the caller\n * can fall back to JSONL-derived heuristics.\n */\n private mapPidStatus(status: string | undefined): AgentStatus | undefined {\n switch (status) {\n case \"running\":\n return AgentStatus.RUNNING;\n case \"waiting\":\n return AgentStatus.WAITING;\n case \"idle\":\n return AgentStatus.IDLE;\n default:\n return undefined;\n }\n }\n\n /**\n * Attempt to match each process to its session via ~/.claude/sessions/<pid>.json.\n *\n * Returns:\n * direct — processes matched authoritatively via PID file\n * fallback — processes with no valid PID file (sent to legacy matching)\n *\n * Per-process fallback triggers on: file absent, malformed JSON,\n * stale startedAt (>60s from proc.startTime), or missing JSONL.\n */\n private tryPidFileMatching(processes: ProcessInfo[]): {\n direct: ClaudeDirectMatch[];\n fallback: ProcessInfo[];\n } {\n const direct: ClaudeDirectMatch[] = [];\n const fallback: ProcessInfo[] = [];\n\n for (const proc of processes) {\n const entry = this.readMatchingPidFile(proc.pid, proc.startTime);\n if (!entry) {\n fallback.push(proc);\n continue;\n }\n\n const projectDir = this.getProjectDir(entry.cwd);\n const jsonlPath = path.join(projectDir, `${entry.sessionId}.jsonl`);\n\n if (!fs.existsSync(jsonlPath)) {\n fallback.push(proc);\n continue;\n }\n\n direct.push({\n process: proc,\n sessionFile: {\n sessionId: entry.sessionId,\n filePath: jsonlPath,\n projectDir,\n birthtimeMs: entry.startedAt,\n resolvedCwd: entry.cwd,\n },\n pidStatus: this.mapPidStatus(entry.status),\n waitingFor: entry.waitingFor,\n });\n }\n\n return { direct, fallback };\n }\n}\n"],"names":["fs","path","AgentStatus","matchProcessesToSessions","batchGetSessionFileBirthtimes","isDirectory","isSafePathSegment","listJsonl","safeReaddir","safeStat","homeDir","PID_FILE_STALENESS_MS","ClaudeSessionLocator","projectsDir","sessionsDir","options","join","matchRunningProcesses","processes","direct","resumeDirect","fallback","noResume","tryResumeMatching","pidDirect","tryPidFileMatching","legacySessions","discoverLiveSessions","legacyMatches","length","discoverHistoricalSessionFiles","out","dirName","projectDir","decoded","replace","name","push","filePath","defaultCwd","findHistoricalSessionFilesById","sessionId","matches","isFile","getProjectDir","cwd","encoded","dirToCwd","Map","proc","has","statSync","set","size","files","keys","file","resolvedCwd","get","extractResumeSessionId","command","jsonlPath","stat","pidEntry","readMatchingPidFile","pid","startTime","process","sessionFile","birthtimeMs","pidStatus","mapPidStatus","status","waitingFor","match","procStartTime","pidFilePath","entry","JSON","parse","readFileSync","deltaMs","Math","abs","getTime","startedAt","RUNNING","WAITING","IDLE","undefined","existsSync"],"mappings":"AAAA,YAAYA,QAAQ,KAAK;AACzB,YAAYC,UAAU,OAAO;AAE7B,SAASC,WAAW,QAAQ,iCAAiC;AAC7D,SAASC,wBAAwB,QAA0B,0BAA0B;AACrF,SACEC,6BAA6B,EAC7BC,WAAW,EACXC,iBAAiB,EACjBC,SAAS,EACTC,WAAW,EACXC,QAAQ,QAEH,yBAAyB;AAChC,SAASC,OAAO,QAAQ,eAAe;AAiDvC,kFAAkF,GAClF,MAAMC,wBAAwB;AAE9B,OAAO,MAAMC;IACMC,YAAoB;IACpBC,YAAoB;IAErC,YAAYC,UAAuC,CAAC,CAAC,CAAE;QACrD,IAAI,CAACF,WAAW,GAAGE,QAAQF,WAAW,IAAIZ,KAAKe,IAAI,CAACN,WAAW,WAAW;QAC1E,IAAI,CAACI,WAAW,GAAGC,QAAQD,WAAW,IAAIb,KAAKe,IAAI,CAACN,WAAW,WAAW;IAC5E;IAEA;;;;;;;;;GASC,GACDO,sBAAsBC,SAAwB,EAA+B;QAC3E,MAAM,EAAEC,QAAQC,YAAY,EAAEC,UAAUC,QAAQ,EAAE,GAAG,IAAI,CAACC,iBAAiB,CAACL;QAC5E,MAAM,EAAEC,QAAQK,SAAS,EAAEH,QAAQ,EAAE,GAAG,IAAI,CAACI,kBAAkB,CAACH;QAChE,MAAMI,iBAAiB,IAAI,CAACC,oBAAoB,CAACN;QACjD,MAAMO,gBACJP,SAASQ,MAAM,GAAG,KAAKH,eAAeG,MAAM,GAAG,IAC3C1B,yBAAyBkB,UAAUK,kBACnC,EAAE;QAER,OAAO;YACLP,QAAQ;mBAAIC;mBAAiBI;aAAU;YACvCI;QACF;IACF;IAEA;;;;;;;;;;GAUC,GACDE,iCAAkF;QAChF,MAAMC,MAAuD,EAAE;QAE/D,IAAI,CAAC1B,YAAY,IAAI,CAACQ,WAAW,GAAG,OAAOkB;QAE3C,KAAK,MAAMC,WAAWxB,YAAY,IAAI,CAACK,WAAW,EAAG;YACnD,MAAMoB,aAAahC,KAAKe,IAAI,CAAC,IAAI,CAACH,WAAW,EAAEmB;YAC/C,IAAI,CAAC3B,YAAY4B,aAAa;YAE9B,8DAA8D;YAC9D,+DAA+D;YAC/D,4DAA4D;YAC5D,uBAAuB;YACvB,MAAMC,UAAUF,QAAQG,OAAO,CAAC,MAAM;YACtC,KAAK,MAAMC,QAAQ7B,UAAU0B,YAAa;gBACxCF,IAAIM,IAAI,CAAC;oBAAEC,UAAUrC,KAAKe,IAAI,CAACiB,YAAYG;oBAAOG,YAAYL;gBAAQ;YACxE;QACF;QAEA,OAAOH;IACT;IAEAS,+BACEC,SAAiB,EACgC;QACjD,IAAI,CAACnC,kBAAkBmC,cAAc,CAACpC,YAAY,IAAI,CAACQ,WAAW,GAAG;YACnE,OAAO,EAAE;QACX;QAEA,MAAM6B,UAA2D,EAAE;QACnE,KAAK,MAAMV,WAAWxB,YAAY,IAAI,CAACK,WAAW,EAAG;YACnD,MAAMoB,aAAahC,KAAKe,IAAI,CAAC,IAAI,CAACH,WAAW,EAAEmB;YAC/C,IAAI,CAAC3B,YAAY4B,aAAa;YAE9B,MAAMK,WAAWrC,KAAKe,IAAI,CAACiB,YAAY,GAAGQ,UAAU,MAAM,CAAC;YAC3D,IAAI,CAAChC,SAAS6B,WAAWK,UAAU;YACnCD,QAAQL,IAAI,CAAC;gBAAEC;gBAAUC,YAAYP,QAAQG,OAAO,CAAC,MAAM;YAAK;QAClE;QACA,OAAOO;IACT;IAEA;;;;;;;;;;;;GAYC,GACD,AAAQE,cAAcC,GAAW,EAAU;QACzC,MAAMC,UAAUD,IAAIV,OAAO,CAAC,iBAAiB;QAC7C,OAAOlC,KAAKe,IAAI,CAAC,IAAI,CAACH,WAAW,EAAEiC;IACrC;IAEA;;;;;;GAMC,GACDnB,qBAAqBT,SAAwB,EAAiB;QAC5D,MAAM6B,WAAW,IAAIC;QAErB,KAAK,MAAMC,QAAQ/B,UAAW;YAC5B,IAAI,CAAC+B,KAAKJ,GAAG,EAAE;YAEf,MAAMZ,aAAa,IAAI,CAACW,aAAa,CAACK,KAAKJ,GAAG;YAC9C,IAAIE,SAASG,GAAG,CAACjB,aAAa;YAE9B,IAAI;gBACF,IAAI,CAACjC,GAAGmD,QAAQ,CAAClB,YAAY5B,WAAW,IAAI;YAC9C,EAAE,OAAM;gBACN;YACF;YAEA0C,SAASK,GAAG,CAACnB,YAAYgB,KAAKJ,GAAG;QACnC;QAEA,IAAIE,SAASM,IAAI,KAAK,GAAG,OAAO,EAAE;QAElC,MAAMC,QAAQlD,8BAA8B;eAAI2C,SAASQ,IAAI;SAAG;QAEhE,KAAK,MAAMC,QAAQF,MAAO;YACxBE,KAAKC,WAAW,GAAGV,SAASW,GAAG,CAACF,KAAKvB,UAAU,KAAK;QACtD;QAEA,OAAOqB;IACT;IAEA;;;;;GAKC,GACD,AAAQ/B,kBAAkBL,SAAwB,EAGhD;QACA,MAAMC,SAA8B,EAAE;QACtC,MAAME,WAA0B,EAAE;QAElC,KAAK,MAAM4B,QAAQ/B,UAAW;YAC5B,MAAMuB,YAAY,IAAI,CAACkB,sBAAsB,CAACV,KAAKW,OAAO;YAC1D,IAAI,CAACnB,aAAa,CAACQ,KAAKJ,GAAG,EAAE;gBAC3BxB,SAASgB,IAAI,CAACY;gBACd;YACF;YAEA,MAAMhB,aAAa,IAAI,CAACW,aAAa,CAACK,KAAKJ,GAAG;YAC9C,MAAMgB,YAAY5D,KAAKe,IAAI,CAACiB,YAAY,GAAGQ,UAAU,MAAM,CAAC;YAE5D,MAAMqB,OAAOrD,SAASoD;YACtB,IAAI,CAACC,MAAM;gBACTzC,SAASgB,IAAI,CAACY;gBACd;YACF;YAEA,8DAA8D;YAC9D,kEAAkE;YAClE,8DAA8D;YAC9D,qBAAqB;YACrB,MAAMc,WAAW,IAAI,CAACC,mBAAmB,CAACf,KAAKgB,GAAG,EAAEhB,KAAKiB,SAAS;YAElE/C,OAAOkB,IAAI,CAAC;gBACV8B,SAASlB;gBACTmB,aAAa;oBACX3B;oBACAH,UAAUuB;oBACV5B;oBACAoC,aAAaP,KAAKO,WAAW;oBAC7BZ,aAAaR,KAAKJ,GAAG;gBACvB;gBACAyB,WAAW,IAAI,CAACC,YAAY,CAACR,UAAUS;gBACvCC,YAAYV,UAAUU;YACxB;QACF;QAEA,OAAO;YAAEtD;YAAQE;QAAS;IAC5B;IAEQsC,uBAAuBC,OAAe,EAAiB;QAC7D,MAAMc,QAAQd,QAAQc,KAAK,CAAC;QAC5B,OAAOA,OAAO,CAAC,EAAE,IAAI;IACvB;IAEA;;;;;;;;GAQC,GACD,AAAQV,oBAAoBC,GAAW,EAAEU,aAAoB,EAAuB;QAClF,MAAMC,cAAc3E,KAAKe,IAAI,CAAC,IAAI,CAACF,WAAW,EAAE,GAAGmD,IAAI,KAAK,CAAC;QAC7D,IAAI;YACF,MAAMY,QAAQC,KAAKC,KAAK,CAAC/E,GAAGgF,YAAY,CAACJ,aAAa;YAEtD,IAAID,eAAe;gBACjB,MAAMM,UAAUC,KAAKC,GAAG,CAACR,cAAcS,OAAO,KAAKP,MAAMQ,SAAS;gBAClE,IAAIJ,UAAUtE,uBAAuB;oBACnC,OAAO;gBACT;YACF;YAEA,OAAOkE;QACT,EAAE,OAAM;YACN,OAAO;QACT;IACF;IAEA;;;;;GAKC,GACD,AAAQN,aAAaC,MAA0B,EAA2B;QACxE,OAAQA;YACN,KAAK;gBACH,OAAOtE,YAAYoF,OAAO;YAC5B,KAAK;gBACH,OAAOpF,YAAYqF,OAAO;YAC5B,KAAK;gBACH,OAAOrF,YAAYsF,IAAI;YACzB;gBACE,OAAOC;QACX;IACF;IAEA;;;;;;;;;GASC,GACD,AAAQhE,mBAAmBP,SAAwB,EAGjD;QACA,MAAMC,SAA8B,EAAE;QACtC,MAAME,WAA0B,EAAE;QAElC,KAAK,MAAM4B,QAAQ/B,UAAW;YAC5B,MAAM2D,QAAQ,IAAI,CAACb,mBAAmB,CAACf,KAAKgB,GAAG,EAAEhB,KAAKiB,SAAS;YAC/D,IAAI,CAACW,OAAO;gBACVxD,SAASgB,IAAI,CAACY;gBACd;YACF;YAEA,MAAMhB,aAAa,IAAI,CAACW,aAAa,CAACiC,MAAMhC,GAAG;YAC/C,MAAMgB,YAAY5D,KAAKe,IAAI,CAACiB,YAAY,GAAG4C,MAAMpC,SAAS,CAAC,MAAM,CAAC;YAElE,IAAI,CAACzC,GAAG0F,UAAU,CAAC7B,YAAY;gBAC7BxC,SAASgB,IAAI,CAACY;gBACd;YACF;YAEA9B,OAAOkB,IAAI,CAAC;gBACV8B,SAASlB;gBACTmB,aAAa;oBACX3B,WAAWoC,MAAMpC,SAAS;oBAC1BH,UAAUuB;oBACV5B;oBACAoC,aAAaQ,MAAMQ,SAAS;oBAC5B5B,aAAaoB,MAAMhC,GAAG;gBACxB;gBACAyB,WAAW,IAAI,CAACC,YAAY,CAACM,MAAML,MAAM;gBACzCC,YAAYI,MAAMJ,UAAU;YAC9B;QACF;QAEA,OAAO;YAAEtD;YAAQE;QAAS;IAC5B;AACF"}
@@ -1,5 +1,6 @@
1
- import type { ConversationMessage } from "../../adapters/AgentAdapter.js";
1
+ import type { ConversationMessage, ConversationOptions } from "../../adapters/AgentAdapter.js";
2
2
  import { AgentStatus } from "../../adapters/AgentAdapter.js";
3
+ import { type JsonlSummaryBounds } from "../../utils/IncrementalJsonlSummary.js";
3
4
  /**
4
5
  * Content block within a Claude Code JSONL message entry.
5
6
  * Handles text, tool_use, and tool_result block types.
@@ -45,6 +46,10 @@ export interface ClaudeSession {
45
46
  /** First meaningful user prompt in the session (post noise filter) */
46
47
  firstUserMessage?: string;
47
48
  }
49
+ export interface ClaudeSessionParserOptions {
50
+ /** Cold-start scan bounds for `readSessionIncremental` (see IncrementalJsonlSummary). */
51
+ summaryBounds?: JsonlSummaryBounds | false;
52
+ }
48
53
  /**
49
54
  * Parses Claude Code session JSONL files into structured data.
50
55
  *
@@ -53,6 +58,10 @@ export interface ClaudeSession {
53
58
  * event (user turn, assistant response, tool call, etc.).
54
59
  */
55
60
  export declare class ClaudeSessionParser {
61
+ /** Incremental reader backing `getConversation({ tail })`. */
62
+ private readonly tailReader;
63
+ private readonly sessionCache;
64
+ constructor(options?: ClaudeSessionParserOptions);
56
65
  /**
57
66
  * Parse a session JSONL file into a ClaudeSession summary.
58
67
  *
@@ -63,6 +72,30 @@ export declare class ClaudeSessionParser {
63
72
  * Returns null if the file is unreadable or empty.
64
73
  */
65
74
  readSession(filePath: string, projectPath: string): ClaudeSession | null;
75
+ /**
76
+ * Same result as `readSession`, but backed by a per-instance incremental
77
+ * cache so repeated refreshes only parse bytes appended since the last call.
78
+ * Call `pruneSessionCache()` once per refresh to evict files no longer read.
79
+ *
80
+ * The first read of a large transcript is a bounded head + tail scan (see
81
+ * `summaryReducer.skip`); fields whose entries lie only in the skipped
82
+ * middle fall back to their defaults instead of forcing a full parse.
83
+ */
84
+ readSessionIncremental(filePath: string, projectPath: string): ClaudeSession | null;
85
+ /** Evict cached summaries for files not read since the previous prune. */
86
+ pruneSessionCache(): void;
87
+ /**
88
+ * Fold one JSONL entry into the O(1) session summary. Mirrors the fields
89
+ * `readSession` exposes: session start comes from the first line only;
90
+ * everything else tracks the latest matching entry.
91
+ *
92
+ * `skip` (bounded cold start) keeps the head's session start and first user
93
+ * message and clears every "latest" field, so those come from the tail only:
94
+ * a first user message beyond the head stays undefined, and a last user
95
+ * message before the tail window stays undefined.
96
+ */
97
+ private readonly summaryReducer;
98
+ private toSession;
66
99
  /**
67
100
  * Determine agent status from parsed session state.
68
101
  *
@@ -78,13 +111,14 @@ export declare class ClaudeSessionParser {
78
111
  * Read the full conversation from a session JSONL file.
79
112
  *
80
113
  * Default mode returns only text content from user/assistant/system messages.
81
- * Verbose mode also includes tool_use and tool_result blocks.
114
+ * Verbose mode also includes tool_use and tool_result blocks. With `tail`,
115
+ * only the last N messages are read (from the end of the file).
82
116
  */
83
- getConversation(sessionFilePath: string, options?: {
84
- verbose?: boolean;
85
- }): ConversationMessage[];
117
+ getConversation(sessionFilePath: string, options?: ConversationOptions): ConversationMessage[];
118
+ /** Convert one JSONL line into a conversation message, or null when it is not one. */
119
+ private lineToMessage;
86
120
  /**
87
- * Parse session start time from the first JSONL line.
121
+ * Parse session start time (epoch ms) from the first JSONL entry.
88
122
  *
89
123
  * Claude Code may emit a "file-history-snapshot" as the first entry,
90
124
  * which stores its timestamp inside "snapshot.timestamp" rather than
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ClaudeSessionParser.d.ts","sourceRoot":"","sources":["../../../src/harnesses/claude/ClaudeSessionParser.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAC/F,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAC7D,OAAO,EAGL,KAAK,kBAAkB,EAExB,MAAM,wCAAwC,CAAC;AAGhD;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE;QACR,OAAO,CAAC,EAAE,MAAM,GAAG,YAAY,EAAE,CAAC;KACnC,CAAC;CACH;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,IAAI,CAAC;IACnB,UAAU,EAAE,IAAI,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,OAAO,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,sEAAsE;IACtE,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AA+BD,MAAM,WAAW,0BAA0B;IACzC,yFAAyF;IACzF,aAAa,CAAC,EAAE,kBAAkB,GAAG,KAAK,CAAC;CAC5C;AAED;;;;;;GAMG;AACH,qBAAa,mBAAmB;IAC9B,8DAA8D;IAC9D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAyB;IAEpD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA8C;gBAE/D,OAAO,GAAE,0BAA+B;IAMpD;;;;;;;;OAQG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAWxE;;;;;;;;OAQG;IACH,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAKnF,0EAA0E;IAC1E,iBAAiB,IAAI,IAAI;IAIzB;;;;;;;;;OASG;IACH,OAAO,CAAC,QAAQ,CAAC,cAAc,CAyD7B;IAEF,OAAO,CAAC,SAAS;IAmBjB;;;;;;;;;OASG;IACH,eAAe,CAAC,OAAO,EAAE,aAAa,GAAG,WAAW;IAwBpD;;;;;;OAMG;IACH,eAAe,CAAC,eAAe,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,mBAAmB,EAAE;IA8B9F,sFAAsF;IACtF,OAAO,CAAC,aAAa;IA6BrB;;;;;;OAMG;IACH,OAAO,CAAC,iBAAiB;IAezB;;;;;;;;;OASG;IACH,OAAO,CAAC,sBAAsB;IAwC9B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAW3B;;OAEG;IACH,OAAO,CAAC,0BAA0B;CAoCnC"}