@ai-devkit/agent-manager 0.35.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 (651) 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/claude.test.js +485 -0
  14. package/dist/__tests__/capacity/claude.test.js.map +1 -0
  15. package/dist/__tests__/capacity/openai.test.js +670 -0
  16. package/dist/__tests__/capacity/openai.test.js.map +1 -0
  17. package/dist/__tests__/capacity/wham.test.js +144 -0
  18. package/dist/__tests__/capacity/wham.test.js.map +1 -0
  19. package/dist/__tests__/harnesses/BoundedSummarySkip.test.js +568 -0
  20. package/dist/__tests__/harnesses/BoundedSummarySkip.test.js.map +1 -0
  21. package/dist/__tests__/harnesses/SessionSummaryEquivalence.test.js +1089 -0
  22. package/dist/__tests__/harnesses/SessionSummaryEquivalence.test.js.map +1 -0
  23. package/dist/__tests__/harnesses/antigravity/AntigravityCliAdapter.subprocess.test.js +143 -0
  24. package/dist/__tests__/harnesses/antigravity/AntigravityCliAdapter.subprocess.test.js.map +1 -0
  25. package/dist/__tests__/harnesses/antigravity/AntigravityCliAdapter.test.js +462 -0
  26. package/dist/__tests__/harnesses/antigravity/AntigravityCliAdapter.test.js.map +1 -0
  27. package/dist/__tests__/harnesses/builtinAdapters.test.js +33 -0
  28. package/dist/__tests__/harnesses/builtinAdapters.test.js.map +1 -0
  29. package/dist/__tests__/{providers → harnesses}/claude/ClaudeAgentMapper.test.js +4 -4
  30. package/dist/__tests__/harnesses/claude/ClaudeAgentMapper.test.js.map +1 -0
  31. package/dist/__tests__/{adapters → harnesses/claude}/ClaudeCodeAdapter.test.js +47 -19
  32. package/dist/__tests__/harnesses/claude/ClaudeCodeAdapter.test.js.map +1 -0
  33. package/dist/__tests__/{providers → harnesses}/claude/ClaudeSessionLocator.test.js +1 -12
  34. package/dist/__tests__/{providers → harnesses}/claude/ClaudeSessionLocator.test.js.map +1 -1
  35. package/dist/__tests__/{utils → harnesses/claude}/ClaudeSessionParser.test.js +2 -2
  36. package/dist/__tests__/harnesses/claude/ClaudeSessionParser.test.js.map +1 -0
  37. package/dist/__tests__/{print → harnesses/claude/durable}/ClaudeCliProbe.test.js +1 -1
  38. package/dist/__tests__/harnesses/claude/durable/ClaudeCliProbe.test.js.map +1 -0
  39. package/dist/__tests__/{print → harnesses/claude/durable}/ClaudePrintAgent.integration.test.js +1 -1
  40. package/dist/__tests__/harnesses/claude/durable/ClaudePrintAgent.integration.test.js.map +1 -0
  41. package/dist/__tests__/{print → harnesses/claude/durable}/ClaudePrintAgentService.test.js +4 -4
  42. package/dist/__tests__/harnesses/claude/durable/ClaudePrintAgentService.test.js.map +1 -0
  43. package/dist/__tests__/{print → harnesses/claude/durable}/ClaudePrintRunner.test.js +1 -1
  44. package/dist/__tests__/harnesses/claude/durable/ClaudePrintRunner.test.js.map +1 -0
  45. package/dist/__tests__/{adapters → harnesses/codex}/CodexAdapter.test.js +304 -10
  46. package/dist/__tests__/harnesses/codex/CodexAdapter.test.js.map +1 -0
  47. package/dist/__tests__/harnesses/codex/CodexSessionLocator.test.js +463 -0
  48. package/dist/__tests__/harnesses/codex/CodexSessionLocator.test.js.map +1 -0
  49. package/dist/__tests__/{providers → harnesses}/codex/CodexSessionMapping.test.js +1 -1
  50. package/dist/__tests__/{providers → harnesses}/codex/CodexSessionMapping.test.js.map +1 -1
  51. package/dist/__tests__/{providers → harnesses}/codex/CodexSessionParser.test.js +1 -1
  52. package/dist/__tests__/{providers → harnesses}/codex/CodexSessionParser.test.js.map +1 -1
  53. package/dist/__tests__/{durable → harnesses/codex/durable}/CodexCliProbe.test.js +4 -4
  54. package/dist/__tests__/harnesses/codex/durable/CodexCliProbe.test.js.map +1 -0
  55. package/dist/__tests__/{durable → harnesses/codex/durable}/CodexDurableAgentRepository.test.js +1 -1
  56. package/dist/__tests__/harnesses/codex/durable/CodexDurableAgentRepository.test.js.map +1 -0
  57. package/dist/__tests__/{durable → harnesses/codex/durable}/CodexPrintAgent.integration.test.js +1 -1
  58. package/dist/__tests__/harnesses/codex/durable/CodexPrintAgent.integration.test.js.map +1 -0
  59. package/dist/__tests__/{durable → harnesses/codex/durable}/CodexPrintAgentService.test.js +8 -18
  60. package/dist/__tests__/harnesses/codex/durable/CodexPrintAgentService.test.js.map +1 -0
  61. package/dist/__tests__/{durable → harnesses/codex/durable}/CodexPrintRunner.test.js +2 -7
  62. package/dist/__tests__/harnesses/codex/durable/CodexPrintRunner.test.js.map +1 -0
  63. package/dist/__tests__/{providers → harnesses}/copilot/CopilotAdapter.test.js +1 -1
  64. package/dist/__tests__/{providers → harnesses}/copilot/CopilotAdapter.test.js.map +1 -1
  65. package/dist/__tests__/harnesses/copilot/CopilotRefreshIO.test.js +290 -0
  66. package/dist/__tests__/harnesses/copilot/CopilotRefreshIO.test.js.map +1 -0
  67. package/dist/__tests__/{providers → harnesses}/gemini/GeminiCliAdapter.test.js +34 -25
  68. package/dist/__tests__/harnesses/gemini/GeminiCliAdapter.test.js.map +1 -0
  69. package/dist/__tests__/harnesses/gemini/GeminiSessionJsonl.test.js +491 -0
  70. package/dist/__tests__/harnesses/gemini/GeminiSessionJsonl.test.js.map +1 -0
  71. package/dist/__tests__/harnesses/gemini/GeminiSessionLocator.test.js +399 -0
  72. package/dist/__tests__/harnesses/gemini/GeminiSessionLocator.test.js.map +1 -0
  73. package/dist/__tests__/{providers → harnesses}/grok/GrokAgentMapper.test.js +1 -1
  74. package/dist/__tests__/{providers → harnesses}/grok/GrokAgentMapper.test.js.map +1 -1
  75. package/dist/__tests__/{providers → harnesses}/grok/GrokCliAdapter.test.js +1 -1
  76. package/dist/__tests__/{providers → harnesses}/grok/GrokCliAdapter.test.js.map +1 -1
  77. package/dist/__tests__/harnesses/grok/GrokIncrementalRefresh.test.js +167 -0
  78. package/dist/__tests__/harnesses/grok/GrokIncrementalRefresh.test.js.map +1 -0
  79. package/dist/__tests__/{providers → harnesses}/grok/GrokSessionLocator.test.js +1 -1
  80. package/dist/__tests__/{providers → harnesses}/grok/GrokSessionLocator.test.js.map +1 -1
  81. package/dist/__tests__/harnesses/grok/GrokSessionParser.test.js +301 -0
  82. package/dist/__tests__/harnesses/grok/GrokSessionParser.test.js.map +1 -0
  83. package/dist/__tests__/harnesses/kiro/KiroAdapter.test.js +662 -0
  84. package/dist/__tests__/harnesses/kiro/KiroAdapter.test.js.map +1 -0
  85. package/dist/__tests__/{providers → harnesses}/opencode/OpenCodeAdapter.test.js +1 -1
  86. package/dist/__tests__/{providers → harnesses}/opencode/OpenCodeAdapter.test.js.map +1 -1
  87. package/dist/__tests__/{providers → harnesses}/opencode/OpenCodeAgentMapper.test.js +1 -1
  88. package/dist/__tests__/{providers → harnesses}/opencode/OpenCodeAgentMapper.test.js.map +1 -1
  89. package/dist/__tests__/{providers → harnesses}/opencode/OpenCodeSessionLocator.test.js +2 -2
  90. package/dist/__tests__/{providers → harnesses}/opencode/OpenCodeSessionLocator.test.js.map +1 -1
  91. package/dist/__tests__/{providers → harnesses}/opencode/OpenCodeSessionParser.test.js +1 -1
  92. package/dist/__tests__/{providers → harnesses}/opencode/OpenCodeSessionParser.test.js.map +1 -1
  93. package/dist/__tests__/{providers → harnesses}/pi/PiAdapter.test.js +1 -1
  94. package/dist/__tests__/{providers → harnesses}/pi/PiAdapter.test.js.map +1 -1
  95. package/dist/__tests__/harnesses/pi/PiDiscoveryIO.test.js +382 -0
  96. package/dist/__tests__/harnesses/pi/PiDiscoveryIO.test.js.map +1 -0
  97. package/dist/__tests__/{providers → harnesses}/pi/PiSessionParser.test.js +171 -1
  98. package/dist/__tests__/harnesses/pi/PiSessionParser.test.js.map +1 -0
  99. package/dist/__tests__/{providers → harnesses}/pi/PiSessionTracker.test.js +1 -1
  100. package/dist/__tests__/{providers → harnesses}/pi/PiSessionTracker.test.js.map +1 -1
  101. package/dist/__tests__/{providers → harnesses}/pi/durable/PiCliProbe.test.js.map +1 -1
  102. package/dist/__tests__/{providers → harnesses}/pi/durable/PiDurableAgentRepository.test.js.map +1 -1
  103. package/dist/__tests__/{providers → harnesses}/pi/durable/PiPrintAgentService.test.js.map +1 -1
  104. package/dist/__tests__/{providers → harnesses}/pi/durable/PiPrintProtocol.test.js +1 -1
  105. package/dist/__tests__/{providers → harnesses}/pi/durable/PiPrintProtocol.test.js.map +1 -1
  106. package/dist/__tests__/{providers → harnesses}/pi/durable/PiPrintRunner.test.js.map +1 -1
  107. package/dist/__tests__/{providers → harnesses}/pi/durable/PiStreamParser.test.js +1 -1
  108. package/dist/__tests__/{providers → harnesses}/pi/durable/PiStreamParser.test.js.map +1 -1
  109. package/dist/__tests__/readiness/AgentReadiness.test.js +20 -0
  110. package/dist/__tests__/readiness/AgentReadiness.test.js.map +1 -1
  111. package/dist/__tests__/runtime/ManagedAgentRuntime.test.js +49 -0
  112. package/dist/__tests__/runtime/ManagedAgentRuntime.test.js.map +1 -1
  113. package/dist/__tests__/utils/IncrementalJsonlSummary.test.js +650 -0
  114. package/dist/__tests__/utils/IncrementalJsonlSummary.test.js.map +1 -0
  115. package/dist/__tests__/utils/agents.test.js +72 -2
  116. package/dist/__tests__/utils/agents.test.js.map +1 -1
  117. package/dist/__tests__/utils/conversationTail.bench.test.js +258 -0
  118. package/dist/__tests__/utils/conversationTail.bench.test.js.map +1 -0
  119. package/dist/__tests__/utils/conversationTailParity.test.js +588 -0
  120. package/dist/__tests__/utils/conversationTailParity.test.js.map +1 -0
  121. package/dist/__tests__/utils/jsonlTail.test.js +360 -0
  122. package/dist/__tests__/utils/jsonlTail.test.js.map +1 -0
  123. package/dist/__tests__/utils/matchingConstants.test.js +35 -0
  124. package/dist/__tests__/utils/matchingConstants.test.js.map +1 -0
  125. package/dist/__tests__/utils/process.test.js +436 -2
  126. package/dist/__tests__/utils/process.test.js.map +1 -1
  127. package/dist/adapters/AgentAdapter.d.ts +25 -6
  128. package/dist/adapters/AgentAdapter.d.ts.map +1 -1
  129. package/dist/adapters/AgentAdapter.js +12 -3
  130. package/dist/adapters/AgentAdapter.js.map +1 -1
  131. package/dist/capacity/claude.d.ts +17 -0
  132. package/dist/capacity/claude.d.ts.map +1 -0
  133. package/dist/capacity/claude.js +271 -0
  134. package/dist/capacity/claude.js.map +1 -0
  135. package/dist/capacity/codex.d.ts +1 -2
  136. package/dist/capacity/codex.d.ts.map +1 -1
  137. package/dist/capacity/codex.js +5 -47
  138. package/dist/capacity/codex.js.map +1 -1
  139. package/dist/capacity/index.d.ts +11 -0
  140. package/dist/capacity/index.d.ts.map +1 -1
  141. package/dist/capacity/index.js +17 -0
  142. package/dist/capacity/index.js.map +1 -1
  143. package/dist/capacity/openai.d.ts +47 -0
  144. package/dist/capacity/openai.d.ts.map +1 -0
  145. package/dist/capacity/openai.js +307 -0
  146. package/dist/capacity/openai.js.map +1 -0
  147. package/dist/capacity/wham.d.ts +16 -0
  148. package/dist/capacity/wham.d.ts.map +1 -0
  149. package/dist/capacity/wham.js +66 -0
  150. package/dist/capacity/wham.js.map +1 -0
  151. package/dist/harnesses/antigravity/AntigravityAgentMapper.d.ts +13 -0
  152. package/dist/harnesses/antigravity/AntigravityAgentMapper.d.ts.map +1 -0
  153. package/dist/harnesses/antigravity/AntigravityAgentMapper.js +30 -0
  154. package/dist/harnesses/antigravity/AntigravityAgentMapper.js.map +1 -0
  155. package/dist/harnesses/antigravity/AntigravityCliAdapter.d.ts +32 -0
  156. package/dist/harnesses/antigravity/AntigravityCliAdapter.d.ts.map +1 -0
  157. package/dist/harnesses/antigravity/AntigravityCliAdapter.js +97 -0
  158. package/dist/harnesses/antigravity/AntigravityCliAdapter.js.map +1 -0
  159. package/dist/harnesses/antigravity/AntigravitySessionLocator.d.ts +30 -0
  160. package/dist/harnesses/antigravity/AntigravitySessionLocator.d.ts.map +1 -0
  161. package/dist/harnesses/antigravity/AntigravitySessionLocator.js +56 -0
  162. package/dist/harnesses/antigravity/AntigravitySessionLocator.js.map +1 -0
  163. package/dist/harnesses/antigravity/AntigravitySessionParser.d.ts +75 -0
  164. package/dist/harnesses/antigravity/AntigravitySessionParser.d.ts.map +1 -0
  165. package/dist/harnesses/antigravity/AntigravitySessionParser.js +174 -0
  166. package/dist/harnesses/antigravity/AntigravitySessionParser.js.map +1 -0
  167. package/dist/{providers → harnesses}/claude/ClaudeAgentMapper.d.ts.map +1 -1
  168. package/dist/{providers → harnesses}/claude/ClaudeAgentMapper.js +4 -10
  169. package/dist/harnesses/claude/ClaudeAgentMapper.js.map +1 -0
  170. package/dist/{providers → harnesses}/claude/ClaudeCodeAdapter.d.ts +5 -6
  171. package/dist/harnesses/claude/ClaudeCodeAdapter.d.ts.map +1 -0
  172. package/dist/{providers → harnesses}/claude/ClaudeCodeAdapter.js +17 -15
  173. package/dist/harnesses/claude/ClaudeCodeAdapter.js.map +1 -0
  174. package/dist/{providers → harnesses}/claude/ClaudeSessionLocator.d.ts.map +1 -1
  175. package/dist/{providers → harnesses}/claude/ClaudeSessionLocator.js +3 -3
  176. package/dist/harnesses/claude/ClaudeSessionLocator.js.map +1 -0
  177. package/dist/{providers → harnesses}/claude/ClaudeSessionParser.d.ts +40 -6
  178. package/dist/harnesses/claude/ClaudeSessionParser.d.ts.map +1 -0
  179. package/dist/{providers → harnesses}/claude/ClaudeSessionParser.js +141 -85
  180. package/dist/harnesses/claude/ClaudeSessionParser.js.map +1 -0
  181. package/dist/{providers → harnesses}/claude/durable/ClaudeCliProbe.d.ts.map +1 -1
  182. package/dist/{providers → harnesses}/claude/durable/ClaudeCliProbe.js.map +1 -1
  183. package/dist/{providers → harnesses}/claude/durable/ClaudePrintAgentService.d.ts.map +1 -1
  184. package/dist/{providers → harnesses}/claude/durable/ClaudePrintAgentService.js.map +1 -1
  185. package/dist/{providers → harnesses}/claude/durable/ClaudePrintRunner.d.ts.map +1 -1
  186. package/dist/{providers → harnesses}/claude/durable/ClaudePrintRunner.js.map +1 -1
  187. package/dist/{providers → harnesses}/claude/durable/ClaudeStreamParser.d.ts.map +1 -1
  188. package/dist/{providers → harnesses}/claude/durable/ClaudeStreamParser.js.map +1 -1
  189. package/dist/{providers → harnesses}/codex/CodexAdapter.d.ts +5 -4
  190. package/dist/harnesses/codex/CodexAdapter.d.ts.map +1 -0
  191. package/dist/{providers → harnesses}/codex/CodexAdapter.js +139 -19
  192. package/dist/harnesses/codex/CodexAdapter.js.map +1 -0
  193. package/dist/{providers → harnesses}/codex/CodexAgentMapper.d.ts.map +1 -1
  194. package/dist/{providers → harnesses}/codex/CodexAgentMapper.js +4 -11
  195. package/dist/harnesses/codex/CodexAgentMapper.js.map +1 -0
  196. package/dist/harnesses/codex/CodexSessionLocator.d.ts +74 -0
  197. package/dist/harnesses/codex/CodexSessionLocator.d.ts.map +1 -0
  198. package/dist/harnesses/codex/CodexSessionLocator.js +359 -0
  199. package/dist/harnesses/codex/CodexSessionLocator.js.map +1 -0
  200. package/dist/{providers → harnesses}/codex/CodexSessionMapping.d.ts.map +1 -1
  201. package/dist/{providers → harnesses}/codex/CodexSessionMapping.js +3 -3
  202. package/dist/harnesses/codex/CodexSessionMapping.js.map +1 -0
  203. package/dist/harnesses/codex/CodexSessionParser.d.ts +89 -0
  204. package/dist/harnesses/codex/CodexSessionParser.d.ts.map +1 -0
  205. package/dist/{providers → harnesses}/codex/CodexSessionParser.js +124 -78
  206. package/dist/harnesses/codex/CodexSessionParser.js.map +1 -0
  207. package/dist/{providers → harnesses}/codex/durable/CodexCliProbe.d.ts.map +1 -1
  208. package/dist/{providers → harnesses}/codex/durable/CodexCliProbe.js.map +1 -1
  209. package/dist/{providers → harnesses}/codex/durable/CodexPrintAgentService.d.ts.map +1 -1
  210. package/dist/{providers → harnesses}/codex/durable/CodexPrintAgentService.js.map +1 -1
  211. package/dist/{providers → harnesses}/codex/durable/CodexPrintRunner.d.ts.map +1 -1
  212. package/dist/{providers → harnesses}/codex/durable/CodexPrintRunner.js.map +1 -1
  213. package/dist/{providers → harnesses}/codex/durable/CodexStreamParser.d.ts.map +1 -1
  214. package/dist/{providers → harnesses}/codex/durable/CodexStreamParser.js.map +1 -1
  215. package/dist/{providers → harnesses}/copilot/CopilotAdapter.d.ts +7 -6
  216. package/dist/harnesses/copilot/CopilotAdapter.d.ts.map +1 -0
  217. package/dist/{providers → harnesses}/copilot/CopilotAdapter.js +19 -14
  218. package/dist/harnesses/copilot/CopilotAdapter.js.map +1 -0
  219. package/dist/{providers → harnesses}/copilot/CopilotAgentMapper.d.ts.map +1 -1
  220. package/dist/{providers → harnesses}/copilot/CopilotAgentMapper.js +4 -11
  221. package/dist/harnesses/copilot/CopilotAgentMapper.js.map +1 -0
  222. package/dist/harnesses/copilot/CopilotSessionLocator.d.ts +42 -0
  223. package/dist/harnesses/copilot/CopilotSessionLocator.d.ts.map +1 -0
  224. package/dist/harnesses/copilot/CopilotSessionLocator.js +126 -0
  225. package/dist/harnesses/copilot/CopilotSessionLocator.js.map +1 -0
  226. package/dist/harnesses/copilot/CopilotSessionParser.d.ts +62 -0
  227. package/dist/harnesses/copilot/CopilotSessionParser.d.ts.map +1 -0
  228. package/dist/harnesses/copilot/CopilotSessionParser.js +236 -0
  229. package/dist/harnesses/copilot/CopilotSessionParser.js.map +1 -0
  230. package/dist/{providers → harnesses}/gemini/GeminiAgentMapper.d.ts.map +1 -1
  231. package/dist/{providers → harnesses}/gemini/GeminiAgentMapper.js +4 -11
  232. package/dist/harnesses/gemini/GeminiAgentMapper.js.map +1 -0
  233. package/dist/{providers → harnesses}/gemini/GeminiCliAdapter.d.ts +4 -5
  234. package/dist/harnesses/gemini/GeminiCliAdapter.d.ts.map +1 -0
  235. package/dist/{providers → harnesses}/gemini/GeminiCliAdapter.js +6 -7
  236. package/dist/harnesses/gemini/GeminiCliAdapter.js.map +1 -0
  237. package/dist/harnesses/gemini/GeminiSessionLocator.d.ts +72 -0
  238. package/dist/harnesses/gemini/GeminiSessionLocator.d.ts.map +1 -0
  239. package/dist/harnesses/gemini/GeminiSessionLocator.js +300 -0
  240. package/dist/harnesses/gemini/GeminiSessionLocator.js.map +1 -0
  241. package/dist/{providers → harnesses}/gemini/GeminiSessionParser.d.ts +34 -7
  242. package/dist/harnesses/gemini/GeminiSessionParser.d.ts.map +1 -0
  243. package/dist/harnesses/gemini/GeminiSessionParser.js +272 -0
  244. package/dist/harnesses/gemini/GeminiSessionParser.js.map +1 -0
  245. package/dist/harnesses/gemini/fileSignature.d.ts +8 -0
  246. package/dist/harnesses/gemini/fileSignature.d.ts.map +1 -0
  247. package/dist/harnesses/gemini/fileSignature.js +9 -0
  248. package/dist/harnesses/gemini/fileSignature.js.map +1 -0
  249. package/dist/{providers → harnesses}/grok/GrokAgentMapper.d.ts.map +1 -1
  250. package/dist/{providers → harnesses}/grok/GrokAgentMapper.js +4 -10
  251. package/dist/harnesses/grok/GrokAgentMapper.js.map +1 -0
  252. package/dist/{providers → harnesses}/grok/GrokCliAdapter.d.ts +5 -5
  253. package/dist/harnesses/grok/GrokCliAdapter.d.ts.map +1 -0
  254. package/dist/{providers → harnesses}/grok/GrokCliAdapter.js +14 -10
  255. package/dist/harnesses/grok/GrokCliAdapter.js.map +1 -0
  256. package/dist/{providers → harnesses}/grok/GrokSessionLocator.d.ts.map +1 -1
  257. package/dist/{providers → harnesses}/grok/GrokSessionLocator.js +2 -2
  258. package/dist/harnesses/grok/GrokSessionLocator.js.map +1 -0
  259. package/dist/harnesses/grok/GrokSessionParser.d.ts +87 -0
  260. package/dist/harnesses/grok/GrokSessionParser.d.ts.map +1 -0
  261. package/dist/harnesses/grok/GrokSessionParser.js +185 -0
  262. package/dist/harnesses/grok/GrokSessionParser.js.map +1 -0
  263. package/dist/harnesses/index.d.ts +7 -0
  264. package/dist/harnesses/index.d.ts.map +1 -0
  265. package/dist/harnesses/index.js +27 -0
  266. package/dist/harnesses/index.js.map +1 -0
  267. package/dist/harnesses/kiro/KiroAdapter.d.ts +31 -0
  268. package/dist/harnesses/kiro/KiroAdapter.d.ts.map +1 -0
  269. package/dist/harnesses/kiro/KiroAdapter.js +125 -0
  270. package/dist/harnesses/kiro/KiroAdapter.js.map +1 -0
  271. package/dist/harnesses/kiro/KiroAgentMapper.d.ts +13 -0
  272. package/dist/harnesses/kiro/KiroAgentMapper.d.ts.map +1 -0
  273. package/dist/harnesses/kiro/KiroAgentMapper.js +29 -0
  274. package/dist/harnesses/kiro/KiroAgentMapper.js.map +1 -0
  275. package/dist/harnesses/kiro/KiroSessionLocator.d.ts +38 -0
  276. package/dist/harnesses/kiro/KiroSessionLocator.d.ts.map +1 -0
  277. package/dist/harnesses/kiro/KiroSessionLocator.js +95 -0
  278. package/dist/harnesses/kiro/KiroSessionLocator.js.map +1 -0
  279. package/dist/harnesses/kiro/KiroSessionParser.d.ts +81 -0
  280. package/dist/harnesses/kiro/KiroSessionParser.d.ts.map +1 -0
  281. package/dist/harnesses/kiro/KiroSessionParser.js +251 -0
  282. package/dist/harnesses/kiro/KiroSessionParser.js.map +1 -0
  283. package/dist/{providers → harnesses}/opencode/OpenCodeAdapter.d.ts +2 -4
  284. package/dist/harnesses/opencode/OpenCodeAdapter.d.ts.map +1 -0
  285. package/dist/{providers → harnesses}/opencode/OpenCodeAdapter.js +4 -7
  286. package/dist/harnesses/opencode/OpenCodeAdapter.js.map +1 -0
  287. package/dist/{providers → harnesses}/opencode/OpenCodeAgentMapper.d.ts.map +1 -1
  288. package/dist/{providers → harnesses}/opencode/OpenCodeAgentMapper.js +5 -13
  289. package/dist/harnesses/opencode/OpenCodeAgentMapper.js.map +1 -0
  290. package/dist/{providers → harnesses}/opencode/OpenCodeSessionLocator.d.ts.map +1 -1
  291. package/dist/{providers → harnesses}/opencode/OpenCodeSessionLocator.js +2 -2
  292. package/dist/harnesses/opencode/OpenCodeSessionLocator.js.map +1 -0
  293. package/dist/{providers → harnesses}/opencode/OpenCodeSessionParser.d.ts +2 -4
  294. package/dist/harnesses/opencode/OpenCodeSessionParser.d.ts.map +1 -0
  295. package/dist/{providers → harnesses}/opencode/OpenCodeSessionParser.js +2 -1
  296. package/dist/harnesses/opencode/OpenCodeSessionParser.js.map +1 -0
  297. package/dist/{providers → harnesses}/pi/PiAdapter.d.ts +5 -4
  298. package/dist/harnesses/pi/PiAdapter.d.ts.map +1 -0
  299. package/dist/{providers → harnesses}/pi/PiAdapter.js +16 -12
  300. package/dist/harnesses/pi/PiAdapter.js.map +1 -0
  301. package/dist/{providers → harnesses}/pi/PiAgentMapper.d.ts.map +1 -1
  302. package/dist/{providers → harnesses}/pi/PiAgentMapper.js +4 -11
  303. package/dist/harnesses/pi/PiAgentMapper.js.map +1 -0
  304. package/dist/harnesses/pi/PiSessionLocator.d.ts +61 -0
  305. package/dist/harnesses/pi/PiSessionLocator.d.ts.map +1 -0
  306. package/dist/harnesses/pi/PiSessionLocator.js +212 -0
  307. package/dist/harnesses/pi/PiSessionLocator.js.map +1 -0
  308. package/dist/harnesses/pi/PiSessionParser.d.ts +88 -0
  309. package/dist/harnesses/pi/PiSessionParser.d.ts.map +1 -0
  310. package/dist/harnesses/pi/PiSessionParser.js +318 -0
  311. package/dist/harnesses/pi/PiSessionParser.js.map +1 -0
  312. package/dist/{providers → harnesses}/pi/PiSessionTracker.d.ts.map +1 -1
  313. package/dist/{providers → harnesses}/pi/PiSessionTracker.js +2 -2
  314. package/dist/harnesses/pi/PiSessionTracker.js.map +1 -0
  315. package/dist/{providers → harnesses}/pi/durable/PiCliProbe.d.ts.map +1 -1
  316. package/dist/{providers → harnesses}/pi/durable/PiCliProbe.js.map +1 -1
  317. package/dist/{providers → harnesses}/pi/durable/PiPrintAgentService.d.ts.map +1 -1
  318. package/dist/{providers → harnesses}/pi/durable/PiPrintAgentService.js.map +1 -1
  319. package/dist/{providers → harnesses}/pi/durable/PiPrintProtocol.d.ts.map +1 -1
  320. package/dist/{providers → harnesses}/pi/durable/PiPrintProtocol.js.map +1 -1
  321. package/dist/{providers → harnesses}/pi/durable/PiPrintRunner.d.ts.map +1 -1
  322. package/dist/{providers → harnesses}/pi/durable/PiPrintRunner.js.map +1 -1
  323. package/dist/{providers → harnesses}/pi/durable/PiStreamParser.d.ts.map +1 -1
  324. package/dist/{providers → harnesses}/pi/durable/PiStreamParser.js.map +1 -1
  325. package/dist/harnesses/shared.d.ts +41 -0
  326. package/dist/harnesses/shared.d.ts.map +1 -0
  327. package/dist/harnesses/shared.js +71 -0
  328. package/dist/harnesses/shared.js.map +1 -0
  329. package/dist/index.d.ts +28 -25
  330. package/dist/index.d.ts.map +1 -1
  331. package/dist/index.js +19 -16
  332. package/dist/index.js.map +1 -1
  333. package/dist/readiness/AgentReadiness.d.ts +1 -1
  334. package/dist/readiness/AgentReadiness.d.ts.map +1 -1
  335. package/dist/readiness/AgentReadiness.js.map +1 -1
  336. package/dist/runtime/ManagedAgentRuntime.js +3 -1
  337. package/dist/runtime/ManagedAgentRuntime.js.map +1 -1
  338. package/dist/runtime/herdr/HerdrAgentDiscovery.js +10 -0
  339. package/dist/runtime/herdr/HerdrAgentDiscovery.js.map +1 -1
  340. package/dist/utils/IncrementalJsonlSummary.d.ts +100 -0
  341. package/dist/utils/IncrementalJsonlSummary.d.ts.map +1 -0
  342. package/dist/utils/IncrementalJsonlSummary.js +209 -0
  343. package/dist/utils/IncrementalJsonlSummary.js.map +1 -0
  344. package/dist/utils/agents.d.ts +3 -2
  345. package/dist/utils/agents.d.ts.map +1 -1
  346. package/dist/utils/agents.js +61 -15
  347. package/dist/utils/agents.js.map +1 -1
  348. package/dist/utils/index.d.ts +2 -1
  349. package/dist/utils/index.d.ts.map +1 -1
  350. package/dist/utils/index.js +1 -1
  351. package/dist/utils/index.js.map +1 -1
  352. package/dist/utils/jsonlTail.d.ts +73 -0
  353. package/dist/utils/jsonlTail.d.ts.map +1 -0
  354. package/dist/utils/jsonlTail.js +238 -0
  355. package/dist/utils/jsonlTail.js.map +1 -0
  356. package/dist/utils/matching.d.ts +2 -0
  357. package/dist/utils/matching.d.ts.map +1 -1
  358. package/dist/utils/matching.js +3 -2
  359. package/dist/utils/matching.js.map +1 -1
  360. package/dist/utils/matchingConstants.d.ts +15 -0
  361. package/dist/utils/matchingConstants.d.ts.map +1 -0
  362. package/dist/utils/matchingConstants.js +14 -0
  363. package/dist/utils/matchingConstants.js.map +1 -0
  364. package/dist/utils/process.d.ts +38 -2
  365. package/dist/utils/process.d.ts.map +1 -1
  366. package/dist/utils/process.js +131 -43
  367. package/dist/utils/process.js.map +1 -1
  368. package/package.json +2 -1
  369. package/scripts/benchmark-cold-start.mjs +350 -0
  370. package/src/AgentManager.ts +26 -5
  371. package/src/__tests__/AgentManager.test.ts +141 -3
  372. package/src/__tests__/adapters/IncrementalSessionRefresh.test.ts +437 -0
  373. package/src/__tests__/adapters/adapterProcessImports.test.ts +58 -0
  374. package/src/__tests__/adapters/adapterSnapshotCandidates.test.ts +243 -0
  375. package/src/__tests__/capacity/claude.test.ts +467 -0
  376. package/src/__tests__/capacity/fixtures/claude-credentials.json +7 -0
  377. package/src/__tests__/capacity/fixtures/claude-usage-malformed.json +1 -0
  378. package/src/__tests__/capacity/fixtures/claude-usage-partial.json +15 -0
  379. package/src/__tests__/capacity/fixtures/claude-usage.json +63 -0
  380. package/src/__tests__/capacity/fixtures/openai-auth.json +6 -0
  381. package/src/__tests__/capacity/fixtures/openai-codex-auth.json +9 -0
  382. package/src/__tests__/capacity/fixtures/openai-usage-completions.json +67 -0
  383. package/src/__tests__/capacity/fixtures/openai-usage-responses.json +20 -0
  384. package/src/__tests__/capacity/fixtures/wham-usage.json +32 -0
  385. package/src/__tests__/capacity/openai.test.ts +560 -0
  386. package/src/__tests__/capacity/wham.test.ts +104 -0
  387. package/src/__tests__/harnesses/BoundedSummarySkip.test.ts +496 -0
  388. package/src/__tests__/harnesses/SessionSummaryEquivalence.test.ts +726 -0
  389. package/src/__tests__/harnesses/antigravity/AntigravityCliAdapter.subprocess.test.ts +133 -0
  390. package/src/__tests__/harnesses/antigravity/AntigravityCliAdapter.test.ts +396 -0
  391. package/src/__tests__/harnesses/builtinAdapters.test.ts +33 -0
  392. package/src/__tests__/{providers → harnesses}/claude/ClaudeAgentMapper.test.ts +5 -5
  393. package/src/__tests__/{adapters → harnesses/claude}/ClaudeCodeAdapter.test.ts +54 -24
  394. package/src/__tests__/{providers → harnesses}/claude/ClaudeSessionLocator.test.ts +1 -12
  395. package/src/__tests__/{utils → harnesses/claude}/ClaudeSessionParser.test.ts +2 -2
  396. package/src/__tests__/{print → harnesses/claude/durable}/ClaudeCliProbe.test.ts +1 -1
  397. package/src/__tests__/{print → harnesses/claude/durable}/ClaudePrintAgent.integration.test.ts +1 -1
  398. package/src/__tests__/{print → harnesses/claude/durable}/ClaudePrintAgentService.test.ts +4 -4
  399. package/src/__tests__/{print → harnesses/claude/durable}/ClaudePrintRunner.test.ts +2 -2
  400. package/src/__tests__/{adapters → harnesses/codex}/CodexAdapter.test.ts +277 -12
  401. package/src/__tests__/harnesses/codex/CodexSessionLocator.test.ts +419 -0
  402. package/src/__tests__/{providers → harnesses}/codex/CodexSessionMapping.test.ts +1 -1
  403. package/src/__tests__/{providers → harnesses}/codex/CodexSessionParser.test.ts +1 -1
  404. package/src/__tests__/{durable → harnesses/codex/durable}/CodexCliProbe.test.ts +4 -4
  405. package/src/__tests__/{durable → harnesses/codex/durable}/CodexDurableAgentRepository.test.ts +1 -1
  406. package/src/__tests__/{durable → harnesses/codex/durable}/CodexPrintAgent.integration.test.ts +1 -1
  407. package/src/__tests__/{durable → harnesses/codex/durable}/CodexPrintAgentService.test.ts +8 -18
  408. package/src/__tests__/{durable → harnesses/codex/durable}/CodexPrintRunner.test.ts +3 -9
  409. package/src/__tests__/{providers → harnesses}/copilot/CopilotAdapter.test.ts +1 -1
  410. package/src/__tests__/harnesses/copilot/CopilotRefreshIO.test.ts +270 -0
  411. package/src/__tests__/{providers → harnesses}/gemini/GeminiCliAdapter.test.ts +27 -23
  412. package/src/__tests__/harnesses/gemini/GeminiSessionJsonl.test.ts +402 -0
  413. package/src/__tests__/harnesses/gemini/GeminiSessionLocator.test.ts +396 -0
  414. package/src/__tests__/{providers → harnesses}/grok/GrokAgentMapper.test.ts +2 -2
  415. package/src/__tests__/{providers → harnesses}/grok/GrokCliAdapter.test.ts +1 -1
  416. package/src/__tests__/harnesses/grok/GrokIncrementalRefresh.test.ts +170 -0
  417. package/src/__tests__/{providers → harnesses}/grok/GrokSessionLocator.test.ts +1 -1
  418. package/src/__tests__/harnesses/grok/GrokSessionParser.test.ts +230 -0
  419. package/src/__tests__/harnesses/kiro/KiroAdapter.test.ts +552 -0
  420. package/src/__tests__/{providers → harnesses}/opencode/OpenCodeAdapter.test.ts +1 -1
  421. package/src/__tests__/{providers → harnesses}/opencode/OpenCodeAgentMapper.test.ts +1 -1
  422. package/src/__tests__/{providers → harnesses}/opencode/OpenCodeSessionLocator.test.ts +2 -2
  423. package/src/__tests__/{providers → harnesses}/opencode/OpenCodeSessionParser.test.ts +1 -1
  424. package/src/__tests__/{providers → harnesses}/pi/PiAdapter.test.ts +1 -1
  425. package/src/__tests__/harnesses/pi/PiDiscoveryIO.test.ts +337 -0
  426. package/src/__tests__/{providers → harnesses}/pi/PiSessionParser.test.ts +91 -1
  427. package/src/__tests__/{providers → harnesses}/pi/PiSessionTracker.test.ts +1 -1
  428. package/src/__tests__/{providers → harnesses}/pi/durable/PiPrintProtocol.test.ts +1 -1
  429. package/src/__tests__/{providers → harnesses}/pi/durable/PiStreamParser.test.ts +1 -1
  430. package/src/__tests__/readiness/AgentReadiness.test.ts +16 -0
  431. package/src/__tests__/runtime/ManagedAgentRuntime.test.ts +30 -0
  432. package/src/__tests__/utils/IncrementalJsonlSummary.test.ts +414 -0
  433. package/src/__tests__/utils/agents.test.ts +83 -2
  434. package/src/__tests__/utils/conversationTail.bench.test.ts +193 -0
  435. package/src/__tests__/utils/conversationTailParity.test.ts +365 -0
  436. package/src/__tests__/utils/jsonlTail.test.ts +317 -0
  437. package/src/__tests__/utils/matchingConstants.test.ts +40 -0
  438. package/src/__tests__/utils/process.test.ts +254 -0
  439. package/src/adapters/AgentAdapter.ts +37 -12
  440. package/src/capacity/claude.ts +313 -0
  441. package/src/capacity/codex.ts +25 -134
  442. package/src/capacity/index.ts +33 -4
  443. package/src/capacity/openai.ts +355 -0
  444. package/src/capacity/wham.ts +84 -0
  445. package/src/harnesses/antigravity/AntigravityAgentMapper.ts +34 -0
  446. package/src/harnesses/antigravity/AntigravityCliAdapter.ts +126 -0
  447. package/src/harnesses/antigravity/AntigravitySessionLocator.ts +75 -0
  448. package/src/harnesses/antigravity/AntigravitySessionParser.ts +252 -0
  449. package/src/{providers → harnesses}/claude/ClaudeAgentMapper.ts +2 -10
  450. package/src/{providers → harnesses}/claude/ClaudeCodeAdapter.ts +22 -20
  451. package/src/{providers → harnesses}/claude/ClaudeSessionLocator.ts +3 -3
  452. package/src/{providers → harnesses}/claude/ClaudeSessionParser.ts +189 -97
  453. package/src/{providers → harnesses}/codex/CodexAdapter.ts +153 -29
  454. package/src/{providers → harnesses}/codex/CodexAgentMapper.ts +2 -11
  455. package/src/harnesses/codex/CodexSessionLocator.ts +509 -0
  456. package/src/{providers → harnesses}/codex/CodexSessionMapping.ts +3 -3
  457. package/src/{providers → harnesses}/codex/CodexSessionParser.ts +169 -92
  458. package/src/{providers → harnesses}/copilot/CopilotAdapter.ts +22 -22
  459. package/src/{providers → harnesses}/copilot/CopilotAgentMapper.ts +2 -11
  460. package/src/harnesses/copilot/CopilotSessionLocator.ts +161 -0
  461. package/src/harnesses/copilot/CopilotSessionParser.ts +380 -0
  462. package/src/{providers → harnesses}/gemini/GeminiAgentMapper.ts +2 -11
  463. package/src/{providers → harnesses}/gemini/GeminiCliAdapter.ts +7 -9
  464. package/src/harnesses/gemini/GeminiSessionLocator.ts +394 -0
  465. package/src/{providers → harnesses}/gemini/GeminiSessionParser.ts +155 -31
  466. package/src/harnesses/gemini/fileSignature.ts +10 -0
  467. package/src/{providers → harnesses}/grok/GrokAgentMapper.ts +2 -11
  468. package/src/{providers → harnesses}/grok/GrokCliAdapter.ts +16 -15
  469. package/src/{providers → harnesses}/grok/GrokSessionLocator.ts +2 -2
  470. package/src/harnesses/grok/GrokSessionParser.ts +251 -0
  471. package/src/harnesses/index.ts +28 -0
  472. package/src/harnesses/kiro/KiroAdapter.ts +143 -0
  473. package/src/harnesses/kiro/KiroAgentMapper.ts +34 -0
  474. package/src/harnesses/kiro/KiroSessionLocator.ts +143 -0
  475. package/src/harnesses/kiro/KiroSessionParser.ts +376 -0
  476. package/src/{providers → harnesses}/opencode/OpenCodeAdapter.ts +5 -11
  477. package/src/{providers → harnesses}/opencode/OpenCodeAgentMapper.ts +3 -13
  478. package/src/{providers → harnesses}/opencode/OpenCodeSessionLocator.ts +2 -2
  479. package/src/{providers → harnesses}/opencode/OpenCodeSessionParser.ts +4 -3
  480. package/src/{providers → harnesses}/pi/PiAdapter.ts +20 -18
  481. package/src/{providers → harnesses}/pi/PiAgentMapper.ts +2 -11
  482. package/src/harnesses/pi/PiSessionLocator.ts +288 -0
  483. package/src/harnesses/pi/PiSessionParser.ts +488 -0
  484. package/src/{providers → harnesses}/pi/PiSessionTracker.ts +2 -2
  485. package/src/harnesses/shared.ts +119 -0
  486. package/src/index.ts +34 -23
  487. package/src/readiness/AgentReadiness.ts +4 -1
  488. package/src/runtime/ManagedAgentRuntime.ts +2 -0
  489. package/src/runtime/herdr/HerdrAgentDiscovery.ts +5 -1
  490. package/src/utils/IncrementalJsonlSummary.ts +306 -0
  491. package/src/utils/agents.ts +62 -20
  492. package/src/utils/index.ts +2 -0
  493. package/src/utils/jsonlTail.ts +349 -0
  494. package/src/utils/matching.ts +3 -3
  495. package/src/utils/matchingConstants.ts +15 -0
  496. package/src/utils/process.ts +189 -45
  497. package/dist/__tests__/adapters/ClaudeCodeAdapter.test.js.map +0 -1
  498. package/dist/__tests__/adapters/CodexAdapter.test.js.map +0 -1
  499. package/dist/__tests__/durable/CodexCliProbe.test.js.map +0 -1
  500. package/dist/__tests__/durable/CodexDurableAgentRepository.test.js.map +0 -1
  501. package/dist/__tests__/durable/CodexPrintAgent.integration.test.js.map +0 -1
  502. package/dist/__tests__/durable/CodexPrintAgentService.test.js.map +0 -1
  503. package/dist/__tests__/durable/CodexPrintRunner.test.js.map +0 -1
  504. package/dist/__tests__/print/ClaudeCliProbe.test.js.map +0 -1
  505. package/dist/__tests__/print/ClaudePrintAgent.integration.test.js.map +0 -1
  506. package/dist/__tests__/print/ClaudePrintAgentService.test.js.map +0 -1
  507. package/dist/__tests__/print/ClaudePrintRunner.test.js.map +0 -1
  508. package/dist/__tests__/providers/claude/ClaudeAgentMapper.test.js.map +0 -1
  509. package/dist/__tests__/providers/codex/CodexSessionLocator.test.js +0 -194
  510. package/dist/__tests__/providers/codex/CodexSessionLocator.test.js.map +0 -1
  511. package/dist/__tests__/providers/gemini/GeminiCliAdapter.test.js.map +0 -1
  512. package/dist/__tests__/providers/pi/PiSessionParser.test.js.map +0 -1
  513. package/dist/__tests__/utils/ClaudeSessionParser.test.js.map +0 -1
  514. package/dist/adapters/index.d.ts +0 -10
  515. package/dist/adapters/index.d.ts.map +0 -1
  516. package/dist/adapters/index.js +0 -10
  517. package/dist/adapters/index.js.map +0 -1
  518. package/dist/providers/claude/ClaudeAgentMapper.js.map +0 -1
  519. package/dist/providers/claude/ClaudeCodeAdapter.d.ts.map +0 -1
  520. package/dist/providers/claude/ClaudeCodeAdapter.js.map +0 -1
  521. package/dist/providers/claude/ClaudeSessionLocator.js.map +0 -1
  522. package/dist/providers/claude/ClaudeSessionParser.d.ts.map +0 -1
  523. package/dist/providers/claude/ClaudeSessionParser.js.map +0 -1
  524. package/dist/providers/codex/CodexAdapter.d.ts.map +0 -1
  525. package/dist/providers/codex/CodexAdapter.js.map +0 -1
  526. package/dist/providers/codex/CodexAgentMapper.js.map +0 -1
  527. package/dist/providers/codex/CodexSessionLocator.d.ts +0 -44
  528. package/dist/providers/codex/CodexSessionLocator.d.ts.map +0 -1
  529. package/dist/providers/codex/CodexSessionLocator.js +0 -207
  530. package/dist/providers/codex/CodexSessionLocator.js.map +0 -1
  531. package/dist/providers/codex/CodexSessionMapping.js.map +0 -1
  532. package/dist/providers/codex/CodexSessionParser.d.ts +0 -58
  533. package/dist/providers/codex/CodexSessionParser.d.ts.map +0 -1
  534. package/dist/providers/codex/CodexSessionParser.js.map +0 -1
  535. package/dist/providers/copilot/CopilotAdapter.d.ts.map +0 -1
  536. package/dist/providers/copilot/CopilotAdapter.js.map +0 -1
  537. package/dist/providers/copilot/CopilotAgentMapper.js.map +0 -1
  538. package/dist/providers/copilot/CopilotSessionLocator.d.ts +0 -20
  539. package/dist/providers/copilot/CopilotSessionLocator.d.ts.map +0 -1
  540. package/dist/providers/copilot/CopilotSessionLocator.js +0 -49
  541. package/dist/providers/copilot/CopilotSessionLocator.js.map +0 -1
  542. package/dist/providers/copilot/CopilotSessionParser.d.ts +0 -30
  543. package/dist/providers/copilot/CopilotSessionParser.d.ts.map +0 -1
  544. package/dist/providers/copilot/CopilotSessionParser.js +0 -181
  545. package/dist/providers/copilot/CopilotSessionParser.js.map +0 -1
  546. package/dist/providers/gemini/GeminiAgentMapper.js.map +0 -1
  547. package/dist/providers/gemini/GeminiCliAdapter.d.ts.map +0 -1
  548. package/dist/providers/gemini/GeminiCliAdapter.js.map +0 -1
  549. package/dist/providers/gemini/GeminiSessionLocator.d.ts +0 -30
  550. package/dist/providers/gemini/GeminiSessionLocator.d.ts.map +0 -1
  551. package/dist/providers/gemini/GeminiSessionLocator.js +0 -142
  552. package/dist/providers/gemini/GeminiSessionLocator.js.map +0 -1
  553. package/dist/providers/gemini/GeminiSessionParser.d.ts.map +0 -1
  554. package/dist/providers/gemini/GeminiSessionParser.js +0 -166
  555. package/dist/providers/gemini/GeminiSessionParser.js.map +0 -1
  556. package/dist/providers/grok/GrokAgentMapper.js.map +0 -1
  557. package/dist/providers/grok/GrokCliAdapter.d.ts.map +0 -1
  558. package/dist/providers/grok/GrokCliAdapter.js.map +0 -1
  559. package/dist/providers/grok/GrokSessionLocator.js.map +0 -1
  560. package/dist/providers/grok/GrokSessionParser.d.ts +0 -54
  561. package/dist/providers/grok/GrokSessionParser.d.ts.map +0 -1
  562. package/dist/providers/grok/GrokSessionParser.js +0 -122
  563. package/dist/providers/grok/GrokSessionParser.js.map +0 -1
  564. package/dist/providers/opencode/OpenCodeAdapter.d.ts.map +0 -1
  565. package/dist/providers/opencode/OpenCodeAdapter.js.map +0 -1
  566. package/dist/providers/opencode/OpenCodeAgentMapper.js.map +0 -1
  567. package/dist/providers/opencode/OpenCodeSessionLocator.js.map +0 -1
  568. package/dist/providers/opencode/OpenCodeSessionParser.d.ts.map +0 -1
  569. package/dist/providers/opencode/OpenCodeSessionParser.js.map +0 -1
  570. package/dist/providers/pi/PiAdapter.d.ts.map +0 -1
  571. package/dist/providers/pi/PiAdapter.js.map +0 -1
  572. package/dist/providers/pi/PiAgentMapper.js.map +0 -1
  573. package/dist/providers/pi/PiSessionLocator.d.ts +0 -24
  574. package/dist/providers/pi/PiSessionLocator.d.ts.map +0 -1
  575. package/dist/providers/pi/PiSessionLocator.js +0 -86
  576. package/dist/providers/pi/PiSessionLocator.js.map +0 -1
  577. package/dist/providers/pi/PiSessionParser.d.ts +0 -36
  578. package/dist/providers/pi/PiSessionParser.d.ts.map +0 -1
  579. package/dist/providers/pi/PiSessionParser.js +0 -191
  580. package/dist/providers/pi/PiSessionParser.js.map +0 -1
  581. package/dist/providers/pi/PiSessionTracker.js.map +0 -1
  582. package/src/__tests__/fixtures/fake-claude.cjs +0 -31
  583. package/src/__tests__/fixtures/fake-codex.cjs +0 -56
  584. package/src/__tests__/providers/codex/CodexSessionLocator.test.ts +0 -182
  585. package/src/adapters/index.ts +0 -15
  586. package/src/providers/codex/CodexSessionLocator.ts +0 -279
  587. package/src/providers/copilot/CopilotSessionLocator.ts +0 -63
  588. package/src/providers/copilot/CopilotSessionParser.ts +0 -289
  589. package/src/providers/gemini/GeminiSessionLocator.ts +0 -183
  590. package/src/providers/grok/GrokSessionParser.ts +0 -166
  591. package/src/providers/pi/PiSessionLocator.ts +0 -110
  592. package/src/providers/pi/PiSessionParser.ts +0 -284
  593. /package/dist/__tests__/{providers → harnesses}/pi/durable/PiCliProbe.test.js +0 -0
  594. /package/dist/__tests__/{providers → harnesses}/pi/durable/PiDurableAgentRepository.test.js +0 -0
  595. /package/dist/__tests__/{providers → harnesses}/pi/durable/PiPrintAgentService.test.js +0 -0
  596. /package/dist/__tests__/{providers → harnesses}/pi/durable/PiPrintRunner.test.js +0 -0
  597. /package/dist/{providers → harnesses}/claude/ClaudeAgentMapper.d.ts +0 -0
  598. /package/dist/{providers → harnesses}/claude/ClaudeSessionLocator.d.ts +0 -0
  599. /package/dist/{providers → harnesses}/claude/durable/ClaudeCliProbe.d.ts +0 -0
  600. /package/dist/{providers → harnesses}/claude/durable/ClaudeCliProbe.js +0 -0
  601. /package/dist/{providers → harnesses}/claude/durable/ClaudePrintAgentService.d.ts +0 -0
  602. /package/dist/{providers → harnesses}/claude/durable/ClaudePrintAgentService.js +0 -0
  603. /package/dist/{providers → harnesses}/claude/durable/ClaudePrintRunner.d.ts +0 -0
  604. /package/dist/{providers → harnesses}/claude/durable/ClaudePrintRunner.js +0 -0
  605. /package/dist/{providers → harnesses}/claude/durable/ClaudeStreamParser.d.ts +0 -0
  606. /package/dist/{providers → harnesses}/claude/durable/ClaudeStreamParser.js +0 -0
  607. /package/dist/{providers → harnesses}/codex/CodexAgentMapper.d.ts +0 -0
  608. /package/dist/{providers → harnesses}/codex/CodexSessionMapping.d.ts +0 -0
  609. /package/dist/{providers → harnesses}/codex/durable/CodexCliProbe.d.ts +0 -0
  610. /package/dist/{providers → harnesses}/codex/durable/CodexCliProbe.js +0 -0
  611. /package/dist/{providers → harnesses}/codex/durable/CodexPrintAgentService.d.ts +0 -0
  612. /package/dist/{providers → harnesses}/codex/durable/CodexPrintAgentService.js +0 -0
  613. /package/dist/{providers → harnesses}/codex/durable/CodexPrintRunner.d.ts +0 -0
  614. /package/dist/{providers → harnesses}/codex/durable/CodexPrintRunner.js +0 -0
  615. /package/dist/{providers → harnesses}/codex/durable/CodexStreamParser.d.ts +0 -0
  616. /package/dist/{providers → harnesses}/codex/durable/CodexStreamParser.js +0 -0
  617. /package/dist/{providers → harnesses}/copilot/CopilotAgentMapper.d.ts +0 -0
  618. /package/dist/{providers → harnesses}/gemini/GeminiAgentMapper.d.ts +0 -0
  619. /package/dist/{providers → harnesses}/grok/GrokAgentMapper.d.ts +0 -0
  620. /package/dist/{providers → harnesses}/grok/GrokSessionLocator.d.ts +0 -0
  621. /package/dist/{providers → harnesses}/opencode/OpenCodeAgentMapper.d.ts +0 -0
  622. /package/dist/{providers → harnesses}/opencode/OpenCodeSessionLocator.d.ts +0 -0
  623. /package/dist/{providers → harnesses}/pi/PiAgentMapper.d.ts +0 -0
  624. /package/dist/{providers → harnesses}/pi/PiSessionTracker.d.ts +0 -0
  625. /package/dist/{providers → harnesses}/pi/durable/PiCliProbe.d.ts +0 -0
  626. /package/dist/{providers → harnesses}/pi/durable/PiCliProbe.js +0 -0
  627. /package/dist/{providers → harnesses}/pi/durable/PiPrintAgentService.d.ts +0 -0
  628. /package/dist/{providers → harnesses}/pi/durable/PiPrintAgentService.js +0 -0
  629. /package/dist/{providers → harnesses}/pi/durable/PiPrintProtocol.d.ts +0 -0
  630. /package/dist/{providers → harnesses}/pi/durable/PiPrintProtocol.js +0 -0
  631. /package/dist/{providers → harnesses}/pi/durable/PiPrintRunner.d.ts +0 -0
  632. /package/dist/{providers → harnesses}/pi/durable/PiPrintRunner.js +0 -0
  633. /package/dist/{providers → harnesses}/pi/durable/PiStreamParser.d.ts +0 -0
  634. /package/dist/{providers → harnesses}/pi/durable/PiStreamParser.js +0 -0
  635. /package/src/__tests__/{providers → harnesses}/pi/durable/PiCliProbe.test.ts +0 -0
  636. /package/src/__tests__/{providers → harnesses}/pi/durable/PiDurableAgentRepository.test.ts +0 -0
  637. /package/src/__tests__/{providers → harnesses}/pi/durable/PiPrintAgentService.test.ts +0 -0
  638. /package/src/__tests__/{providers → harnesses}/pi/durable/PiPrintRunner.test.ts +0 -0
  639. /package/src/{providers → harnesses}/claude/durable/ClaudeCliProbe.ts +0 -0
  640. /package/src/{providers → harnesses}/claude/durable/ClaudePrintAgentService.ts +0 -0
  641. /package/src/{providers → harnesses}/claude/durable/ClaudePrintRunner.ts +0 -0
  642. /package/src/{providers → harnesses}/claude/durable/ClaudeStreamParser.ts +0 -0
  643. /package/src/{providers → harnesses}/codex/durable/CodexCliProbe.ts +0 -0
  644. /package/src/{providers → harnesses}/codex/durable/CodexPrintAgentService.ts +0 -0
  645. /package/src/{providers → harnesses}/codex/durable/CodexPrintRunner.ts +0 -0
  646. /package/src/{providers → harnesses}/codex/durable/CodexStreamParser.ts +0 -0
  647. /package/src/{providers → harnesses}/pi/durable/PiCliProbe.ts +0 -0
  648. /package/src/{providers → harnesses}/pi/durable/PiPrintAgentService.ts +0 -0
  649. /package/src/{providers → harnesses}/pi/durable/PiPrintProtocol.ts +0 -0
  650. /package/src/{providers → harnesses}/pi/durable/PiPrintRunner.ts +0 -0
  651. /package/src/{providers → harnesses}/pi/durable/PiStreamParser.ts +0 -0
@@ -0,0 +1,396 @@
1
+ /**
2
+ * I/O-bounded discovery tests for GeminiSessionLocator (issue #263).
3
+ *
4
+ * `fs` is wrapped so every open/read is recorded, which lets the tests
5
+ * assert exactly which chat files discovery touches and how many bytes
6
+ * of chat content it reads per refresh.
7
+ */
8
+
9
+ import * as crypto from "crypto";
10
+ import * as fs from "fs";
11
+ import * as os from "os";
12
+ import * as path from "path";
13
+
14
+ import { GeminiCliAdapter } from "../../../harnesses/gemini/GeminiCliAdapter.js";
15
+ import { GeminiSessionLocator } from "../../../harnesses/gemini/GeminiSessionLocator.js";
16
+ import type { ProcessInfo } from "../../../adapters/AgentAdapter.js";
17
+ import { AgentRegistry } from "../../../utils/AgentRegistry.js";
18
+
19
+ vi.mock("fs", async (importOriginal) => {
20
+ const actual = (await importOriginal()) as typeof import("fs");
21
+ const wrapped = {
22
+ ...actual,
23
+ openSync: vi.fn(actual.openSync),
24
+ readSync: vi.fn(actual.readSync),
25
+ readFileSync: vi.fn(actual.readFileSync),
26
+ };
27
+ return { ...wrapped, default: wrapped };
28
+ });
29
+
30
+ const DAY_MS = 24 * 60 * 60 * 1000;
31
+
32
+ interface IoLog {
33
+ /** Paths passed to openSync/readFileSync, in call order. */
34
+ opened: string[];
35
+ /** Bytes returned by readSync/readFileSync, keyed by path. */
36
+ bytesByPath: Map<string, number>;
37
+ }
38
+
39
+ function startIoLog(): IoLog {
40
+ const log: IoLog = { opened: [], bytesByPath: new Map() };
41
+ const fdPaths = new Map<number, string>();
42
+ const openSync = vi.mocked(fs.openSync);
43
+ const readSync = vi.mocked(fs.readSync);
44
+ const readFileSync = vi.mocked(fs.readFileSync);
45
+
46
+ const addBytes = (p: string, n: number) =>
47
+ log.bytesByPath.set(p, (log.bytesByPath.get(p) ?? 0) + n);
48
+
49
+ openSync.mockImplementation(((p: fs.PathLike, ...rest: unknown[]) => {
50
+ const fd = (fsActual.openSync as (...args: unknown[]) => number)(p, ...rest);
51
+ log.opened.push(String(p));
52
+ fdPaths.set(fd, String(p));
53
+ return fd;
54
+ }) as typeof fs.openSync);
55
+ readSync.mockImplementation(((fd: number, ...rest: unknown[]) => {
56
+ const n = (fsActual.readSync as (...args: unknown[]) => number)(fd, ...rest);
57
+ addBytes(fdPaths.get(fd) ?? `fd:${fd}`, n);
58
+ return n;
59
+ }) as typeof fs.readSync);
60
+ readFileSync.mockImplementation(((p: fs.PathOrFileDescriptor, ...rest: unknown[]) => {
61
+ const result = (fsActual.readFileSync as (...args: unknown[]) => string | Buffer)(p, ...rest);
62
+ log.opened.push(String(p));
63
+ addBytes(String(p), Buffer.byteLength(result));
64
+ return result;
65
+ }) as typeof fs.readFileSync);
66
+ return log;
67
+ }
68
+
69
+ let fsActual: typeof import("fs");
70
+
71
+ function chatBytes(log: IoLog): number {
72
+ let total = 0;
73
+ for (const [p, n] of log.bytesByPath) {
74
+ if (isChatFile(p)) total += n;
75
+ }
76
+ return total;
77
+ }
78
+
79
+ function openedChatFiles(log: IoLog): string[] {
80
+ return [...new Set(log.opened.filter(isChatFile))].sort();
81
+ }
82
+
83
+ function isChatFile(p: string): boolean {
84
+ return path.basename(path.dirname(p)) === "chats";
85
+ }
86
+
87
+ function sha256(value: string): string {
88
+ return crypto.createHash("sha256").update(value).digest("hex");
89
+ }
90
+
91
+ function writeChat(
92
+ tmpDir: string,
93
+ dirName: string,
94
+ fileName: string,
95
+ body: Record<string, unknown>,
96
+ mtime?: Date,
97
+ ): string {
98
+ const chatsDir = path.join(tmpDir, dirName, "chats");
99
+ fsActual.mkdirSync(chatsDir, { recursive: true });
100
+ const filePath = path.join(chatsDir, fileName);
101
+ // Gemini CLI writes the legacy .json format with 2-space indentation.
102
+ fsActual.writeFileSync(filePath, JSON.stringify(body, null, 2));
103
+ if (mtime) fsActual.utimesSync(filePath, mtime, mtime);
104
+ return filePath;
105
+ }
106
+
107
+ function writeProjectMarker(tmpDir: string, dirName: string, projectRoot: string): void {
108
+ fsActual.mkdirSync(path.join(tmpDir, dirName), { recursive: true });
109
+ fsActual.writeFileSync(path.join(tmpDir, dirName, ".project_root"), projectRoot);
110
+ }
111
+
112
+ function sessionBody(projectRoot: string, sessionId: string, extraMessages = 1) {
113
+ const now = new Date().toISOString();
114
+ return {
115
+ sessionId,
116
+ projectHash: sha256(projectRoot),
117
+ startTime: now,
118
+ lastUpdated: now,
119
+ kind: "main",
120
+ directories: [projectRoot],
121
+ messages: Array.from({ length: extraMessages }, (_, i) => ({
122
+ id: `m${i}`,
123
+ timestamp: now,
124
+ type: "user",
125
+ content: [{ text: `message ${i} for ${sessionId}` }],
126
+ })),
127
+ };
128
+ }
129
+
130
+ function geminiProcess(pid: number, cwd: string, startTime = new Date()): ProcessInfo {
131
+ return { pid, command: "node /usr/local/bin/gemini", cwd, tty: "ttys001", startTime };
132
+ }
133
+
134
+ describe("GeminiSessionLocator — bounded discovery (#263)", () => {
135
+ let tmpHome: string;
136
+ let tmpDir: string;
137
+ let locator: GeminiSessionLocator;
138
+
139
+ beforeAll(async () => {
140
+ fsActual = await vi.importActual<typeof import("fs")>("fs");
141
+ });
142
+
143
+ beforeEach(() => {
144
+ tmpHome = fsActual.mkdtempSync(path.join(os.tmpdir(), "gemini-locator-test-"));
145
+ tmpDir = path.join(tmpHome, ".gemini", "tmp");
146
+ fsActual.mkdirSync(tmpDir, { recursive: true });
147
+ locator = new GeminiSessionLocator({ geminiTmpDir: tmpDir });
148
+ });
149
+
150
+ afterEach(() => {
151
+ fsActual.rmSync(tmpHome, { recursive: true, force: true });
152
+ });
153
+
154
+ /**
155
+ * 20 projects x 25 chats = 500 historical fixtures. Half the projects use
156
+ * Gemini's current slug + `.project_root` layout, half the legacy
157
+ * sha256(projectRoot) directory name. Every project has fresh files so
158
+ * only directory pruning (not the mtime window) can exclude them.
159
+ */
160
+ function seedHistory(): { liveRoot: string; liveRecent: string } {
161
+ const old = new Date(Date.now() - 3 * DAY_MS);
162
+ let liveRecent = "";
163
+ const liveRoot = "/work/project-07";
164
+
165
+ for (let p = 0; p < 20; p++) {
166
+ const root = `/work/project-${String(p).padStart(2, "0")}`;
167
+ const dirName = p % 2 === 1 ? `project-${String(p).padStart(2, "0")}` : sha256(root);
168
+ if (p % 2 === 1) writeProjectMarker(tmpDir, dirName, root);
169
+
170
+ for (let f = 0; f < 25; f++) {
171
+ const isRecent = f === 24;
172
+ const filePath = writeChat(
173
+ tmpDir,
174
+ dirName,
175
+ `session-2026-09-${String(f + 1).padStart(2, "0")}T00-00-${p}-${f}.json`,
176
+ sessionBody(root, `s-${p}-${f}`),
177
+ isRecent ? undefined : old,
178
+ );
179
+ if (root === liveRoot && isRecent) liveRecent = filePath;
180
+ }
181
+ }
182
+ return { liveRoot, liveRecent };
183
+ }
184
+
185
+ it("opens only the live process's project chat files inside the mtime window", () => {
186
+ const { liveRoot, liveRecent } = seedHistory();
187
+ const log = startIoLog();
188
+
189
+ const result = locator.discoverSessions([geminiProcess(1, liveRoot)]);
190
+
191
+ expect(result.sessions.map((s) => s.filePath)).toEqual([liveRecent]);
192
+ expect(result.sessions[0]).toMatchObject({ sessionId: "s-7-24", resolvedCwd: liveRoot });
193
+ expect(openedChatFiles(log)).toEqual([liveRecent]);
194
+ });
195
+
196
+ it("prunes legacy hash-named project dirs without opening their chats", () => {
197
+ const { liveRecent } = seedHistory();
198
+ const legacyRoot = "/work/project-04"; // even index => sha256-named dir
199
+ const log = startIoLog();
200
+
201
+ const result = locator.discoverSessions([geminiProcess(1, legacyRoot)]);
202
+
203
+ expect(result.sessions.map((s) => s.sessionId)).toEqual(["s-4-24"]);
204
+ const opened = openedChatFiles(log);
205
+ expect(opened).toHaveLength(1);
206
+ expect(opened[0]).toContain(sha256(legacyRoot));
207
+ expect(opened).not.toContain(liveRecent);
208
+ });
209
+
210
+ it("does not expose a content cache and reads only a bounded head of large chats", () => {
211
+ const root = "/work/big";
212
+ const bigPath = writeChat(tmpDir, "big", "session-big.json", sessionBody(root, "s-big", 4000));
213
+ const size = fsActual.statSync(bigPath).size;
214
+ expect(size).toBeGreaterThan(256 * 1024);
215
+ const log = startIoLog();
216
+
217
+ const result = locator.discoverSessions([geminiProcess(1, root)]);
218
+
219
+ expect(result.sessions.map((s) => s.sessionId)).toEqual(["s-big"]);
220
+ expect(result).not.toHaveProperty("contentCache");
221
+ expect(chatBytes(log)).toBeLessThanOrEqual(16 * 1024);
222
+ });
223
+
224
+ it("reads 0 bytes of chat content on a refresh when files are unchanged", () => {
225
+ seedHistory();
226
+ const proc = geminiProcess(1, "/work/project-07");
227
+ const first = locator.discoverSessions([proc]);
228
+ const log = startIoLog();
229
+
230
+ const second = locator.discoverSessions([proc]);
231
+
232
+ expect(second.sessions).toEqual(first.sessions);
233
+ expect(chatBytes(log)).toBe(0);
234
+ expect(log.opened).toEqual([]);
235
+ });
236
+
237
+ it("re-reads metadata once a cached chat file changes", () => {
238
+ const root = "/work/changing";
239
+ const filePath = writeChat(tmpDir, "changing", "session-c.json", sessionBody(root, "s-1"));
240
+ const proc = geminiProcess(1, root);
241
+ expect(locator.discoverSessions([proc]).sessions[0].sessionId).toBe("s-1");
242
+
243
+ fsActual.writeFileSync(filePath, JSON.stringify(sessionBody(root, "s-2", 3), null, 2));
244
+ const log = startIoLog();
245
+
246
+ expect(locator.discoverSessions([proc]).sessions[0].sessionId).toBe("s-2");
247
+ expect(chatBytes(log)).toBeGreaterThan(0);
248
+ });
249
+
250
+ it("falls back to scanning dirs without a recognisable layout", () => {
251
+ const root = "/work/unknown-layout";
252
+ writeChat(tmpDir, "opaque", "session-u.json", sessionBody(root, "s-u"));
253
+
254
+ const result = locator.discoverSessions([geminiProcess(1, root)]);
255
+
256
+ expect(result.sessions.map((s) => s.sessionId)).toEqual(["s-u"]);
257
+ });
258
+
259
+ it("skips slug dirs whose .project_root names a different project", () => {
260
+ writeProjectMarker(tmpDir, "other", "/work/other");
261
+ writeChat(tmpDir, "other", "session-o.json", sessionBody("/work/mine", "s-o"));
262
+ const log = startIoLog();
263
+
264
+ const result = locator.discoverSessions([geminiProcess(1, "/work/mine")]);
265
+
266
+ expect(result.sessions).toEqual([]);
267
+ expect(openedChatFiles(log)).toEqual([]);
268
+ });
269
+
270
+ it("matches a subdirectory process against the project-root marker", () => {
271
+ writeProjectMarker(tmpDir, "mono", "/work/mono");
272
+ writeChat(tmpDir, "mono", "session-m.json", sessionBody("/work/mono", "s-m"));
273
+
274
+ const result = locator.discoverSessions([geminiProcess(1, "/work/mono/packages/a")]);
275
+
276
+ expect(result.sessions).toHaveLength(1);
277
+ expect(result.sessions[0].resolvedCwd).toBe("/work/mono/packages/a");
278
+ });
279
+
280
+ it("does not apply an mtime window when no process has a start time", () => {
281
+ const root = "/work/nostart";
282
+ writeChat(
283
+ tmpDir,
284
+ "nostart",
285
+ "session-n.json",
286
+ sessionBody(root, "s-n"),
287
+ new Date(Date.now() - 30 * DAY_MS),
288
+ );
289
+ const proc: ProcessInfo = { pid: 1, command: "gemini", cwd: root, tty: "ttys001" };
290
+
291
+ expect(locator.discoverSessions([proc]).sessions.map((s) => s.sessionId)).toEqual(["s-n"]);
292
+ });
293
+
294
+ it("keeps sessions modified within the matching tolerance before process start", () => {
295
+ const root = "/work/tolerance";
296
+ const start = new Date();
297
+ writeChat(
298
+ tmpDir,
299
+ "tolerance",
300
+ "session-t.json",
301
+ sessionBody(root, "s-t"),
302
+ new Date(start.getTime() - 60 * 1000),
303
+ );
304
+
305
+ const result = locator.discoverSessions([geminiProcess(1, root, start)]);
306
+
307
+ expect(result.sessions.map((s) => s.sessionId)).toEqual(["s-t"]);
308
+ });
309
+
310
+ it("falls back to a full parse when the head lacks the metadata keys", () => {
311
+ const root = "/work/late-keys";
312
+ const chatsDir = path.join(tmpDir, "late", "chats");
313
+ fsActual.mkdirSync(chatsDir, { recursive: true });
314
+ const body = {
315
+ messages: Array.from({ length: 2000 }, (_, i) => ({ id: `m${i}`, type: "user" })),
316
+ sessionId: "s-late",
317
+ projectHash: sha256(root),
318
+ };
319
+ fsActual.writeFileSync(path.join(chatsDir, "session-late.json"), JSON.stringify(body));
320
+
321
+ const result = locator.discoverSessions([geminiProcess(1, root)]);
322
+
323
+ expect(result.sessions.map((s) => s.sessionId)).toEqual(["s-late"]);
324
+ });
325
+ });
326
+
327
+ describe("GeminiCliAdapter — refresh I/O (#263)", () => {
328
+ let tmpHome: string;
329
+
330
+ beforeAll(async () => {
331
+ fsActual = await vi.importActual<typeof import("fs")>("fs");
332
+ });
333
+
334
+ beforeEach(() => {
335
+ tmpHome = fsActual.mkdtempSync(path.join(os.tmpdir(), "gemini-adapter-io-test-"));
336
+ });
337
+
338
+ afterEach(() => {
339
+ fsActual.rmSync(tmpHome, { recursive: true, force: true });
340
+ });
341
+
342
+ it("reads 0 bytes of chat content on the second detectAgents with unchanged files", async () => {
343
+ const tmpDir = path.join(tmpHome, ".gemini", "tmp");
344
+ const root = "/work/live";
345
+ writeProjectMarker(tmpDir, "live", root);
346
+ const sessionPath = writeChat(tmpDir, "live", "session-live.json", sessionBody(root, "s-live"));
347
+ for (let i = 0; i < 10; i++) {
348
+ writeChat(
349
+ tmpDir,
350
+ "live",
351
+ `session-old-${i}.json`,
352
+ sessionBody(root, `s-old-${i}`),
353
+ new Date(Date.now() - 2 * DAY_MS),
354
+ );
355
+ }
356
+
357
+ const adapter = new GeminiCliAdapter(new AgentRegistry(path.join(tmpHome, "agents.json")), {
358
+ geminiTmpDir: tmpDir,
359
+ });
360
+ const context = { processes: [geminiProcess(4242, root)] };
361
+
362
+ const first = await adapter.detectAgents(context);
363
+ expect(first).toHaveLength(1);
364
+ expect(first[0]).toMatchObject({ sessionId: "s-live", sessionFilePath: sessionPath });
365
+
366
+ const log = startIoLog();
367
+ const second = await adapter.detectAgents(context);
368
+
369
+ expect(second).toHaveLength(1);
370
+ expect(second[0]).toMatchObject({
371
+ sessionId: first[0].sessionId,
372
+ sessionFilePath: first[0].sessionFilePath,
373
+ summary: first[0].summary,
374
+ });
375
+ expect(chatBytes(log)).toBe(0);
376
+ });
377
+
378
+ it("re-parses the matched session after it is appended to", async () => {
379
+ const tmpDir = path.join(tmpHome, ".gemini", "tmp");
380
+ const root = "/work/appending";
381
+ writeProjectMarker(tmpDir, "appending", root);
382
+ const sessionPath = writeChat(tmpDir, "appending", "session-a.json", sessionBody(root, "s-a"));
383
+ const adapter = new GeminiCliAdapter(new AgentRegistry(path.join(tmpHome, "agents.json")), {
384
+ geminiTmpDir: tmpDir,
385
+ });
386
+ const context = { processes: [geminiProcess(4343, root)] };
387
+
388
+ const first = await adapter.detectAgents(context);
389
+ expect(first[0].summary).toBe("message 0 for s-a");
390
+
391
+ fsActual.writeFileSync(sessionPath, JSON.stringify(sessionBody(root, "s-a", 3), null, 2));
392
+ const second = await adapter.detectAgents(context);
393
+
394
+ expect(second[0]).toMatchObject({ sessionId: "s-a", summary: "message 2 for s-a" });
395
+ });
396
+ });
@@ -1,8 +1,8 @@
1
1
  import { describe, expect, it } from "vitest";
2
2
 
3
3
  import { AgentStatus, type ProcessInfo } from "../../../adapters/AgentAdapter.js";
4
- import { GrokAgentMapper } from "../../../providers/grok/GrokAgentMapper.js";
5
- import type { GrokSession } from "../../../providers/grok/GrokSessionParser.js";
4
+ import { GrokAgentMapper } from "../../../harnesses/grok/GrokAgentMapper.js";
5
+ import type { GrokSession } from "../../../harnesses/grok/GrokSessionParser.js";
6
6
 
7
7
  function makeProcess(overrides: Partial<ProcessInfo> = {}): ProcessInfo {
8
8
  return { pid: 123, command: "grok", cwd: "/repo/my-app", tty: "ttys001", ...overrides };
@@ -10,7 +10,7 @@ import * as fs from "fs";
10
10
  import * as os from "os";
11
11
  import * as path from "path";
12
12
 
13
- import { GrokCliAdapter } from "../../../providers/grok/GrokCliAdapter.js";
13
+ import { GrokCliAdapter } from "../../../harnesses/grok/GrokCliAdapter.js";
14
14
  import type { ProcessInfo } from "../../../adapters/AgentAdapter.js";
15
15
  import { AgentStatus } from "../../../adapters/AgentAdapter.js";
16
16
  import {
@@ -0,0 +1,170 @@
1
+ /**
2
+ * Refresh-path I/O tests for the Grok adapter: repeated `detectAgents()` calls
3
+ * must only read chat_history.jsonl bytes that changed since the last refresh.
4
+ */
5
+
6
+ import * as fs from "fs";
7
+ import * as os from "os";
8
+ import * as path from "path";
9
+
10
+ import type { ProcessInfo } from "../../../adapters/AgentAdapter.js";
11
+ import { GrokCliAdapter } from "../../../harnesses/grok/GrokCliAdapter.js";
12
+
13
+ vi.mock("fs", async (importOriginal) => {
14
+ const actual = (await importOriginal()) as typeof import("fs");
15
+ return {
16
+ ...actual,
17
+ openSync: vi.fn(actual.openSync),
18
+ readSync: vi.fn(actual.readSync),
19
+ readFileSync: vi.fn(actual.readFileSync),
20
+ };
21
+ });
22
+
23
+ const mockedOpenSync = vi.mocked(fs.openSync);
24
+ const mockedReadSync = vi.mocked(fs.readSync);
25
+ const mockedReadFileSync = vi.mocked(fs.readFileSync);
26
+
27
+ /** Bytes read from `filePath` via readFileSync or fd reads since the last `resetReads()`. */
28
+ function bytesReadFrom(filePath: string): number {
29
+ // fds are reused after close, so attribute each read to the latest open of that fd
30
+ const opens = mockedOpenSync.mock.calls.map((call, index) => ({
31
+ path: String(call[0]),
32
+ fd: mockedOpenSync.mock.results[index]?.value as number,
33
+ order: mockedOpenSync.mock.invocationCallOrder[index],
34
+ }));
35
+
36
+ let total = 0;
37
+ mockedReadSync.mock.calls.forEach((call, index) => {
38
+ const result = mockedReadSync.mock.results[index];
39
+ const order = mockedReadSync.mock.invocationCallOrder[index];
40
+ const open = opens.filter((o) => o.fd === call[0] && o.order < order).at(-1);
41
+ if (result?.type === "return" && open?.path === filePath) {
42
+ total += result.value as number;
43
+ }
44
+ });
45
+ mockedReadFileSync.mock.calls.forEach((call, index) => {
46
+ const result = mockedReadFileSync.mock.results[index];
47
+ if (result?.type === "return" && String(call[0]) === filePath) {
48
+ total += Buffer.byteLength(result.value as string | Buffer);
49
+ }
50
+ });
51
+ return total;
52
+ }
53
+
54
+ function resetReads(): void {
55
+ mockedOpenSync.mockClear();
56
+ mockedReadSync.mockClear();
57
+ mockedReadFileSync.mockClear();
58
+ }
59
+
60
+ const userRecord = (text: string) => ({
61
+ type: "user",
62
+ content: [{ type: "text", text: `<user_query>\n${text}\n</user_query>` }],
63
+ });
64
+ const assistantRecord = (text: string) => ({
65
+ type: "assistant",
66
+ content: [{ type: "text", text }],
67
+ });
68
+
69
+ describe("Grok incremental transcript reads across detectAgents() refreshes", () => {
70
+ let originalHome: string | undefined;
71
+ let originalGrokHome: string | undefined;
72
+ let tmpHome: string;
73
+ let chatFile: string;
74
+ let adapter: GrokCliAdapter;
75
+ let processes: ProcessInfo[];
76
+
77
+ const pid = 73001;
78
+ const cwd = "/repo/grok";
79
+
80
+ beforeEach(() => {
81
+ originalHome = process.env.HOME;
82
+ originalGrokHome = process.env.GROK_HOME;
83
+ tmpHome = fs.mkdtempSync(path.join(os.tmpdir(), "grok-incremental-refresh-"));
84
+ process.env.HOME = tmpHome;
85
+ delete process.env.GROK_HOME;
86
+
87
+ const sessionDir = path.join(
88
+ tmpHome,
89
+ ".grok",
90
+ "sessions",
91
+ encodeURIComponent(cwd),
92
+ "019f16c3-0000-7000-8000-000000000001",
93
+ );
94
+ fs.mkdirSync(sessionDir, { recursive: true });
95
+ chatFile = path.join(sessionDir, "chat_history.jsonl");
96
+ // Large, newline-terminated transcript; the last record is left unterminated
97
+ // the way the existing Grok fixtures write it.
98
+ fs.writeFileSync(
99
+ chatFile,
100
+ [
101
+ userRecord("first task"),
102
+ assistantRecord("x".repeat(300_000)),
103
+ { type: "user", content: [{ type: "text", text: "<user_info>OS</user_info>" }] },
104
+ userRecord("second task"),
105
+ ]
106
+ .map((record) => JSON.stringify(record))
107
+ .join("\n"),
108
+ );
109
+ fs.writeFileSync(
110
+ path.join(tmpHome, ".grok", "active_sessions.json"),
111
+ JSON.stringify([{ pid, cwd, opened_at: 1 }]),
112
+ );
113
+
114
+ processes = [{ pid, command: "grok", cwd, tty: "ttys003", startTime: new Date() }];
115
+ adapter = new GrokCliAdapter();
116
+ resetReads();
117
+ });
118
+
119
+ afterEach(() => {
120
+ process.env.HOME = originalHome;
121
+ if (originalGrokHome === undefined) delete process.env.GROK_HOME;
122
+ else process.env.GROK_HOME = originalGrokHome;
123
+ fs.rmSync(tmpHome, { recursive: true, force: true });
124
+ });
125
+
126
+ const detect = () => adapter.detectAgents({ processes });
127
+ const summaryOf = (agents: Awaited<ReturnType<typeof detect>>) => ({
128
+ sessionId: agents[0]?.sessionId,
129
+ status: agents[0]?.status,
130
+ summary: agents[0]?.summary,
131
+ });
132
+
133
+ it("reads 0 transcript bytes on a second refresh when nothing changed", async () => {
134
+ const first = await detect();
135
+ expect(bytesReadFrom(chatFile)).toBe(fs.statSync(chatFile).size);
136
+ expect(first[0].summary).toBe("second task");
137
+
138
+ resetReads();
139
+ const second = await detect();
140
+
141
+ expect(bytesReadFrom(chatFile)).toBe(0);
142
+ expect(summaryOf(second)).toEqual(summaryOf(first));
143
+ });
144
+
145
+ it("reads at most the appended bytes plus 64 KiB after an append", async () => {
146
+ await detect();
147
+
148
+ const append = `\n${JSON.stringify(assistantRecord("done"))}\n${JSON.stringify(
149
+ userRecord("follow-up task"),
150
+ )}\n`;
151
+ fs.appendFileSync(chatFile, append);
152
+
153
+ resetReads();
154
+ const agents = await detect();
155
+
156
+ expect(bytesReadFrom(chatFile)).toBeGreaterThan(0);
157
+ expect(bytesReadFrom(chatFile)).toBeLessThanOrEqual(Buffer.byteLength(append) + 64 * 1024);
158
+ expect(agents[0].summary).toBe("follow-up task");
159
+ });
160
+
161
+ it("evicts cache entries for transcripts absent from the latest refresh", async () => {
162
+ await detect();
163
+ expect((adapter as any).parser.sessionCache.size).toBe(1);
164
+
165
+ processes = [];
166
+ await detect();
167
+
168
+ expect((adapter as any).parser.sessionCache.size).toBe(0);
169
+ });
170
+ });
@@ -4,7 +4,7 @@ import * as path from "path";
4
4
  import { afterEach, beforeEach, describe, expect, it } from "vitest";
5
5
 
6
6
  import type { ProcessInfo } from "../../../adapters/AgentAdapter.js";
7
- import { GrokSessionLocator } from "../../../providers/grok/GrokSessionLocator.js";
7
+ import { GrokSessionLocator } from "../../../harnesses/grok/GrokSessionLocator.js";
8
8
 
9
9
  describe("GrokSessionLocator", () => {
10
10
  let baseDir: string;