nduka 1.0.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 (1011) hide show
  1. package/README.md +157 -0
  2. package/config/agent-tools.settings.json +70 -0
  3. package/config/chatbot.config.json +113 -0
  4. package/config/chatbot.config.schema.json +54 -0
  5. package/config/connectors.chatbot.json +5 -0
  6. package/config/llm.settings.json +416 -0
  7. package/config/prompts.chatbot.json +13 -0
  8. package/config/secure-tool-identities.example.json +21 -0
  9. package/config/secure-tool-identities.json +13 -0
  10. package/config/secure-tools.chatbot.json +82 -0
  11. package/config/secure-tools.example.json +200 -0
  12. package/config/test.env +2 -0
  13. package/config/tools.chatbot.json +318 -0
  14. package/dist/acceptance/index.d.ts +3 -0
  15. package/dist/acceptance/index.d.ts.map +1 -0
  16. package/dist/acceptance/index.js +2 -0
  17. package/dist/acceptance/index.js.map +1 -0
  18. package/dist/acceptance/runner.d.ts +57 -0
  19. package/dist/acceptance/runner.d.ts.map +1 -0
  20. package/dist/acceptance/runner.js +222 -0
  21. package/dist/acceptance/runner.js.map +1 -0
  22. package/dist/agent-runtime/engine.d.ts +73 -0
  23. package/dist/agent-runtime/engine.d.ts.map +1 -0
  24. package/dist/agent-runtime/engine.js +169 -0
  25. package/dist/agent-runtime/engine.js.map +1 -0
  26. package/dist/agent-runtime/index.d.ts +3 -0
  27. package/dist/agent-runtime/index.d.ts.map +1 -0
  28. package/dist/agent-runtime/index.js +2 -0
  29. package/dist/agent-runtime/index.js.map +1 -0
  30. package/dist/agent-tools/agent-tool-router.d.ts +44 -0
  31. package/dist/agent-tools/agent-tool-router.d.ts.map +1 -0
  32. package/dist/agent-tools/agent-tool-router.js +196 -0
  33. package/dist/agent-tools/agent-tool-router.js.map +1 -0
  34. package/dist/agent-tools/async-tool-bridge.d.ts +31 -0
  35. package/dist/agent-tools/async-tool-bridge.d.ts.map +1 -0
  36. package/dist/agent-tools/async-tool-bridge.js +65 -0
  37. package/dist/agent-tools/async-tool-bridge.js.map +1 -0
  38. package/dist/agent-tools/async-tool-processor.d.ts +19 -0
  39. package/dist/agent-tools/async-tool-processor.d.ts.map +1 -0
  40. package/dist/agent-tools/async-tool-processor.js +81 -0
  41. package/dist/agent-tools/async-tool-processor.js.map +1 -0
  42. package/dist/agent-tools/claude-tool-adapter.d.ts +20 -0
  43. package/dist/agent-tools/claude-tool-adapter.d.ts.map +1 -0
  44. package/dist/agent-tools/claude-tool-adapter.js +64 -0
  45. package/dist/agent-tools/claude-tool-adapter.js.map +1 -0
  46. package/dist/agent-tools/claude-tool-planner.d.ts +35 -0
  47. package/dist/agent-tools/claude-tool-planner.d.ts.map +1 -0
  48. package/dist/agent-tools/claude-tool-planner.js +83 -0
  49. package/dist/agent-tools/claude-tool-planner.js.map +1 -0
  50. package/dist/agent-tools/connector-tool-adapter.d.ts +16 -0
  51. package/dist/agent-tools/connector-tool-adapter.d.ts.map +1 -0
  52. package/dist/agent-tools/connector-tool-adapter.js +62 -0
  53. package/dist/agent-tools/connector-tool-adapter.js.map +1 -0
  54. package/dist/agent-tools/context-routing-policy.d.ts +4 -0
  55. package/dist/agent-tools/context-routing-policy.d.ts.map +1 -0
  56. package/dist/agent-tools/context-routing-policy.js +20 -0
  57. package/dist/agent-tools/context-routing-policy.js.map +1 -0
  58. package/dist/agent-tools/index.d.ts +18 -0
  59. package/dist/agent-tools/index.d.ts.map +1 -0
  60. package/dist/agent-tools/index.js +18 -0
  61. package/dist/agent-tools/index.js.map +1 -0
  62. package/dist/agent-tools/logging.d.ts +3 -0
  63. package/dist/agent-tools/logging.d.ts.map +1 -0
  64. package/dist/agent-tools/logging.js +15 -0
  65. package/dist/agent-tools/logging.js.map +1 -0
  66. package/dist/agent-tools/mcp-tool-adapter.d.ts +18 -0
  67. package/dist/agent-tools/mcp-tool-adapter.d.ts.map +1 -0
  68. package/dist/agent-tools/mcp-tool-adapter.js +76 -0
  69. package/dist/agent-tools/mcp-tool-adapter.js.map +1 -0
  70. package/dist/agent-tools/settings.d.ts +50 -0
  71. package/dist/agent-tools/settings.d.ts.map +1 -0
  72. package/dist/agent-tools/settings.js +101 -0
  73. package/dist/agent-tools/settings.js.map +1 -0
  74. package/dist/agent-tools/tool-candidate-detector.d.ts +16 -0
  75. package/dist/agent-tools/tool-candidate-detector.d.ts.map +1 -0
  76. package/dist/agent-tools/tool-candidate-detector.js +165 -0
  77. package/dist/agent-tools/tool-candidate-detector.js.map +1 -0
  78. package/dist/agent-tools/tool-chain-runner.d.ts +24 -0
  79. package/dist/agent-tools/tool-chain-runner.d.ts.map +1 -0
  80. package/dist/agent-tools/tool-chain-runner.js +39 -0
  81. package/dist/agent-tools/tool-chain-runner.js.map +1 -0
  82. package/dist/agent-tools/tool-context-store.d.ts +28 -0
  83. package/dist/agent-tools/tool-context-store.d.ts.map +1 -0
  84. package/dist/agent-tools/tool-context-store.js +127 -0
  85. package/dist/agent-tools/tool-context-store.js.map +1 -0
  86. package/dist/agent-tools/tool-followup-resolver.d.ts +18 -0
  87. package/dist/agent-tools/tool-followup-resolver.d.ts.map +1 -0
  88. package/dist/agent-tools/tool-followup-resolver.js +98 -0
  89. package/dist/agent-tools/tool-followup-resolver.js.map +1 -0
  90. package/dist/agent-tools/tool-plan-validator.d.ts +13 -0
  91. package/dist/agent-tools/tool-plan-validator.d.ts.map +1 -0
  92. package/dist/agent-tools/tool-plan-validator.js +119 -0
  93. package/dist/agent-tools/tool-plan-validator.js.map +1 -0
  94. package/dist/agent-tools/tool-result-summarizer.d.ts +17 -0
  95. package/dist/agent-tools/tool-result-summarizer.d.ts.map +1 -0
  96. package/dist/agent-tools/tool-result-summarizer.js +41 -0
  97. package/dist/agent-tools/tool-result-summarizer.js.map +1 -0
  98. package/dist/agent-tools/tool-session-store.d.ts +49 -0
  99. package/dist/agent-tools/tool-session-store.d.ts.map +1 -0
  100. package/dist/agent-tools/tool-session-store.js +104 -0
  101. package/dist/agent-tools/tool-session-store.js.map +1 -0
  102. package/dist/agent-tools/types.d.ts +97 -0
  103. package/dist/agent-tools/types.d.ts.map +1 -0
  104. package/dist/agent-tools/types.js +2 -0
  105. package/dist/agent-tools/types.js.map +1 -0
  106. package/dist/ai/execution-controller.d.ts +62 -0
  107. package/dist/ai/execution-controller.d.ts.map +1 -0
  108. package/dist/ai/execution-controller.js +117 -0
  109. package/dist/ai/execution-controller.js.map +1 -0
  110. package/dist/ai/index.d.ts +3 -0
  111. package/dist/ai/index.d.ts.map +1 -0
  112. package/dist/ai/index.js +2 -0
  113. package/dist/ai/index.js.map +1 -0
  114. package/dist/ai-context/engine.d.ts +85 -0
  115. package/dist/ai-context/engine.d.ts.map +1 -0
  116. package/dist/ai-context/engine.js +173 -0
  117. package/dist/ai-context/engine.js.map +1 -0
  118. package/dist/ai-context/index.d.ts +3 -0
  119. package/dist/ai-context/index.d.ts.map +1 -0
  120. package/dist/ai-context/index.js +2 -0
  121. package/dist/ai-context/index.js.map +1 -0
  122. package/dist/ai-router/index.d.ts +3 -0
  123. package/dist/ai-router/index.d.ts.map +1 -0
  124. package/dist/ai-router/index.js +2 -0
  125. package/dist/ai-router/index.js.map +1 -0
  126. package/dist/ai-router/router.d.ts +68 -0
  127. package/dist/ai-router/router.d.ts.map +1 -0
  128. package/dist/ai-router/router.js +260 -0
  129. package/dist/ai-router/router.js.map +1 -0
  130. package/dist/async-jobs/context-resolver-planner.d.ts +35 -0
  131. package/dist/async-jobs/context-resolver-planner.d.ts.map +1 -0
  132. package/dist/async-jobs/context-resolver-planner.js +324 -0
  133. package/dist/async-jobs/context-resolver-planner.js.map +1 -0
  134. package/dist/async-jobs/gateway-worker.d.ts +22 -0
  135. package/dist/async-jobs/gateway-worker.d.ts.map +1 -0
  136. package/dist/async-jobs/gateway-worker.js +53 -0
  137. package/dist/async-jobs/gateway-worker.js.map +1 -0
  138. package/dist/async-jobs/job-delivery.d.ts +16 -0
  139. package/dist/async-jobs/job-delivery.d.ts.map +1 -0
  140. package/dist/async-jobs/job-delivery.js +30 -0
  141. package/dist/async-jobs/job-delivery.js.map +1 -0
  142. package/dist/async-jobs/job-runner.d.ts +39 -0
  143. package/dist/async-jobs/job-runner.d.ts.map +1 -0
  144. package/dist/async-jobs/job-runner.js +67 -0
  145. package/dist/async-jobs/job-runner.js.map +1 -0
  146. package/dist/async-jobs/job-store.d.ts +27 -0
  147. package/dist/async-jobs/job-store.d.ts.map +1 -0
  148. package/dist/async-jobs/job-store.js +168 -0
  149. package/dist/async-jobs/job-store.js.map +1 -0
  150. package/dist/async-jobs/job-types.d.ts +59 -0
  151. package/dist/async-jobs/job-types.d.ts.map +1 -0
  152. package/dist/async-jobs/job-types.js +2 -0
  153. package/dist/async-jobs/job-types.js.map +1 -0
  154. package/dist/async-jobs/job-utils.d.ts +16 -0
  155. package/dist/async-jobs/job-utils.d.ts.map +1 -0
  156. package/dist/async-jobs/job-utils.js +72 -0
  157. package/dist/async-jobs/job-utils.js.map +1 -0
  158. package/dist/async-jobs/job-worker.d.ts +31 -0
  159. package/dist/async-jobs/job-worker.d.ts.map +1 -0
  160. package/dist/async-jobs/job-worker.js +60 -0
  161. package/dist/async-jobs/job-worker.js.map +1 -0
  162. package/dist/async-jobs/message-triage-planner.d.ts +52 -0
  163. package/dist/async-jobs/message-triage-planner.d.ts.map +1 -0
  164. package/dist/async-jobs/message-triage-planner.js +262 -0
  165. package/dist/async-jobs/message-triage-planner.js.map +1 -0
  166. package/dist/async-jobs/request-controller.d.ts +65 -0
  167. package/dist/async-jobs/request-controller.d.ts.map +1 -0
  168. package/dist/async-jobs/request-controller.js +471 -0
  169. package/dist/async-jobs/request-controller.js.map +1 -0
  170. package/dist/async-jobs/routing-context.d.ts +12 -0
  171. package/dist/async-jobs/routing-context.d.ts.map +1 -0
  172. package/dist/async-jobs/routing-context.js +15 -0
  173. package/dist/async-jobs/routing-context.js.map +1 -0
  174. package/dist/async-jobs/tool-intent-planner.d.ts +51 -0
  175. package/dist/async-jobs/tool-intent-planner.d.ts.map +1 -0
  176. package/dist/async-jobs/tool-intent-planner.js +241 -0
  177. package/dist/async-jobs/tool-intent-planner.js.map +1 -0
  178. package/dist/async-jobs/tool-processor.d.ts +31 -0
  179. package/dist/async-jobs/tool-processor.d.ts.map +1 -0
  180. package/dist/async-jobs/tool-processor.js +263 -0
  181. package/dist/async-jobs/tool-processor.js.map +1 -0
  182. package/dist/auth/session-admin.d.ts +19 -0
  183. package/dist/auth/session-admin.d.ts.map +1 -0
  184. package/dist/auth/session-admin.js +52 -0
  185. package/dist/auth/session-admin.js.map +1 -0
  186. package/dist/chat-registry/aliases.d.ts +55 -0
  187. package/dist/chat-registry/aliases.d.ts.map +1 -0
  188. package/dist/chat-registry/aliases.js +170 -0
  189. package/dist/chat-registry/aliases.js.map +1 -0
  190. package/dist/chat-registry/index.d.ts +3 -0
  191. package/dist/chat-registry/index.d.ts.map +1 -0
  192. package/dist/chat-registry/index.js +2 -0
  193. package/dist/chat-registry/index.js.map +1 -0
  194. package/dist/chat-registry/service.d.ts +54 -0
  195. package/dist/chat-registry/service.d.ts.map +1 -0
  196. package/dist/chat-registry/service.js +224 -0
  197. package/dist/chat-registry/service.js.map +1 -0
  198. package/dist/chat-state/execution-gate.d.ts +66 -0
  199. package/dist/chat-state/execution-gate.d.ts.map +1 -0
  200. package/dist/chat-state/execution-gate.js +143 -0
  201. package/dist/chat-state/execution-gate.js.map +1 -0
  202. package/dist/chat-state/index.d.ts +7 -0
  203. package/dist/chat-state/index.d.ts.map +1 -0
  204. package/dist/chat-state/index.js +4 -0
  205. package/dist/chat-state/index.js.map +1 -0
  206. package/dist/chat-state/invariants.d.ts +32 -0
  207. package/dist/chat-state/invariants.d.ts.map +1 -0
  208. package/dist/chat-state/invariants.js +95 -0
  209. package/dist/chat-state/invariants.js.map +1 -0
  210. package/dist/chat-state/store.d.ts +55 -0
  211. package/dist/chat-state/store.d.ts.map +1 -0
  212. package/dist/chat-state/store.js +220 -0
  213. package/dist/chat-state/store.js.map +1 -0
  214. package/dist/cli/admin-inspection.d.ts +17 -0
  215. package/dist/cli/admin-inspection.d.ts.map +1 -0
  216. package/dist/cli/admin-inspection.js +161 -0
  217. package/dist/cli/admin-inspection.js.map +1 -0
  218. package/dist/cli/connector-admin.d.ts +2 -0
  219. package/dist/cli/connector-admin.d.ts.map +1 -0
  220. package/dist/cli/connector-admin.js +28 -0
  221. package/dist/cli/connector-admin.js.map +1 -0
  222. package/dist/cli/index.d.ts +7 -0
  223. package/dist/cli/index.d.ts.map +1 -0
  224. package/dist/cli/index.js +709 -0
  225. package/dist/cli/index.js.map +1 -0
  226. package/dist/config/chatbot-config.d.ts +108 -0
  227. package/dist/config/chatbot-config.d.ts.map +1 -0
  228. package/dist/config/chatbot-config.js +280 -0
  229. package/dist/config/chatbot-config.js.map +1 -0
  230. package/dist/config/config-editor.d.ts +16 -0
  231. package/dist/config/config-editor.d.ts.map +1 -0
  232. package/dist/config/config-editor.js +367 -0
  233. package/dist/config/config-editor.js.map +1 -0
  234. package/dist/config/local-env-editor.d.ts +22 -0
  235. package/dist/config/local-env-editor.d.ts.map +1 -0
  236. package/dist/config/local-env-editor.js +129 -0
  237. package/dist/config/local-env-editor.js.map +1 -0
  238. package/dist/config/runtime-feature-flags.d.ts +19 -0
  239. package/dist/config/runtime-feature-flags.d.ts.map +1 -0
  240. package/dist/config/runtime-feature-flags.js +39 -0
  241. package/dist/config/runtime-feature-flags.js.map +1 -0
  242. package/dist/connectors/audit.d.ts +32 -0
  243. package/dist/connectors/audit.d.ts.map +1 -0
  244. package/dist/connectors/audit.js +77 -0
  245. package/dist/connectors/audit.js.map +1 -0
  246. package/dist/connectors/config.d.ts +9 -0
  247. package/dist/connectors/config.d.ts.map +1 -0
  248. package/dist/connectors/config.js +66 -0
  249. package/dist/connectors/config.js.map +1 -0
  250. package/dist/connectors/dns-guard.d.ts +7 -0
  251. package/dist/connectors/dns-guard.d.ts.map +1 -0
  252. package/dist/connectors/dns-guard.js +70 -0
  253. package/dist/connectors/dns-guard.js.map +1 -0
  254. package/dist/connectors/executor.d.ts +30 -0
  255. package/dist/connectors/executor.d.ts.map +1 -0
  256. package/dist/connectors/executor.js +80 -0
  257. package/dist/connectors/executor.js.map +1 -0
  258. package/dist/connectors/manifest.d.ts +18 -0
  259. package/dist/connectors/manifest.d.ts.map +1 -0
  260. package/dist/connectors/manifest.js +72 -0
  261. package/dist/connectors/manifest.js.map +1 -0
  262. package/dist/connectors/runner.d.ts +17 -0
  263. package/dist/connectors/runner.d.ts.map +1 -0
  264. package/dist/connectors/runner.js +36 -0
  265. package/dist/connectors/runner.js.map +1 -0
  266. package/dist/connectors/url-guard.d.ts +7 -0
  267. package/dist/connectors/url-guard.d.ts.map +1 -0
  268. package/dist/connectors/url-guard.js +50 -0
  269. package/dist/connectors/url-guard.js.map +1 -0
  270. package/dist/conversation/connector-command-controller.d.ts +31 -0
  271. package/dist/conversation/connector-command-controller.d.ts.map +1 -0
  272. package/dist/conversation/connector-command-controller.js +105 -0
  273. package/dist/conversation/connector-command-controller.js.map +1 -0
  274. package/dist/conversation/context-command-controller.d.ts +23 -0
  275. package/dist/conversation/context-command-controller.d.ts.map +1 -0
  276. package/dist/conversation/context-command-controller.js +184 -0
  277. package/dist/conversation/context-command-controller.js.map +1 -0
  278. package/dist/conversation/group-reply-policy.d.ts +3 -0
  279. package/dist/conversation/group-reply-policy.d.ts.map +1 -0
  280. package/dist/conversation/group-reply-policy.js +17 -0
  281. package/dist/conversation/group-reply-policy.js.map +1 -0
  282. package/dist/conversation/index.d.ts +3 -0
  283. package/dist/conversation/index.d.ts.map +1 -0
  284. package/dist/conversation/index.js +2 -0
  285. package/dist/conversation/index.js.map +1 -0
  286. package/dist/conversation/lock-manager.d.ts +47 -0
  287. package/dist/conversation/lock-manager.d.ts.map +1 -0
  288. package/dist/conversation/lock-manager.js +144 -0
  289. package/dist/conversation/lock-manager.js.map +1 -0
  290. package/dist/conversation/memory-trace.d.ts +16 -0
  291. package/dist/conversation/memory-trace.d.ts.map +1 -0
  292. package/dist/conversation/memory-trace.js +13 -0
  293. package/dist/conversation/memory-trace.js.map +1 -0
  294. package/dist/conversation/natural-schedule-command-controller.d.ts +21 -0
  295. package/dist/conversation/natural-schedule-command-controller.d.ts.map +1 -0
  296. package/dist/conversation/natural-schedule-command-controller.js +180 -0
  297. package/dist/conversation/natural-schedule-command-controller.js.map +1 -0
  298. package/dist/conversation/ops.d.ts +75 -0
  299. package/dist/conversation/ops.d.ts.map +1 -0
  300. package/dist/conversation/ops.js +169 -0
  301. package/dist/conversation/ops.js.map +1 -0
  302. package/dist/conversation/owner-action-command-controller.d.ts +25 -0
  303. package/dist/conversation/owner-action-command-controller.d.ts.map +1 -0
  304. package/dist/conversation/owner-action-command-controller.js +90 -0
  305. package/dist/conversation/owner-action-command-controller.js.map +1 -0
  306. package/dist/conversation/owner-action-planner.d.ts +28 -0
  307. package/dist/conversation/owner-action-planner.d.ts.map +1 -0
  308. package/dist/conversation/owner-action-planner.js +99 -0
  309. package/dist/conversation/owner-action-planner.js.map +1 -0
  310. package/dist/conversation/rate-limiter.d.ts +22 -0
  311. package/dist/conversation/rate-limiter.d.ts.map +1 -0
  312. package/dist/conversation/rate-limiter.js +66 -0
  313. package/dist/conversation/rate-limiter.js.map +1 -0
  314. package/dist/conversation/runtime-admin-media.d.ts +11 -0
  315. package/dist/conversation/runtime-admin-media.d.ts.map +1 -0
  316. package/dist/conversation/runtime-admin-media.js +31 -0
  317. package/dist/conversation/runtime-admin-media.js.map +1 -0
  318. package/dist/conversation/runtime-group.d.ts +13 -0
  319. package/dist/conversation/runtime-group.d.ts.map +1 -0
  320. package/dist/conversation/runtime-group.js +96 -0
  321. package/dist/conversation/runtime-group.js.map +1 -0
  322. package/dist/conversation/runtime-impl.d.ts +90 -0
  323. package/dist/conversation/runtime-impl.d.ts.map +1 -0
  324. package/dist/conversation/runtime-impl.js +452 -0
  325. package/dist/conversation/runtime-impl.js.map +1 -0
  326. package/dist/conversation/runtime-kb.d.ts +36 -0
  327. package/dist/conversation/runtime-kb.d.ts.map +1 -0
  328. package/dist/conversation/runtime-kb.js +123 -0
  329. package/dist/conversation/runtime-kb.js.map +1 -0
  330. package/dist/conversation/runtime-media.d.ts +28 -0
  331. package/dist/conversation/runtime-media.d.ts.map +1 -0
  332. package/dist/conversation/runtime-media.js +93 -0
  333. package/dist/conversation/runtime-media.js.map +1 -0
  334. package/dist/conversation/runtime-production.d.ts +36 -0
  335. package/dist/conversation/runtime-production.d.ts.map +1 -0
  336. package/dist/conversation/runtime-production.js +274 -0
  337. package/dist/conversation/runtime-production.js.map +1 -0
  338. package/dist/conversation/runtime-timing.d.ts +2 -0
  339. package/dist/conversation/runtime-timing.d.ts.map +1 -0
  340. package/dist/conversation/runtime-timing.js +2 -0
  341. package/dist/conversation/runtime-timing.js.map +1 -0
  342. package/dist/conversation/runtime.d.ts +3 -0
  343. package/dist/conversation/runtime.d.ts.map +1 -0
  344. package/dist/conversation/runtime.js +2 -0
  345. package/dist/conversation/runtime.js.map +1 -0
  346. package/dist/conversation/secure-tool-natural-language-controller.d.ts +67 -0
  347. package/dist/conversation/secure-tool-natural-language-controller.d.ts.map +1 -0
  348. package/dist/conversation/secure-tool-natural-language-controller.js +634 -0
  349. package/dist/conversation/secure-tool-natural-language-controller.js.map +1 -0
  350. package/dist/conversation/secure-tool-routing.d.ts +5 -0
  351. package/dist/conversation/secure-tool-routing.d.ts.map +1 -0
  352. package/dist/conversation/secure-tool-routing.js +91 -0
  353. package/dist/conversation/secure-tool-routing.js.map +1 -0
  354. package/dist/conversation/secure-tool-runtime-utils.d.ts +4 -0
  355. package/dist/conversation/secure-tool-runtime-utils.d.ts.map +1 -0
  356. package/dist/conversation/secure-tool-runtime-utils.js +19 -0
  357. package/dist/conversation/secure-tool-runtime-utils.js.map +1 -0
  358. package/dist/conversation/slash-command.d.ts +8 -0
  359. package/dist/conversation/slash-command.d.ts.map +1 -0
  360. package/dist/conversation/slash-command.js +13 -0
  361. package/dist/conversation/slash-command.js.map +1 -0
  362. package/dist/conversation/target-resolver.d.ts +7 -0
  363. package/dist/conversation/target-resolver.d.ts.map +1 -0
  364. package/dist/conversation/target-resolver.js +23 -0
  365. package/dist/conversation/target-resolver.js.map +1 -0
  366. package/dist/copilot/engine.d.ts +102 -0
  367. package/dist/copilot/engine.d.ts.map +1 -0
  368. package/dist/copilot/engine.js +222 -0
  369. package/dist/copilot/engine.js.map +1 -0
  370. package/dist/copilot/index.d.ts +3 -0
  371. package/dist/copilot/index.d.ts.map +1 -0
  372. package/dist/copilot/index.js +2 -0
  373. package/dist/copilot/index.js.map +1 -0
  374. package/dist/database/index.d.ts +135 -0
  375. package/dist/database/index.d.ts.map +1 -0
  376. package/dist/database/index.js +331 -0
  377. package/dist/database/index.js.map +1 -0
  378. package/dist/database/path.d.ts +2 -0
  379. package/dist/database/path.d.ts.map +1 -0
  380. package/dist/database/path.js +5 -0
  381. package/dist/database/path.js.map +1 -0
  382. package/dist/event-bus/index.d.ts +153 -0
  383. package/dist/event-bus/index.d.ts.map +1 -0
  384. package/dist/event-bus/index.js +118 -0
  385. package/dist/event-bus/index.js.map +1 -0
  386. package/dist/event-sourcing/index.d.ts +3 -0
  387. package/dist/event-sourcing/index.d.ts.map +1 -0
  388. package/dist/event-sourcing/index.js +2 -0
  389. package/dist/event-sourcing/index.js.map +1 -0
  390. package/dist/event-sourcing/store.d.ts +54 -0
  391. package/dist/event-sourcing/store.d.ts.map +1 -0
  392. package/dist/event-sourcing/store.js +169 -0
  393. package/dist/event-sourcing/store.js.map +1 -0
  394. package/dist/gateway/auth/index.d.ts +5 -0
  395. package/dist/gateway/auth/index.d.ts.map +1 -0
  396. package/dist/gateway/auth/index.js +5 -0
  397. package/dist/gateway/auth/index.js.map +1 -0
  398. package/dist/gateway/auth/store.d.ts +44 -0
  399. package/dist/gateway/auth/store.d.ts.map +1 -0
  400. package/dist/gateway/auth/store.js +387 -0
  401. package/dist/gateway/auth/store.js.map +1 -0
  402. package/dist/gateway/bootstrap.d.ts +2 -0
  403. package/dist/gateway/bootstrap.d.ts.map +1 -0
  404. package/dist/gateway/bootstrap.js +8 -0
  405. package/dist/gateway/bootstrap.js.map +1 -0
  406. package/dist/gateway/conn-state-machine.d.ts +25 -0
  407. package/dist/gateway/conn-state-machine.d.ts.map +1 -0
  408. package/dist/gateway/conn-state-machine.js +39 -0
  409. package/dist/gateway/conn-state-machine.js.map +1 -0
  410. package/dist/gateway/connection-state.d.ts +22 -0
  411. package/dist/gateway/connection-state.d.ts.map +1 -0
  412. package/dist/gateway/connection-state.js +60 -0
  413. package/dist/gateway/connection-state.js.map +1 -0
  414. package/dist/gateway/events/handler.d.ts +75 -0
  415. package/dist/gateway/events/handler.d.ts.map +1 -0
  416. package/dist/gateway/events/handler.js +164 -0
  417. package/dist/gateway/events/handler.js.map +1 -0
  418. package/dist/gateway/events/index.d.ts +3 -0
  419. package/dist/gateway/events/index.d.ts.map +1 -0
  420. package/dist/gateway/events/index.js +2 -0
  421. package/dist/gateway/events/index.js.map +1 -0
  422. package/dist/gateway/exit-shutdown.d.ts +5 -0
  423. package/dist/gateway/exit-shutdown.d.ts.map +1 -0
  424. package/dist/gateway/exit-shutdown.js +12 -0
  425. package/dist/gateway/exit-shutdown.js.map +1 -0
  426. package/dist/gateway/group-activation.d.ts +25 -0
  427. package/dist/gateway/group-activation.d.ts.map +1 -0
  428. package/dist/gateway/group-activation.js +78 -0
  429. package/dist/gateway/group-activation.js.map +1 -0
  430. package/dist/gateway/health/index.d.ts +3 -0
  431. package/dist/gateway/health/index.d.ts.map +1 -0
  432. package/dist/gateway/health/index.js +2 -0
  433. package/dist/gateway/health/index.js.map +1 -0
  434. package/dist/gateway/health/monitor.d.ts +63 -0
  435. package/dist/gateway/health/monitor.d.ts.map +1 -0
  436. package/dist/gateway/health/monitor.js +94 -0
  437. package/dist/gateway/health/monitor.js.map +1 -0
  438. package/dist/gateway/index.d.ts +12 -0
  439. package/dist/gateway/index.d.ts.map +1 -0
  440. package/dist/gateway/index.js +10 -0
  441. package/dist/gateway/index.js.map +1 -0
  442. package/dist/gateway/logger.d.ts +8 -0
  443. package/dist/gateway/logger.d.ts.map +1 -0
  444. package/dist/gateway/logger.js +12 -0
  445. package/dist/gateway/logger.js.map +1 -0
  446. package/dist/gateway/media-queue-worker-runtime.d.ts +16 -0
  447. package/dist/gateway/media-queue-worker-runtime.d.ts.map +1 -0
  448. package/dist/gateway/media-queue-worker-runtime.js +35 -0
  449. package/dist/gateway/media-queue-worker-runtime.js.map +1 -0
  450. package/dist/gateway/message-buffer.d.ts +9 -0
  451. package/dist/gateway/message-buffer.d.ts.map +1 -0
  452. package/dist/gateway/message-buffer.js +16 -0
  453. package/dist/gateway/message-buffer.js.map +1 -0
  454. package/dist/gateway/outgoing-messages.d.ts +4 -0
  455. package/dist/gateway/outgoing-messages.d.ts.map +1 -0
  456. package/dist/gateway/outgoing-messages.js +25 -0
  457. package/dist/gateway/outgoing-messages.js.map +1 -0
  458. package/dist/gateway/process-lifecycle.d.ts +8 -0
  459. package/dist/gateway/process-lifecycle.d.ts.map +1 -0
  460. package/dist/gateway/process-lifecycle.js +14 -0
  461. package/dist/gateway/process-lifecycle.js.map +1 -0
  462. package/dist/gateway/process-safety.d.ts +14 -0
  463. package/dist/gateway/process-safety.d.ts.map +1 -0
  464. package/dist/gateway/process-safety.js +48 -0
  465. package/dist/gateway/process-safety.js.map +1 -0
  466. package/dist/gateway/reconnect/index.d.ts +3 -0
  467. package/dist/gateway/reconnect/index.d.ts.map +1 -0
  468. package/dist/gateway/reconnect/index.js +2 -0
  469. package/dist/gateway/reconnect/index.js.map +1 -0
  470. package/dist/gateway/reconnect/manager.d.ts +59 -0
  471. package/dist/gateway/reconnect/manager.d.ts.map +1 -0
  472. package/dist/gateway/reconnect/manager.js +195 -0
  473. package/dist/gateway/reconnect/manager.js.map +1 -0
  474. package/dist/gateway/self-echo-guard.d.ts +2 -0
  475. package/dist/gateway/self-echo-guard.d.ts.map +1 -0
  476. package/dist/gateway/self-echo-guard.js +31 -0
  477. package/dist/gateway/self-echo-guard.js.map +1 -0
  478. package/dist/gateway/server.d.ts +61 -0
  479. package/dist/gateway/server.d.ts.map +1 -0
  480. package/dist/gateway/server.js +947 -0
  481. package/dist/gateway/server.js.map +1 -0
  482. package/dist/gateway/shutdown-registry.d.ts +5 -0
  483. package/dist/gateway/shutdown-registry.d.ts.map +1 -0
  484. package/dist/gateway/shutdown-registry.js +20 -0
  485. package/dist/gateway/shutdown-registry.js.map +1 -0
  486. package/dist/gateway/socket/connection.d.ts +45 -0
  487. package/dist/gateway/socket/connection.d.ts.map +1 -0
  488. package/dist/gateway/socket/connection.js +198 -0
  489. package/dist/gateway/socket/connection.js.map +1 -0
  490. package/dist/gateway/socket/index.d.ts +3 -0
  491. package/dist/gateway/socket/index.d.ts.map +1 -0
  492. package/dist/gateway/socket/index.js +3 -0
  493. package/dist/gateway/socket/index.js.map +1 -0
  494. package/dist/gateway/sync-mutex.d.ts +13 -0
  495. package/dist/gateway/sync-mutex.d.ts.map +1 -0
  496. package/dist/gateway/sync-mutex.js +26 -0
  497. package/dist/gateway/sync-mutex.js.map +1 -0
  498. package/dist/gateway/text-media.d.ts +23 -0
  499. package/dist/gateway/text-media.d.ts.map +1 -0
  500. package/dist/gateway/text-media.js +30 -0
  501. package/dist/gateway/text-media.js.map +1 -0
  502. package/dist/group-intel/engine.d.ts +77 -0
  503. package/dist/group-intel/engine.d.ts.map +1 -0
  504. package/dist/group-intel/engine.js +197 -0
  505. package/dist/group-intel/engine.js.map +1 -0
  506. package/dist/group-intel/index.d.ts +3 -0
  507. package/dist/group-intel/index.d.ts.map +1 -0
  508. package/dist/group-intel/index.js +2 -0
  509. package/dist/group-intel/index.js.map +1 -0
  510. package/dist/intent/classifier.d.ts +17 -0
  511. package/dist/intent/classifier.d.ts.map +1 -0
  512. package/dist/intent/classifier.js +89 -0
  513. package/dist/intent/classifier.js.map +1 -0
  514. package/dist/kb/store.d.ts +38 -0
  515. package/dist/kb/store.d.ts.map +1 -0
  516. package/dist/kb/store.js +114 -0
  517. package/dist/kb/store.js.map +1 -0
  518. package/dist/llm/audit.d.ts +70 -0
  519. package/dist/llm/audit.d.ts.map +1 -0
  520. package/dist/llm/audit.js +281 -0
  521. package/dist/llm/audit.js.map +1 -0
  522. package/dist/llm/base-provider.d.ts +46 -0
  523. package/dist/llm/base-provider.d.ts.map +1 -0
  524. package/dist/llm/base-provider.js +158 -0
  525. package/dist/llm/base-provider.js.map +1 -0
  526. package/dist/llm/config.d.ts +32 -0
  527. package/dist/llm/config.d.ts.map +1 -0
  528. package/dist/llm/config.js +125 -0
  529. package/dist/llm/config.js.map +1 -0
  530. package/dist/llm/direct-tool-guard.d.ts +8 -0
  531. package/dist/llm/direct-tool-guard.d.ts.map +1 -0
  532. package/dist/llm/direct-tool-guard.js +36 -0
  533. package/dist/llm/direct-tool-guard.js.map +1 -0
  534. package/dist/llm/engine.d.ts +44 -0
  535. package/dist/llm/engine.d.ts.map +1 -0
  536. package/dist/llm/engine.js +327 -0
  537. package/dist/llm/engine.js.map +1 -0
  538. package/dist/llm/index.d.ts +8 -0
  539. package/dist/llm/index.d.ts.map +1 -0
  540. package/dist/llm/index.js +8 -0
  541. package/dist/llm/index.js.map +1 -0
  542. package/dist/llm/model-settings.d.ts +57 -0
  543. package/dist/llm/model-settings.d.ts.map +1 -0
  544. package/dist/llm/model-settings.js +184 -0
  545. package/dist/llm/model-settings.js.map +1 -0
  546. package/dist/llm/ocr-client.d.ts +19 -0
  547. package/dist/llm/ocr-client.d.ts.map +1 -0
  548. package/dist/llm/ocr-client.js +94 -0
  549. package/dist/llm/ocr-client.js.map +1 -0
  550. package/dist/llm/ocr-errors.d.ts +15 -0
  551. package/dist/llm/ocr-errors.d.ts.map +1 -0
  552. package/dist/llm/ocr-errors.js +42 -0
  553. package/dist/llm/ocr-errors.js.map +1 -0
  554. package/dist/llm/ocr-registry.d.ts +33 -0
  555. package/dist/llm/ocr-registry.d.ts.map +1 -0
  556. package/dist/llm/ocr-registry.js +129 -0
  557. package/dist/llm/ocr-registry.js.map +1 -0
  558. package/dist/llm/ocr-types.d.ts +53 -0
  559. package/dist/llm/ocr-types.d.ts.map +1 -0
  560. package/dist/llm/ocr-types.js +11 -0
  561. package/dist/llm/ocr-types.js.map +1 -0
  562. package/dist/llm/providers/anthropic-ocr.d.ts +3 -0
  563. package/dist/llm/providers/anthropic-ocr.d.ts.map +1 -0
  564. package/dist/llm/providers/anthropic-ocr.js +32 -0
  565. package/dist/llm/providers/anthropic-ocr.js.map +1 -0
  566. package/dist/llm/providers/custom-ocr.d.ts +3 -0
  567. package/dist/llm/providers/custom-ocr.d.ts.map +1 -0
  568. package/dist/llm/providers/custom-ocr.js +20 -0
  569. package/dist/llm/providers/custom-ocr.js.map +1 -0
  570. package/dist/llm/providers/gemini-ocr.d.ts +3 -0
  571. package/dist/llm/providers/gemini-ocr.d.ts.map +1 -0
  572. package/dist/llm/providers/gemini-ocr.js +26 -0
  573. package/dist/llm/providers/gemini-ocr.js.map +1 -0
  574. package/dist/llm/providers/http-ocr.d.ts +12 -0
  575. package/dist/llm/providers/http-ocr.d.ts.map +1 -0
  576. package/dist/llm/providers/http-ocr.js +135 -0
  577. package/dist/llm/providers/http-ocr.js.map +1 -0
  578. package/dist/llm/providers/local-ocr.d.ts +3 -0
  579. package/dist/llm/providers/local-ocr.d.ts.map +1 -0
  580. package/dist/llm/providers/local-ocr.js +19 -0
  581. package/dist/llm/providers/local-ocr.js.map +1 -0
  582. package/dist/llm/providers/ollama-ocr.d.ts +3 -0
  583. package/dist/llm/providers/ollama-ocr.d.ts.map +1 -0
  584. package/dist/llm/providers/ollama-ocr.js +18 -0
  585. package/dist/llm/providers/ollama-ocr.js.map +1 -0
  586. package/dist/llm/providers/openai-compat.d.ts +26 -0
  587. package/dist/llm/providers/openai-compat.d.ts.map +1 -0
  588. package/dist/llm/providers/openai-compat.js +284 -0
  589. package/dist/llm/providers/openai-compat.js.map +1 -0
  590. package/dist/llm/providers/openai-compatible-ocr.d.ts +3 -0
  591. package/dist/llm/providers/openai-compatible-ocr.d.ts.map +1 -0
  592. package/dist/llm/providers/openai-compatible-ocr.js +21 -0
  593. package/dist/llm/providers/openai-compatible-ocr.js.map +1 -0
  594. package/dist/llm/providers/openai-ocr.d.ts +3 -0
  595. package/dist/llm/providers/openai-ocr.d.ts.map +1 -0
  596. package/dist/llm/providers/openai-ocr.js +25 -0
  597. package/dist/llm/providers/openai-ocr.js.map +1 -0
  598. package/dist/llm/providers/openrouter-ocr.d.ts +3 -0
  599. package/dist/llm/providers/openrouter-ocr.d.ts.map +1 -0
  600. package/dist/llm/providers/openrouter-ocr.js +21 -0
  601. package/dist/llm/providers/openrouter-ocr.js.map +1 -0
  602. package/dist/llm/response-sanitizer.d.ts +3 -0
  603. package/dist/llm/response-sanitizer.d.ts.map +1 -0
  604. package/dist/llm/response-sanitizer.js +122 -0
  605. package/dist/llm/response-sanitizer.js.map +1 -0
  606. package/dist/llm/router.d.ts +29 -0
  607. package/dist/llm/router.d.ts.map +1 -0
  608. package/dist/llm/router.js +167 -0
  609. package/dist/llm/router.js.map +1 -0
  610. package/dist/llm/safety.d.ts +15 -0
  611. package/dist/llm/safety.d.ts.map +1 -0
  612. package/dist/llm/safety.js +48 -0
  613. package/dist/llm/safety.js.map +1 -0
  614. package/dist/llm/search-planner.d.ts +4 -0
  615. package/dist/llm/search-planner.d.ts.map +1 -0
  616. package/dist/llm/search-planner.js +49 -0
  617. package/dist/llm/search-planner.js.map +1 -0
  618. package/dist/llm/task-router.d.ts +19 -0
  619. package/dist/llm/task-router.d.ts.map +1 -0
  620. package/dist/llm/task-router.js +70 -0
  621. package/dist/llm/task-router.js.map +1 -0
  622. package/dist/llm/types.d.ts +161 -0
  623. package/dist/llm/types.d.ts.map +1 -0
  624. package/dist/llm/types.js +45 -0
  625. package/dist/llm/types.js.map +1 -0
  626. package/dist/media/command-controller.d.ts +15 -0
  627. package/dist/media/command-controller.d.ts.map +1 -0
  628. package/dist/media/command-controller.js +122 -0
  629. package/dist/media/command-controller.js.map +1 -0
  630. package/dist/media/command-parse.d.ts +2 -0
  631. package/dist/media/command-parse.d.ts.map +1 -0
  632. package/dist/media/command-parse.js +5 -0
  633. package/dist/media/command-parse.js.map +1 -0
  634. package/dist/media/index.d.ts +13 -0
  635. package/dist/media/index.d.ts.map +1 -0
  636. package/dist/media/index.js +7 -0
  637. package/dist/media/index.js.map +1 -0
  638. package/dist/media/policy.d.ts +23 -0
  639. package/dist/media/policy.d.ts.map +1 -0
  640. package/dist/media/policy.js +125 -0
  641. package/dist/media/policy.js.map +1 -0
  642. package/dist/media/prep-router.d.ts +24 -0
  643. package/dist/media/prep-router.d.ts.map +1 -0
  644. package/dist/media/prep-router.js +79 -0
  645. package/dist/media/prep-router.js.map +1 -0
  646. package/dist/media/prep.d.ts +22 -0
  647. package/dist/media/prep.d.ts.map +1 -0
  648. package/dist/media/prep.js +74 -0
  649. package/dist/media/prep.js.map +1 -0
  650. package/dist/media/queue-admin.d.ts +10 -0
  651. package/dist/media/queue-admin.d.ts.map +1 -0
  652. package/dist/media/queue-admin.js +47 -0
  653. package/dist/media/queue-admin.js.map +1 -0
  654. package/dist/media/queue-runner.d.ts +28 -0
  655. package/dist/media/queue-runner.d.ts.map +1 -0
  656. package/dist/media/queue-runner.js +71 -0
  657. package/dist/media/queue-runner.js.map +1 -0
  658. package/dist/media/queue-store.d.ts +27 -0
  659. package/dist/media/queue-store.d.ts.map +1 -0
  660. package/dist/media/queue-store.js +147 -0
  661. package/dist/media/queue-store.js.map +1 -0
  662. package/dist/media/queue-types.d.ts +71 -0
  663. package/dist/media/queue-types.d.ts.map +1 -0
  664. package/dist/media/queue-types.js +2 -0
  665. package/dist/media/queue-types.js.map +1 -0
  666. package/dist/media/queue-utils.d.ts +9 -0
  667. package/dist/media/queue-utils.d.ts.map +1 -0
  668. package/dist/media/queue-utils.js +52 -0
  669. package/dist/media/queue-utils.js.map +1 -0
  670. package/dist/media/queue-worker.d.ts +31 -0
  671. package/dist/media/queue-worker.d.ts.map +1 -0
  672. package/dist/media/queue-worker.js +58 -0
  673. package/dist/media/queue-worker.js.map +1 -0
  674. package/dist/media/reliability.d.ts +58 -0
  675. package/dist/media/reliability.d.ts.map +1 -0
  676. package/dist/media/reliability.js +240 -0
  677. package/dist/media/reliability.js.map +1 -0
  678. package/dist/media/service.d.ts +53 -0
  679. package/dist/media/service.d.ts.map +1 -0
  680. package/dist/media/service.js +238 -0
  681. package/dist/media/service.js.map +1 -0
  682. package/dist/media/text-extractor.d.ts +23 -0
  683. package/dist/media/text-extractor.d.ts.map +1 -0
  684. package/dist/media/text-extractor.js +66 -0
  685. package/dist/media/text-extractor.js.map +1 -0
  686. package/dist/media/text-format.d.ts +10 -0
  687. package/dist/media/text-format.d.ts.map +1 -0
  688. package/dist/media/text-format.js +19 -0
  689. package/dist/media/text-format.js.map +1 -0
  690. package/dist/media-orchestration/engine.d.ts +74 -0
  691. package/dist/media-orchestration/engine.d.ts.map +1 -0
  692. package/dist/media-orchestration/engine.js +155 -0
  693. package/dist/media-orchestration/engine.js.map +1 -0
  694. package/dist/media-orchestration/index.d.ts +3 -0
  695. package/dist/media-orchestration/index.d.ts.map +1 -0
  696. package/dist/media-orchestration/index.js +2 -0
  697. package/dist/media-orchestration/index.js.map +1 -0
  698. package/dist/memory/index.d.ts +3 -0
  699. package/dist/memory/index.d.ts.map +1 -0
  700. package/dist/memory/index.js +2 -0
  701. package/dist/memory/index.js.map +1 -0
  702. package/dist/memory/persistent.d.ts +78 -0
  703. package/dist/memory/persistent.d.ts.map +1 -0
  704. package/dist/memory/persistent.js +254 -0
  705. package/dist/memory/persistent.js.map +1 -0
  706. package/dist/memory-isolation/engine.d.ts +83 -0
  707. package/dist/memory-isolation/engine.d.ts.map +1 -0
  708. package/dist/memory-isolation/engine.js +247 -0
  709. package/dist/memory-isolation/engine.js.map +1 -0
  710. package/dist/memory-isolation/index.d.ts +3 -0
  711. package/dist/memory-isolation/index.d.ts.map +1 -0
  712. package/dist/memory-isolation/index.js +2 -0
  713. package/dist/memory-isolation/index.js.map +1 -0
  714. package/dist/message-dedupe/engine.d.ts +67 -0
  715. package/dist/message-dedupe/engine.d.ts.map +1 -0
  716. package/dist/message-dedupe/engine.js +208 -0
  717. package/dist/message-dedupe/engine.js.map +1 -0
  718. package/dist/message-dedupe/index.d.ts +3 -0
  719. package/dist/message-dedupe/index.d.ts.map +1 -0
  720. package/dist/message-dedupe/index.js +2 -0
  721. package/dist/message-dedupe/index.js.map +1 -0
  722. package/dist/monitoring/index.d.ts +3 -0
  723. package/dist/monitoring/index.d.ts.map +1 -0
  724. package/dist/monitoring/index.js +2 -0
  725. package/dist/monitoring/index.js.map +1 -0
  726. package/dist/monitoring/leak-detector.d.ts +63 -0
  727. package/dist/monitoring/leak-detector.d.ts.map +1 -0
  728. package/dist/monitoring/leak-detector.js +169 -0
  729. package/dist/monitoring/leak-detector.js.map +1 -0
  730. package/dist/monitoring/runtime-health.d.ts +14 -0
  731. package/dist/monitoring/runtime-health.d.ts.map +1 -0
  732. package/dist/monitoring/runtime-health.js +82 -0
  733. package/dist/monitoring/runtime-health.js.map +1 -0
  734. package/dist/observability/safe-log.d.ts +3 -0
  735. package/dist/observability/safe-log.d.ts.map +1 -0
  736. package/dist/observability/safe-log.js +22 -0
  737. package/dist/observability/safe-log.js.map +1 -0
  738. package/dist/outbound/index.d.ts +3 -0
  739. package/dist/outbound/index.d.ts.map +1 -0
  740. package/dist/outbound/index.js +2 -0
  741. package/dist/outbound/index.js.map +1 -0
  742. package/dist/outbound/ledger.d.ts +78 -0
  743. package/dist/outbound/ledger.d.ts.map +1 -0
  744. package/dist/outbound/ledger.js +143 -0
  745. package/dist/outbound/ledger.js.map +1 -0
  746. package/dist/owner/config.d.ts +43 -0
  747. package/dist/owner/config.d.ts.map +1 -0
  748. package/dist/owner/config.js +110 -0
  749. package/dist/owner/config.js.map +1 -0
  750. package/dist/owner/help.d.ts +2 -0
  751. package/dist/owner/help.d.ts.map +1 -0
  752. package/dist/owner/help.js +96 -0
  753. package/dist/owner/help.js.map +1 -0
  754. package/dist/owner/identity.d.ts +45 -0
  755. package/dist/owner/identity.d.ts.map +1 -0
  756. package/dist/owner/identity.js +155 -0
  757. package/dist/owner/identity.js.map +1 -0
  758. package/dist/owner/index.d.ts +7 -0
  759. package/dist/owner/index.d.ts.map +1 -0
  760. package/dist/owner/index.js +4 -0
  761. package/dist/owner/index.js.map +1 -0
  762. package/dist/owner/ocr-help.d.ts +2 -0
  763. package/dist/owner/ocr-help.d.ts.map +1 -0
  764. package/dist/owner/ocr-help.js +13 -0
  765. package/dist/owner/ocr-help.js.map +1 -0
  766. package/dist/owner/router.d.ts +47 -0
  767. package/dist/owner/router.d.ts.map +1 -0
  768. package/dist/owner/router.js +229 -0
  769. package/dist/owner/router.js.map +1 -0
  770. package/dist/prompts/registry.d.ts +19 -0
  771. package/dist/prompts/registry.d.ts.map +1 -0
  772. package/dist/prompts/registry.js +64 -0
  773. package/dist/prompts/registry.js.map +1 -0
  774. package/dist/scheduler/alias-planner.d.ts +9 -0
  775. package/dist/scheduler/alias-planner.d.ts.map +1 -0
  776. package/dist/scheduler/alias-planner.js +57 -0
  777. package/dist/scheduler/alias-planner.js.map +1 -0
  778. package/dist/scheduler/runner.d.ts +16 -0
  779. package/dist/scheduler/runner.d.ts.map +1 -0
  780. package/dist/scheduler/runner.js +40 -0
  781. package/dist/scheduler/runner.js.map +1 -0
  782. package/dist/scheduler/store.d.ts +35 -0
  783. package/dist/scheduler/store.d.ts.map +1 -0
  784. package/dist/scheduler/store.js +104 -0
  785. package/dist/scheduler/store.js.map +1 -0
  786. package/dist/scheduler/time.d.ts +8 -0
  787. package/dist/scheduler/time.d.ts.map +1 -0
  788. package/dist/scheduler/time.js +248 -0
  789. package/dist/scheduler/time.js.map +1 -0
  790. package/dist/security/backup.d.ts +69 -0
  791. package/dist/security/backup.d.ts.map +1 -0
  792. package/dist/security/backup.js +319 -0
  793. package/dist/security/backup.js.map +1 -0
  794. package/dist/security/index.d.ts +7 -0
  795. package/dist/security/index.d.ts.map +1 -0
  796. package/dist/security/index.js +4 -0
  797. package/dist/security/index.js.map +1 -0
  798. package/dist/security/red-team.d.ts +52 -0
  799. package/dist/security/red-team.d.ts.map +1 -0
  800. package/dist/security/red-team.js +249 -0
  801. package/dist/security/red-team.js.map +1 -0
  802. package/dist/security/tester.d.ts +65 -0
  803. package/dist/security/tester.d.ts.map +1 -0
  804. package/dist/security/tester.js +218 -0
  805. package/dist/security/tester.js.map +1 -0
  806. package/dist/self-improvement/index.d.ts +2 -0
  807. package/dist/self-improvement/index.d.ts.map +1 -0
  808. package/dist/self-improvement/index.js +2 -0
  809. package/dist/self-improvement/index.js.map +1 -0
  810. package/dist/self-improvement/trace-store.d.ts +27 -0
  811. package/dist/self-improvement/trace-store.d.ts.map +1 -0
  812. package/dist/self-improvement/trace-store.js +88 -0
  813. package/dist/self-improvement/trace-store.js.map +1 -0
  814. package/dist/session/index.d.ts +9 -0
  815. package/dist/session/index.d.ts.map +1 -0
  816. package/dist/session/index.js +5 -0
  817. package/dist/session/index.js.map +1 -0
  818. package/dist/session/manager.d.ts +65 -0
  819. package/dist/session/manager.d.ts.map +1 -0
  820. package/dist/session/manager.js +265 -0
  821. package/dist/session/manager.js.map +1 -0
  822. package/dist/session/recovery.d.ts +44 -0
  823. package/dist/session/recovery.d.ts.map +1 -0
  824. package/dist/session/recovery.js +196 -0
  825. package/dist/session/recovery.js.map +1 -0
  826. package/dist/session/snapshot.d.ts +70 -0
  827. package/dist/session/snapshot.d.ts.map +1 -0
  828. package/dist/session/snapshot.js +268 -0
  829. package/dist/session/snapshot.js.map +1 -0
  830. package/dist/session/validator.d.ts +56 -0
  831. package/dist/session/validator.d.ts.map +1 -0
  832. package/dist/session/validator.js +247 -0
  833. package/dist/session/validator.js.map +1 -0
  834. package/dist/support/store.d.ts +91 -0
  835. package/dist/support/store.d.ts.map +1 -0
  836. package/dist/support/store.js +352 -0
  837. package/dist/support/store.js.map +1 -0
  838. package/dist/test/setup-env.d.ts +2 -0
  839. package/dist/test/setup-env.d.ts.map +1 -0
  840. package/dist/test/setup-env.js +34 -0
  841. package/dist/test/setup-env.js.map +1 -0
  842. package/dist/tool-runtime/access-policy.d.ts +25 -0
  843. package/dist/tool-runtime/access-policy.d.ts.map +1 -0
  844. package/dist/tool-runtime/access-policy.js +42 -0
  845. package/dist/tool-runtime/access-policy.js.map +1 -0
  846. package/dist/tool-runtime/audit.d.ts +13 -0
  847. package/dist/tool-runtime/audit.d.ts.map +1 -0
  848. package/dist/tool-runtime/audit.js +34 -0
  849. package/dist/tool-runtime/audit.js.map +1 -0
  850. package/dist/tool-runtime/engine.d.ts +154 -0
  851. package/dist/tool-runtime/engine.d.ts.map +1 -0
  852. package/dist/tool-runtime/engine.js +236 -0
  853. package/dist/tool-runtime/engine.js.map +1 -0
  854. package/dist/tool-runtime/http-executor.d.ts +19 -0
  855. package/dist/tool-runtime/http-executor.d.ts.map +1 -0
  856. package/dist/tool-runtime/http-executor.js +85 -0
  857. package/dist/tool-runtime/http-executor.js.map +1 -0
  858. package/dist/tool-runtime/identity.d.ts +25 -0
  859. package/dist/tool-runtime/identity.d.ts.map +1 -0
  860. package/dist/tool-runtime/identity.js +55 -0
  861. package/dist/tool-runtime/identity.js.map +1 -0
  862. package/dist/tool-runtime/index.d.ts +3 -0
  863. package/dist/tool-runtime/index.d.ts.map +1 -0
  864. package/dist/tool-runtime/index.js +2 -0
  865. package/dist/tool-runtime/index.js.map +1 -0
  866. package/dist/tool-runtime/manifest-loader.d.ts +6 -0
  867. package/dist/tool-runtime/manifest-loader.d.ts.map +1 -0
  868. package/dist/tool-runtime/manifest-loader.js +23 -0
  869. package/dist/tool-runtime/manifest-loader.js.map +1 -0
  870. package/dist/tool-runtime/manifest.d.ts +71 -0
  871. package/dist/tool-runtime/manifest.d.ts.map +1 -0
  872. package/dist/tool-runtime/manifest.js +467 -0
  873. package/dist/tool-runtime/manifest.js.map +1 -0
  874. package/dist/tool-runtime/mcp-executor.d.ts +12 -0
  875. package/dist/tool-runtime/mcp-executor.d.ts.map +1 -0
  876. package/dist/tool-runtime/mcp-executor.js +102 -0
  877. package/dist/tool-runtime/mcp-executor.js.map +1 -0
  878. package/dist/tool-runtime/multipart.d.ts +12 -0
  879. package/dist/tool-runtime/multipart.d.ts.map +1 -0
  880. package/dist/tool-runtime/multipart.js +47 -0
  881. package/dist/tool-runtime/multipart.js.map +1 -0
  882. package/dist/tool-runtime/oauth.d.ts +18 -0
  883. package/dist/tool-runtime/oauth.d.ts.map +1 -0
  884. package/dist/tool-runtime/oauth.js +80 -0
  885. package/dist/tool-runtime/oauth.js.map +1 -0
  886. package/dist/tool-runtime/orchestrator.d.ts +38 -0
  887. package/dist/tool-runtime/orchestrator.d.ts.map +1 -0
  888. package/dist/tool-runtime/orchestrator.js +117 -0
  889. package/dist/tool-runtime/orchestrator.js.map +1 -0
  890. package/dist/tool-runtime/planner.d.ts +23 -0
  891. package/dist/tool-runtime/planner.d.ts.map +1 -0
  892. package/dist/tool-runtime/planner.js +126 -0
  893. package/dist/tool-runtime/planner.js.map +1 -0
  894. package/dist/tool-runtime/policy.d.ts +23 -0
  895. package/dist/tool-runtime/policy.d.ts.map +1 -0
  896. package/dist/tool-runtime/policy.js +48 -0
  897. package/dist/tool-runtime/policy.js.map +1 -0
  898. package/dist/tool-runtime/response-template.d.ts +20 -0
  899. package/dist/tool-runtime/response-template.d.ts.map +1 -0
  900. package/dist/tool-runtime/response-template.js +87 -0
  901. package/dist/tool-runtime/response-template.js.map +1 -0
  902. package/dist/tool-runtime/workflow-runner.d.ts +13 -0
  903. package/dist/tool-runtime/workflow-runner.d.ts.map +1 -0
  904. package/dist/tool-runtime/workflow-runner.js +61 -0
  905. package/dist/tool-runtime/workflow-runner.js.map +1 -0
  906. package/dist/tools/crunchtrova.d.ts +78 -0
  907. package/dist/tools/crunchtrova.d.ts.map +1 -0
  908. package/dist/tools/crunchtrova.js +378 -0
  909. package/dist/tools/crunchtrova.js.map +1 -0
  910. package/dist/tools/index.d.ts +7 -0
  911. package/dist/tools/index.d.ts.map +1 -0
  912. package/dist/tools/index.js +4 -0
  913. package/dist/tools/index.js.map +1 -0
  914. package/dist/tools/input-guard.d.ts +8 -0
  915. package/dist/tools/input-guard.d.ts.map +1 -0
  916. package/dist/tools/input-guard.js +41 -0
  917. package/dist/tools/input-guard.js.map +1 -0
  918. package/dist/tools/llm-tool-definitions.d.ts +4 -0
  919. package/dist/tools/llm-tool-definitions.d.ts.map +1 -0
  920. package/dist/tools/llm-tool-definitions.js +30 -0
  921. package/dist/tools/llm-tool-definitions.js.map +1 -0
  922. package/dist/tools/model-manager.d.ts +29 -0
  923. package/dist/tools/model-manager.d.ts.map +1 -0
  924. package/dist/tools/model-manager.js +118 -0
  925. package/dist/tools/model-manager.js.map +1 -0
  926. package/dist/tools/registry.d.ts +41 -0
  927. package/dist/tools/registry.d.ts.map +1 -0
  928. package/dist/tools/registry.js +325 -0
  929. package/dist/tools/registry.js.map +1 -0
  930. package/dist/tools/search-orchestrator.d.ts +74 -0
  931. package/dist/tools/search-orchestrator.d.ts.map +1 -0
  932. package/dist/tools/search-orchestrator.js +174 -0
  933. package/dist/tools/search-orchestrator.js.map +1 -0
  934. package/dist/tools/tool-catalog-config.d.ts +103 -0
  935. package/dist/tools/tool-catalog-config.d.ts.map +1 -0
  936. package/dist/tools/tool-catalog-config.js +185 -0
  937. package/dist/tools/tool-catalog-config.js.map +1 -0
  938. package/dist/tools/tool-catalog.d.ts +24 -0
  939. package/dist/tools/tool-catalog.d.ts.map +1 -0
  940. package/dist/tools/tool-catalog.js +62 -0
  941. package/dist/tools/tool-catalog.js.map +1 -0
  942. package/dist/tools/tool-command-synthesis.d.ts +22 -0
  943. package/dist/tools/tool-command-synthesis.d.ts.map +1 -0
  944. package/dist/tools/tool-command-synthesis.js +17 -0
  945. package/dist/tools/tool-command-synthesis.js.map +1 -0
  946. package/dist/tools/tool-policy.d.ts +21 -0
  947. package/dist/tools/tool-policy.d.ts.map +1 -0
  948. package/dist/tools/tool-policy.js +66 -0
  949. package/dist/tools/tool-policy.js.map +1 -0
  950. package/dist/usage/tracker.d.ts +35 -0
  951. package/dist/usage/tracker.d.ts.map +1 -0
  952. package/dist/usage/tracker.js +141 -0
  953. package/dist/usage/tracker.js.map +1 -0
  954. package/dist/validation/event-matrix.d.ts +41 -0
  955. package/dist/validation/event-matrix.d.ts.map +1 -0
  956. package/dist/validation/event-matrix.js +119 -0
  957. package/dist/validation/event-matrix.js.map +1 -0
  958. package/dist/validation/failure-simulator.d.ts +40 -0
  959. package/dist/validation/failure-simulator.d.ts.map +1 -0
  960. package/dist/validation/failure-simulator.js +216 -0
  961. package/dist/validation/failure-simulator.js.map +1 -0
  962. package/dist/validation/function-verifier.d.ts +48 -0
  963. package/dist/validation/function-verifier.d.ts.map +1 -0
  964. package/dist/validation/function-verifier.js +128 -0
  965. package/dist/validation/function-verifier.js.map +1 -0
  966. package/dist/validation/index.d.ts +14 -0
  967. package/dist/validation/index.d.ts.map +1 -0
  968. package/dist/validation/index.js +9 -0
  969. package/dist/validation/index.js.map +1 -0
  970. package/dist/validation/route-inventory.d.ts +39 -0
  971. package/dist/validation/route-inventory.d.ts.map +1 -0
  972. package/dist/validation/route-inventory.js +413 -0
  973. package/dist/validation/route-inventory.js.map +1 -0
  974. package/dist/validation/state-machine.d.ts +51 -0
  975. package/dist/validation/state-machine.d.ts.map +1 -0
  976. package/dist/validation/state-machine.js +217 -0
  977. package/dist/validation/state-machine.js.map +1 -0
  978. package/dist/voice-pipeline/combined.d.ts +145 -0
  979. package/dist/voice-pipeline/combined.d.ts.map +1 -0
  980. package/dist/voice-pipeline/combined.js +166 -0
  981. package/dist/voice-pipeline/combined.js.map +1 -0
  982. package/dist/voice-pipeline/groq-whisper.d.ts +29 -0
  983. package/dist/voice-pipeline/groq-whisper.d.ts.map +1 -0
  984. package/dist/voice-pipeline/groq-whisper.js +138 -0
  985. package/dist/voice-pipeline/groq-whisper.js.map +1 -0
  986. package/dist/voice-pipeline/index.d.ts +5 -0
  987. package/dist/voice-pipeline/index.d.ts.map +1 -0
  988. package/dist/voice-pipeline/index.js +3 -0
  989. package/dist/voice-pipeline/index.js.map +1 -0
  990. package/docs/CLAUDE_STYLE_TOOLING_HANDOVER.md +1188 -0
  991. package/docs/admin-cli-security.md +71 -0
  992. package/docs/async-job-implementation-status.md +88 -0
  993. package/docs/async-job-workflow.md +175 -0
  994. package/docs/auth-persistence.md +18 -0
  995. package/docs/baileys-resilience.md +103 -0
  996. package/docs/chatbot-architecture-research-plan.md +80 -0
  997. package/docs/config-write-commands.md +78 -0
  998. package/docs/connector-implementation-playbook.md +182 -0
  999. package/docs/custom-connectors.md +167 -0
  1000. package/docs/docker.md +76 -0
  1001. package/docs/installation.md +384 -0
  1002. package/docs/media-worker.md +114 -0
  1003. package/docs/npm-install.md +75 -0
  1004. package/docs/production-bot-guide.md +499 -0
  1005. package/docs/production-handover.md +255 -0
  1006. package/docs/production-monitoring.md +117 -0
  1007. package/docs/routing-state-machine.md +47 -0
  1008. package/docs/support-inbox-milestones.md +159 -0
  1009. package/docs/tool-configuration-guide.md +257 -0
  1010. package/docs/tool-plugin-and-packaging-roadmap.md +278 -0
  1011. package/package.json +55 -0
@@ -0,0 +1,67 @@
1
+ export interface DedupeKey {
2
+ remoteJid: string;
3
+ messageId: string;
4
+ participant?: string;
5
+ deviceId?: number;
6
+ timestamp?: number;
7
+ }
8
+ export interface DedupeRecord {
9
+ dedupeKey: string;
10
+ messageId: string;
11
+ firstSeenAt: number;
12
+ source: 'live' | 'history' | 'retry' | 'replay';
13
+ processed: boolean;
14
+ }
15
+ export interface DedupeStats {
16
+ totalChecked: number;
17
+ duplicatesFound: number;
18
+ inMemoryHits: number;
19
+ dbHits: number;
20
+ cacheSize: number;
21
+ }
22
+ export declare class MessageDeduplicationEngine {
23
+ private cache;
24
+ private cacheOrder;
25
+ private stats;
26
+ /**
27
+ * Check if a message is a duplicate.
28
+ * Returns true if duplicate (should be skipped), false if new.
29
+ */
30
+ isDuplicate(key: DedupeKey, source?: DedupeRecord['source']): boolean;
31
+ /**
32
+ * Mark a message as processed (after successful handling).
33
+ */
34
+ markProcessed(key: DedupeKey): void;
35
+ /**
36
+ * Check if a batch of messages contains duplicates.
37
+ * Returns the deduplicated list and duplicate count.
38
+ */
39
+ deduplicateBatch(keys: DedupeKey[], source?: DedupeRecord['source']): {
40
+ unique: DedupeKey[];
41
+ duplicates: number;
42
+ };
43
+ /**
44
+ * Simulate a reconnect replay scenario.
45
+ * Returns stats about deduplication effectiveness.
46
+ */
47
+ simulateReplay(keys: DedupeKey[]): {
48
+ total: number;
49
+ unique: number;
50
+ duplicates: number;
51
+ duplicateRatio: number;
52
+ };
53
+ /**
54
+ * Clear old dedupe records from database (cleanup task).
55
+ */
56
+ clearExpiredRecords(): number;
57
+ /** Get current stats. */
58
+ getStats(): DedupeStats;
59
+ /** Reset stats counters. */
60
+ resetStats(): void;
61
+ /** Clear all dedupe data. */
62
+ clear(): void;
63
+ private buildDedupeKey;
64
+ private addToCache;
65
+ private touchCacheEntry;
66
+ }
67
+ //# sourceMappingURL=engine.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/message-dedupe/engine.ts"],"names":[],"mappings":"AAoBA,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;IAChD,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAaD,qBAAa,0BAA0B;IACrC,OAAO,CAAC,KAAK,CAAkC;IAC/C,OAAO,CAAC,UAAU,CAAgB;IAClC,OAAO,CAAC,KAAK,CAMX;IAEF;;;OAGG;IACH,WAAW,CAAC,GAAG,EAAE,SAAS,EAAE,MAAM,GAAE,YAAY,CAAC,QAAQ,CAAU,GAAG,OAAO;IAgD7E;;OAEG;IACH,aAAa,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI;IAcnC;;;OAGG;IACH,gBAAgB,CACd,IAAI,EAAE,SAAS,EAAE,EACjB,MAAM,GAAE,YAAY,CAAC,QAAQ,CAAY,GACxC;QAAE,MAAM,EAAE,SAAS,EAAE,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE;IAe9C;;;OAGG;IACH,cAAc,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG;QACjC,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,cAAc,EAAE,MAAM,CAAC;KACxB;IAqBD;;OAEG;IACH,mBAAmB,IAAI,MAAM;IAe7B,yBAAyB;IACzB,QAAQ,IAAI,WAAW;IAOvB,4BAA4B;IAC5B,UAAU,IAAI,IAAI;IAUlB,6BAA6B;IAC7B,KAAK,IAAI,IAAI;IAQb,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,UAAU;IAWlB,OAAO,CAAC,eAAe;CAQxB"}
@@ -0,0 +1,208 @@
1
+ /**
2
+ * Message Deduplication Engine
3
+ *
4
+ * Prevents duplicate processing of WhatsApp messages from:
5
+ * - Reconnect replays
6
+ * - History sync replays
7
+ * - Retry messages
8
+ * - Webhook event duplication
9
+ *
10
+ * Uses a multi-level deduplication strategy:
11
+ * 1. In-memory LRU cache (fast, recent messages)
12
+ * 2. Persistent database records (durable, 24h window)
13
+ *
14
+ * Every message produces exactly one: DB write, AI decision, outbound action.
15
+ */
16
+ import { createHash } from 'node:crypto';
17
+ import { DatabaseManager } from '../database/index.js';
18
+ // ─── Config ──────────────────────────────────────────────────────────────────
19
+ const IN_MEMORY_CACHE_SIZE = 10_000; // Last 10k dedupe keys
20
+ const DEDUPE_WINDOW_MS = 24 * 60 * 60 * 1000; // 24 hours
21
+ function normalizeDedupeJid(jid) {
22
+ return String(jid || '').replace(/:(\d+)@/, '@').trim().toLowerCase();
23
+ }
24
+ // ─── Message Deduplication Engine ────────────────────────────────────────────
25
+ export class MessageDeduplicationEngine {
26
+ cache = new Map(); // key -> firstSeenAt
27
+ cacheOrder = []; // LRU tracking
28
+ stats = {
29
+ totalChecked: 0,
30
+ duplicatesFound: 0,
31
+ inMemoryHits: 0,
32
+ dbHits: 0,
33
+ cacheSize: 0,
34
+ };
35
+ /**
36
+ * Check if a message is a duplicate.
37
+ * Returns true if duplicate (should be skipped), false if new.
38
+ */
39
+ isDuplicate(key, source = 'live') {
40
+ this.stats.totalChecked++;
41
+ const dedupeKey = this.buildDedupeKey(key);
42
+ // 1. Check in-memory cache (fast path)
43
+ if (this.cache.has(dedupeKey)) {
44
+ this.stats.duplicatesFound++;
45
+ this.stats.inMemoryHits++;
46
+ this.touchCacheEntry(dedupeKey);
47
+ return true;
48
+ }
49
+ // 2. Check database (persistent path)
50
+ const db = DatabaseManager.getInstance();
51
+ try {
52
+ const session = db.getSession(`dedupe:${dedupeKey}`);
53
+ if (session) {
54
+ this.stats.duplicatesFound++;
55
+ this.stats.dbHits++;
56
+ // Promote to in-memory cache
57
+ this.addToCache(dedupeKey, session.firstSeenAt);
58
+ return true;
59
+ }
60
+ }
61
+ catch {
62
+ // Database may not be initialized — skip DB check
63
+ }
64
+ // 3. Store as new
65
+ const firstSeenAt = Date.now();
66
+ this.addToCache(dedupeKey, firstSeenAt);
67
+ // Persist to database
68
+ try {
69
+ db.setSession(`dedupe:${dedupeKey}`, {
70
+ dedupeKey,
71
+ messageId: key.messageId,
72
+ firstSeenAt,
73
+ source,
74
+ processed: false,
75
+ });
76
+ }
77
+ catch {
78
+ // DB write failure is non-fatal for dedupe
79
+ }
80
+ return false;
81
+ }
82
+ /**
83
+ * Mark a message as processed (after successful handling).
84
+ */
85
+ markProcessed(key) {
86
+ const dedupeKey = this.buildDedupeKey(key);
87
+ try {
88
+ const db = DatabaseManager.getInstance();
89
+ const session = db.getSession(`dedupe:${dedupeKey}`);
90
+ if (session) {
91
+ session.processed = true;
92
+ db.setSession(`dedupe:${dedupeKey}`, session);
93
+ }
94
+ }
95
+ catch {
96
+ // Non-fatal
97
+ }
98
+ }
99
+ /**
100
+ * Check if a batch of messages contains duplicates.
101
+ * Returns the deduplicated list and duplicate count.
102
+ */
103
+ deduplicateBatch(keys, source = 'replay') {
104
+ const unique = [];
105
+ let duplicates = 0;
106
+ for (const key of keys) {
107
+ if (this.isDuplicate(key, source)) {
108
+ duplicates++;
109
+ }
110
+ else {
111
+ unique.push(key);
112
+ }
113
+ }
114
+ return { unique, duplicates };
115
+ }
116
+ /**
117
+ * Simulate a reconnect replay scenario.
118
+ * Returns stats about deduplication effectiveness.
119
+ */
120
+ simulateReplay(keys) {
121
+ const total = keys.length;
122
+ let unique = 0;
123
+ let dupes = 0;
124
+ for (const key of keys) {
125
+ if (this.isDuplicate(key, 'replay')) {
126
+ dupes++;
127
+ }
128
+ else {
129
+ unique++;
130
+ }
131
+ }
132
+ return {
133
+ total,
134
+ unique,
135
+ duplicates: dupes,
136
+ duplicateRatio: total > 0 ? dupes / total : 0,
137
+ };
138
+ }
139
+ /**
140
+ * Clear old dedupe records from database (cleanup task).
141
+ */
142
+ clearExpiredRecords() {
143
+ const cutoff = Date.now() - DEDUPE_WINDOW_MS;
144
+ // DB sessions are key-value; we track timestamps in the value
145
+ // For now, just clear the in-memory cache of old entries
146
+ let removed = 0;
147
+ for (const [key, timestamp] of this.cache.entries()) {
148
+ if (timestamp < cutoff) {
149
+ this.cache.delete(key);
150
+ removed++;
151
+ }
152
+ }
153
+ this.cacheOrder = this.cacheOrder.filter((k) => this.cache.has(k));
154
+ return removed;
155
+ }
156
+ /** Get current stats. */
157
+ getStats() {
158
+ return {
159
+ ...this.stats,
160
+ cacheSize: this.cache.size,
161
+ };
162
+ }
163
+ /** Reset stats counters. */
164
+ resetStats() {
165
+ this.stats = {
166
+ totalChecked: 0,
167
+ duplicatesFound: 0,
168
+ inMemoryHits: 0,
169
+ dbHits: 0,
170
+ cacheSize: this.cache.size,
171
+ };
172
+ }
173
+ /** Clear all dedupe data. */
174
+ clear() {
175
+ this.cache.clear();
176
+ this.cacheOrder = [];
177
+ this.resetStats();
178
+ }
179
+ // ─── Private ────────────────────────────────────────────────────────────
180
+ buildDedupeKey(key) {
181
+ const parts = [normalizeDedupeJid(key.remoteJid), key.messageId];
182
+ if (key.participant)
183
+ parts.push(normalizeDedupeJid(key.participant));
184
+ if (key.deviceId !== undefined)
185
+ parts.push(String(key.deviceId));
186
+ const raw = parts.join(':');
187
+ return createHash('md5').update(raw).digest('hex').slice(0, 16);
188
+ }
189
+ addToCache(key, timestamp) {
190
+ // Evict oldest if at capacity
191
+ if (this.cache.size >= IN_MEMORY_CACHE_SIZE && this.cacheOrder.length > 0) {
192
+ const oldest = this.cacheOrder.shift();
193
+ if (oldest)
194
+ this.cache.delete(oldest);
195
+ }
196
+ this.cache.set(key, timestamp);
197
+ this.cacheOrder.push(key);
198
+ }
199
+ touchCacheEntry(key) {
200
+ // Move to end of LRU order
201
+ const idx = this.cacheOrder.indexOf(key);
202
+ if (idx >= 0) {
203
+ this.cacheOrder.splice(idx, 1);
204
+ this.cacheOrder.push(key);
205
+ }
206
+ }
207
+ }
208
+ //# sourceMappingURL=engine.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"engine.js","sourceRoot":"","sources":["../../src/message-dedupe/engine.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,3 @@
1
+ export { MessageDeduplicationEngine } from './engine.js';
2
+ export type { DedupeKey, DedupeRecord, DedupeStats } from './engine.js';
3
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/message-dedupe/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AACzD,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}
@@ -0,0 +1,2 @@
1
+ export { MessageDeduplicationEngine } from './engine.js';
2
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/message-dedupe/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC"}
@@ -0,0 +1,3 @@
1
+ export { LeakDetector } from './leak-detector.js';
2
+ export type { MemorySnapshot, LeakReport, SoakTestConfig } from './leak-detector.js';
3
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/monitoring/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC"}
@@ -0,0 +1,2 @@
1
+ export { LeakDetector } from './leak-detector.js';
2
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/monitoring/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}
@@ -0,0 +1,63 @@
1
+ export interface MemorySnapshot {
2
+ timestamp: number;
3
+ heapUsedMB: number;
4
+ heapTotalMB: number;
5
+ externalMB: number;
6
+ rssMB: number;
7
+ listenerCount: number;
8
+ activeHandles: number;
9
+ activeRequests: number;
10
+ }
11
+ export interface LeakReport {
12
+ type: 'memory' | 'listener' | 'handle' | 'socket';
13
+ detected: boolean;
14
+ growthRate: string;
15
+ snapshotCount: number;
16
+ firstSnapshot: MemorySnapshot;
17
+ lastSnapshot: MemorySnapshot;
18
+ details: string;
19
+ }
20
+ export interface SoakTestConfig {
21
+ durationMs: number;
22
+ sampleIntervalMs: number;
23
+ memoryGrowthThresholdPct: number;
24
+ listenerGrowthThreshold: number;
25
+ }
26
+ export declare class LeakDetector {
27
+ private snapshots;
28
+ private config;
29
+ private intervalId;
30
+ private maxEmitter;
31
+ constructor(config?: Partial<SoakTestConfig>);
32
+ /**
33
+ * Take a memory snapshot.
34
+ */
35
+ takeSnapshot(): MemorySnapshot;
36
+ /**
37
+ * Start periodic snapshot collection.
38
+ */
39
+ startMonitoring(): void;
40
+ /**
41
+ * Stop monitoring.
42
+ */
43
+ stopMonitoring(): void;
44
+ /**
45
+ * Analyze snapshots for leaks.
46
+ */
47
+ analyzeForLeaks(): LeakReport[];
48
+ /**
49
+ * Simulate a soak test by collecting snapshots with injected "time" progression.
50
+ * Useful for unit testing without waiting hours.
51
+ */
52
+ simulateSoakTest(durationMs: number, sampleCount: number): LeakReport[];
53
+ /**
54
+ * Get all snapshots.
55
+ */
56
+ getSnapshots(): MemorySnapshot[];
57
+ /**
58
+ * Clear all collected data.
59
+ */
60
+ reset(): void;
61
+ private createEmptySnapshot;
62
+ }
63
+ //# sourceMappingURL=leak-detector.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"leak-detector.d.ts","sourceRoot":"","sources":["../../src/monitoring/leak-detector.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAClD,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,cAAc,CAAC;IAC9B,YAAY,EAAE,cAAc,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,wBAAwB,EAAE,MAAM,CAAC;IACjC,uBAAuB,EAAE,MAAM,CAAC;CACjC;AAaD,qBAAa,YAAY;IACvB,OAAO,CAAC,SAAS,CAAwB;IACzC,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,UAAU,CAA+C;IACjE,OAAO,CAAC,UAAU,CAAe;gBAErB,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC;IAM5C;;OAEG;IACH,YAAY,IAAI,cAAc;IAoB9B;;OAEG;IACH,eAAe,IAAI,IAAI;IAOvB;;OAEG;IACH,cAAc,IAAI,IAAI;IAOtB;;OAEG;IACH,eAAe,IAAI,UAAU,EAAE;IAsD/B;;;OAGG;IACH,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,UAAU,EAAE;IA0BvE;;OAEG;IACH,YAAY,IAAI,cAAc,EAAE;IAIhC;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb,OAAO,CAAC,mBAAmB;CAY5B"}
@@ -0,0 +1,169 @@
1
+ /**
2
+ * Memory & Listener Leak Detector
3
+ *
4
+ * Tracks resource usage over time to detect production memory leaks,
5
+ * listener accumulation, and socket leaks — the most common Baileys failures.
6
+ *
7
+ * Based on Node.js heap snapshot diagnostics and OpenClaw production findings:
8
+ * - Unclosed listeners after reconnect
9
+ * - EventEmitter max listeners warnings
10
+ * - Growing heap usage over time
11
+ */
12
+ import { EventEmitter } from 'node:events';
13
+ // ─── Default Config ──────────────────────────────────────────────────────────
14
+ const DEFAULT_CONFIG = {
15
+ durationMs: 24 * 60 * 60 * 1000, // 24 hours
16
+ sampleIntervalMs: 60 * 1000, // Every 60 seconds
17
+ memoryGrowthThresholdPct: 5, // 5% growth max
18
+ listenerGrowthThreshold: 10, // Max 10 listener growth
19
+ };
20
+ // ─── Leak Detector ───────────────────────────────────────────────────────────
21
+ export class LeakDetector {
22
+ snapshots = [];
23
+ config;
24
+ intervalId = null;
25
+ maxEmitter;
26
+ constructor(config) {
27
+ this.config = { ...DEFAULT_CONFIG, ...config };
28
+ this.maxEmitter = new EventEmitter();
29
+ this.maxEmitter.setMaxListeners(100);
30
+ }
31
+ /**
32
+ * Take a memory snapshot.
33
+ */
34
+ takeSnapshot() {
35
+ const mem = process.memoryUsage();
36
+ const handles = process._getActiveHandles;
37
+ const requests = process._getActiveRequests;
38
+ const snapshot = {
39
+ timestamp: Date.now(),
40
+ heapUsedMB: Math.round((mem.heapUsed / 1024 / 1024) * 100) / 100,
41
+ heapTotalMB: Math.round((mem.heapTotal / 1024 / 1024) * 100) / 100,
42
+ externalMB: Math.round((mem.external / 1024 / 1024) * 100) / 100,
43
+ rssMB: Math.round((mem.rss / 1024 / 1024) * 100) / 100,
44
+ listenerCount: this.maxEmitter.listenerCount('test') || 0,
45
+ activeHandles: typeof handles === 'function' ? handles().length : 0,
46
+ activeRequests: typeof requests === 'function' ? requests().length : 0,
47
+ };
48
+ this.snapshots.push(snapshot);
49
+ return snapshot;
50
+ }
51
+ /**
52
+ * Start periodic snapshot collection.
53
+ */
54
+ startMonitoring() {
55
+ this.takeSnapshot(); // Baseline
56
+ this.intervalId = setInterval(() => {
57
+ this.takeSnapshot();
58
+ }, this.config.sampleIntervalMs);
59
+ }
60
+ /**
61
+ * Stop monitoring.
62
+ */
63
+ stopMonitoring() {
64
+ if (this.intervalId) {
65
+ clearInterval(this.intervalId);
66
+ this.intervalId = null;
67
+ }
68
+ }
69
+ /**
70
+ * Analyze snapshots for leaks.
71
+ */
72
+ analyzeForLeaks() {
73
+ const reports = [];
74
+ if (this.snapshots.length < 2) {
75
+ return [{
76
+ type: 'memory',
77
+ detected: false,
78
+ growthRate: 'N/A',
79
+ snapshotCount: this.snapshots.length,
80
+ firstSnapshot: this.snapshots[0] || this.createEmptySnapshot(),
81
+ lastSnapshot: this.snapshots[this.snapshots.length - 1] || this.createEmptySnapshot(),
82
+ details: 'Insufficient snapshots for analysis (need >= 2)',
83
+ }];
84
+ }
85
+ const first = this.snapshots[0];
86
+ const last = this.snapshots[this.snapshots.length - 1];
87
+ // Memory leak check
88
+ const heapGrowth = last.heapUsedMB - first.heapUsedMB;
89
+ const heapGrowthPct = first.heapUsedMB > 0 ? (heapGrowth / first.heapUsedMB) * 100 : 0;
90
+ const memoryLeak = heapGrowthPct > this.config.memoryGrowthThresholdPct;
91
+ reports.push({
92
+ type: 'memory',
93
+ detected: memoryLeak,
94
+ growthRate: `${heapGrowthPct.toFixed(1)}%`,
95
+ snapshotCount: this.snapshots.length,
96
+ firstSnapshot: first,
97
+ lastSnapshot: last,
98
+ details: memoryLeak
99
+ ? `Memory leak detected: ${heapGrowth.toFixed(1)}MB growth (${heapGrowthPct.toFixed(1)}%)`
100
+ : `Memory stable: ${heapGrowth.toFixed(1)}MB growth (${heapGrowthPct.toFixed(1)}%)`,
101
+ });
102
+ // Listener leak check
103
+ const listenerGrowth = last.listenerCount - first.listenerCount;
104
+ const listenerLeak = listenerGrowth > this.config.listenerGrowthThreshold;
105
+ reports.push({
106
+ type: 'listener',
107
+ detected: listenerLeak,
108
+ growthRate: `${listenerGrowth}`,
109
+ snapshotCount: this.snapshots.length,
110
+ firstSnapshot: first,
111
+ lastSnapshot: last,
112
+ details: listenerLeak
113
+ ? `Listener leak detected: ${listenerGrowth} new listeners`
114
+ : `Listeners stable: ${listenerGrowth} growth`,
115
+ });
116
+ return reports;
117
+ }
118
+ /**
119
+ * Simulate a soak test by collecting snapshots with injected "time" progression.
120
+ * Useful for unit testing without waiting hours.
121
+ */
122
+ simulateSoakTest(durationMs, sampleCount) {
123
+ this.snapshots = [];
124
+ const interval = durationMs / sampleCount;
125
+ let heapUsed = 50; // Start at 50MB
126
+ for (let i = 0; i < sampleCount; i++) {
127
+ // Simulate slight growth (or flat for healthy)
128
+ const isHealthy = i < sampleCount * 0.8;
129
+ heapUsed += isHealthy ? 0.1 : 1.0;
130
+ this.snapshots.push({
131
+ timestamp: Date.now() + i * interval,
132
+ heapUsedMB: Math.round(heapUsed * 100) / 100,
133
+ heapTotalMB: 100,
134
+ externalMB: 5,
135
+ rssMB: heapUsed + 20,
136
+ listenerCount: isHealthy ? 10 : 10 + Math.floor(i * 0.5),
137
+ activeHandles: 5,
138
+ activeRequests: 2,
139
+ });
140
+ }
141
+ return this.analyzeForLeaks();
142
+ }
143
+ /**
144
+ * Get all snapshots.
145
+ */
146
+ getSnapshots() {
147
+ return [...this.snapshots];
148
+ }
149
+ /**
150
+ * Clear all collected data.
151
+ */
152
+ reset() {
153
+ this.stopMonitoring();
154
+ this.snapshots = [];
155
+ }
156
+ createEmptySnapshot() {
157
+ return {
158
+ timestamp: Date.now(),
159
+ heapUsedMB: 0,
160
+ heapTotalMB: 0,
161
+ externalMB: 0,
162
+ rssMB: 0,
163
+ listenerCount: 0,
164
+ activeHandles: 0,
165
+ activeRequests: 0,
166
+ };
167
+ }
168
+ }
169
+ //# sourceMappingURL=leak-detector.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"leak-detector.js","sourceRoot":"","sources":["../../src/monitoring/leak-detector.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,14 @@
1
+ export type RuntimeHealthStatus = 'ok' | 'warn' | 'fail';
2
+ export interface RuntimeHealthCheck {
3
+ name: string;
4
+ status: RuntimeHealthStatus;
5
+ message: string;
6
+ }
7
+ export interface RuntimeHealthReport {
8
+ status: RuntimeHealthStatus;
9
+ checks: RuntimeHealthCheck[];
10
+ }
11
+ export declare function getRuntimeHealth(): RuntimeHealthReport;
12
+ export declare function ensureRuntimeDataDirs(): void;
13
+ export declare function formatRuntimeHealth(report?: RuntimeHealthReport): string;
14
+ //# sourceMappingURL=runtime-health.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"runtime-health.d.ts","sourceRoot":"","sources":["../../src/monitoring/runtime-health.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,mBAAmB,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;AAEzD,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,mBAAmB,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,MAAM,EAAE,kBAAkB,EAAE,CAAC;CAC9B;AAkCD,wBAAgB,gBAAgB,IAAI,mBAAmB,CA8BtD;AAED,wBAAgB,qBAAqB,IAAI,IAAI,CAK5C;AAED,wBAAgB,mBAAmB,CAAC,MAAM,sBAAqB,GAAG,MAAM,CAKvE"}