@a1hvdy/cc-openclaw 0.8.0 → 0.9.1

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 (288) hide show
  1. package/dist/scripts/bench/ab-harness.d.ts +58 -0
  2. package/dist/scripts/bench/ab-harness.d.ts.map +1 -0
  3. package/dist/scripts/bench/ab-harness.js +78 -0
  4. package/dist/scripts/bench/ab-harness.js.map +1 -0
  5. package/dist/src/channels/adapter.d.ts.map +1 -0
  6. package/dist/src/channels/telegram/completion-summary.d.ts.map +1 -0
  7. package/dist/src/channels/telegram/error-renderer.d.ts.map +1 -0
  8. package/dist/src/channels/telegram/event-reducer.d.ts.map +1 -0
  9. package/dist/src/channels/telegram/index.d.ts.map +1 -0
  10. package/dist/src/channels/telegram/injector.d.ts.map +1 -0
  11. package/dist/src/channels/telegram/live-card.d.ts.map +1 -0
  12. package/dist/src/channels/telegram/state-machine.d.ts.map +1 -0
  13. package/dist/src/channels/telegram/tool-tracker.d.ts.map +1 -0
  14. package/dist/src/command-router/cc-handler.d.ts.map +1 -0
  15. package/dist/src/command-router/index.d.ts.map +1 -0
  16. package/dist/src/constants.d.ts.map +1 -0
  17. package/dist/src/council/consensus.d.ts.map +1 -0
  18. package/dist/src/council/council.d.ts.map +1 -0
  19. package/dist/src/council/index.d.ts.map +1 -0
  20. package/dist/src/engines/base-oneshot-session.d.ts.map +1 -0
  21. package/dist/src/engines/index.d.ts.map +1 -0
  22. package/dist/src/engines/persistent-codex-session.d.ts.map +1 -0
  23. package/dist/src/engines/persistent-cursor-session.d.ts.map +1 -0
  24. package/dist/src/engines/persistent-custom-session.d.ts.map +1 -0
  25. package/dist/src/engines/persistent-gemini-session.d.ts.map +1 -0
  26. package/dist/src/engines/persistent-session.d.ts.map +1 -0
  27. package/dist/src/health/handler.d.ts.map +1 -0
  28. package/dist/src/health/index.d.ts.map +1 -0
  29. package/dist/src/index.d.ts +10 -1
  30. package/dist/src/index.d.ts.map +1 -0
  31. package/dist/src/index.js +47 -7
  32. package/dist/src/index.js.map +1 -1
  33. package/dist/src/lib/auto-recovery.d.ts.map +1 -0
  34. package/dist/src/lib/cache-parity.d.ts.map +1 -0
  35. package/dist/src/lib/circuit-breaker.d.ts.map +1 -0
  36. package/dist/src/lib/config-service.d.ts +106 -0
  37. package/dist/src/lib/config-service.js +217 -0
  38. package/dist/src/lib/config-service.js.map +1 -0
  39. package/dist/src/lib/config.d.ts +33 -14
  40. package/dist/src/lib/config.d.ts.map +1 -0
  41. package/dist/src/lib/config.js +147 -34
  42. package/dist/src/lib/config.js.map +1 -1
  43. package/dist/src/lib/debug-tap.d.ts.map +1 -0
  44. package/dist/src/lib/drift-detector.d.ts.map +1 -0
  45. package/dist/src/lib/error-formatter.d.ts.map +1 -0
  46. package/dist/src/lib/heartbeat-workaround.d.ts.map +1 -0
  47. package/dist/src/lib/index.d.ts +1 -1
  48. package/dist/src/lib/index.d.ts.map +1 -0
  49. package/dist/src/lib/index.js +4 -1
  50. package/dist/src/lib/index.js.map +1 -1
  51. package/dist/src/lib/register-guard.d.ts.map +1 -0
  52. package/dist/src/lib/req-shape-log.d.ts +31 -0
  53. package/dist/src/lib/req-shape-log.js +106 -0
  54. package/dist/src/lib/req-shape-log.js.map +1 -0
  55. package/dist/src/lib/route-flag.d.ts.map +1 -0
  56. package/dist/src/lib/sysprompt-strip.d.ts.map +1 -0
  57. package/dist/src/lib/telemetry.d.ts.map +1 -0
  58. package/dist/src/lib/test-mode.d.ts.map +1 -0
  59. package/dist/src/lib/vendor-paths.d.ts.map +1 -0
  60. package/dist/src/logger.d.ts.map +1 -0
  61. package/dist/src/mcp/bridge.d.ts.map +1 -0
  62. package/dist/src/mcp/index.d.ts.map +1 -0
  63. package/dist/src/models.d.ts.map +1 -0
  64. package/dist/src/openai-compat/cli-stream-parser.d.ts.map +1 -0
  65. package/dist/src/openai-compat/index.d.ts.map +1 -0
  66. package/dist/src/openai-compat/message-extractor.d.ts +79 -0
  67. package/dist/src/openai-compat/message-extractor.js +162 -0
  68. package/dist/src/openai-compat/message-extractor.js.map +1 -0
  69. package/dist/src/openai-compat/mode-flags.d.ts +34 -0
  70. package/dist/src/openai-compat/mode-flags.js +44 -0
  71. package/dist/src/openai-compat/mode-flags.js.map +1 -0
  72. package/dist/src/openai-compat/non-streaming-handler.d.ts +26 -0
  73. package/dist/src/openai-compat/non-streaming-handler.js +108 -0
  74. package/dist/src/openai-compat/non-streaming-handler.js.map +1 -0
  75. package/dist/src/openai-compat/openai-compat.d.ts +15 -166
  76. package/dist/src/openai-compat/openai-compat.d.ts.map +1 -0
  77. package/dist/src/openai-compat/openai-compat.js +65 -849
  78. package/dist/src/openai-compat/openai-compat.js.map +1 -1
  79. package/dist/src/openai-compat/prompts.d.ts +47 -0
  80. package/dist/src/openai-compat/prompts.js +119 -0
  81. package/dist/src/openai-compat/prompts.js.map +1 -0
  82. package/dist/src/openai-compat/response-formatter.d.ts +33 -0
  83. package/dist/src/openai-compat/response-formatter.js +74 -0
  84. package/dist/src/openai-compat/response-formatter.js.map +1 -0
  85. package/dist/src/openai-compat/session-key-resolver.d.ts +41 -0
  86. package/dist/src/openai-compat/session-key-resolver.js +78 -0
  87. package/dist/src/openai-compat/session-key-resolver.js.map +1 -0
  88. package/dist/src/openai-compat/skill-resolver.d.ts.map +1 -0
  89. package/dist/src/openai-compat/sse-translator.d.ts.map +1 -0
  90. package/dist/src/openai-compat/status-reporter.d.ts +30 -0
  91. package/dist/src/openai-compat/status-reporter.js +81 -0
  92. package/dist/src/openai-compat/status-reporter.js.map +1 -0
  93. package/dist/src/openai-compat/streaming-handler.d.ts +41 -0
  94. package/dist/src/openai-compat/streaming-handler.js +294 -0
  95. package/dist/src/openai-compat/streaming-handler.js.map +1 -0
  96. package/dist/src/openai-compat/tool-calls-parser.d.ts +34 -0
  97. package/dist/src/openai-compat/tool-calls-parser.js +93 -0
  98. package/dist/src/openai-compat/tool-calls-parser.js.map +1 -0
  99. package/dist/src/openai-compat/tool-results-serializer.d.ts +60 -0
  100. package/dist/src/openai-compat/tool-results-serializer.js +56 -0
  101. package/dist/src/openai-compat/tool-results-serializer.js.map +1 -0
  102. package/dist/src/proxy/anthropic-adapter.d.ts.map +1 -0
  103. package/dist/src/proxy/handler.d.ts.map +1 -0
  104. package/dist/src/proxy/index.d.ts.map +1 -0
  105. package/dist/src/proxy/schema-cleaner.d.ts.map +1 -0
  106. package/dist/src/proxy/thought-cache.d.ts.map +1 -0
  107. package/dist/src/session/embedded-server.d.ts.map +1 -0
  108. package/dist/src/session/inbox-manager.d.ts.map +1 -0
  109. package/dist/src/session/index.d.ts.map +1 -0
  110. package/dist/src/session/session-manager.d.ts.map +1 -0
  111. package/dist/src/session-bootstrap/cwd-patch.d.ts.map +1 -0
  112. package/dist/src/session-bootstrap/cwd-patch.js +20 -13
  113. package/dist/src/session-bootstrap/cwd-patch.js.map +1 -1
  114. package/dist/src/session-bootstrap/index.d.ts.map +1 -0
  115. package/dist/src/session-bootstrap/sysprompt-strip.d.ts.map +1 -0
  116. package/dist/src/session-bootstrap/think-conflict-resolver.d.ts.map +1 -0
  117. package/dist/src/types/index.d.ts +15 -0
  118. package/dist/src/types/index.js +16 -0
  119. package/dist/src/types/index.js.map +1 -0
  120. package/dist/src/types/route.d.ts +41 -0
  121. package/dist/src/types/route.js +12 -0
  122. package/dist/src/types/route.js.map +1 -0
  123. package/dist/src/types/runtime-config.d.ts +161 -0
  124. package/dist/src/types/runtime-config.js +118 -0
  125. package/dist/src/types/runtime-config.js.map +1 -0
  126. package/dist/src/types/session.d.ts +48 -0
  127. package/dist/src/types/session.js +20 -0
  128. package/dist/src/types/session.js.map +1 -0
  129. package/dist/src/types/sse.d.ts +38 -0
  130. package/dist/src/types/sse.js +12 -0
  131. package/dist/src/types/sse.js.map +1 -0
  132. package/dist/src/types/tool-bridge.d.ts +81 -0
  133. package/dist/src/types/tool-bridge.js +34 -0
  134. package/dist/src/types/tool-bridge.js.map +1 -0
  135. package/dist/src/types/upstream.d.ts +652 -0
  136. package/dist/src/types/upstream.js +145 -0
  137. package/dist/src/types/upstream.js.map +1 -0
  138. package/dist/src/types.d.ts.map +1 -0
  139. package/dist/src/validation.d.ts.map +1 -0
  140. package/dist/tests/_helpers/subprocess-mock.d.ts +35 -0
  141. package/dist/tests/_helpers/subprocess-mock.d.ts.map +1 -0
  142. package/dist/tests/_helpers/subprocess-mock.js +136 -0
  143. package/dist/tests/_helpers/subprocess-mock.js.map +1 -0
  144. package/dist/tests/auto-recovery.test.d.ts +2 -0
  145. package/dist/tests/auto-recovery.test.d.ts.map +1 -0
  146. package/dist/tests/auto-recovery.test.js +189 -0
  147. package/dist/tests/auto-recovery.test.js.map +1 -0
  148. package/dist/tests/bench-harness.test.d.ts +2 -0
  149. package/dist/tests/bench-harness.test.d.ts.map +1 -0
  150. package/dist/tests/bench-harness.test.js +21 -0
  151. package/dist/tests/bench-harness.test.js.map +1 -0
  152. package/dist/tests/cache-parity.test.d.ts +2 -0
  153. package/dist/tests/cache-parity.test.d.ts.map +1 -0
  154. package/dist/tests/cache-parity.test.js +401 -0
  155. package/dist/tests/cache-parity.test.js.map +1 -0
  156. package/dist/tests/command-router.test.d.ts +2 -0
  157. package/dist/tests/command-router.test.d.ts.map +1 -0
  158. package/dist/tests/command-router.test.js +60 -0
  159. package/dist/tests/command-router.test.js.map +1 -0
  160. package/dist/tests/council.test.d.ts +2 -0
  161. package/dist/tests/council.test.d.ts.map +1 -0
  162. package/dist/tests/council.test.js +20 -0
  163. package/dist/tests/council.test.js.map +1 -0
  164. package/dist/tests/drift-detector.test.d.ts +2 -0
  165. package/dist/tests/drift-detector.test.d.ts.map +1 -0
  166. package/dist/tests/drift-detector.test.js +268 -0
  167. package/dist/tests/drift-detector.test.js.map +1 -0
  168. package/dist/tests/eager-bootstrap-gating.test.d.ts +9 -0
  169. package/dist/tests/eager-bootstrap-gating.test.d.ts.map +1 -0
  170. package/dist/tests/eager-bootstrap-gating.test.js +97 -0
  171. package/dist/tests/eager-bootstrap-gating.test.js.map +1 -0
  172. package/dist/tests/engines.test.d.ts +2 -0
  173. package/dist/tests/engines.test.d.ts.map +1 -0
  174. package/dist/tests/engines.test.js +8 -0
  175. package/dist/tests/engines.test.js.map +1 -0
  176. package/dist/tests/error-formatter.test.d.ts +2 -0
  177. package/dist/tests/error-formatter.test.d.ts.map +1 -0
  178. package/dist/tests/error-formatter.test.js +220 -0
  179. package/dist/tests/error-formatter.test.js.map +1 -0
  180. package/dist/tests/health.test.d.ts +2 -0
  181. package/dist/tests/health.test.d.ts.map +1 -0
  182. package/dist/tests/health.test.js +110 -0
  183. package/dist/tests/health.test.js.map +1 -0
  184. package/dist/tests/heartbeat-workaround.test.d.ts +2 -0
  185. package/dist/tests/heartbeat-workaround.test.d.ts.map +1 -0
  186. package/dist/tests/heartbeat-workaround.test.js +90 -0
  187. package/dist/tests/heartbeat-workaround.test.js.map +1 -0
  188. package/dist/tests/index.test.d.ts +2 -0
  189. package/dist/tests/index.test.d.ts.map +1 -0
  190. package/dist/tests/index.test.js +7 -0
  191. package/dist/tests/index.test.js.map +1 -0
  192. package/dist/tests/lib-sysprompt-strip.test.d.ts +2 -0
  193. package/dist/tests/lib-sysprompt-strip.test.d.ts.map +1 -0
  194. package/dist/tests/lib-sysprompt-strip.test.js +145 -0
  195. package/dist/tests/lib-sysprompt-strip.test.js.map +1 -0
  196. package/dist/tests/listener-activation.test.d.ts +2 -0
  197. package/dist/tests/listener-activation.test.d.ts.map +1 -0
  198. package/dist/tests/listener-activation.test.js +87 -0
  199. package/dist/tests/listener-activation.test.js.map +1 -0
  200. package/dist/tests/mcp-bridge.test.d.ts +2 -0
  201. package/dist/tests/mcp-bridge.test.d.ts.map +1 -0
  202. package/dist/tests/mcp-bridge.test.js +137 -0
  203. package/dist/tests/mcp-bridge.test.js.map +1 -0
  204. package/dist/tests/openai-compat.test.d.ts +2 -0
  205. package/dist/tests/openai-compat.test.d.ts.map +1 -0
  206. package/dist/tests/openai-compat.test.js +8 -0
  207. package/dist/tests/openai-compat.test.js.map +1 -0
  208. package/dist/tests/proxy-heartbeat-integration.test.d.ts +15 -0
  209. package/dist/tests/proxy-heartbeat-integration.test.d.ts.map +1 -0
  210. package/dist/tests/proxy-heartbeat-integration.test.js +122 -0
  211. package/dist/tests/proxy-heartbeat-integration.test.js.map +1 -0
  212. package/dist/tests/proxy.test.d.ts +2 -0
  213. package/dist/tests/proxy.test.d.ts.map +1 -0
  214. package/dist/tests/proxy.test.js +8 -0
  215. package/dist/tests/proxy.test.js.map +1 -0
  216. package/dist/tests/register-guard-stacking.test.d.ts +2 -0
  217. package/dist/tests/register-guard-stacking.test.d.ts.map +1 -0
  218. package/dist/tests/register-guard-stacking.test.js +61 -0
  219. package/dist/tests/register-guard-stacking.test.js.map +1 -0
  220. package/dist/tests/register-guard.test.d.ts +2 -0
  221. package/dist/tests/register-guard.test.d.ts.map +1 -0
  222. package/dist/tests/register-guard.test.js +129 -0
  223. package/dist/tests/register-guard.test.js.map +1 -0
  224. package/dist/tests/route-flag-rollback.test.d.ts +2 -0
  225. package/dist/tests/route-flag-rollback.test.d.ts.map +1 -0
  226. package/dist/tests/route-flag-rollback.test.js +70 -0
  227. package/dist/tests/route-flag-rollback.test.js.map +1 -0
  228. package/dist/tests/route-flag.test.d.ts +2 -0
  229. package/dist/tests/route-flag.test.d.ts.map +1 -0
  230. package/dist/tests/route-flag.test.js +101 -0
  231. package/dist/tests/route-flag.test.js.map +1 -0
  232. package/dist/tests/session-bootstrap.test.d.ts +2 -0
  233. package/dist/tests/session-bootstrap.test.d.ts.map +1 -0
  234. package/dist/tests/session-bootstrap.test.js +183 -0
  235. package/dist/tests/session-bootstrap.test.js.map +1 -0
  236. package/dist/tests/session.test.d.ts +2 -0
  237. package/dist/tests/session.test.d.ts.map +1 -0
  238. package/dist/tests/session.test.js +17 -0
  239. package/dist/tests/session.test.js.map +1 -0
  240. package/dist/tests/state-machine.test.d.ts +2 -0
  241. package/dist/tests/state-machine.test.d.ts.map +1 -0
  242. package/dist/tests/state-machine.test.js +133 -0
  243. package/dist/tests/state-machine.test.js.map +1 -0
  244. package/dist/tests/streaming/cli-stream-parser.test.d.ts +2 -0
  245. package/dist/tests/streaming/cli-stream-parser.test.d.ts.map +1 -0
  246. package/dist/tests/streaming/cli-stream-parser.test.js +233 -0
  247. package/dist/tests/streaming/cli-stream-parser.test.js.map +1 -0
  248. package/dist/tests/streaming/feature-flag.test.d.ts +14 -0
  249. package/dist/tests/streaming/feature-flag.test.d.ts.map +1 -0
  250. package/dist/tests/streaming/feature-flag.test.js +163 -0
  251. package/dist/tests/streaming/feature-flag.test.js.map +1 -0
  252. package/dist/tests/streaming/no-tools-prompt.test.d.ts +17 -0
  253. package/dist/tests/streaming/no-tools-prompt.test.d.ts.map +1 -0
  254. package/dist/tests/streaming/no-tools-prompt.test.js +229 -0
  255. package/dist/tests/streaming/no-tools-prompt.test.js.map +1 -0
  256. package/dist/tests/streaming/skill-plus-tools.test.d.ts +14 -0
  257. package/dist/tests/streaming/skill-plus-tools.test.d.ts.map +1 -0
  258. package/dist/tests/streaming/skill-plus-tools.test.js +234 -0
  259. package/dist/tests/streaming/skill-plus-tools.test.js.map +1 -0
  260. package/dist/tests/streaming/sse-translator.test.d.ts +2 -0
  261. package/dist/tests/streaming/sse-translator.test.d.ts.map +1 -0
  262. package/dist/tests/streaming/sse-translator.test.js +227 -0
  263. package/dist/tests/streaming/sse-translator.test.js.map +1 -0
  264. package/dist/tests/streaming/tool-result-roundtrip.test.d.ts +11 -0
  265. package/dist/tests/streaming/tool-result-roundtrip.test.d.ts.map +1 -0
  266. package/dist/tests/streaming/tool-result-roundtrip.test.js +215 -0
  267. package/dist/tests/streaming/tool-result-roundtrip.test.js.map +1 -0
  268. package/dist/tests/streaming/tool-use-translation.test.d.ts +10 -0
  269. package/dist/tests/streaming/tool-use-translation.test.d.ts.map +1 -0
  270. package/dist/tests/streaming/tool-use-translation.test.js +251 -0
  271. package/dist/tests/streaming/tool-use-translation.test.js.map +1 -0
  272. package/dist/tests/telegram-bridge.test.d.ts +2 -0
  273. package/dist/tests/telegram-bridge.test.d.ts.map +1 -0
  274. package/dist/tests/telegram-bridge.test.js +17 -0
  275. package/dist/tests/telegram-bridge.test.js.map +1 -0
  276. package/dist/tests/telegram-injector.test.d.ts +2 -0
  277. package/dist/tests/telegram-injector.test.d.ts.map +1 -0
  278. package/dist/tests/telegram-injector.test.js +74 -0
  279. package/dist/tests/telegram-injector.test.js.map +1 -0
  280. package/dist/tests/telemetry.test.d.ts +2 -0
  281. package/dist/tests/telemetry.test.d.ts.map +1 -0
  282. package/dist/tests/telemetry.test.js +405 -0
  283. package/dist/tests/telemetry.test.js.map +1 -0
  284. package/dist/tests/test-mode.test.d.ts +2 -0
  285. package/dist/tests/test-mode.test.d.ts.map +1 -0
  286. package/dist/tests/test-mode.test.js +39 -0
  287. package/dist/tests/test-mode.test.js.map +1 -0
  288. package/package.json +3 -2
@@ -0,0 +1,220 @@
1
+ // phase: 4 | pillar: 2 | agent: P2.B
2
+ import { describe, it, expect } from 'vitest';
3
+ import { formatError, formatUnknownError, extractMessage, escapeMdV2, ERROR_CODES, } from '../src/lib/error-formatter.js';
4
+ // ─── extractMessage ────────────────────────────────────────────────────────────
5
+ describe('extractMessage', () => {
6
+ it('handles null', () => {
7
+ expect(extractMessage(null)).toBe('(no error message)');
8
+ });
9
+ it('handles undefined', () => {
10
+ expect(extractMessage(undefined)).toBe('(no error message)');
11
+ });
12
+ it('handles plain string', () => {
13
+ expect(extractMessage('something broke')).toBe('something broke');
14
+ });
15
+ it('handles empty string', () => {
16
+ expect(extractMessage('')).toBe('(empty string error)');
17
+ });
18
+ it('handles Error instance with message', () => {
19
+ expect(extractMessage(new Error('disk full'))).toBe('disk full');
20
+ });
21
+ it('handles Error instance with empty message', () => {
22
+ const e = new Error('');
23
+ e.message = '';
24
+ // name fallback
25
+ expect(extractMessage(e)).toBe('Error');
26
+ });
27
+ it('handles plain object', () => {
28
+ const msg = extractMessage({ code: 42, reason: 'oops' });
29
+ expect(msg).toContain('code');
30
+ });
31
+ it('handles number', () => {
32
+ expect(extractMessage(500)).toBe('500');
33
+ });
34
+ it('truncates very long strings', () => {
35
+ const long = 'x'.repeat(300);
36
+ const msg = extractMessage(long);
37
+ expect(msg.length).toBeLessThanOrEqual(300);
38
+ });
39
+ });
40
+ // ─── escapeMdV2 ───────────────────────────────────────────────────────────────
41
+ describe('escapeMdV2', () => {
42
+ it('escapes underscore', () => {
43
+ expect(escapeMdV2('hello_world')).toBe('hello\\_world');
44
+ });
45
+ it('escapes dot', () => {
46
+ expect(escapeMdV2('v1.2.3')).toBe('v1\\.2\\.3');
47
+ });
48
+ it('escapes asterisk', () => {
49
+ expect(escapeMdV2('a*b')).toBe('a\\*b');
50
+ });
51
+ it('escapes backtick', () => {
52
+ expect(escapeMdV2('`code`')).toBe('\\`code\\`');
53
+ });
54
+ it('leaves plain alphanumeric unchanged', () => {
55
+ expect(escapeMdV2('hello123')).toBe('hello123');
56
+ });
57
+ });
58
+ // ─── formatError — all 14 error codes ─────────────────────────────────────────
59
+ describe('formatError — error code taxonomy', () => {
60
+ const allCodes = Object.values(ERROR_CODES);
61
+ it('covers ≥10 error codes in taxonomy', () => {
62
+ expect(allCodes.length).toBeGreaterThanOrEqual(10);
63
+ });
64
+ for (const code of allCodes) {
65
+ it(`produces valid jsonlRow for ${code}`, () => {
66
+ const result = formatError(new Error('test'), { code });
67
+ expect(result.jsonlRow.code).toBe(code);
68
+ expect(result.jsonlRow.message).toBe('test');
69
+ expect(result.jsonlRow.ts).toMatch(/^\d{4}-\d{2}-\d{2}T/);
70
+ expect(['critical', 'error', 'warning', 'info']).toContain(result.jsonlRow.severity);
71
+ // Telegram MarkdownV2 escapes underscores as `\_`; normalize before comparing.
72
+ expect(result.telegramText.replace(/\\_/g, '_')).toContain(code);
73
+ expect(result.telegramText.length).toBeGreaterThan(0);
74
+ });
75
+ }
76
+ });
77
+ // ─── Severity mapping correctness ─────────────────────────────────────────────
78
+ describe('formatError — severity mapping', () => {
79
+ it('GATEWAY_CRASH → critical', () => {
80
+ const r = formatError(new Error('crash'), { code: ERROR_CODES.GATEWAY_CRASH });
81
+ expect(r.jsonlRow.severity).toBe('critical');
82
+ });
83
+ it('RECOVERY_FAILED → critical', () => {
84
+ const r = formatError(new Error('fail'), { code: ERROR_CODES.RECOVERY_FAILED });
85
+ expect(r.jsonlRow.severity).toBe('critical');
86
+ });
87
+ it('CONFIG_ERROR → critical', () => {
88
+ const r = formatError(new Error('bad config'), { code: ERROR_CODES.CONFIG_ERROR });
89
+ expect(r.jsonlRow.severity).toBe('critical');
90
+ });
91
+ it('AUTH_ERROR → critical', () => {
92
+ const r = formatError(new Error('401'), { code: ERROR_CODES.AUTH_ERROR });
93
+ expect(r.jsonlRow.severity).toBe('critical');
94
+ });
95
+ it('BUDGET_EXCEEDED → warning', () => {
96
+ const r = formatError(new Error('quota'), { code: ERROR_CODES.BUDGET_EXCEEDED });
97
+ expect(r.jsonlRow.severity).toBe('warning');
98
+ });
99
+ it('DRIFT_DETECTED → warning', () => {
100
+ const r = formatError(new Error('drift'), { code: ERROR_CODES.DRIFT_DETECTED });
101
+ expect(r.jsonlRow.severity).toBe('warning');
102
+ });
103
+ it('TIMEOUT → warning', () => {
104
+ const r = formatError(new Error('timed out'), { code: ERROR_CODES.TIMEOUT });
105
+ expect(r.jsonlRow.severity).toBe('warning');
106
+ });
107
+ it('RECOVERY_OK → info', () => {
108
+ const r = formatError(new Error('ok'), { code: ERROR_CODES.RECOVERY_OK });
109
+ expect(r.jsonlRow.severity).toBe('info');
110
+ });
111
+ it('TOOL_FAILURE → error', () => {
112
+ const r = formatError(new Error('tool'), { code: ERROR_CODES.TOOL_FAILURE });
113
+ expect(r.jsonlRow.severity).toBe('error');
114
+ });
115
+ });
116
+ // ─── Telegram text formatting ──────────────────────────────────────────────────
117
+ describe('formatError — telegramText', () => {
118
+ it('critical severity uses 🚨 emoji', () => {
119
+ const r = formatError(new Error('x'), { code: ERROR_CODES.GATEWAY_CRASH });
120
+ expect(r.telegramText).toContain('🚨');
121
+ });
122
+ it('error severity uses ❌ emoji', () => {
123
+ const r = formatError(new Error('x'), { code: ERROR_CODES.TOOL_FAILURE });
124
+ expect(r.telegramText).toContain('❌');
125
+ });
126
+ it('warning severity uses ⚠️ emoji', () => {
127
+ const r = formatError(new Error('x'), { code: ERROR_CODES.DRIFT_DETECTED });
128
+ expect(r.telegramText).toContain('⚠️');
129
+ });
130
+ it('info severity uses ✅ emoji', () => {
131
+ const r = formatError(new Error('x'), { code: ERROR_CODES.RECOVERY_OK });
132
+ expect(r.telegramText).toContain('✅');
133
+ });
134
+ it('includes sessionId when provided', () => {
135
+ const r = formatError(new Error('x'), { code: ERROR_CODES.SESSION_ERROR, sessionId: 'sess-xyz' });
136
+ expect(r.telegramText).toContain('sess');
137
+ });
138
+ it('includes laptopId when provided', () => {
139
+ const r = formatError(new Error('x'), { code: ERROR_CODES.DRIFT_DETECTED, laptopId: 'mhg' });
140
+ expect(r.telegramText).toContain('mhg');
141
+ });
142
+ it('includes details summary when provided', () => {
143
+ const r = formatError(new Error('x'), {
144
+ code: ERROR_CODES.TOOL_FAILURE,
145
+ details: { tool: 'Bash', exitCode: 1 },
146
+ });
147
+ expect(r.telegramText).toContain('tool');
148
+ });
149
+ it('truncates long messages to 300 chars in telegramText', () => {
150
+ const long = 'a'.repeat(500);
151
+ const r = formatError(new Error(long), { code: ERROR_CODES.UNKNOWN });
152
+ // Telegram text message portion should be ≤ 300 + some overhead
153
+ expect(r.telegramText.length).toBeLessThan(600);
154
+ });
155
+ });
156
+ // ─── jsonlRow completeness ────────────────────────────────────────────────────
157
+ describe('formatError — jsonlRow', () => {
158
+ it('does not include sessionId key when not provided', () => {
159
+ const r = formatError(new Error('x'), { code: ERROR_CODES.UNKNOWN });
160
+ expect('sessionId' in r.jsonlRow).toBe(false);
161
+ });
162
+ it('does not include laptopId key when not provided', () => {
163
+ const r = formatError(new Error('x'), { code: ERROR_CODES.UNKNOWN });
164
+ expect('laptopId' in r.jsonlRow).toBe(false);
165
+ });
166
+ it('does not include stack key when error has no stack', () => {
167
+ const r = formatError('string error', { code: ERROR_CODES.UNKNOWN });
168
+ expect('stack' in r.jsonlRow).toBe(false);
169
+ });
170
+ it('includes stack when Error has one', () => {
171
+ const e = new Error('has stack');
172
+ const r = formatError(e, { code: ERROR_CODES.UNKNOWN });
173
+ expect(r.jsonlRow.stack).toBeDefined();
174
+ // Stack should be trimmed to max 4 lines
175
+ expect(r.jsonlRow.stack.split('\n').length).toBeLessThanOrEqual(4);
176
+ });
177
+ it('includes details when provided', () => {
178
+ const r = formatError(new Error('x'), {
179
+ code: ERROR_CODES.NETWORK_ERROR,
180
+ details: { url: 'https://example.com', status: 503 },
181
+ });
182
+ expect(r.jsonlRow.details?.url).toBe('https://example.com');
183
+ expect(r.jsonlRow.details?.status).toBe(503);
184
+ });
185
+ });
186
+ // ─── Edge cases ───────────────────────────────────────────────────────────────
187
+ describe('formatError — edge cases', () => {
188
+ it('handles null error', () => {
189
+ const r = formatError(null, { code: ERROR_CODES.TIMEOUT });
190
+ expect(r.jsonlRow.message).toBe('(no error message)');
191
+ });
192
+ it('handles undefined error', () => {
193
+ const r = formatError(undefined, { code: ERROR_CODES.TIMEOUT });
194
+ expect(r.jsonlRow.message).toBe('(no error message)');
195
+ });
196
+ it('handles string error', () => {
197
+ const r = formatError('something bad', { code: ERROR_CODES.PARSE_ERROR });
198
+ expect(r.jsonlRow.message).toBe('something bad');
199
+ });
200
+ it('ts is ISO-8601', () => {
201
+ const r = formatError(new Error('x'), { code: ERROR_CODES.UNKNOWN });
202
+ expect(r.jsonlRow.ts).toMatch(/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}/);
203
+ });
204
+ });
205
+ // ─── formatUnknownError convenience ──────────────────────────────────────────
206
+ describe('formatUnknownError', () => {
207
+ it('uses UNKNOWN code', () => {
208
+ const r = formatUnknownError(new Error('surprise'));
209
+ expect(r.jsonlRow.code).toBe(ERROR_CODES.UNKNOWN);
210
+ });
211
+ it('passes sessionId when given', () => {
212
+ const r = formatUnknownError(new Error('x'), 'sess-123');
213
+ expect(r.jsonlRow.sessionId).toBe('sess-123');
214
+ });
215
+ it('omits sessionId when not given', () => {
216
+ const r = formatUnknownError(new Error('x'));
217
+ expect('sessionId' in r.jsonlRow).toBe(false);
218
+ });
219
+ });
220
+ //# sourceMappingURL=error-formatter.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"error-formatter.test.js","sourceRoot":"","sources":["../../tests/error-formatter.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=health.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"health.test.d.ts","sourceRoot":"","sources":["../../tests/health.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,110 @@
1
+ import { describe, it, expect, beforeEach, vi } from 'vitest';
2
+ import { getHealthInfo, healthRoute, markStart, recordSessionStart, recordSessionEnd, getHealthPort, DEFAULT_HEALTH_PORT, _resetForTests, } from '../src/health/index.js';
3
+ beforeEach(() => {
4
+ _resetForTests();
5
+ delete process.env.CC_OPENCLAW_HEALTH_PORT;
6
+ });
7
+ describe('getHealthInfo()', () => {
8
+ it('returns status=ok', () => {
9
+ const info = getHealthInfo();
10
+ expect(info.status).toBe('ok');
11
+ });
12
+ it('pluginId is cc-openclaw', () => {
13
+ const info = getHealthInfo();
14
+ expect(info.pluginId).toBe('cc-openclaw');
15
+ });
16
+ it('version is 0.1.0', () => {
17
+ const info = getHealthInfo();
18
+ expect(info.version).toBe('0.1.0');
19
+ });
20
+ it('sessions.active increments on recordSessionStart', () => {
21
+ recordSessionStart();
22
+ recordSessionStart();
23
+ const info = getHealthInfo();
24
+ expect(info.sessions.active).toBe(2);
25
+ });
26
+ it('sessions.total increments on recordSessionStart', () => {
27
+ recordSessionStart();
28
+ recordSessionStart();
29
+ recordSessionStart();
30
+ const info = getHealthInfo();
31
+ expect(info.sessions.total).toBe(3);
32
+ });
33
+ it('sessions.active decrements on recordSessionEnd and floors at 0', () => {
34
+ recordSessionStart();
35
+ recordSessionEnd();
36
+ const info = getHealthInfo();
37
+ expect(info.sessions.active).toBe(0);
38
+ // Floor at 0 — calling end with no active sessions is safe
39
+ recordSessionEnd();
40
+ const info2 = getHealthInfo();
41
+ expect(info2.sessions.active).toBe(0);
42
+ });
43
+ it('uptime.seconds is non-negative', () => {
44
+ const info = getHealthInfo();
45
+ expect(info.uptime.seconds).toBeGreaterThanOrEqual(0);
46
+ });
47
+ it('uptime.startedAt is a valid ISO string', () => {
48
+ markStart();
49
+ const info = getHealthInfo();
50
+ expect(() => new Date(info.uptime.startedAt)).not.toThrow();
51
+ expect(new Date(info.uptime.startedAt).toISOString()).toBe(info.uptime.startedAt);
52
+ });
53
+ it('timestamp is a valid ISO string', () => {
54
+ const info = getHealthInfo();
55
+ expect(() => new Date(info.timestamp)).not.toThrow();
56
+ expect(new Date(info.timestamp).toISOString()).toBe(info.timestamp);
57
+ });
58
+ it('sessions shape has active and total keys', () => {
59
+ const info = getHealthInfo();
60
+ expect(info.sessions).toHaveProperty('active');
61
+ expect(info.sessions).toHaveProperty('total');
62
+ });
63
+ });
64
+ describe('getHealthPort()', () => {
65
+ it('returns 18796 by default', () => {
66
+ expect(getHealthPort()).toBe(18796);
67
+ expect(getHealthPort()).toBe(DEFAULT_HEALTH_PORT);
68
+ });
69
+ it('respects CC_OPENCLAW_HEALTH_PORT env var', () => {
70
+ process.env.CC_OPENCLAW_HEALTH_PORT = '12345';
71
+ expect(getHealthPort()).toBe(12345);
72
+ });
73
+ it('falls back to default for invalid env value (non-numeric)', () => {
74
+ process.env.CC_OPENCLAW_HEALTH_PORT = 'abc';
75
+ expect(getHealthPort()).toBe(DEFAULT_HEALTH_PORT);
76
+ });
77
+ it('falls back to default for out-of-range port (0)', () => {
78
+ process.env.CC_OPENCLAW_HEALTH_PORT = '0';
79
+ expect(getHealthPort()).toBe(DEFAULT_HEALTH_PORT);
80
+ });
81
+ it('falls back to default for out-of-range port (65536)', () => {
82
+ process.env.CC_OPENCLAW_HEALTH_PORT = '65536';
83
+ expect(getHealthPort()).toBe(DEFAULT_HEALTH_PORT);
84
+ });
85
+ });
86
+ describe('healthRoute()', () => {
87
+ it('writes JSON body with correct shape via mocked ServerResponse', () => {
88
+ const mockEnd = vi.fn();
89
+ const mockSetHeader = vi.fn();
90
+ const res = {
91
+ statusCode: 0,
92
+ setHeader: mockSetHeader,
93
+ end: mockEnd,
94
+ };
95
+ const req = {};
96
+ healthRoute(req, res);
97
+ expect(res.statusCode).toBe(200);
98
+ expect(mockSetHeader).toHaveBeenCalledWith('Content-Type', 'application/json; charset=utf-8');
99
+ expect(mockSetHeader).toHaveBeenCalledWith('Cache-Control', 'no-store');
100
+ expect(mockEnd).toHaveBeenCalledOnce();
101
+ const body = JSON.parse(mockEnd.mock.calls[0][0]);
102
+ expect(body.status).toBe('ok');
103
+ expect(body.pluginId).toBe('cc-openclaw');
104
+ expect(body.version).toBe('0.1.0');
105
+ expect(body).toHaveProperty('sessions');
106
+ expect(body).toHaveProperty('uptime');
107
+ expect(body).toHaveProperty('timestamp');
108
+ });
109
+ });
110
+ //# sourceMappingURL=health.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"health.test.js","sourceRoot":"","sources":["../../tests/health.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=heartbeat-workaround.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"heartbeat-workaround.test.d.ts","sourceRoot":"","sources":["../../tests/heartbeat-workaround.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,90 @@
1
+ import { describe, it, expect, beforeEach, afterEach } from 'vitest';
2
+ import { applyHeartbeatWorkaround, isHeartbeatRequest, HEARTBEAT_FALLBACK_MODEL, } from '../src/lib/heartbeat-workaround.js';
3
+ describe('isHeartbeatRequest()', () => {
4
+ it('detects top-level heartbeat field', () => {
5
+ expect(isHeartbeatRequest({ model: 'opus', heartbeat: { model: 'haiku' } })).toBe(true);
6
+ });
7
+ it('detects metadata.heartbeat', () => {
8
+ expect(isHeartbeatRequest({ model: 'opus', metadata: { heartbeat: { model: 'haiku' } } })).toBe(true);
9
+ });
10
+ it('detects metadata.is_heartbeat', () => {
11
+ expect(isHeartbeatRequest({ model: 'opus', metadata: { is_heartbeat: true } })).toBe(true);
12
+ });
13
+ it('detects sentinel in message content (__heartbeat__)', () => {
14
+ expect(isHeartbeatRequest({ model: 'opus', messages: [{ role: 'user', content: '__heartbeat__' }] })).toBe(true);
15
+ });
16
+ it('detects sentinel in message content (heartbeat:ping)', () => {
17
+ expect(isHeartbeatRequest({ model: 'opus', messages: [{ role: 'user', content: 'heartbeat:ping' }] })).toBe(true);
18
+ });
19
+ it('detects sentinel in message content (__keepalive__)', () => {
20
+ expect(isHeartbeatRequest({ model: 'opus', messages: [{ role: 'user', content: '__keepalive__' }] })).toBe(true);
21
+ });
22
+ it('returns false for normal requests', () => {
23
+ expect(isHeartbeatRequest({ model: 'opus', messages: [{ role: 'user', content: 'Hello' }] })).toBe(false);
24
+ });
25
+ it('returns false for empty messages array', () => {
26
+ expect(isHeartbeatRequest({ model: 'opus', messages: [] })).toBe(false);
27
+ });
28
+ it('returns false when metadata is absent', () => {
29
+ expect(isHeartbeatRequest({ model: 'opus' })).toBe(false);
30
+ });
31
+ it('returns false when heartbeat field exists but has no model and no other signals', () => {
32
+ // heartbeat.model is falsy → top-level check fails; no metadata signals; no sentinel
33
+ expect(isHeartbeatRequest({ model: 'opus', heartbeat: {} })).toBe(false);
34
+ });
35
+ });
36
+ describe('applyHeartbeatWorkaround()', () => {
37
+ const origDisableEnv = process.env.CC_OPENCLAW_DISABLE_HEARTBEAT_WORKAROUND;
38
+ beforeEach(() => { delete process.env.CC_OPENCLAW_DISABLE_HEARTBEAT_WORKAROUND; });
39
+ afterEach(() => {
40
+ if (origDisableEnv === undefined) {
41
+ delete process.env.CC_OPENCLAW_DISABLE_HEARTBEAT_WORKAROUND;
42
+ }
43
+ else {
44
+ process.env.CC_OPENCLAW_DISABLE_HEARTBEAT_WORKAROUND = origDisableEnv;
45
+ }
46
+ });
47
+ it('overrides model on heartbeat-shaped requests using heartbeat.model', () => {
48
+ const result = applyHeartbeatWorkaround({ model: 'claude-opus-4-7', heartbeat: { model: 'claude-haiku-4-5' } });
49
+ expect(result.model).toBe('claude-haiku-4-5');
50
+ });
51
+ it('falls back to HEARTBEAT_FALLBACK_MODEL when heartbeat.model is missing (metadata.is_heartbeat)', () => {
52
+ const result = applyHeartbeatWorkaround({ model: 'claude-opus-4-7', metadata: { is_heartbeat: true } });
53
+ expect(result.model).toBe(HEARTBEAT_FALLBACK_MODEL);
54
+ });
55
+ it('uses metadata.heartbeat.model when present', () => {
56
+ const result = applyHeartbeatWorkaround({
57
+ model: 'claude-opus-4-7',
58
+ metadata: { heartbeat: { model: 'claude-haiku-4-5' } },
59
+ });
60
+ expect(result.model).toBe('claude-haiku-4-5');
61
+ });
62
+ it('falls back to HEARTBEAT_FALLBACK_MODEL for sentinel-detected requests with no model hint', () => {
63
+ const result = applyHeartbeatWorkaround({
64
+ model: 'claude-opus-4-7',
65
+ messages: [{ role: 'user', content: '__heartbeat__' }],
66
+ });
67
+ expect(result.model).toBe(HEARTBEAT_FALLBACK_MODEL);
68
+ });
69
+ it('leaves non-heartbeat requests untouched', () => {
70
+ const req = { model: 'claude-opus-4-7', messages: [{ role: 'user', content: 'Hi' }] };
71
+ const result = applyHeartbeatWorkaround(req);
72
+ expect(result.model).toBe('claude-opus-4-7');
73
+ expect(result).toEqual(req);
74
+ });
75
+ it('returns NEW object, does not mutate input', () => {
76
+ const req = { model: 'claude-opus-4-7', heartbeat: { model: 'claude-haiku-4-5' } };
77
+ const result = applyHeartbeatWorkaround(req);
78
+ expect(req.model).toBe('claude-opus-4-7'); // original unchanged
79
+ expect(result.model).toBe('claude-haiku-4-5');
80
+ expect(result).not.toBe(req);
81
+ });
82
+ it('disables override when CC_OPENCLAW_DISABLE_HEARTBEAT_WORKAROUND=1', () => {
83
+ process.env.CC_OPENCLAW_DISABLE_HEARTBEAT_WORKAROUND = '1';
84
+ const req = { model: 'claude-opus-4-7', heartbeat: { model: 'claude-haiku-4-5' } };
85
+ const result = applyHeartbeatWorkaround(req);
86
+ expect(result.model).toBe('claude-opus-4-7'); // workaround skipped
87
+ expect(result).toBe(req); // same reference returned
88
+ });
89
+ });
90
+ //# sourceMappingURL=heartbeat-workaround.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"heartbeat-workaround.test.js","sourceRoot":"","sources":["../../tests/heartbeat-workaround.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=index.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../../tests/index.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,7 @@
1
+ import { describe, it, expect } from 'vitest';
2
+ import { PLUGIN_ID, VERSION } from '../src/index.js';
3
+ describe('plugin metadata', () => {
4
+ it('exports plugin id', () => { expect(PLUGIN_ID).toBe('cc-openclaw'); });
5
+ it('exports version', () => { expect(VERSION).toBe('0.1.0'); });
6
+ });
7
+ //# sourceMappingURL=index.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.test.js","sourceRoot":"","sources":["../../tests/index.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AACrD,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,EAAE,CAAC,mBAAmB,EAAE,GAAG,EAAE,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1E,EAAE,CAAC,iBAAiB,EAAE,GAAG,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAClE,CAAC,CAAC,CAAC"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=lib-sysprompt-strip.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"lib-sysprompt-strip.test.d.ts","sourceRoot":"","sources":["../../tests/lib-sysprompt-strip.test.ts"],"names":[],"mappings":""}