@nxuss/lemma 0.1.0 → 0.2.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 (452) hide show
  1. package/README.md +347 -181
  2. package/dist/cjs/cloud/KeyManager.d.ts.map +1 -0
  3. package/dist/cjs/cloud/KeyManager.js.map +1 -0
  4. package/dist/cjs/cloud/TenantCache.d.ts.map +1 -0
  5. package/dist/cjs/cloud/TenantCache.js.map +1 -0
  6. package/dist/cjs/cloud/index.d.ts.map +1 -0
  7. package/dist/cjs/cloud/index.js.map +1 -0
  8. package/dist/cjs/cloud/server.d.ts.map +1 -0
  9. package/dist/cjs/cloud/server.js.map +1 -0
  10. package/dist/cjs/cloud/types.d.ts.map +1 -0
  11. package/dist/cjs/cloud/types.js.map +1 -0
  12. package/dist/cjs/config/index.d.ts.map +1 -0
  13. package/dist/cjs/config/index.js.map +1 -0
  14. package/dist/cjs/consensus/ConsensusEngine.d.ts.map +1 -0
  15. package/dist/cjs/consensus/ConsensusEngine.js.map +1 -0
  16. package/dist/cjs/consensus/ModelPool.d.ts.map +1 -0
  17. package/dist/cjs/consensus/ModelPool.js.map +1 -0
  18. package/dist/cjs/consensus/index.d.ts.map +1 -0
  19. package/dist/cjs/consensus/index.js.map +1 -0
  20. package/dist/cjs/core/AgentRegistry.d.ts.map +1 -0
  21. package/dist/cjs/core/AgentRegistry.js.map +1 -0
  22. package/dist/cjs/core/DashboardBroadcaster.d.ts.map +1 -0
  23. package/dist/cjs/core/DashboardBroadcaster.js.map +1 -0
  24. package/dist/{core → cjs/core}/OrchestrationEngine.d.ts +1 -0
  25. package/dist/cjs/core/OrchestrationEngine.d.ts.map +1 -0
  26. package/dist/{core → cjs/core}/OrchestrationEngine.js +29 -23
  27. package/dist/cjs/core/OrchestrationEngine.js.map +1 -0
  28. package/dist/cjs/core/SubconsciousEngine.d.ts.map +1 -0
  29. package/dist/{core → cjs/core}/SubconsciousEngine.js +15 -3
  30. package/dist/cjs/core/SubconsciousEngine.js.map +1 -0
  31. package/dist/cjs/core/WebSocketServer.d.ts.map +1 -0
  32. package/dist/{core → cjs/core}/WebSocketServer.js +2 -1
  33. package/dist/cjs/core/WebSocketServer.js.map +1 -0
  34. package/dist/cjs/core/index.d.ts.map +1 -0
  35. package/dist/cjs/core/index.js.map +1 -0
  36. package/dist/cjs/core/router.d.ts.map +1 -0
  37. package/dist/cjs/core/router.js.map +1 -0
  38. package/dist/{embed → cjs/embed}/index.d.ts +66 -1
  39. package/dist/cjs/embed/index.d.ts.map +1 -0
  40. package/dist/cjs/embed/index.js +979 -0
  41. package/dist/cjs/embed/index.js.map +1 -0
  42. package/dist/cjs/embed.d.ts.map +1 -0
  43. package/dist/cjs/embed.js.map +1 -0
  44. package/dist/cjs/examples/basic-usage.d.ts +12 -0
  45. package/dist/cjs/examples/basic-usage.d.ts.map +1 -0
  46. package/dist/cjs/examples/basic-usage.js +128 -0
  47. package/dist/cjs/examples/basic-usage.js.map +1 -0
  48. package/dist/cjs/index.d.ts.map +1 -0
  49. package/dist/cjs/index.js.map +1 -0
  50. package/dist/cjs/package.json +3 -0
  51. package/dist/cjs/protocol/flows.d.ts.map +1 -0
  52. package/dist/cjs/protocol/flows.js.map +1 -0
  53. package/dist/cjs/protocol/iap.d.ts.map +1 -0
  54. package/dist/cjs/protocol/iap.js.map +1 -0
  55. package/dist/cjs/protocol/index.d.ts.map +1 -0
  56. package/dist/cjs/protocol/index.js.map +1 -0
  57. package/dist/cjs/protocol/types.d.ts.map +1 -0
  58. package/dist/cjs/protocol/types.js.map +1 -0
  59. package/dist/cjs/protocol/utils.d.ts.map +1 -0
  60. package/dist/cjs/protocol/utils.js.map +1 -0
  61. package/dist/cjs/protocol/validators.d.ts.map +1 -0
  62. package/dist/cjs/protocol/validators.js.map +1 -0
  63. package/dist/cjs/security/AuthManager.d.ts.map +1 -0
  64. package/dist/cjs/security/AuthManager.js.map +1 -0
  65. package/dist/cjs/security/MessageSanitizer.d.ts.map +1 -0
  66. package/dist/{security → cjs/security}/MessageSanitizer.js +22 -6
  67. package/dist/cjs/security/MessageSanitizer.js.map +1 -0
  68. package/dist/cjs/security/RateLimiter.d.ts.map +1 -0
  69. package/dist/cjs/security/RateLimiter.js.map +1 -0
  70. package/dist/{security → cjs/security}/SecurityMiddleware.d.ts +3 -1
  71. package/dist/cjs/security/SecurityMiddleware.d.ts.map +1 -0
  72. package/dist/{security → cjs/security}/SecurityMiddleware.js +5 -3
  73. package/dist/cjs/security/SecurityMiddleware.js.map +1 -0
  74. package/dist/cjs/security/index.d.ts.map +1 -0
  75. package/dist/cjs/security/index.js.map +1 -0
  76. package/dist/cjs/speculative/PredictionEngine.d.ts.map +1 -0
  77. package/dist/cjs/speculative/PredictionEngine.js.map +1 -0
  78. package/dist/cjs/speculative/SpeculativeCache.d.ts.map +1 -0
  79. package/dist/cjs/speculative/SpeculativeCache.js.map +1 -0
  80. package/dist/cjs/speculative/SpeculativeEngine.d.ts.map +1 -0
  81. package/dist/cjs/speculative/SpeculativeEngine.js.map +1 -0
  82. package/dist/cjs/speculative/WorkerPool.d.ts.map +1 -0
  83. package/dist/cjs/speculative/WorkerPool.js.map +1 -0
  84. package/dist/cjs/speculative/index.d.ts.map +1 -0
  85. package/dist/cjs/speculative/index.js.map +1 -0
  86. package/dist/cjs/subconscious/EmbeddingService.d.ts.map +1 -0
  87. package/dist/cjs/subconscious/EmbeddingService.js.map +1 -0
  88. package/dist/cjs/subconscious/SemanticCache.d.ts.map +1 -0
  89. package/dist/cjs/subconscious/SemanticCache.js.map +1 -0
  90. package/dist/cjs/subconscious/SubconsciousEngine.d.ts.map +1 -0
  91. package/dist/cjs/subconscious/SubconsciousEngine.js.map +1 -0
  92. package/dist/cjs/subconscious/VectorStore.d.ts.map +1 -0
  93. package/dist/{subconscious → cjs/subconscious}/VectorStore.js +3 -3
  94. package/dist/cjs/subconscious/VectorStore.js.map +1 -0
  95. package/dist/cjs/subconscious/cache.d.ts.map +1 -0
  96. package/dist/cjs/subconscious/cache.js.map +1 -0
  97. package/dist/cjs/subconscious/embeddings.d.ts.map +1 -0
  98. package/dist/cjs/subconscious/embeddings.js.map +1 -0
  99. package/dist/cjs/subconscious/index.d.ts.map +1 -0
  100. package/dist/cjs/subconscious/index.js.map +1 -0
  101. package/dist/cjs/types/index.d.ts.map +1 -0
  102. package/dist/cjs/types/index.js.map +1 -0
  103. package/dist/cjs/utils/logger.d.ts.map +1 -0
  104. package/dist/cjs/utils/logger.js.map +1 -0
  105. package/dist/esm/cloud/KeyManager.d.ts +29 -0
  106. package/dist/esm/cloud/KeyManager.d.ts.map +1 -0
  107. package/dist/esm/cloud/KeyManager.js +135 -0
  108. package/dist/esm/cloud/KeyManager.js.map +1 -0
  109. package/dist/esm/cloud/TenantCache.d.ts +29 -0
  110. package/dist/esm/cloud/TenantCache.d.ts.map +1 -0
  111. package/dist/esm/cloud/TenantCache.js +125 -0
  112. package/dist/esm/cloud/TenantCache.js.map +1 -0
  113. package/dist/esm/cloud/index.d.ts +4 -0
  114. package/dist/esm/cloud/index.d.ts.map +1 -0
  115. package/dist/esm/cloud/index.js +4 -0
  116. package/dist/esm/cloud/index.js.map +1 -0
  117. package/dist/esm/cloud/server.d.ts +17 -0
  118. package/dist/esm/cloud/server.d.ts.map +1 -0
  119. package/dist/esm/cloud/server.js +181 -0
  120. package/dist/esm/cloud/server.js.map +1 -0
  121. package/dist/esm/cloud/types.d.ts +35 -0
  122. package/dist/esm/cloud/types.d.ts.map +1 -0
  123. package/dist/esm/cloud/types.js +11 -0
  124. package/dist/esm/cloud/types.js.map +1 -0
  125. package/dist/esm/config/index.d.ts +44 -0
  126. package/dist/esm/config/index.d.ts.map +1 -0
  127. package/dist/esm/config/index.js +151 -0
  128. package/dist/esm/config/index.js.map +1 -0
  129. package/dist/esm/consensus/ConsensusEngine.d.ts +119 -0
  130. package/dist/esm/consensus/ConsensusEngine.d.ts.map +1 -0
  131. package/dist/esm/consensus/ConsensusEngine.js +310 -0
  132. package/dist/esm/consensus/ConsensusEngine.js.map +1 -0
  133. package/dist/esm/consensus/ModelPool.d.ts +103 -0
  134. package/dist/esm/consensus/ModelPool.d.ts.map +1 -0
  135. package/dist/esm/consensus/ModelPool.js +269 -0
  136. package/dist/esm/consensus/ModelPool.js.map +1 -0
  137. package/dist/esm/consensus/index.d.ts +8 -0
  138. package/dist/esm/consensus/index.d.ts.map +1 -0
  139. package/dist/esm/consensus/index.js +8 -0
  140. package/dist/esm/consensus/index.js.map +1 -0
  141. package/dist/esm/core/AgentRegistry.d.ts +89 -0
  142. package/dist/esm/core/AgentRegistry.d.ts.map +1 -0
  143. package/dist/esm/core/AgentRegistry.js +260 -0
  144. package/dist/esm/core/AgentRegistry.js.map +1 -0
  145. package/dist/esm/core/DashboardBroadcaster.d.ts +67 -0
  146. package/dist/esm/core/DashboardBroadcaster.d.ts.map +1 -0
  147. package/dist/esm/core/DashboardBroadcaster.js +260 -0
  148. package/dist/esm/core/DashboardBroadcaster.js.map +1 -0
  149. package/dist/esm/core/OrchestrationEngine.d.ts +85 -0
  150. package/dist/esm/core/OrchestrationEngine.d.ts.map +1 -0
  151. package/dist/esm/core/OrchestrationEngine.js +457 -0
  152. package/dist/esm/core/OrchestrationEngine.js.map +1 -0
  153. package/dist/esm/core/SubconsciousEngine.d.ts +53 -0
  154. package/dist/esm/core/SubconsciousEngine.d.ts.map +1 -0
  155. package/dist/esm/core/SubconsciousEngine.js +278 -0
  156. package/dist/esm/core/SubconsciousEngine.js.map +1 -0
  157. package/dist/esm/core/WebSocketServer.d.ts +89 -0
  158. package/dist/esm/core/WebSocketServer.d.ts.map +1 -0
  159. package/dist/esm/core/WebSocketServer.js +380 -0
  160. package/dist/esm/core/WebSocketServer.js.map +1 -0
  161. package/dist/esm/core/index.d.ts +15 -0
  162. package/dist/esm/core/index.d.ts.map +1 -0
  163. package/dist/esm/core/index.js +15 -0
  164. package/dist/esm/core/index.js.map +1 -0
  165. package/dist/esm/core/router.d.ts +105 -0
  166. package/dist/esm/core/router.d.ts.map +1 -0
  167. package/dist/esm/core/router.js +416 -0
  168. package/dist/esm/core/router.js.map +1 -0
  169. package/dist/esm/embed/index.d.ts +218 -0
  170. package/dist/esm/embed/index.d.ts.map +1 -0
  171. package/dist/esm/embed/index.js +939 -0
  172. package/dist/esm/embed/index.js.map +1 -0
  173. package/dist/esm/embed.d.ts +11 -0
  174. package/dist/esm/embed.d.ts.map +1 -0
  175. package/dist/esm/embed.js +11 -0
  176. package/dist/esm/embed.js.map +1 -0
  177. package/dist/esm/examples/basic-usage.d.ts +12 -0
  178. package/dist/esm/examples/basic-usage.d.ts.map +1 -0
  179. package/dist/esm/examples/basic-usage.js +126 -0
  180. package/dist/esm/examples/basic-usage.js.map +1 -0
  181. package/dist/esm/index.d.ts +83 -0
  182. package/dist/esm/index.d.ts.map +1 -0
  183. package/dist/esm/index.js +132 -0
  184. package/dist/esm/index.js.map +1 -0
  185. package/dist/esm/package.json +3 -0
  186. package/dist/esm/protocol/flows.d.ts +126 -0
  187. package/dist/esm/protocol/flows.d.ts.map +1 -0
  188. package/dist/esm/protocol/flows.js +338 -0
  189. package/dist/esm/protocol/flows.js.map +1 -0
  190. package/dist/esm/protocol/iap.d.ts +54 -0
  191. package/dist/esm/protocol/iap.d.ts.map +1 -0
  192. package/dist/esm/protocol/iap.js +104 -0
  193. package/dist/esm/protocol/iap.js.map +1 -0
  194. package/dist/esm/protocol/index.d.ts +23 -0
  195. package/dist/esm/protocol/index.d.ts.map +1 -0
  196. package/dist/esm/protocol/index.js +28 -0
  197. package/dist/esm/protocol/index.js.map +1 -0
  198. package/dist/esm/protocol/types.d.ts +332 -0
  199. package/dist/esm/protocol/types.d.ts.map +1 -0
  200. package/dist/esm/protocol/types.js +54 -0
  201. package/dist/esm/protocol/types.js.map +1 -0
  202. package/dist/esm/protocol/utils.d.ts +130 -0
  203. package/dist/esm/protocol/utils.d.ts.map +1 -0
  204. package/dist/esm/protocol/utils.js +260 -0
  205. package/dist/esm/protocol/utils.js.map +1 -0
  206. package/dist/esm/protocol/validators.d.ts +54 -0
  207. package/dist/esm/protocol/validators.d.ts.map +1 -0
  208. package/dist/esm/protocol/validators.js +332 -0
  209. package/dist/esm/protocol/validators.js.map +1 -0
  210. package/dist/esm/security/AuthManager.d.ts +73 -0
  211. package/dist/esm/security/AuthManager.d.ts.map +1 -0
  212. package/dist/esm/security/AuthManager.js +95 -0
  213. package/dist/esm/security/AuthManager.js.map +1 -0
  214. package/dist/esm/security/MessageSanitizer.d.ts +51 -0
  215. package/dist/esm/security/MessageSanitizer.d.ts.map +1 -0
  216. package/dist/esm/security/MessageSanitizer.js +178 -0
  217. package/dist/esm/security/MessageSanitizer.js.map +1 -0
  218. package/dist/esm/security/RateLimiter.d.ts +46 -0
  219. package/dist/esm/security/RateLimiter.d.ts.map +1 -0
  220. package/dist/esm/security/RateLimiter.js +129 -0
  221. package/dist/esm/security/RateLimiter.js.map +1 -0
  222. package/dist/esm/security/SecurityMiddleware.d.ts +90 -0
  223. package/dist/esm/security/SecurityMiddleware.d.ts.map +1 -0
  224. package/dist/esm/security/SecurityMiddleware.js +144 -0
  225. package/dist/esm/security/SecurityMiddleware.js.map +1 -0
  226. package/dist/esm/security/index.d.ts +35 -0
  227. package/dist/esm/security/index.d.ts.map +1 -0
  228. package/dist/esm/security/index.js +35 -0
  229. package/dist/esm/security/index.js.map +1 -0
  230. package/dist/esm/speculative/PredictionEngine.d.ts +99 -0
  231. package/dist/esm/speculative/PredictionEngine.d.ts.map +1 -0
  232. package/dist/esm/speculative/PredictionEngine.js +284 -0
  233. package/dist/esm/speculative/PredictionEngine.js.map +1 -0
  234. package/dist/esm/speculative/SpeculativeCache.d.ts +117 -0
  235. package/dist/esm/speculative/SpeculativeCache.d.ts.map +1 -0
  236. package/dist/esm/speculative/SpeculativeCache.js +288 -0
  237. package/dist/esm/speculative/SpeculativeCache.js.map +1 -0
  238. package/dist/esm/speculative/SpeculativeEngine.d.ts +114 -0
  239. package/dist/esm/speculative/SpeculativeEngine.d.ts.map +1 -0
  240. package/dist/esm/speculative/SpeculativeEngine.js +240 -0
  241. package/dist/esm/speculative/SpeculativeEngine.js.map +1 -0
  242. package/dist/esm/speculative/WorkerPool.d.ts +109 -0
  243. package/dist/esm/speculative/WorkerPool.d.ts.map +1 -0
  244. package/dist/esm/speculative/WorkerPool.js +323 -0
  245. package/dist/esm/speculative/WorkerPool.js.map +1 -0
  246. package/dist/esm/speculative/index.d.ts +10 -0
  247. package/dist/esm/speculative/index.d.ts.map +1 -0
  248. package/dist/esm/speculative/index.js +10 -0
  249. package/dist/esm/speculative/index.js.map +1 -0
  250. package/dist/esm/subconscious/EmbeddingService.d.ts +73 -0
  251. package/dist/esm/subconscious/EmbeddingService.d.ts.map +1 -0
  252. package/dist/esm/subconscious/EmbeddingService.js +189 -0
  253. package/dist/esm/subconscious/EmbeddingService.js.map +1 -0
  254. package/dist/esm/subconscious/SemanticCache.d.ts +82 -0
  255. package/dist/esm/subconscious/SemanticCache.d.ts.map +1 -0
  256. package/dist/esm/subconscious/SemanticCache.js +160 -0
  257. package/dist/esm/subconscious/SemanticCache.js.map +1 -0
  258. package/dist/esm/subconscious/SubconsciousEngine.d.ts +121 -0
  259. package/dist/esm/subconscious/SubconsciousEngine.d.ts.map +1 -0
  260. package/dist/esm/subconscious/SubconsciousEngine.js +237 -0
  261. package/dist/esm/subconscious/SubconsciousEngine.js.map +1 -0
  262. package/dist/esm/subconscious/VectorStore.d.ts +54 -0
  263. package/dist/esm/subconscious/VectorStore.d.ts.map +1 -0
  264. package/dist/esm/subconscious/VectorStore.js +164 -0
  265. package/dist/esm/subconscious/VectorStore.js.map +1 -0
  266. package/dist/esm/subconscious/cache.d.ts +34 -0
  267. package/dist/esm/subconscious/cache.d.ts.map +1 -0
  268. package/dist/esm/subconscious/cache.js +152 -0
  269. package/dist/{subconscious → esm/subconscious}/cache.js.map +1 -1
  270. package/dist/esm/subconscious/embeddings.d.ts +25 -0
  271. package/dist/esm/subconscious/embeddings.d.ts.map +1 -0
  272. package/dist/esm/subconscious/embeddings.js +58 -0
  273. package/dist/esm/subconscious/embeddings.js.map +1 -0
  274. package/dist/esm/subconscious/index.d.ts +12 -0
  275. package/dist/esm/subconscious/index.d.ts.map +1 -0
  276. package/dist/esm/subconscious/index.js +12 -0
  277. package/dist/esm/subconscious/index.js.map +1 -0
  278. package/dist/esm/types/index.d.ts +286 -0
  279. package/dist/esm/types/index.d.ts.map +1 -0
  280. package/dist/esm/types/index.js +40 -0
  281. package/dist/esm/types/index.js.map +1 -0
  282. package/dist/esm/utils/logger.d.ts +63 -0
  283. package/dist/esm/utils/logger.d.ts.map +1 -0
  284. package/dist/esm/utils/logger.js +122 -0
  285. package/dist/esm/utils/logger.js.map +1 -0
  286. package/package.json +77 -13
  287. package/dist/cloud/KeyManager.d.ts.map +0 -1
  288. package/dist/cloud/KeyManager.js.map +0 -1
  289. package/dist/cloud/TenantCache.d.ts.map +0 -1
  290. package/dist/cloud/TenantCache.js.map +0 -1
  291. package/dist/cloud/index.d.ts.map +0 -1
  292. package/dist/cloud/index.js.map +0 -1
  293. package/dist/cloud/server.d.ts.map +0 -1
  294. package/dist/cloud/server.js.map +0 -1
  295. package/dist/cloud/types.d.ts.map +0 -1
  296. package/dist/cloud/types.js.map +0 -1
  297. package/dist/config/index.d.ts.map +0 -1
  298. package/dist/config/index.js.map +0 -1
  299. package/dist/consensus/ConsensusEngine.d.ts.map +0 -1
  300. package/dist/consensus/ConsensusEngine.js.map +0 -1
  301. package/dist/consensus/ModelPool.d.ts.map +0 -1
  302. package/dist/consensus/ModelPool.js.map +0 -1
  303. package/dist/consensus/index.d.ts.map +0 -1
  304. package/dist/consensus/index.js.map +0 -1
  305. package/dist/core/AgentRegistry.d.ts.map +0 -1
  306. package/dist/core/AgentRegistry.js.map +0 -1
  307. package/dist/core/DashboardBroadcaster.d.ts.map +0 -1
  308. package/dist/core/DashboardBroadcaster.js.map +0 -1
  309. package/dist/core/OrchestrationEngine.d.ts.map +0 -1
  310. package/dist/core/OrchestrationEngine.js.map +0 -1
  311. package/dist/core/SubconsciousEngine.d.ts.map +0 -1
  312. package/dist/core/SubconsciousEngine.js.map +0 -1
  313. package/dist/core/WebSocketServer.d.ts.map +0 -1
  314. package/dist/core/WebSocketServer.js.map +0 -1
  315. package/dist/core/index.d.ts.map +0 -1
  316. package/dist/core/index.js.map +0 -1
  317. package/dist/core/router.d.ts.map +0 -1
  318. package/dist/core/router.js.map +0 -1
  319. package/dist/embed/index.d.ts.map +0 -1
  320. package/dist/embed/index.js +0 -408
  321. package/dist/embed/index.js.map +0 -1
  322. package/dist/embed.d.ts.map +0 -1
  323. package/dist/embed.js.map +0 -1
  324. package/dist/index.d.ts.map +0 -1
  325. package/dist/index.js.map +0 -1
  326. package/dist/protocol/flows.d.ts.map +0 -1
  327. package/dist/protocol/flows.js.map +0 -1
  328. package/dist/protocol/iap.d.ts.map +0 -1
  329. package/dist/protocol/iap.js.map +0 -1
  330. package/dist/protocol/index.d.ts.map +0 -1
  331. package/dist/protocol/index.js.map +0 -1
  332. package/dist/protocol/types.d.ts.map +0 -1
  333. package/dist/protocol/types.js.map +0 -1
  334. package/dist/protocol/utils.d.ts.map +0 -1
  335. package/dist/protocol/utils.js.map +0 -1
  336. package/dist/protocol/validators.d.ts.map +0 -1
  337. package/dist/protocol/validators.js.map +0 -1
  338. package/dist/security/AuthManager.d.ts.map +0 -1
  339. package/dist/security/AuthManager.js.map +0 -1
  340. package/dist/security/MessageSanitizer.d.ts.map +0 -1
  341. package/dist/security/MessageSanitizer.js.map +0 -1
  342. package/dist/security/RateLimiter.d.ts.map +0 -1
  343. package/dist/security/RateLimiter.js.map +0 -1
  344. package/dist/security/SecurityMiddleware.d.ts.map +0 -1
  345. package/dist/security/SecurityMiddleware.js.map +0 -1
  346. package/dist/security/index.d.ts.map +0 -1
  347. package/dist/security/index.js.map +0 -1
  348. package/dist/speculative/PredictionEngine.d.ts.map +0 -1
  349. package/dist/speculative/PredictionEngine.js.map +0 -1
  350. package/dist/speculative/SpeculativeCache.d.ts.map +0 -1
  351. package/dist/speculative/SpeculativeCache.js.map +0 -1
  352. package/dist/speculative/SpeculativeEngine.d.ts.map +0 -1
  353. package/dist/speculative/SpeculativeEngine.js.map +0 -1
  354. package/dist/speculative/WorkerPool.d.ts.map +0 -1
  355. package/dist/speculative/WorkerPool.js.map +0 -1
  356. package/dist/speculative/index.d.ts.map +0 -1
  357. package/dist/speculative/index.js.map +0 -1
  358. package/dist/subconscious/EmbeddingService.d.ts.map +0 -1
  359. package/dist/subconscious/EmbeddingService.js.map +0 -1
  360. package/dist/subconscious/SemanticCache.d.ts.map +0 -1
  361. package/dist/subconscious/SemanticCache.js.map +0 -1
  362. package/dist/subconscious/SubconsciousEngine.d.ts.map +0 -1
  363. package/dist/subconscious/SubconsciousEngine.js.map +0 -1
  364. package/dist/subconscious/VectorStore.d.ts.map +0 -1
  365. package/dist/subconscious/VectorStore.js.map +0 -1
  366. package/dist/subconscious/cache.d.ts.map +0 -1
  367. package/dist/subconscious/embeddings.d.ts.map +0 -1
  368. package/dist/subconscious/embeddings.js.map +0 -1
  369. package/dist/subconscious/index.d.ts.map +0 -1
  370. package/dist/subconscious/index.js.map +0 -1
  371. package/dist/types/index.d.ts.map +0 -1
  372. package/dist/types/index.js.map +0 -1
  373. package/dist/utils/logger.d.ts.map +0 -1
  374. package/dist/utils/logger.js.map +0 -1
  375. /package/dist/{cloud → cjs/cloud}/KeyManager.d.ts +0 -0
  376. /package/dist/{cloud → cjs/cloud}/KeyManager.js +0 -0
  377. /package/dist/{cloud → cjs/cloud}/TenantCache.d.ts +0 -0
  378. /package/dist/{cloud → cjs/cloud}/TenantCache.js +0 -0
  379. /package/dist/{cloud → cjs/cloud}/index.d.ts +0 -0
  380. /package/dist/{cloud → cjs/cloud}/index.js +0 -0
  381. /package/dist/{cloud → cjs/cloud}/server.d.ts +0 -0
  382. /package/dist/{cloud → cjs/cloud}/server.js +0 -0
  383. /package/dist/{cloud → cjs/cloud}/types.d.ts +0 -0
  384. /package/dist/{cloud → cjs/cloud}/types.js +0 -0
  385. /package/dist/{config → cjs/config}/index.d.ts +0 -0
  386. /package/dist/{config → cjs/config}/index.js +0 -0
  387. /package/dist/{consensus → cjs/consensus}/ConsensusEngine.d.ts +0 -0
  388. /package/dist/{consensus → cjs/consensus}/ConsensusEngine.js +0 -0
  389. /package/dist/{consensus → cjs/consensus}/ModelPool.d.ts +0 -0
  390. /package/dist/{consensus → cjs/consensus}/ModelPool.js +0 -0
  391. /package/dist/{consensus → cjs/consensus}/index.d.ts +0 -0
  392. /package/dist/{consensus → cjs/consensus}/index.js +0 -0
  393. /package/dist/{core → cjs/core}/AgentRegistry.d.ts +0 -0
  394. /package/dist/{core → cjs/core}/AgentRegistry.js +0 -0
  395. /package/dist/{core → cjs/core}/DashboardBroadcaster.d.ts +0 -0
  396. /package/dist/{core → cjs/core}/DashboardBroadcaster.js +0 -0
  397. /package/dist/{core → cjs/core}/SubconsciousEngine.d.ts +0 -0
  398. /package/dist/{core → cjs/core}/WebSocketServer.d.ts +0 -0
  399. /package/dist/{core → cjs/core}/index.d.ts +0 -0
  400. /package/dist/{core → cjs/core}/index.js +0 -0
  401. /package/dist/{core → cjs/core}/router.d.ts +0 -0
  402. /package/dist/{core → cjs/core}/router.js +0 -0
  403. /package/dist/{embed.d.ts → cjs/embed.d.ts} +0 -0
  404. /package/dist/{embed.js → cjs/embed.js} +0 -0
  405. /package/dist/{index.d.ts → cjs/index.d.ts} +0 -0
  406. /package/dist/{index.js → cjs/index.js} +0 -0
  407. /package/dist/{protocol → cjs/protocol}/flows.d.ts +0 -0
  408. /package/dist/{protocol → cjs/protocol}/flows.js +0 -0
  409. /package/dist/{protocol → cjs/protocol}/iap.d.ts +0 -0
  410. /package/dist/{protocol → cjs/protocol}/iap.js +0 -0
  411. /package/dist/{protocol → cjs/protocol}/index.d.ts +0 -0
  412. /package/dist/{protocol → cjs/protocol}/index.js +0 -0
  413. /package/dist/{protocol → cjs/protocol}/types.d.ts +0 -0
  414. /package/dist/{protocol → cjs/protocol}/types.js +0 -0
  415. /package/dist/{protocol → cjs/protocol}/utils.d.ts +0 -0
  416. /package/dist/{protocol → cjs/protocol}/utils.js +0 -0
  417. /package/dist/{protocol → cjs/protocol}/validators.d.ts +0 -0
  418. /package/dist/{protocol → cjs/protocol}/validators.js +0 -0
  419. /package/dist/{security → cjs/security}/AuthManager.d.ts +0 -0
  420. /package/dist/{security → cjs/security}/AuthManager.js +0 -0
  421. /package/dist/{security → cjs/security}/MessageSanitizer.d.ts +0 -0
  422. /package/dist/{security → cjs/security}/RateLimiter.d.ts +0 -0
  423. /package/dist/{security → cjs/security}/RateLimiter.js +0 -0
  424. /package/dist/{security → cjs/security}/index.d.ts +0 -0
  425. /package/dist/{security → cjs/security}/index.js +0 -0
  426. /package/dist/{speculative → cjs/speculative}/PredictionEngine.d.ts +0 -0
  427. /package/dist/{speculative → cjs/speculative}/PredictionEngine.js +0 -0
  428. /package/dist/{speculative → cjs/speculative}/SpeculativeCache.d.ts +0 -0
  429. /package/dist/{speculative → cjs/speculative}/SpeculativeCache.js +0 -0
  430. /package/dist/{speculative → cjs/speculative}/SpeculativeEngine.d.ts +0 -0
  431. /package/dist/{speculative → cjs/speculative}/SpeculativeEngine.js +0 -0
  432. /package/dist/{speculative → cjs/speculative}/WorkerPool.d.ts +0 -0
  433. /package/dist/{speculative → cjs/speculative}/WorkerPool.js +0 -0
  434. /package/dist/{speculative → cjs/speculative}/index.d.ts +0 -0
  435. /package/dist/{speculative → cjs/speculative}/index.js +0 -0
  436. /package/dist/{subconscious → cjs/subconscious}/EmbeddingService.d.ts +0 -0
  437. /package/dist/{subconscious → cjs/subconscious}/EmbeddingService.js +0 -0
  438. /package/dist/{subconscious → cjs/subconscious}/SemanticCache.d.ts +0 -0
  439. /package/dist/{subconscious → cjs/subconscious}/SemanticCache.js +0 -0
  440. /package/dist/{subconscious → cjs/subconscious}/SubconsciousEngine.d.ts +0 -0
  441. /package/dist/{subconscious → cjs/subconscious}/SubconsciousEngine.js +0 -0
  442. /package/dist/{subconscious → cjs/subconscious}/VectorStore.d.ts +0 -0
  443. /package/dist/{subconscious → cjs/subconscious}/cache.d.ts +0 -0
  444. /package/dist/{subconscious → cjs/subconscious}/cache.js +0 -0
  445. /package/dist/{subconscious → cjs/subconscious}/embeddings.d.ts +0 -0
  446. /package/dist/{subconscious → cjs/subconscious}/embeddings.js +0 -0
  447. /package/dist/{subconscious → cjs/subconscious}/index.d.ts +0 -0
  448. /package/dist/{subconscious → cjs/subconscious}/index.js +0 -0
  449. /package/dist/{types → cjs/types}/index.d.ts +0 -0
  450. /package/dist/{types → cjs/types}/index.js +0 -0
  451. /package/dist/{utils → cjs/utils}/logger.d.ts +0 -0
  452. /package/dist/{utils → cjs/utils}/logger.js +0 -0
@@ -0,0 +1,288 @@
1
+ /**
2
+ * Speculative Cache - Speculative Execution v2.0
3
+ *
4
+ * Stores pre-computed results from speculative execution with TTL-based expiration.
5
+ * Provides instant (<10ms) cache lookups for predicted requests.
6
+ *
7
+ * Features:
8
+ * - TTL-based expiration
9
+ * - Confidence-based prioritization
10
+ * - Memory-efficient storage
11
+ * - Automatic cleanup
12
+ */
13
+ import { EventEmitter } from 'events';
14
+ export class SpeculativeCache extends EventEmitter {
15
+ constructor(config = {}) {
16
+ super();
17
+ this.cache = new Map();
18
+ this.metrics = {
19
+ size: 0,
20
+ hits: 0,
21
+ misses: 0,
22
+ hitRate: 0,
23
+ averageHitLatency: 0,
24
+ memoryUsageMB: 0,
25
+ evictions: 0,
26
+ };
27
+ this.hitLatencies = [];
28
+ this.config = {
29
+ maxSize: config.maxSize || 100,
30
+ defaultTTL: config.defaultTTL || 60000,
31
+ cleanupInterval: config.cleanupInterval || 10000,
32
+ maxMemoryMB: config.maxMemoryMB || 200,
33
+ };
34
+ }
35
+ /**
36
+ * Start the cache
37
+ */
38
+ start() {
39
+ // Start cleanup timer
40
+ this.cleanupTimer = setInterval(() => {
41
+ this.cleanup();
42
+ }, this.config.cleanupInterval);
43
+ this.emit('started');
44
+ }
45
+ /**
46
+ * Store a pre-computed result
47
+ */
48
+ set(result) {
49
+ if (!result.success) {
50
+ return; // Don't cache failed results
51
+ }
52
+ // Check memory limit
53
+ if (this.getMemoryUsageMB() > this.config.maxMemoryMB) {
54
+ this.evictLowPriority();
55
+ }
56
+ // Check size limit
57
+ if (this.cache.size >= this.config.maxSize) {
58
+ this.evictLowPriority();
59
+ }
60
+ const entry = {
61
+ id: result.taskId,
62
+ prediction: result.prediction,
63
+ result: result.result,
64
+ confidence: result.prediction.confidence,
65
+ createdAt: Date.now(),
66
+ expiresAt: Date.now() + this.config.defaultTTL,
67
+ hits: 0,
68
+ lastAccessedAt: Date.now(),
69
+ };
70
+ this.cache.set(this.generateKey(result.prediction), entry);
71
+ this.updateMetrics();
72
+ this.emit('entry-added', entry);
73
+ }
74
+ /**
75
+ * Get a cached result
76
+ */
77
+ get(taskType, context) {
78
+ const startTime = Date.now();
79
+ const key = this.generateKeyFromRequest(taskType, context);
80
+ // Try exact match first
81
+ let entry = this.cache.get(key);
82
+ // Try fuzzy match if exact match fails
83
+ if (!entry) {
84
+ entry = this.findBestMatch(taskType, context) ?? undefined;
85
+ }
86
+ const latency = Date.now() - startTime;
87
+ if (entry) {
88
+ // Check expiration
89
+ if (entry.expiresAt < Date.now()) {
90
+ this.cache.delete(key);
91
+ this.metrics.misses++;
92
+ this.updateMetrics();
93
+ return null;
94
+ }
95
+ // Update entry stats
96
+ entry.hits++;
97
+ entry.lastAccessedAt = Date.now();
98
+ // Update metrics
99
+ this.metrics.hits++;
100
+ this.hitLatencies.push(latency);
101
+ if (this.hitLatencies.length > 100) {
102
+ this.hitLatencies.shift();
103
+ }
104
+ this.updateMetrics();
105
+ this.emit('cache-hit', { entry, latency });
106
+ return entry;
107
+ }
108
+ this.metrics.misses++;
109
+ this.updateMetrics();
110
+ this.emit('cache-miss', { taskType, context, latency });
111
+ return null;
112
+ }
113
+ /**
114
+ * Find best matching entry using fuzzy matching
115
+ */
116
+ findBestMatch(taskType, context) {
117
+ let bestMatch = null;
118
+ let bestScore = 0;
119
+ for (const entry of this.cache.values()) {
120
+ // Skip expired entries
121
+ if (entry.expiresAt < Date.now()) {
122
+ continue;
123
+ }
124
+ const score = this.calculateMatchScore(taskType, context, entry.prediction);
125
+ if (score > bestScore && score > 0.85) {
126
+ // 85% similarity threshold
127
+ bestScore = score;
128
+ bestMatch = entry;
129
+ }
130
+ }
131
+ return bestMatch;
132
+ }
133
+ /**
134
+ * Calculate match score between request and cached prediction
135
+ */
136
+ calculateMatchScore(taskType, context, prediction) {
137
+ let score = 0;
138
+ // Task type exact match (40% weight)
139
+ if (taskType === prediction.taskType) {
140
+ score += 0.4;
141
+ }
142
+ // Context similarity (40% weight)
143
+ const contextSimilarity = this.calculateTextSimilarity(context, prediction.context);
144
+ score += contextSimilarity * 0.4;
145
+ // Confidence bonus (20% weight)
146
+ score += prediction.confidence * 0.2;
147
+ return score;
148
+ }
149
+ /**
150
+ * Simple text similarity using word overlap
151
+ */
152
+ calculateTextSimilarity(text1, text2) {
153
+ const words1 = new Set(text1.toLowerCase().split(/\s+/));
154
+ const words2 = new Set(text2.toLowerCase().split(/\s+/));
155
+ const intersection = new Set([...words1].filter((w) => words2.has(w)));
156
+ const union = new Set([...words1, ...words2]);
157
+ return union.size > 0 ? intersection.size / union.size : 0;
158
+ }
159
+ /**
160
+ * Generate cache key from prediction
161
+ */
162
+ generateKey(prediction) {
163
+ return `${prediction.taskType}:${this.hashString(prediction.context)}`;
164
+ }
165
+ /**
166
+ * Generate cache key from request
167
+ */
168
+ generateKeyFromRequest(taskType, context) {
169
+ return `${taskType}:${this.hashString(context)}`;
170
+ }
171
+ /**
172
+ * Simple string hash function
173
+ */
174
+ hashString(str) {
175
+ let hash = 0;
176
+ for (let i = 0; i < str.length; i++) {
177
+ const char = str.charCodeAt(i);
178
+ hash = (hash << 5) - hash + char;
179
+ hash = hash & hash; // Convert to 32-bit integer
180
+ }
181
+ return Math.abs(hash).toString(36);
182
+ }
183
+ /**
184
+ * Evict low priority entries
185
+ */
186
+ evictLowPriority() {
187
+ // Sort by priority (confidence * hits / age)
188
+ const entries = Array.from(this.cache.entries()).map(([key, entry]) => {
189
+ const age = Date.now() - entry.createdAt;
190
+ const priority = (entry.confidence * (entry.hits + 1)) / (age + 1);
191
+ return { key, entry, priority };
192
+ });
193
+ entries.sort((a, b) => a.priority - b.priority);
194
+ // Remove lowest 10% or at least 1
195
+ const toRemove = Math.max(1, Math.floor(entries.length * 0.1));
196
+ for (let i = 0; i < toRemove; i++) {
197
+ this.cache.delete(entries[i].key);
198
+ this.metrics.evictions++;
199
+ this.emit('entry-evicted', entries[i].entry);
200
+ }
201
+ this.updateMetrics();
202
+ }
203
+ /**
204
+ * Cleanup expired entries
205
+ */
206
+ cleanup() {
207
+ const now = Date.now();
208
+ let removed = 0;
209
+ for (const [key, entry] of this.cache.entries()) {
210
+ if (entry.expiresAt < now) {
211
+ this.cache.delete(key);
212
+ removed++;
213
+ }
214
+ }
215
+ if (removed > 0) {
216
+ this.updateMetrics();
217
+ this.emit('cleanup', { removed });
218
+ }
219
+ }
220
+ /**
221
+ * Estimate memory usage in MB
222
+ */
223
+ getMemoryUsageMB() {
224
+ let totalSize = 0;
225
+ for (const entry of this.cache.values()) {
226
+ // Rough estimate: JSON size
227
+ totalSize += JSON.stringify(entry).length;
228
+ }
229
+ return totalSize / (1024 * 1024);
230
+ }
231
+ /**
232
+ * Update metrics
233
+ */
234
+ updateMetrics() {
235
+ this.metrics.size = this.cache.size;
236
+ this.metrics.hitRate =
237
+ this.metrics.hits + this.metrics.misses > 0
238
+ ? this.metrics.hits / (this.metrics.hits + this.metrics.misses)
239
+ : 0;
240
+ this.metrics.averageHitLatency =
241
+ this.hitLatencies.length > 0
242
+ ? this.hitLatencies.reduce((sum, l) => sum + l, 0) /
243
+ this.hitLatencies.length
244
+ : 0;
245
+ this.metrics.memoryUsageMB = this.getMemoryUsageMB();
246
+ }
247
+ /**
248
+ * Get current metrics
249
+ */
250
+ getMetrics() {
251
+ this.updateMetrics();
252
+ return { ...this.metrics };
253
+ }
254
+ /**
255
+ * Get all entries
256
+ */
257
+ getEntries() {
258
+ return Array.from(this.cache.values());
259
+ }
260
+ /**
261
+ * Clear all entries
262
+ */
263
+ clear() {
264
+ this.cache.clear();
265
+ this.metrics = {
266
+ size: 0,
267
+ hits: 0,
268
+ misses: 0,
269
+ hitRate: 0,
270
+ averageHitLatency: 0,
271
+ memoryUsageMB: 0,
272
+ evictions: 0,
273
+ };
274
+ this.hitLatencies = [];
275
+ this.emit('cleared');
276
+ }
277
+ /**
278
+ * Stop the cache
279
+ */
280
+ stop() {
281
+ if (this.cleanupTimer) {
282
+ clearInterval(this.cleanupTimer);
283
+ this.cleanupTimer = undefined;
284
+ }
285
+ this.emit('stopped');
286
+ }
287
+ }
288
+ //# sourceMappingURL=SpeculativeCache.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"SpeculativeCache.js","sourceRoot":"","sources":["../../../src/speculative/SpeculativeCache.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,114 @@
1
+ /**
2
+ * Speculative Engine - Speculative Execution v2.0
3
+ *
4
+ * Main orchestrator for speculative execution. Coordinates prediction,
5
+ * worker pool, and speculative cache to achieve negative latency.
6
+ *
7
+ * Features:
8
+ * - Automatic prediction generation
9
+ * - Background pre-computation
10
+ * - Instant cache lookups (<10ms)
11
+ * - Graceful fallback to standard routing
12
+ */
13
+ import { EventEmitter } from 'events';
14
+ import { Prediction } from './PredictionEngine';
15
+ import { CacheEntry } from './SpeculativeCache';
16
+ export interface SpeculativeEngineConfig {
17
+ enabled?: boolean;
18
+ predictionEngine?: any;
19
+ workerPool?: any;
20
+ speculativeCache?: any;
21
+ }
22
+ export interface SpeculativeResult {
23
+ hit: boolean;
24
+ result: any;
25
+ latency: number;
26
+ source: 'speculative-cache' | 'semantic-cache' | 'agent';
27
+ confidence?: number;
28
+ }
29
+ export interface SpeculativeMetrics {
30
+ enabled: boolean;
31
+ predictions: {
32
+ total: number;
33
+ accurate: number;
34
+ accuracy: number;
35
+ averageConfidence: number;
36
+ };
37
+ cache: {
38
+ size: number;
39
+ hits: number;
40
+ misses: number;
41
+ hitRate: number;
42
+ averageLatency: number;
43
+ };
44
+ workers: {
45
+ active: number;
46
+ idle: number;
47
+ queued: number;
48
+ completed: number;
49
+ failed: number;
50
+ };
51
+ performance: {
52
+ averageSpeculativeLatency: number;
53
+ averageFallbackLatency: number;
54
+ latencyImprovement: number;
55
+ };
56
+ }
57
+ export declare class SpeculativeEngine extends EventEmitter {
58
+ private config;
59
+ private predictionEngine;
60
+ private workerPool;
61
+ private speculativeCache;
62
+ private enabled;
63
+ private performanceMetrics;
64
+ constructor(config?: SpeculativeEngineConfig);
65
+ /**
66
+ * Setup event handlers between components
67
+ */
68
+ private setupEventHandlers;
69
+ /**
70
+ * Initialize the speculative engine
71
+ */
72
+ initialize(): Promise<void>;
73
+ /**
74
+ * Process a request with speculative execution
75
+ */
76
+ processRequest(taskType: string, context: string, agentId?: string): Promise<SpeculativeResult>;
77
+ /**
78
+ * Trim performance metrics to keep memory bounded
79
+ */
80
+ private trimMetrics;
81
+ /**
82
+ * Get comprehensive metrics
83
+ */
84
+ getMetrics(): SpeculativeMetrics;
85
+ /**
86
+ * Get active predictions
87
+ */
88
+ getActivePredictions(): Prediction[];
89
+ /**
90
+ * Get cached entries
91
+ */
92
+ getCachedEntries(): CacheEntry[];
93
+ /**
94
+ * Enable speculative execution
95
+ */
96
+ enable(): void;
97
+ /**
98
+ * Disable speculative execution
99
+ */
100
+ disable(): void;
101
+ /**
102
+ * Check if enabled
103
+ */
104
+ isEnabled(): boolean;
105
+ /**
106
+ * Clear all caches and predictions
107
+ */
108
+ clear(): void;
109
+ /**
110
+ * Shutdown the speculative engine
111
+ */
112
+ shutdown(): Promise<void>;
113
+ }
114
+ //# sourceMappingURL=SpeculativeEngine.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"SpeculativeEngine.d.ts","sourceRoot":"","sources":["../../../src/speculative/SpeculativeEngine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAoB,UAAU,EAAqB,MAAM,oBAAoB,CAAC;AAErF,OAAO,EAAoB,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAElE,MAAM,WAAW,uBAAuB;IACtC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,gBAAgB,CAAC,EAAE,GAAG,CAAC;IACvB,UAAU,CAAC,EAAE,GAAG,CAAC;IACjB,gBAAgB,CAAC,EAAE,GAAG,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,OAAO,CAAC;IACb,MAAM,EAAE,GAAG,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,mBAAmB,GAAG,gBAAgB,GAAG,OAAO,CAAC;IACzD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE;QACX,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,iBAAiB,EAAE,MAAM,CAAC;KAC3B,CAAC;IACF,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,OAAO,EAAE;QACP,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,WAAW,EAAE;QACX,yBAAyB,EAAE,MAAM,CAAC;QAClC,sBAAsB,EAAE,MAAM,CAAC;QAC/B,kBAAkB,EAAE,MAAM,CAAC;KAC5B,CAAC;CACH;AAED,qBAAa,iBAAkB,SAAQ,YAAY;IACjD,OAAO,CAAC,MAAM,CAAoC;IAClD,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,kBAAkB,CAGxB;gBAEU,MAAM,GAAE,uBAA4B;IAmBhD;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAmC1B;;OAEG;IACU,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAYxC;;OAEG;IACU,cAAc,CACzB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,iBAAiB,CAAC;IAkD7B;;OAEG;IACH,OAAO,CAAC,WAAW;IAYnB;;OAEG;IACI,UAAU,IAAI,kBAAkB;IAsDvC;;OAEG;IACI,oBAAoB,IAAI,UAAU,EAAE;IAI3C;;OAEG;IACI,gBAAgB,IAAI,UAAU,EAAE;IAIvC;;OAEG;IACI,MAAM,IAAI,IAAI;IAKrB;;OAEG;IACI,OAAO,IAAI,IAAI;IAKtB;;OAEG;IACI,SAAS,IAAI,OAAO;IAI3B;;OAEG;IACI,KAAK,IAAI,IAAI;IAUpB;;OAEG;IACU,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAMvC"}
@@ -0,0 +1,240 @@
1
+ /**
2
+ * Speculative Engine - Speculative Execution v2.0
3
+ *
4
+ * Main orchestrator for speculative execution. Coordinates prediction,
5
+ * worker pool, and speculative cache to achieve negative latency.
6
+ *
7
+ * Features:
8
+ * - Automatic prediction generation
9
+ * - Background pre-computation
10
+ * - Instant cache lookups (<10ms)
11
+ * - Graceful fallback to standard routing
12
+ */
13
+ import { EventEmitter } from 'events';
14
+ import { PredictionEngine } from './PredictionEngine';
15
+ import { WorkerPool } from './WorkerPool';
16
+ import { SpeculativeCache } from './SpeculativeCache';
17
+ export class SpeculativeEngine extends EventEmitter {
18
+ constructor(config = {}) {
19
+ super();
20
+ this.performanceMetrics = {
21
+ speculativeLatencies: [],
22
+ fallbackLatencies: [],
23
+ };
24
+ this.enabled = config.enabled !== false;
25
+ this.predictionEngine = config.predictionEngine || new PredictionEngine();
26
+ this.workerPool = config.workerPool || new WorkerPool();
27
+ this.speculativeCache = config.speculativeCache || new SpeculativeCache();
28
+ this.config = {
29
+ enabled: this.enabled,
30
+ predictionEngine: this.predictionEngine,
31
+ workerPool: this.workerPool,
32
+ speculativeCache: this.speculativeCache,
33
+ };
34
+ this.setupEventHandlers();
35
+ }
36
+ /**
37
+ * Setup event handlers between components
38
+ */
39
+ setupEventHandlers() {
40
+ // When predictions are generated, submit to worker pool
41
+ this.predictionEngine.on('predictions', (predictions) => {
42
+ this.workerPool.submitPredictions(predictions).catch((error) => {
43
+ this.emit('error', error);
44
+ });
45
+ });
46
+ // When tasks complete, store in speculative cache
47
+ this.workerPool.on('task-completed', (result) => {
48
+ if (result.success) {
49
+ this.speculativeCache.set(result);
50
+ }
51
+ });
52
+ // Forward prediction hits
53
+ this.predictionEngine.on('prediction-hit', (data) => {
54
+ this.emit('prediction-hit', data);
55
+ });
56
+ // Forward cache hits
57
+ this.speculativeCache.on('cache-hit', (data) => {
58
+ this.emit('speculative-cache-hit', data);
59
+ });
60
+ // Forward errors
61
+ this.predictionEngine.on('error', (error) => {
62
+ this.emit('error', { source: 'prediction-engine', error });
63
+ });
64
+ this.workerPool.on('worker-error', (error) => {
65
+ this.emit('error', { source: 'worker-pool', error });
66
+ });
67
+ }
68
+ /**
69
+ * Initialize the speculative engine
70
+ */
71
+ async initialize() {
72
+ if (!this.enabled) {
73
+ this.emit('disabled');
74
+ return;
75
+ }
76
+ await this.workerPool.initialize();
77
+ this.speculativeCache.start();
78
+ this.emit('initialized');
79
+ }
80
+ /**
81
+ * Process a request with speculative execution
82
+ */
83
+ async processRequest(taskType, context, agentId) {
84
+ const startTime = Date.now();
85
+ if (!this.enabled) {
86
+ return {
87
+ hit: false,
88
+ result: null,
89
+ latency: Date.now() - startTime,
90
+ source: 'agent',
91
+ };
92
+ }
93
+ // 1. Check speculative cache first (fastest path)
94
+ const cacheEntry = this.speculativeCache.get(taskType, context);
95
+ if (cacheEntry) {
96
+ const latency = Date.now() - startTime;
97
+ this.performanceMetrics.speculativeLatencies.push(latency);
98
+ this.trimMetrics();
99
+ return {
100
+ hit: true,
101
+ result: cacheEntry.result,
102
+ latency,
103
+ source: 'speculative-cache',
104
+ confidence: cacheEntry.confidence,
105
+ };
106
+ }
107
+ // 2. Record request for future predictions
108
+ const request = {
109
+ taskType,
110
+ context,
111
+ agentId,
112
+ timestamp: Date.now(),
113
+ };
114
+ this.predictionEngine.recordRequest(request);
115
+ // 3. Return miss (caller should fallback to semantic cache or agent)
116
+ const latency = Date.now() - startTime;
117
+ this.performanceMetrics.fallbackLatencies.push(latency);
118
+ this.trimMetrics();
119
+ return {
120
+ hit: false,
121
+ result: null,
122
+ latency,
123
+ source: 'agent',
124
+ };
125
+ }
126
+ /**
127
+ * Trim performance metrics to keep memory bounded
128
+ */
129
+ trimMetrics() {
130
+ const maxSize = 1000;
131
+ if (this.performanceMetrics.speculativeLatencies.length > maxSize) {
132
+ this.performanceMetrics.speculativeLatencies =
133
+ this.performanceMetrics.speculativeLatencies.slice(-maxSize);
134
+ }
135
+ if (this.performanceMetrics.fallbackLatencies.length > maxSize) {
136
+ this.performanceMetrics.fallbackLatencies =
137
+ this.performanceMetrics.fallbackLatencies.slice(-maxSize);
138
+ }
139
+ }
140
+ /**
141
+ * Get comprehensive metrics
142
+ */
143
+ getMetrics() {
144
+ const predictionMetrics = this.predictionEngine.getMetrics();
145
+ const cacheMetrics = this.speculativeCache.getMetrics();
146
+ const workerMetrics = this.workerPool.getMetrics();
147
+ const avgSpeculativeLatency = this.performanceMetrics.speculativeLatencies.length > 0
148
+ ? this.performanceMetrics.speculativeLatencies.reduce((sum, l) => sum + l, 0) / this.performanceMetrics.speculativeLatencies.length
149
+ : 0;
150
+ const avgFallbackLatency = this.performanceMetrics.fallbackLatencies.length > 0
151
+ ? this.performanceMetrics.fallbackLatencies.reduce((sum, l) => sum + l, 0) /
152
+ this.performanceMetrics.fallbackLatencies.length
153
+ : 0;
154
+ const latencyImprovement = avgFallbackLatency > 0
155
+ ? ((avgFallbackLatency - avgSpeculativeLatency) / avgFallbackLatency) * 100
156
+ : 0;
157
+ return {
158
+ enabled: this.enabled,
159
+ predictions: {
160
+ total: predictionMetrics.totalPredictions,
161
+ accurate: predictionMetrics.accuratePredictions,
162
+ accuracy: predictionMetrics.accuracy,
163
+ averageConfidence: predictionMetrics.averageConfidence,
164
+ },
165
+ cache: {
166
+ size: cacheMetrics.size,
167
+ hits: cacheMetrics.hits,
168
+ misses: cacheMetrics.misses,
169
+ hitRate: cacheMetrics.hitRate,
170
+ averageLatency: cacheMetrics.averageHitLatency,
171
+ },
172
+ workers: {
173
+ active: workerMetrics.activeWorkers,
174
+ idle: workerMetrics.idleWorkers,
175
+ queued: workerMetrics.queuedTasks,
176
+ completed: workerMetrics.completedTasks,
177
+ failed: workerMetrics.failedTasks,
178
+ },
179
+ performance: {
180
+ averageSpeculativeLatency: avgSpeculativeLatency,
181
+ averageFallbackLatency: avgFallbackLatency,
182
+ latencyImprovement,
183
+ },
184
+ };
185
+ }
186
+ /**
187
+ * Get active predictions
188
+ */
189
+ getActivePredictions() {
190
+ return this.predictionEngine.getActivePredictions();
191
+ }
192
+ /**
193
+ * Get cached entries
194
+ */
195
+ getCachedEntries() {
196
+ return this.speculativeCache.getEntries();
197
+ }
198
+ /**
199
+ * Enable speculative execution
200
+ */
201
+ enable() {
202
+ this.enabled = true;
203
+ this.emit('enabled');
204
+ }
205
+ /**
206
+ * Disable speculative execution
207
+ */
208
+ disable() {
209
+ this.enabled = false;
210
+ this.emit('disabled');
211
+ }
212
+ /**
213
+ * Check if enabled
214
+ */
215
+ isEnabled() {
216
+ return this.enabled;
217
+ }
218
+ /**
219
+ * Clear all caches and predictions
220
+ */
221
+ clear() {
222
+ this.predictionEngine.clear();
223
+ this.speculativeCache.clear();
224
+ this.performanceMetrics = {
225
+ speculativeLatencies: [],
226
+ fallbackLatencies: [],
227
+ };
228
+ this.emit('cleared');
229
+ }
230
+ /**
231
+ * Shutdown the speculative engine
232
+ */
233
+ async shutdown() {
234
+ this.speculativeCache.stop();
235
+ await this.workerPool.shutdown();
236
+ this.clear();
237
+ this.emit('shutdown');
238
+ }
239
+ }
240
+ //# sourceMappingURL=SpeculativeEngine.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"SpeculativeEngine.js","sourceRoot":"","sources":["../../../src/speculative/SpeculativeEngine.ts"],"names":[],"mappings":"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"}