@a1hvdy/cc-openclaw 0.3.2

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 (491) hide show
  1. package/LICENSE +22 -0
  2. package/README.md +207 -0
  3. package/configs/.gitkeep +0 -0
  4. package/configs/council-reviewer-prompt.md +82 -0
  5. package/configs/council-system-prompt.md +141 -0
  6. package/dist/scripts/bench/ab-harness.d.ts +58 -0
  7. package/dist/scripts/bench/ab-harness.d.ts.map +1 -0
  8. package/dist/scripts/bench/ab-harness.js +78 -0
  9. package/dist/scripts/bench/ab-harness.js.map +1 -0
  10. package/dist/src/channels/adapter.d.ts +103 -0
  11. package/dist/src/channels/adapter.d.ts.map +1 -0
  12. package/dist/src/channels/adapter.js +38 -0
  13. package/dist/src/channels/adapter.js.map +1 -0
  14. package/dist/src/channels/telegram/completion-summary.d.ts +22 -0
  15. package/dist/src/channels/telegram/completion-summary.d.ts.map +1 -0
  16. package/dist/src/channels/telegram/completion-summary.js +186 -0
  17. package/dist/src/channels/telegram/completion-summary.js.map +1 -0
  18. package/dist/src/channels/telegram/error-renderer.d.ts +30 -0
  19. package/dist/src/channels/telegram/error-renderer.d.ts.map +1 -0
  20. package/dist/src/channels/telegram/error-renderer.js +133 -0
  21. package/dist/src/channels/telegram/error-renderer.js.map +1 -0
  22. package/dist/src/channels/telegram/event-reducer.d.ts +34 -0
  23. package/dist/src/channels/telegram/event-reducer.d.ts.map +1 -0
  24. package/dist/src/channels/telegram/event-reducer.js +579 -0
  25. package/dist/src/channels/telegram/event-reducer.js.map +1 -0
  26. package/dist/src/channels/telegram/index.d.ts +14 -0
  27. package/dist/src/channels/telegram/index.d.ts.map +1 -0
  28. package/dist/src/channels/telegram/index.js +14 -0
  29. package/dist/src/channels/telegram/index.js.map +1 -0
  30. package/dist/src/channels/telegram/injector.d.ts +54 -0
  31. package/dist/src/channels/telegram/injector.d.ts.map +1 -0
  32. package/dist/src/channels/telegram/injector.js +200 -0
  33. package/dist/src/channels/telegram/injector.js.map +1 -0
  34. package/dist/src/channels/telegram/live-card.d.ts +230 -0
  35. package/dist/src/channels/telegram/live-card.d.ts.map +1 -0
  36. package/dist/src/channels/telegram/live-card.js +916 -0
  37. package/dist/src/channels/telegram/live-card.js.map +1 -0
  38. package/dist/src/channels/telegram/state-machine.d.ts +23 -0
  39. package/dist/src/channels/telegram/state-machine.d.ts.map +1 -0
  40. package/dist/src/channels/telegram/state-machine.js +72 -0
  41. package/dist/src/channels/telegram/state-machine.js.map +1 -0
  42. package/dist/src/channels/telegram/tool-tracker.d.ts +147 -0
  43. package/dist/src/channels/telegram/tool-tracker.d.ts.map +1 -0
  44. package/dist/src/channels/telegram/tool-tracker.js +520 -0
  45. package/dist/src/channels/telegram/tool-tracker.js.map +1 -0
  46. package/dist/src/circuit-breaker.d.ts +22 -0
  47. package/dist/src/circuit-breaker.d.ts.map +1 -0
  48. package/dist/src/circuit-breaker.js +47 -0
  49. package/dist/src/circuit-breaker.js.map +1 -0
  50. package/dist/src/command-router/cc-handler.d.ts +67 -0
  51. package/dist/src/command-router/cc-handler.d.ts.map +1 -0
  52. package/dist/src/command-router/cc-handler.js +980 -0
  53. package/dist/src/command-router/cc-handler.js.map +1 -0
  54. package/dist/src/command-router/index.d.ts +3 -0
  55. package/dist/src/command-router/index.d.ts.map +1 -0
  56. package/dist/src/command-router/index.js +2 -0
  57. package/dist/src/command-router/index.js.map +1 -0
  58. package/dist/src/constants.d.ts +132 -0
  59. package/dist/src/constants.d.ts.map +1 -0
  60. package/dist/src/constants.js +140 -0
  61. package/dist/src/constants.js.map +1 -0
  62. package/dist/src/council/consensus.d.ts +21 -0
  63. package/dist/src/council/consensus.d.ts.map +1 -0
  64. package/dist/src/council/consensus.js +52 -0
  65. package/dist/src/council/consensus.js.map +1 -0
  66. package/dist/src/council/council.d.ts +68 -0
  67. package/dist/src/council/council.d.ts.map +1 -0
  68. package/dist/src/council/council.js +914 -0
  69. package/dist/src/council/council.js.map +1 -0
  70. package/dist/src/council/index.d.ts +3 -0
  71. package/dist/src/council/index.d.ts.map +1 -0
  72. package/dist/src/council/index.js +3 -0
  73. package/dist/src/council/index.js.map +1 -0
  74. package/dist/src/engines/base-oneshot-session.d.ts +88 -0
  75. package/dist/src/engines/base-oneshot-session.d.ts.map +1 -0
  76. package/dist/src/engines/base-oneshot-session.js +228 -0
  77. package/dist/src/engines/base-oneshot-session.js.map +1 -0
  78. package/dist/src/engines/index.d.ts +7 -0
  79. package/dist/src/engines/index.d.ts.map +1 -0
  80. package/dist/src/engines/index.js +7 -0
  81. package/dist/src/engines/index.js.map +1 -0
  82. package/dist/src/engines/persistent-codex-session.d.ts +17 -0
  83. package/dist/src/engines/persistent-codex-session.d.ts.map +1 -0
  84. package/dist/src/engines/persistent-codex-session.js +106 -0
  85. package/dist/src/engines/persistent-codex-session.js.map +1 -0
  86. package/dist/src/engines/persistent-cursor-session.d.ts +22 -0
  87. package/dist/src/engines/persistent-cursor-session.d.ts.map +1 -0
  88. package/dist/src/engines/persistent-cursor-session.js +242 -0
  89. package/dist/src/engines/persistent-cursor-session.js.map +1 -0
  90. package/dist/src/engines/persistent-custom-session.d.ts +79 -0
  91. package/dist/src/engines/persistent-custom-session.d.ts.map +1 -0
  92. package/dist/src/engines/persistent-custom-session.js +939 -0
  93. package/dist/src/engines/persistent-custom-session.js.map +1 -0
  94. package/dist/src/engines/persistent-gemini-session.d.ts +22 -0
  95. package/dist/src/engines/persistent-gemini-session.d.ts.map +1 -0
  96. package/dist/src/engines/persistent-gemini-session.js +217 -0
  97. package/dist/src/engines/persistent-gemini-session.js.map +1 -0
  98. package/dist/src/engines/persistent-session.d.ts +77 -0
  99. package/dist/src/engines/persistent-session.d.ts.map +1 -0
  100. package/dist/src/engines/persistent-session.js +730 -0
  101. package/dist/src/engines/persistent-session.js.map +1 -0
  102. package/dist/src/health/handler.d.ts +40 -0
  103. package/dist/src/health/handler.d.ts.map +1 -0
  104. package/dist/src/health/handler.js +70 -0
  105. package/dist/src/health/handler.js.map +1 -0
  106. package/dist/src/health/index.d.ts +2 -0
  107. package/dist/src/health/index.d.ts.map +1 -0
  108. package/dist/src/health/index.js +2 -0
  109. package/dist/src/health/index.js.map +1 -0
  110. package/dist/src/index.d.ts +49 -0
  111. package/dist/src/index.d.ts.map +1 -0
  112. package/dist/src/index.js +84 -0
  113. package/dist/src/index.js.map +1 -0
  114. package/dist/src/lib/auto-recovery.d.ts +45 -0
  115. package/dist/src/lib/auto-recovery.d.ts.map +1 -0
  116. package/dist/src/lib/auto-recovery.js +217 -0
  117. package/dist/src/lib/auto-recovery.js.map +1 -0
  118. package/dist/src/lib/cache-parity.d.ts +39 -0
  119. package/dist/src/lib/cache-parity.d.ts.map +1 -0
  120. package/dist/src/lib/cache-parity.js +92 -0
  121. package/dist/src/lib/cache-parity.js.map +1 -0
  122. package/dist/src/lib/circuit-breaker.d.ts +22 -0
  123. package/dist/src/lib/circuit-breaker.d.ts.map +1 -0
  124. package/dist/src/lib/circuit-breaker.js +47 -0
  125. package/dist/src/lib/circuit-breaker.js.map +1 -0
  126. package/dist/src/lib/config.d.ts +74 -0
  127. package/dist/src/lib/config.d.ts.map +1 -0
  128. package/dist/src/lib/config.js +244 -0
  129. package/dist/src/lib/config.js.map +1 -0
  130. package/dist/src/lib/drift-detector.d.ts +47 -0
  131. package/dist/src/lib/drift-detector.d.ts.map +1 -0
  132. package/dist/src/lib/drift-detector.js +192 -0
  133. package/dist/src/lib/drift-detector.js.map +1 -0
  134. package/dist/src/lib/error-formatter.d.ts +78 -0
  135. package/dist/src/lib/error-formatter.d.ts.map +1 -0
  136. package/dist/src/lib/error-formatter.js +149 -0
  137. package/dist/src/lib/error-formatter.js.map +1 -0
  138. package/dist/src/lib/heartbeat-workaround.d.ts +45 -0
  139. package/dist/src/lib/heartbeat-workaround.d.ts.map +1 -0
  140. package/dist/src/lib/heartbeat-workaround.js +61 -0
  141. package/dist/src/lib/heartbeat-workaround.js.map +1 -0
  142. package/dist/src/lib/index.d.ts +8 -0
  143. package/dist/src/lib/index.d.ts.map +1 -0
  144. package/dist/src/lib/index.js +8 -0
  145. package/dist/src/lib/index.js.map +1 -0
  146. package/dist/src/lib/register-guard.d.ts +49 -0
  147. package/dist/src/lib/register-guard.d.ts.map +1 -0
  148. package/dist/src/lib/register-guard.js +73 -0
  149. package/dist/src/lib/register-guard.js.map +1 -0
  150. package/dist/src/lib/route-flag.d.ts +50 -0
  151. package/dist/src/lib/route-flag.d.ts.map +1 -0
  152. package/dist/src/lib/route-flag.js +52 -0
  153. package/dist/src/lib/route-flag.js.map +1 -0
  154. package/dist/src/lib/sysprompt-strip.d.ts +54 -0
  155. package/dist/src/lib/sysprompt-strip.d.ts.map +1 -0
  156. package/dist/src/lib/sysprompt-strip.js +75 -0
  157. package/dist/src/lib/sysprompt-strip.js.map +1 -0
  158. package/dist/src/lib/telemetry.d.ts +39 -0
  159. package/dist/src/lib/telemetry.d.ts.map +1 -0
  160. package/dist/src/lib/telemetry.js +73 -0
  161. package/dist/src/lib/telemetry.js.map +1 -0
  162. package/dist/src/lib/test-mode.d.ts +27 -0
  163. package/dist/src/lib/test-mode.d.ts.map +1 -0
  164. package/dist/src/lib/test-mode.js +38 -0
  165. package/dist/src/lib/test-mode.js.map +1 -0
  166. package/dist/src/lib/vendor-paths.d.ts +15 -0
  167. package/dist/src/lib/vendor-paths.d.ts.map +1 -0
  168. package/dist/src/lib/vendor-paths.js +32 -0
  169. package/dist/src/lib/vendor-paths.js.map +1 -0
  170. package/dist/src/logger.d.ts +17 -0
  171. package/dist/src/logger.d.ts.map +1 -0
  172. package/dist/src/logger.js +46 -0
  173. package/dist/src/logger.js.map +1 -0
  174. package/dist/src/mcp/bridge.d.ts +22 -0
  175. package/dist/src/mcp/bridge.d.ts.map +1 -0
  176. package/dist/src/mcp/bridge.js +78 -0
  177. package/dist/src/mcp/bridge.js.map +1 -0
  178. package/dist/src/mcp/index.d.ts +3 -0
  179. package/dist/src/mcp/index.d.ts.map +1 -0
  180. package/dist/src/mcp/index.js +2 -0
  181. package/dist/src/mcp/index.js.map +1 -0
  182. package/dist/src/models.d.ts +70 -0
  183. package/dist/src/models.d.ts.map +1 -0
  184. package/dist/src/models.js +289 -0
  185. package/dist/src/models.js.map +1 -0
  186. package/dist/src/openai-compat/cli-stream-parser.d.ts +135 -0
  187. package/dist/src/openai-compat/cli-stream-parser.d.ts.map +1 -0
  188. package/dist/src/openai-compat/cli-stream-parser.js +195 -0
  189. package/dist/src/openai-compat/cli-stream-parser.js.map +1 -0
  190. package/dist/src/openai-compat/index.d.ts +2 -0
  191. package/dist/src/openai-compat/index.d.ts.map +1 -0
  192. package/dist/src/openai-compat/index.js +2 -0
  193. package/dist/src/openai-compat/index.js.map +1 -0
  194. package/dist/src/openai-compat/openai-compat.d.ts +281 -0
  195. package/dist/src/openai-compat/openai-compat.d.ts.map +1 -0
  196. package/dist/src/openai-compat/openai-compat.js +939 -0
  197. package/dist/src/openai-compat/openai-compat.js.map +1 -0
  198. package/dist/src/openai-compat/skill-resolver.d.ts +36 -0
  199. package/dist/src/openai-compat/skill-resolver.d.ts.map +1 -0
  200. package/dist/src/openai-compat/skill-resolver.js +134 -0
  201. package/dist/src/openai-compat/skill-resolver.js.map +1 -0
  202. package/dist/src/openai-compat/sse-translator.d.ts +32 -0
  203. package/dist/src/openai-compat/sse-translator.d.ts.map +1 -0
  204. package/dist/src/openai-compat/sse-translator.js +155 -0
  205. package/dist/src/openai-compat/sse-translator.js.map +1 -0
  206. package/dist/src/proxy/anthropic-adapter.d.ts +137 -0
  207. package/dist/src/proxy/anthropic-adapter.d.ts.map +1 -0
  208. package/dist/src/proxy/anthropic-adapter.js +392 -0
  209. package/dist/src/proxy/anthropic-adapter.js.map +1 -0
  210. package/dist/src/proxy/handler.d.ts +40 -0
  211. package/dist/src/proxy/handler.d.ts.map +1 -0
  212. package/dist/src/proxy/handler.js +378 -0
  213. package/dist/src/proxy/handler.js.map +1 -0
  214. package/dist/src/proxy/index.d.ts +5 -0
  215. package/dist/src/proxy/index.d.ts.map +1 -0
  216. package/dist/src/proxy/index.js +5 -0
  217. package/dist/src/proxy/index.js.map +1 -0
  218. package/dist/src/proxy/schema-cleaner.d.ts +12 -0
  219. package/dist/src/proxy/schema-cleaner.d.ts.map +1 -0
  220. package/dist/src/proxy/schema-cleaner.js +34 -0
  221. package/dist/src/proxy/schema-cleaner.js.map +1 -0
  222. package/dist/src/proxy/thought-cache.d.ts +20 -0
  223. package/dist/src/proxy/thought-cache.d.ts.map +1 -0
  224. package/dist/src/proxy/thought-cache.js +53 -0
  225. package/dist/src/proxy/thought-cache.js.map +1 -0
  226. package/dist/src/session/embedded-server.d.ts +26 -0
  227. package/dist/src/session/embedded-server.d.ts.map +1 -0
  228. package/dist/src/session/embedded-server.js +367 -0
  229. package/dist/src/session/embedded-server.js.map +1 -0
  230. package/dist/src/session/inbox-manager.d.ts +39 -0
  231. package/dist/src/session/inbox-manager.d.ts.map +1 -0
  232. package/dist/src/session/inbox-manager.js +111 -0
  233. package/dist/src/session/inbox-manager.js.map +1 -0
  234. package/dist/src/session/index.d.ts +4 -0
  235. package/dist/src/session/index.d.ts.map +1 -0
  236. package/dist/src/session/index.js +4 -0
  237. package/dist/src/session/index.js.map +1 -0
  238. package/dist/src/session/session-manager.d.ts +212 -0
  239. package/dist/src/session/session-manager.d.ts.map +1 -0
  240. package/dist/src/session/session-manager.js +1351 -0
  241. package/dist/src/session/session-manager.js.map +1 -0
  242. package/dist/src/session-bootstrap/cwd-patch.d.ts +51 -0
  243. package/dist/src/session-bootstrap/cwd-patch.d.ts.map +1 -0
  244. package/dist/src/session-bootstrap/cwd-patch.js +955 -0
  245. package/dist/src/session-bootstrap/cwd-patch.js.map +1 -0
  246. package/dist/src/session-bootstrap/index.d.ts +4 -0
  247. package/dist/src/session-bootstrap/index.d.ts.map +1 -0
  248. package/dist/src/session-bootstrap/index.js +4 -0
  249. package/dist/src/session-bootstrap/index.js.map +1 -0
  250. package/dist/src/session-bootstrap/sysprompt-strip.d.ts +26 -0
  251. package/dist/src/session-bootstrap/sysprompt-strip.d.ts.map +1 -0
  252. package/dist/src/session-bootstrap/sysprompt-strip.js +57 -0
  253. package/dist/src/session-bootstrap/sysprompt-strip.js.map +1 -0
  254. package/dist/src/session-bootstrap/think-conflict-resolver.d.ts +33 -0
  255. package/dist/src/session-bootstrap/think-conflict-resolver.d.ts.map +1 -0
  256. package/dist/src/session-bootstrap/think-conflict-resolver.js +234 -0
  257. package/dist/src/session-bootstrap/think-conflict-resolver.js.map +1 -0
  258. package/dist/src/types.d.ts +489 -0
  259. package/dist/src/types.d.ts.map +1 -0
  260. package/dist/src/types.js +8 -0
  261. package/dist/src/types.js.map +1 -0
  262. package/dist/src/validation.d.ts +32 -0
  263. package/dist/src/validation.d.ts.map +1 -0
  264. package/dist/src/validation.js +104 -0
  265. package/dist/src/validation.js.map +1 -0
  266. package/dist/tests/_helpers/subprocess-mock.d.ts +35 -0
  267. package/dist/tests/_helpers/subprocess-mock.d.ts.map +1 -0
  268. package/dist/tests/_helpers/subprocess-mock.js +136 -0
  269. package/dist/tests/_helpers/subprocess-mock.js.map +1 -0
  270. package/dist/tests/auto-recovery.test.d.ts +2 -0
  271. package/dist/tests/auto-recovery.test.d.ts.map +1 -0
  272. package/dist/tests/auto-recovery.test.js +189 -0
  273. package/dist/tests/auto-recovery.test.js.map +1 -0
  274. package/dist/tests/bench-harness.test.d.ts +2 -0
  275. package/dist/tests/bench-harness.test.d.ts.map +1 -0
  276. package/dist/tests/bench-harness.test.js +21 -0
  277. package/dist/tests/bench-harness.test.js.map +1 -0
  278. package/dist/tests/cache-parity.test.d.ts +2 -0
  279. package/dist/tests/cache-parity.test.d.ts.map +1 -0
  280. package/dist/tests/cache-parity.test.js +401 -0
  281. package/dist/tests/cache-parity.test.js.map +1 -0
  282. package/dist/tests/command-router.test.d.ts +2 -0
  283. package/dist/tests/command-router.test.d.ts.map +1 -0
  284. package/dist/tests/command-router.test.js +60 -0
  285. package/dist/tests/command-router.test.js.map +1 -0
  286. package/dist/tests/council.test.d.ts +2 -0
  287. package/dist/tests/council.test.d.ts.map +1 -0
  288. package/dist/tests/council.test.js +20 -0
  289. package/dist/tests/council.test.js.map +1 -0
  290. package/dist/tests/drift-detector.test.d.ts +2 -0
  291. package/dist/tests/drift-detector.test.d.ts.map +1 -0
  292. package/dist/tests/drift-detector.test.js +268 -0
  293. package/dist/tests/drift-detector.test.js.map +1 -0
  294. package/dist/tests/eager-bootstrap-gating.test.d.ts +9 -0
  295. package/dist/tests/eager-bootstrap-gating.test.d.ts.map +1 -0
  296. package/dist/tests/eager-bootstrap-gating.test.js +97 -0
  297. package/dist/tests/eager-bootstrap-gating.test.js.map +1 -0
  298. package/dist/tests/engines.test.d.ts +2 -0
  299. package/dist/tests/engines.test.d.ts.map +1 -0
  300. package/dist/tests/engines.test.js +8 -0
  301. package/dist/tests/engines.test.js.map +1 -0
  302. package/dist/tests/error-formatter.test.d.ts +2 -0
  303. package/dist/tests/error-formatter.test.d.ts.map +1 -0
  304. package/dist/tests/error-formatter.test.js +220 -0
  305. package/dist/tests/error-formatter.test.js.map +1 -0
  306. package/dist/tests/health.test.d.ts +2 -0
  307. package/dist/tests/health.test.d.ts.map +1 -0
  308. package/dist/tests/health.test.js +110 -0
  309. package/dist/tests/health.test.js.map +1 -0
  310. package/dist/tests/heartbeat-workaround.test.d.ts +2 -0
  311. package/dist/tests/heartbeat-workaround.test.d.ts.map +1 -0
  312. package/dist/tests/heartbeat-workaround.test.js +90 -0
  313. package/dist/tests/heartbeat-workaround.test.js.map +1 -0
  314. package/dist/tests/index.test.d.ts +2 -0
  315. package/dist/tests/index.test.d.ts.map +1 -0
  316. package/dist/tests/index.test.js +7 -0
  317. package/dist/tests/index.test.js.map +1 -0
  318. package/dist/tests/lib-sysprompt-strip.test.d.ts +2 -0
  319. package/dist/tests/lib-sysprompt-strip.test.d.ts.map +1 -0
  320. package/dist/tests/lib-sysprompt-strip.test.js +145 -0
  321. package/dist/tests/lib-sysprompt-strip.test.js.map +1 -0
  322. package/dist/tests/listener-activation.test.d.ts +2 -0
  323. package/dist/tests/listener-activation.test.d.ts.map +1 -0
  324. package/dist/tests/listener-activation.test.js +87 -0
  325. package/dist/tests/listener-activation.test.js.map +1 -0
  326. package/dist/tests/mcp-bridge.test.d.ts +2 -0
  327. package/dist/tests/mcp-bridge.test.d.ts.map +1 -0
  328. package/dist/tests/mcp-bridge.test.js +137 -0
  329. package/dist/tests/mcp-bridge.test.js.map +1 -0
  330. package/dist/tests/openai-compat.test.d.ts +2 -0
  331. package/dist/tests/openai-compat.test.d.ts.map +1 -0
  332. package/dist/tests/openai-compat.test.js +8 -0
  333. package/dist/tests/openai-compat.test.js.map +1 -0
  334. package/dist/tests/proxy-heartbeat-integration.test.d.ts +15 -0
  335. package/dist/tests/proxy-heartbeat-integration.test.d.ts.map +1 -0
  336. package/dist/tests/proxy-heartbeat-integration.test.js +122 -0
  337. package/dist/tests/proxy-heartbeat-integration.test.js.map +1 -0
  338. package/dist/tests/proxy.test.d.ts +2 -0
  339. package/dist/tests/proxy.test.d.ts.map +1 -0
  340. package/dist/tests/proxy.test.js +8 -0
  341. package/dist/tests/proxy.test.js.map +1 -0
  342. package/dist/tests/register-guard-stacking.test.d.ts +2 -0
  343. package/dist/tests/register-guard-stacking.test.d.ts.map +1 -0
  344. package/dist/tests/register-guard-stacking.test.js +61 -0
  345. package/dist/tests/register-guard-stacking.test.js.map +1 -0
  346. package/dist/tests/register-guard.test.d.ts +2 -0
  347. package/dist/tests/register-guard.test.d.ts.map +1 -0
  348. package/dist/tests/register-guard.test.js +129 -0
  349. package/dist/tests/register-guard.test.js.map +1 -0
  350. package/dist/tests/route-flag-rollback.test.d.ts +2 -0
  351. package/dist/tests/route-flag-rollback.test.d.ts.map +1 -0
  352. package/dist/tests/route-flag-rollback.test.js +70 -0
  353. package/dist/tests/route-flag-rollback.test.js.map +1 -0
  354. package/dist/tests/route-flag.test.d.ts +2 -0
  355. package/dist/tests/route-flag.test.d.ts.map +1 -0
  356. package/dist/tests/route-flag.test.js +101 -0
  357. package/dist/tests/route-flag.test.js.map +1 -0
  358. package/dist/tests/session-bootstrap.test.d.ts +2 -0
  359. package/dist/tests/session-bootstrap.test.d.ts.map +1 -0
  360. package/dist/tests/session-bootstrap.test.js +183 -0
  361. package/dist/tests/session-bootstrap.test.js.map +1 -0
  362. package/dist/tests/session.test.d.ts +2 -0
  363. package/dist/tests/session.test.d.ts.map +1 -0
  364. package/dist/tests/session.test.js +17 -0
  365. package/dist/tests/session.test.js.map +1 -0
  366. package/dist/tests/state-machine.test.d.ts +2 -0
  367. package/dist/tests/state-machine.test.d.ts.map +1 -0
  368. package/dist/tests/state-machine.test.js +133 -0
  369. package/dist/tests/state-machine.test.js.map +1 -0
  370. package/dist/tests/streaming/cli-stream-parser.test.d.ts +2 -0
  371. package/dist/tests/streaming/cli-stream-parser.test.d.ts.map +1 -0
  372. package/dist/tests/streaming/cli-stream-parser.test.js +233 -0
  373. package/dist/tests/streaming/cli-stream-parser.test.js.map +1 -0
  374. package/dist/tests/streaming/feature-flag.test.d.ts +14 -0
  375. package/dist/tests/streaming/feature-flag.test.d.ts.map +1 -0
  376. package/dist/tests/streaming/feature-flag.test.js +163 -0
  377. package/dist/tests/streaming/feature-flag.test.js.map +1 -0
  378. package/dist/tests/streaming/no-tools-prompt.test.d.ts +17 -0
  379. package/dist/tests/streaming/no-tools-prompt.test.d.ts.map +1 -0
  380. package/dist/tests/streaming/no-tools-prompt.test.js +229 -0
  381. package/dist/tests/streaming/no-tools-prompt.test.js.map +1 -0
  382. package/dist/tests/streaming/skill-plus-tools.test.d.ts +14 -0
  383. package/dist/tests/streaming/skill-plus-tools.test.d.ts.map +1 -0
  384. package/dist/tests/streaming/skill-plus-tools.test.js +234 -0
  385. package/dist/tests/streaming/skill-plus-tools.test.js.map +1 -0
  386. package/dist/tests/streaming/sse-translator.test.d.ts +2 -0
  387. package/dist/tests/streaming/sse-translator.test.d.ts.map +1 -0
  388. package/dist/tests/streaming/sse-translator.test.js +227 -0
  389. package/dist/tests/streaming/sse-translator.test.js.map +1 -0
  390. package/dist/tests/streaming/tool-result-roundtrip.test.d.ts +11 -0
  391. package/dist/tests/streaming/tool-result-roundtrip.test.d.ts.map +1 -0
  392. package/dist/tests/streaming/tool-result-roundtrip.test.js +215 -0
  393. package/dist/tests/streaming/tool-result-roundtrip.test.js.map +1 -0
  394. package/dist/tests/streaming/tool-use-translation.test.d.ts +10 -0
  395. package/dist/tests/streaming/tool-use-translation.test.d.ts.map +1 -0
  396. package/dist/tests/streaming/tool-use-translation.test.js +251 -0
  397. package/dist/tests/streaming/tool-use-translation.test.js.map +1 -0
  398. package/dist/tests/telegram-bridge.test.d.ts +2 -0
  399. package/dist/tests/telegram-bridge.test.d.ts.map +1 -0
  400. package/dist/tests/telegram-bridge.test.js +17 -0
  401. package/dist/tests/telegram-bridge.test.js.map +1 -0
  402. package/dist/tests/telegram-injector.test.d.ts +2 -0
  403. package/dist/tests/telegram-injector.test.d.ts.map +1 -0
  404. package/dist/tests/telegram-injector.test.js +74 -0
  405. package/dist/tests/telegram-injector.test.js.map +1 -0
  406. package/dist/tests/telemetry.test.d.ts +2 -0
  407. package/dist/tests/telemetry.test.d.ts.map +1 -0
  408. package/dist/tests/telemetry.test.js +405 -0
  409. package/dist/tests/telemetry.test.js.map +1 -0
  410. package/dist/tests/test-mode.test.d.ts +2 -0
  411. package/dist/tests/test-mode.test.d.ts.map +1 -0
  412. package/dist/tests/test-mode.test.js +39 -0
  413. package/dist/tests/test-mode.test.js.map +1 -0
  414. package/mcp-config.template.json +13 -0
  415. package/mcp-tools.json +1 -0
  416. package/openclaw-mcp-bridge.cjs +152 -0
  417. package/openclaw.plugin.json +30 -0
  418. package/package.json +45 -0
  419. package/skills/.gitkeep +0 -0
  420. package/stubs/commands-status-deps.runtime.js +10 -0
  421. package/stubs/status.runtime.js +149 -0
  422. package/vendor/base-oneshot-session.d.ts +87 -0
  423. package/vendor/base-oneshot-session.js +227 -0
  424. package/vendor/base-oneshot-session.js.map +1 -0
  425. package/vendor/circuit-breaker.d.ts +21 -0
  426. package/vendor/circuit-breaker.js +47 -0
  427. package/vendor/circuit-breaker.js.map +1 -0
  428. package/vendor/consensus.d.ts +20 -0
  429. package/vendor/consensus.js +52 -0
  430. package/vendor/consensus.js.map +1 -0
  431. package/vendor/constants.d.ts +130 -0
  432. package/vendor/constants.js +139 -0
  433. package/vendor/constants.js.map +1 -0
  434. package/vendor/council.d.ts +67 -0
  435. package/vendor/council.js +913 -0
  436. package/vendor/council.js.map +1 -0
  437. package/vendor/embedded-server.d.ts +25 -0
  438. package/vendor/embedded-server.js +360 -0
  439. package/vendor/embedded-server.js.map +1 -0
  440. package/vendor/inbox-manager.d.ts +38 -0
  441. package/vendor/inbox-manager.js +111 -0
  442. package/vendor/inbox-manager.js.map +1 -0
  443. package/vendor/index.d.ts +63 -0
  444. package/vendor/index.js +705 -0
  445. package/vendor/index.js.map +1 -0
  446. package/vendor/logger.d.ts +16 -0
  447. package/vendor/logger.js +44 -0
  448. package/vendor/logger.js.map +1 -0
  449. package/vendor/models.d.ts +69 -0
  450. package/vendor/models.js +289 -0
  451. package/vendor/models.js.map +1 -0
  452. package/vendor/openai-compat.d.ts +197 -0
  453. package/vendor/openai-compat.js +721 -0
  454. package/vendor/openai-compat.js.map +1 -0
  455. package/vendor/persistent-codex-session.d.ts +16 -0
  456. package/vendor/persistent-codex-session.js +105 -0
  457. package/vendor/persistent-codex-session.js.map +1 -0
  458. package/vendor/persistent-cursor-session.d.ts +21 -0
  459. package/vendor/persistent-cursor-session.js +241 -0
  460. package/vendor/persistent-cursor-session.js.map +1 -0
  461. package/vendor/persistent-custom-session.d.ts +78 -0
  462. package/vendor/persistent-custom-session.js +937 -0
  463. package/vendor/persistent-custom-session.js.map +1 -0
  464. package/vendor/persistent-gemini-session.d.ts +21 -0
  465. package/vendor/persistent-gemini-session.js +216 -0
  466. package/vendor/persistent-gemini-session.js.map +1 -0
  467. package/vendor/persistent-session.d.ts +74 -0
  468. package/vendor/persistent-session.js +684 -0
  469. package/vendor/persistent-session.js.map +1 -0
  470. package/vendor/proxy/anthropic-adapter.d.ts +136 -0
  471. package/vendor/proxy/anthropic-adapter.js +392 -0
  472. package/vendor/proxy/anthropic-adapter.js.map +1 -0
  473. package/vendor/proxy/handler.d.ts +39 -0
  474. package/vendor/proxy/handler.js +323 -0
  475. package/vendor/proxy/handler.js.map +1 -0
  476. package/vendor/proxy/schema-cleaner.d.ts +11 -0
  477. package/vendor/proxy/schema-cleaner.js +34 -0
  478. package/vendor/proxy/schema-cleaner.js.map +1 -0
  479. package/vendor/proxy/thought-cache.d.ts +19 -0
  480. package/vendor/proxy/thought-cache.js +53 -0
  481. package/vendor/proxy/thought-cache.js.map +1 -0
  482. package/vendor/session-manager.d.ts +211 -0
  483. package/vendor/session-manager.js +1345 -0
  484. package/vendor/session-manager.js.map +1 -0
  485. package/vendor/skill-resolver.js +107 -0
  486. package/vendor/types.d.ts +466 -0
  487. package/vendor/types.js +8 -0
  488. package/vendor/types.js.map +1 -0
  489. package/vendor/validation.d.ts +31 -0
  490. package/vendor/validation.js +104 -0
  491. package/vendor/validation.js.map +1 -0
@@ -0,0 +1,684 @@
1
+ /**
2
+ * Persistent Claude Code Session — wraps `claude` CLI via child_process.spawn
3
+ *
4
+ * Maintains a long-running Claude Code process with streaming JSON I/O.
5
+ * Enables multi-turn agent loops, continuous conversation, and real-time streaming.
6
+ */
7
+ import { spawn } from 'node:child_process';
8
+ import { EventEmitter } from 'node:events';
9
+ import * as readline from 'node:readline';
10
+ import * as fs from 'node:fs';
11
+ import * as path from 'node:path';
12
+ import { getModelPricing, } from './types.js';
13
+ import { resolveAlias, getContextWindow, isClaudeModel } from './models.js';
14
+ import { CONTEXT_HIGH_THRESHOLD, MAX_HISTORY_ITEMS, DEFAULT_HISTORY_LIMIT, SESSION_READY_TIMEOUT_MS, SESSION_READY_FALLBACK_MS, TURN_TIMEOUT_MS, COMPACT_TIMEOUT_MS, STOP_SIGKILL_DELAY_MS, SESSION_EVENT, } from './constants.js';
15
+ // ─── PersistentClaudeSession ─────────────────────────────────────────────────
16
+ export class PersistentClaudeSession extends EventEmitter {
17
+ options;
18
+ claudeBin;
19
+ proc = null;
20
+ _rl = null;
21
+ _isReady = false;
22
+ _isPaused = false;
23
+ _isBusy = false;
24
+ currentRequestId = 0;
25
+ _streamCallbacks = null;
26
+ _contextHighFired = false;
27
+ _realModel = null;
28
+ sessionId;
29
+ stats;
30
+ constructor(config, claudeBin) {
31
+ super();
32
+ this.claudeBin = claudeBin || process.env.CLAUDE_BIN || 'claude';
33
+ this.options = {
34
+ ...config,
35
+ permissionMode: config.permissionMode || 'acceptEdits',
36
+ hooks: {},
37
+ modelOverrides: config.modelOverrides || {},
38
+ };
39
+ this.stats = {
40
+ turns: 0,
41
+ toolCalls: 0,
42
+ toolErrors: 0,
43
+ tokensIn: 0,
44
+ tokensOut: 0,
45
+ cachedTokens: 0,
46
+ costUsd: 0,
47
+ startTime: null,
48
+ lastActivity: null,
49
+ history: [],
50
+ };
51
+ }
52
+ get pid() {
53
+ return this.proc?.pid ?? undefined;
54
+ }
55
+ get isReady() {
56
+ return this._isReady;
57
+ }
58
+ get isPaused() {
59
+ return this._isPaused;
60
+ }
61
+ get isBusy() {
62
+ return this._isBusy;
63
+ }
64
+ // ─── Start ───────────────────────────────────────────────────────────────
65
+ async start() {
66
+ const resolvedBin = this.claudeBin;
67
+ const args = [
68
+ '-p',
69
+ '--input-format',
70
+ 'stream-json',
71
+ '--output-format',
72
+ 'stream-json',
73
+ '--replay-user-messages',
74
+ '--verbose',
75
+ '--include-partial-messages',
76
+ '--permission-mode',
77
+ this.options.permissionMode || 'acceptEdits',
78
+ ];
79
+ // Model alias resolution
80
+ if (this.options.model) {
81
+ const resolved = this.resolveModel(this.options.model);
82
+ if (resolved !== this.options.model)
83
+ this.options.model = resolved;
84
+ }
85
+ // Resume / fork
86
+ const resumeId = this.options.claudeResumeId || this.options.resumeSessionId;
87
+ if (resumeId) {
88
+ args.push('--resume', resumeId);
89
+ if (this.options.forkSession)
90
+ args.push('--fork-session');
91
+ }
92
+ if (this.options.customSessionId)
93
+ args.push('--session-id', this.options.customSessionId);
94
+ // Model — proxy mode mapping
95
+ if (this.options.model) {
96
+ if (!isClaudeModel(this.options.model) && this.options.baseUrl) {
97
+ this._realModel = this.options.model;
98
+ args.push('--model', 'opus');
99
+ }
100
+ else {
101
+ const cliModel = this.options.model.includes('/') ? this.options.model.split('/').pop() : this.options.model;
102
+ args.push('--model', cliModel);
103
+ }
104
+ }
105
+ // Tool control
106
+ if (this.options.allowedTools?.length)
107
+ args.push('--allowed-tools', this.options.allowedTools.join(','));
108
+ if (this.options.disallowedTools?.length)
109
+ args.push('--disallowed-tools', this.options.disallowedTools.join(','));
110
+ if (this.options.tools !== undefined && this.options.tools !== null) {
111
+ const t = Array.isArray(this.options.tools) ? this.options.tools.join(',') : this.options.tools;
112
+ args.push('--tools', t);
113
+ }
114
+ // System prompts
115
+ if (this.options.systemPrompt)
116
+ args.push('--system-prompt', this.options.systemPrompt);
117
+ if (this.options.appendSystemPrompt)
118
+ args.push('--append-system-prompt', this.options.appendSystemPrompt);
119
+ // Limits
120
+ if (this.options.maxTurns)
121
+ args.push('--max-turns', String(this.options.maxTurns));
122
+ if (this.options.maxBudgetUsd)
123
+ args.push('--max-budget-usd', String(this.options.maxBudgetUsd));
124
+ // Permissions
125
+ if (this.options.dangerouslySkipPermissions)
126
+ args.push('--dangerously-skip-permissions');
127
+ // Agents
128
+ if (this.options.agents) {
129
+ const json = typeof this.options.agents === 'string' ? this.options.agents : JSON.stringify(this.options.agents);
130
+ args.push('--agents', json);
131
+ }
132
+ if (this.options.agent)
133
+ args.push('--agent', this.options.agent);
134
+ // Directories
135
+ if (this.options.addDir?.length) {
136
+ for (const dir of this.options.addDir)
137
+ args.push('--add-dir', dir);
138
+ }
139
+ // Effort
140
+ if (this.options.effort && this.options.effort !== 'auto')
141
+ args.push('--effort', this.options.effort);
142
+ // Auto mode
143
+ if (this.options.enableAutoMode || this.options.permissionMode === 'auto')
144
+ args.push('--enable-auto-mode');
145
+ // Session name
146
+ if (this.options.sessionName)
147
+ args.push('-n', this.options.sessionName);
148
+ // New CLI flags
149
+ if (this.options.bare)
150
+ args.push('--bare');
151
+ if (this.options.worktree) {
152
+ args.push('--worktree');
153
+ if (typeof this.options.worktree === 'string' && this.options.worktree !== 'true')
154
+ args.push(this.options.worktree);
155
+ }
156
+ if (this.options.fallbackModel)
157
+ args.push('--fallback-model', this.options.fallbackModel);
158
+ if (this.options.jsonSchema)
159
+ args.push('--json-schema', this.options.jsonSchema);
160
+ if (this.options.mcpConfig) {
161
+ const configs = Array.isArray(this.options.mcpConfig) ? this.options.mcpConfig : [this.options.mcpConfig];
162
+ for (const c of configs)
163
+ args.push('--mcp-config', c);
164
+ }
165
+ if (this.options.settings)
166
+ args.push('--settings', this.options.settings);
167
+ if (this.options.noSessionPersistence)
168
+ args.push('--no-session-persistence');
169
+ if (this.options.betas) {
170
+ const bl = Array.isArray(this.options.betas) ? this.options.betas : this.options.betas.split(',');
171
+ for (const b of bl)
172
+ args.push('--betas', b.trim());
173
+ }
174
+ // Ensure CWD exists (normalize to prevent path traversal)
175
+ if (this.options.cwd) {
176
+ this.options.cwd = path.resolve(this.options.cwd);
177
+ if (!fs.existsSync(this.options.cwd)) {
178
+ fs.mkdirSync(this.options.cwd, { recursive: true });
179
+ }
180
+ }
181
+ // Build spawn environment
182
+ // Preserve the parent process PATH so the resolved binary and any PATH-relative
183
+ // tools (git, node, npm, etc.) remain accessible on all platforms and distros.
184
+ const spawnEnv = {
185
+ ...process.env,
186
+ PATH: process.env.PATH || '/usr/local/bin:/usr/bin:/bin',
187
+ };
188
+ if (this.options.baseUrl)
189
+ spawnEnv.ANTHROPIC_BASE_URL = this.options.baseUrl;
190
+ if (this.options.enableAgentTeams)
191
+ spawnEnv.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS = 'true';
192
+ if (this._realModel && this.options.baseUrl) {
193
+ const base = this.options.baseUrl.replace(/\/$/, '');
194
+ spawnEnv.ANTHROPIC_BASE_URL = `${base}/real/${this._realModel}`;
195
+ }
196
+ // Spawn
197
+ this.proc = spawn(resolvedBin, args, {
198
+ cwd: this.options.cwd,
199
+ env: spawnEnv,
200
+ stdio: ['pipe', 'pipe', 'pipe'],
201
+ detached: true,
202
+ });
203
+ // Unref so the parent process can exit independently of the child.
204
+ this.proc.unref();
205
+ // Parse stdout line-by-line
206
+ this._rl = readline.createInterface({ input: this.proc.stdout, crlfDelay: Infinity });
207
+ this._rl.on('line', (line) => {
208
+ if (!line.trim())
209
+ return;
210
+ try {
211
+ const event = JSON.parse(line);
212
+ this._handleEvent(event);
213
+ }
214
+ catch {
215
+ this.emit(SESSION_EVENT.LOG, `[stdout] ${line}`);
216
+ }
217
+ });
218
+ this.proc.stderr?.on('data', (data) => {
219
+ const sanitized = data
220
+ .toString()
221
+ .replace(/sk-[a-zA-Z0-9_-]{10,}/g, 'sk-***')
222
+ .replace(/ANTHROPIC_API_KEY=[^\s]+/g, 'ANTHROPIC_API_KEY=***')
223
+ .replace(/OPENAI_API_KEY=[^\s]+/g, 'OPENAI_API_KEY=***')
224
+ .replace(/GEMINI_API_KEY=[^\s]+/g, 'GEMINI_API_KEY=***')
225
+ .replace(/Bearer [a-zA-Z0-9_-]+/g, 'Bearer ***');
226
+ this.emit(SESSION_EVENT.LOG, `[stderr] ${sanitized}`);
227
+ });
228
+ this.proc.on('close', (code) => {
229
+ this._isReady = false;
230
+ this.emit(SESSION_EVENT.CLOSE, code);
231
+ });
232
+ this.proc.on('error', (err) => {
233
+ this.emit(SESSION_EVENT.ERROR, err);
234
+ });
235
+ // Wait for ready
236
+ return new Promise((resolve, reject) => {
237
+ const timeout = setTimeout(() => reject(new Error('Timeout waiting for session ready')), SESSION_READY_TIMEOUT_MS);
238
+ this.once(SESSION_EVENT.READY, () => {
239
+ clearTimeout(timeout);
240
+ resolve(this);
241
+ });
242
+ this.once(SESSION_EVENT.ERROR, (err) => {
243
+ clearTimeout(timeout);
244
+ reject(err);
245
+ });
246
+ // Detect premature CLI exit to avoid hanging or marking a dead process as "ready".
247
+ const onCloseBeforeReady = (code) => {
248
+ if (!this._isReady) {
249
+ clearTimeout(timeout);
250
+ reject(new Error(`Claude process exited prematurely with code ${code}. Session failed to start.`));
251
+ }
252
+ };
253
+ this.once(SESSION_EVENT.CLOSE, onCloseBeforeReady);
254
+ // Emit ready on the first `system` init event from the CLI.
255
+ // Fall back to a 2 s timer in case the CLI version doesn't emit one.
256
+ const onInit = () => {
257
+ if (!this._isReady) {
258
+ this._isReady = true;
259
+ // Cleanup the early-close listener since initialization succeeded
260
+ this.removeListener(SESSION_EVENT.CLOSE, onCloseBeforeReady);
261
+ this.emit(SESSION_EVENT.READY);
262
+ }
263
+ };
264
+ this.once(SESSION_EVENT.INIT, onInit);
265
+ setTimeout(() => {
266
+ this.removeListener(SESSION_EVENT.INIT, onInit);
267
+ // If process already exited, reject instead of falsely marking ready
268
+ if (this.proc?.killed || this.proc?.exitCode !== null) {
269
+ clearTimeout(timeout);
270
+ this.removeListener(SESSION_EVENT.CLOSE, onCloseBeforeReady);
271
+ reject(new Error('Claude CLI process crashed immediately upon startup. Fallback timer aborted.'));
272
+ return;
273
+ }
274
+ if (!this._isReady) {
275
+ this._isReady = true;
276
+ this.removeListener(SESSION_EVENT.CLOSE, onCloseBeforeReady);
277
+ this.emit(SESSION_EVENT.READY);
278
+ }
279
+ }, SESSION_READY_FALLBACK_MS);
280
+ });
281
+ }
282
+ // ─── Event Handling ──────────────────────────────────────────────────────
283
+ _handleEvent(event) {
284
+ const type = event.type;
285
+ this.stats.lastActivity = new Date().toISOString();
286
+ // Track history (keep last 100)
287
+ this.stats.history.push({ time: this.stats.lastActivity, type, event });
288
+ if (this.stats.history.length > MAX_HISTORY_ITEMS)
289
+ this.stats.history.shift();
290
+ switch (type) {
291
+ case 'system':
292
+ if (event.subtype === 'init') {
293
+ this.sessionId = event.session_id;
294
+ this.stats.startTime = new Date().toISOString();
295
+ this.emit(SESSION_EVENT.INIT, event);
296
+ }
297
+ this.emit(SESSION_EVENT.SYSTEM, event);
298
+ break;
299
+ case 'stream_event': {
300
+ const inner = event.event;
301
+ if (!inner)
302
+ break;
303
+ const innerType = inner.type;
304
+ if (innerType === 'content_block_start') {
305
+ const block = inner.content_block;
306
+ if (block?.type === 'tool_use') {
307
+ this.stats.toolCalls++;
308
+ const toolEvent = { tool: { name: block.name, input: {} } };
309
+ try {
310
+ this._streamCallbacks?.onToolUse?.(toolEvent);
311
+ }
312
+ catch (err) {
313
+ this.emit(SESSION_EVENT.LOG, `[stream callback error] onToolUse: ${err.message}`);
314
+ }
315
+ this.emit(SESSION_EVENT.TOOL_USE, toolEvent);
316
+ }
317
+ }
318
+ else if (innerType === 'content_block_delta') {
319
+ const delta = inner.delta;
320
+ if (delta?.type === 'text_delta' && delta.text) {
321
+ try {
322
+ this._streamCallbacks?.onText?.(delta.text);
323
+ }
324
+ catch (err) {
325
+ this.emit(SESSION_EVENT.LOG, `[stream callback error] onText: ${err.message}`);
326
+ }
327
+ this.emit(SESSION_EVENT.TEXT, delta.text);
328
+ }
329
+ }
330
+ else if (innerType === 'message_delta') {
331
+ const usage = inner.usage;
332
+ if (usage) {
333
+ this.stats.tokensIn += usage.input_tokens || 0;
334
+ this.stats.tokensOut += usage.output_tokens || 0;
335
+ this.stats.cachedTokens += usage.cache_read_input_tokens || 0;
336
+ this._updateCost();
337
+ }
338
+ }
339
+ this.emit(SESSION_EVENT.STREAM_EVENT, event);
340
+ break;
341
+ }
342
+ case 'user':
343
+ this.stats.turns++;
344
+ this.emit(SESSION_EVENT.USER_ECHO, event);
345
+ break;
346
+ case 'assistant':
347
+ this.emit(SESSION_EVENT.ASSISTANT, event);
348
+ if (event.message?.content && Array.isArray(event.message.content)) {
349
+ for (const block of event.message.content) {
350
+ if (block.type === 'tool_use') {
351
+ this.stats.toolCalls++;
352
+ const toolEvent = {
353
+ tool: {
354
+ name: block.name,
355
+ input: block.input || {},
356
+ },
357
+ };
358
+ try {
359
+ this._streamCallbacks?.onToolUse?.(toolEvent);
360
+ }
361
+ catch (err) {
362
+ this.emit(SESSION_EVENT.LOG, `[stream callback error] onToolUse: ${err.message}`);
363
+ }
364
+ this.emit(SESSION_EVENT.TOOL_USE, toolEvent);
365
+ }
366
+ }
367
+ }
368
+ break;
369
+ case 'tool_use':
370
+ this.stats.toolCalls++;
371
+ try {
372
+ this._streamCallbacks?.onToolUse?.(event);
373
+ }
374
+ catch (err) {
375
+ this.emit(SESSION_EVENT.LOG, `[stream callback error] onToolUse: ${err.message}`);
376
+ }
377
+ this.emit(SESSION_EVENT.TOOL_USE, event);
378
+ break;
379
+ case 'tool_result':
380
+ try {
381
+ this._streamCallbacks?.onToolResult?.(event);
382
+ }
383
+ catch (err) {
384
+ this.emit(SESSION_EVENT.LOG, `[stream callback error] onToolResult: ${err.message}`);
385
+ }
386
+ if (event.is_error || event.error) {
387
+ this.stats.toolErrors++;
388
+ this._fireHook('onToolError', {
389
+ tool: event.tool_use_id,
390
+ error: event.error,
391
+ });
392
+ }
393
+ this.emit(SESSION_EVENT.TOOL_RESULT, event);
394
+ break;
395
+ case 'error':
396
+ this.emit(SESSION_EVENT.ERROR, new Error(String(event.error) || JSON.stringify(event)));
397
+ break;
398
+ case 'result': {
399
+ const usage = event.usage;
400
+ if (usage) {
401
+ this.stats.tokensIn += usage.input_tokens || 0;
402
+ this.stats.tokensOut += usage.output_tokens || 0;
403
+ this.stats.cachedTokens += usage.cache_read_input_tokens || 0;
404
+ this._updateCost();
405
+ }
406
+ this.emit(SESSION_EVENT.RESULT, event);
407
+ this.emit(SESSION_EVENT.TURN_COMPLETE, event);
408
+ this._fireHook('onTurnComplete', {
409
+ text: event.result,
410
+ usage,
411
+ stopReason: event.stop_reason,
412
+ });
413
+ const totalTokens = this.stats.tokensIn + this.stats.tokensOut;
414
+ if (totalTokens > CONTEXT_HIGH_THRESHOLD && !this._contextHighFired) {
415
+ this._contextHighFired = true;
416
+ this._fireHook('onContextHigh', { tokensUsed: totalTokens, threshold: CONTEXT_HIGH_THRESHOLD });
417
+ }
418
+ const stopReason = event.stop_reason;
419
+ if (stopReason === 'error' || stopReason === 'rate_limit') {
420
+ this._fireHook('onStopFailure', { reason: stopReason, error: event.error });
421
+ }
422
+ break;
423
+ }
424
+ default:
425
+ this.emit(SESSION_EVENT.EVENT, event);
426
+ }
427
+ }
428
+ // ─── Send ────────────────────────────────────────────────────────────────
429
+ async send(message, options = {}) {
430
+ if (!this._isReady || !this.proc)
431
+ throw new Error('Session not ready. Call start() first.');
432
+ const requestId = ++this.currentRequestId;
433
+ let finalMessage = typeof message === 'string' ? message : message;
434
+ if (typeof finalMessage === 'string') {
435
+ if (options.effort === 'high' || options.effort === 'max') {
436
+ finalMessage = `ultrathink\n\n${finalMessage}`;
437
+ }
438
+ if (options.plan) {
439
+ finalMessage = `/plan ${finalMessage}`;
440
+ }
441
+ }
442
+ const payload = {
443
+ type: 'user',
444
+ message: {
445
+ role: 'user',
446
+ content: typeof finalMessage === 'string' ? [{ type: 'text', text: finalMessage }] : finalMessage,
447
+ },
448
+ };
449
+ this.proc.stdin.write(JSON.stringify(payload) + '\n');
450
+ if (options.callbacks)
451
+ this._streamCallbacks = options.callbacks;
452
+ if (options.waitForComplete) {
453
+ this._isBusy = true;
454
+ try {
455
+ return await this._waitForTurnComplete(options.timeout || TURN_TIMEOUT_MS);
456
+ }
457
+ finally {
458
+ this._isBusy = false;
459
+ if (options.callbacks)
460
+ this._streamCallbacks = null;
461
+ }
462
+ }
463
+ return { requestId, sent: true };
464
+ }
465
+ // ─── Wait for Turn Complete ──────────────────────────────────────────────
466
+ _waitForTurnComplete(timeout) {
467
+ return new Promise((resolve, reject) => {
468
+ let settled = false;
469
+ let streamedText = '';
470
+ let allAssistantText = '';
471
+ const toolNames = [];
472
+ const onText = (chunk) => {
473
+ streamedText += chunk;
474
+ };
475
+ this.on(SESSION_EVENT.TEXT, onText);
476
+ const onAssistant = (event) => {
477
+ if (event.message?.content && Array.isArray(event.message.content)) {
478
+ for (const block of event.message.content) {
479
+ if (block.type === 'text' && block.text)
480
+ allAssistantText += block.text + '\n';
481
+ }
482
+ }
483
+ };
484
+ this.on(SESSION_EVENT.ASSISTANT, onAssistant);
485
+ const onToolUse = (event) => {
486
+ const tool = event.tool;
487
+ toolNames.push(tool?.name || event.name || 'unknown');
488
+ };
489
+ this.on(SESSION_EVENT.TOOL_USE, onToolUse);
490
+ const cleanup = () => {
491
+ clearTimeout(timer);
492
+ this.removeListener(SESSION_EVENT.TEXT, onText);
493
+ this.removeListener(SESSION_EVENT.ASSISTANT, onAssistant);
494
+ this.removeListener(SESSION_EVENT.TOOL_USE, onToolUse);
495
+ this.removeListener(SESSION_EVENT.TURN_COMPLETE, onTurnComplete);
496
+ this.removeListener(SESSION_EVENT.ERROR, onError);
497
+ this.removeListener(SESSION_EVENT.CLOSE, onClose);
498
+ };
499
+ const timer = setTimeout(() => {
500
+ if (settled)
501
+ return;
502
+ settled = true;
503
+ cleanup();
504
+ reject(new Error('Timeout waiting for response'));
505
+ }, timeout);
506
+ const onTurnComplete = (event) => {
507
+ if (settled)
508
+ return;
509
+ settled = true;
510
+ cleanup();
511
+ let text = event.result || streamedText || allAssistantText.trim() || '';
512
+ if (!text && toolNames.length > 0) {
513
+ const unique = [...new Set(toolNames)];
514
+ text = `[Agent completed ${toolNames.length} tool calls: ${unique.join(', ')}]`;
515
+ }
516
+ resolve({ text, event });
517
+ };
518
+ const onError = (err) => {
519
+ if (settled)
520
+ return;
521
+ settled = true;
522
+ cleanup();
523
+ reject(err);
524
+ };
525
+ const onClose = (code) => {
526
+ if (settled)
527
+ return;
528
+ settled = true;
529
+ cleanup();
530
+ const text = streamedText || allAssistantText.trim() || '';
531
+ resolve({
532
+ text,
533
+ event: {
534
+ type: 'result',
535
+ result: text,
536
+ stop_reason: 'process_exit',
537
+ exit_code: code,
538
+ },
539
+ });
540
+ };
541
+ this.once(SESSION_EVENT.TURN_COMPLETE, onTurnComplete);
542
+ this.once(SESSION_EVENT.ERROR, onError);
543
+ this.once(SESSION_EVENT.CLOSE, onClose);
544
+ });
545
+ }
546
+ // ─── Utilities ───────────────────────────────────────────────────────────
547
+ getStats() {
548
+ return {
549
+ turns: this.stats.turns,
550
+ toolCalls: this.stats.toolCalls,
551
+ toolErrors: this.stats.toolErrors,
552
+ tokensIn: this.stats.tokensIn,
553
+ tokensOut: this.stats.tokensOut,
554
+ cachedTokens: this.stats.cachedTokens,
555
+ costUsd: Math.round(this.stats.costUsd * 10000) / 10000,
556
+ isReady: this._isReady,
557
+ startTime: this.stats.startTime,
558
+ lastActivity: this.stats.lastActivity,
559
+ // Approximate context window utilization based on model's known window size.
560
+ // Claude Code doesn't expose exact context usage via the JSON protocol,
561
+ // so this is a best-effort heuristic. May overcount because cumulative
562
+ // token counts include the full conversation history replayed each turn.
563
+ contextPercent: Math.min(100, Math.round(((this.stats.tokensIn + this.stats.tokensOut) /
564
+ getContextWindow(this.options.resolvedModel || this.options.model || 'claude-sonnet-4-6')) *
565
+ 100)),
566
+ sessionId: this.sessionId,
567
+ uptime: this.stats.startTime ? Math.round((Date.now() - new Date(this.stats.startTime).getTime()) / 1000) : 0,
568
+ };
569
+ }
570
+ getHistory(limit = DEFAULT_HISTORY_LIMIT) {
571
+ return this.stats.history.slice(-limit);
572
+ }
573
+ async compact(summary) {
574
+ const msg = summary ? `/compact ${summary}` : '/compact';
575
+ return this.send(msg, { waitForComplete: true, timeout: COMPACT_TIMEOUT_MS });
576
+ }
577
+ getEffort() {
578
+ return this.options.effort || 'auto';
579
+ }
580
+ setEffort(level) {
581
+ this.options.effort = level;
582
+ }
583
+ getCost() {
584
+ const pricing = getModelPricing(this.options.model);
585
+ const nonCachedIn = Math.max(0, this.stats.tokensIn - this.stats.cachedTokens);
586
+ return {
587
+ model: this.options.model || 'default',
588
+ tokensIn: this.stats.tokensIn,
589
+ tokensOut: this.stats.tokensOut,
590
+ cachedTokens: this.stats.cachedTokens,
591
+ pricing: { inputPer1M: pricing.input, outputPer1M: pricing.output, cachedPer1M: pricing.cached },
592
+ breakdown: {
593
+ inputCost: (nonCachedIn / 1_000_000) * pricing.input,
594
+ cachedCost: (this.stats.cachedTokens / 1_000_000) * (pricing.cached ?? 0),
595
+ outputCost: (this.stats.tokensOut / 1_000_000) * pricing.output,
596
+ },
597
+ totalUsd: this.stats.costUsd,
598
+ };
599
+ }
600
+ resolveModel(alias) {
601
+ if (this.options.modelOverrides?.[alias])
602
+ return this.options.modelOverrides[alias];
603
+ return resolveAlias(alias);
604
+ }
605
+ pause() {
606
+ this._isPaused = true;
607
+ this.emit(SESSION_EVENT.PAUSED, { sessionId: this.sessionId });
608
+ }
609
+ resume() {
610
+ this._isPaused = false;
611
+ this.emit(SESSION_EVENT.RESUMED, { sessionId: this.sessionId });
612
+ }
613
+ stop() {
614
+ this._fireHook('onStop', { cost: this.getCost(), stats: this.getStats() });
615
+ if (this._rl) {
616
+ this._rl.close();
617
+ this._rl = null;
618
+ }
619
+ if (this.proc) {
620
+ const pid = this.proc.pid;
621
+ this.proc.stdin?.end();
622
+ this.proc.stdout?.destroy();
623
+ this.proc.stderr?.destroy();
624
+ try {
625
+ process.kill(-pid, 'SIGTERM');
626
+ }
627
+ catch (err) {
628
+ if (err.code !== 'ESRCH') {
629
+ this.emit(SESSION_EVENT.LOG, `[stop] kill(-${pid}, SIGTERM) failed: ${err.message}`);
630
+ }
631
+ try {
632
+ this.proc.kill('SIGTERM');
633
+ }
634
+ catch (innerErr) {
635
+ if (innerErr.code !== 'ESRCH') {
636
+ this.emit(SESSION_EVENT.LOG, `[stop] proc.kill(SIGTERM) failed: ${innerErr.message}`);
637
+ }
638
+ }
639
+ }
640
+ const p = this.proc;
641
+ setTimeout(() => {
642
+ try {
643
+ process.kill(-pid, 'SIGKILL');
644
+ }
645
+ catch {
646
+ /* ESRCH expected — process already gone */
647
+ }
648
+ try {
649
+ p.kill('SIGKILL');
650
+ }
651
+ catch {
652
+ /* ESRCH expected */
653
+ }
654
+ }, STOP_SIGKILL_DELAY_MS);
655
+ this.proc = null;
656
+ }
657
+ this._isReady = false;
658
+ this._isPaused = false;
659
+ this.emit(SESSION_EVENT.CLOSE, 143);
660
+ }
661
+ // ─── Private ─────────────────────────────────────────────────────────────
662
+ _updateCost() {
663
+ const pricing = getModelPricing(this.options.model);
664
+ const nonCachedIn = Math.max(0, this.stats.tokensIn - this.stats.cachedTokens);
665
+ this.stats.costUsd =
666
+ (nonCachedIn / 1_000_000) * pricing.input +
667
+ (this.stats.cachedTokens / 1_000_000) * (pricing.cached ?? 0) +
668
+ (this.stats.tokensOut / 1_000_000) * pricing.output;
669
+ }
670
+ _fireHook(hookName, data) {
671
+ const hooks = this.options.hooks;
672
+ const hook = hooks?.[hookName];
673
+ if (typeof hook === 'function') {
674
+ try {
675
+ hook(data);
676
+ }
677
+ catch (err) {
678
+ this.emit(SESSION_EVENT.LOG, `[hook error] ${hookName}: ${err.message}`);
679
+ }
680
+ }
681
+ this.emit(`hook:${hookName}`, data);
682
+ }
683
+ }
684
+ //# sourceMappingURL=persistent-session.js.map