@ai.ntellect/core 1.0.0 → 1.1.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 (435) hide show
  1. package/.mocharc.json +6 -0
  2. package/AGENTS.md +50 -0
  3. package/ARCHITECTURE.md +58 -0
  4. package/BENCHMARK.md +38 -0
  5. package/CHANGELOG.md +224 -0
  6. package/README.md +411 -142
  7. package/agent/agent-workflow.ts +569 -0
  8. package/agent/agent.ts +183 -0
  9. package/agent/base/executor.ts +103 -0
  10. package/agent/base/index.ts +87 -0
  11. package/agent/entity-resolver/confidence.ts +54 -0
  12. package/agent/entity-resolver/entity-index.ts +241 -0
  13. package/agent/entity-resolver/explore-strategy.ts +82 -0
  14. package/agent/entity-resolver/index.ts +22 -0
  15. package/agent/entity-resolver/resolver.ts +193 -0
  16. package/agent/entity-resolver/scorer.ts +211 -0
  17. package/agent/entity-resolver/types.ts +98 -0
  18. package/agent/generic-executor.ts +713 -0
  19. package/agent/handlers/cognitive-handler.ts +197 -0
  20. package/agent/handlers/index.ts +1 -0
  21. package/agent/handoff.ts +58 -0
  22. package/agent/llm-factory.ts +343 -0
  23. package/agent/orchestrator.ts +45 -0
  24. package/agent/prompt-builder.ts +78 -0
  25. package/agent/registry.ts +64 -0
  26. package/agent/tools/file-system.ts +471 -0
  27. package/agent/tools/index.ts +23 -0
  28. package/agent/tools/logger.ts +105 -0
  29. package/agent/tools/tool-resolver.ts +104 -0
  30. package/benchmark/cortexflow-workflow.ts +182 -0
  31. package/benchmark/langgraph-workflow.ts +201 -0
  32. package/benchmark/llm-client.ts +76 -0
  33. package/benchmark/run-benchmark.ts +222 -0
  34. package/cli-dev.ts +419 -0
  35. package/dist/agent/agent-workflow.d.ts +41 -0
  36. package/dist/agent/agent-workflow.d.ts.map +1 -0
  37. package/dist/agent/agent-workflow.js +560 -0
  38. package/dist/agent/agent-workflow.js.map +1 -0
  39. package/dist/agent/agent.d.ts +38 -0
  40. package/dist/agent/agent.d.ts.map +1 -0
  41. package/dist/agent/agent.js +149 -0
  42. package/dist/agent/agent.js.map +1 -0
  43. package/dist/agent/base/executor.d.ts +51 -0
  44. package/dist/agent/base/executor.d.ts.map +1 -0
  45. package/dist/agent/base/executor.js +69 -0
  46. package/dist/agent/base/executor.js.map +1 -0
  47. package/dist/agent/base/index.d.ts +30 -0
  48. package/dist/agent/base/index.d.ts.map +1 -0
  49. package/dist/agent/base/index.js +88 -0
  50. package/dist/agent/base/index.js.map +1 -0
  51. package/dist/agent/entity-resolver/confidence.d.ts +4 -0
  52. package/dist/agent/entity-resolver/confidence.d.ts.map +1 -0
  53. package/dist/agent/entity-resolver/confidence.js +47 -0
  54. package/dist/agent/entity-resolver/confidence.js.map +1 -0
  55. package/dist/agent/entity-resolver/entity-index.d.ts +40 -0
  56. package/dist/agent/entity-resolver/entity-index.d.ts.map +1 -0
  57. package/dist/agent/entity-resolver/entity-index.js +244 -0
  58. package/dist/agent/entity-resolver/entity-index.js.map +1 -0
  59. package/dist/agent/entity-resolver/explore-strategy.d.ts +13 -0
  60. package/dist/agent/entity-resolver/explore-strategy.d.ts.map +1 -0
  61. package/dist/agent/entity-resolver/explore-strategy.js +109 -0
  62. package/dist/agent/entity-resolver/explore-strategy.js.map +1 -0
  63. package/dist/agent/entity-resolver/index.d.ts +8 -0
  64. package/dist/agent/entity-resolver/index.d.ts.map +1 -0
  65. package/dist/agent/entity-resolver/index.js +16 -0
  66. package/dist/agent/entity-resolver/index.js.map +1 -0
  67. package/dist/agent/entity-resolver/resolver.d.ts +18 -0
  68. package/dist/agent/entity-resolver/resolver.d.ts.map +1 -0
  69. package/dist/agent/entity-resolver/resolver.js +158 -0
  70. package/dist/agent/entity-resolver/resolver.js.map +1 -0
  71. package/dist/agent/entity-resolver/scorer.d.ts +3 -0
  72. package/dist/agent/entity-resolver/scorer.d.ts.map +1 -0
  73. package/dist/agent/entity-resolver/scorer.js +182 -0
  74. package/dist/agent/entity-resolver/scorer.js.map +1 -0
  75. package/dist/agent/entity-resolver/types.d.ts +89 -0
  76. package/dist/agent/entity-resolver/types.d.ts.map +1 -0
  77. package/dist/agent/entity-resolver/types.js +3 -0
  78. package/dist/agent/entity-resolver/types.js.map +1 -0
  79. package/dist/agent/generic-executor.d.ts +68 -0
  80. package/dist/agent/generic-executor.d.ts.map +1 -0
  81. package/dist/agent/generic-executor.js +620 -0
  82. package/dist/agent/generic-executor.js.map +1 -0
  83. package/dist/agent/handlers/cognitive-handler.d.ts +44 -0
  84. package/dist/agent/handlers/cognitive-handler.d.ts.map +1 -0
  85. package/dist/agent/handlers/cognitive-handler.js +172 -0
  86. package/dist/agent/handlers/cognitive-handler.js.map +1 -0
  87. package/dist/agent/handlers/index.d.ts +2 -0
  88. package/dist/agent/handlers/index.d.ts.map +1 -0
  89. package/dist/agent/handlers/index.js +7 -0
  90. package/dist/agent/handlers/index.js.map +1 -0
  91. package/dist/agent/handoff.d.ts +12 -0
  92. package/dist/agent/handoff.d.ts.map +1 -0
  93. package/dist/agent/handoff.js +62 -0
  94. package/dist/agent/handoff.js.map +1 -0
  95. package/dist/agent/llm-factory.d.ts +19 -0
  96. package/dist/agent/llm-factory.d.ts.map +1 -0
  97. package/dist/agent/llm-factory.js +297 -0
  98. package/dist/agent/llm-factory.js.map +1 -0
  99. package/dist/agent/orchestrator.d.ts +18 -0
  100. package/dist/agent/orchestrator.d.ts.map +1 -0
  101. package/dist/agent/orchestrator.js +44 -0
  102. package/dist/agent/orchestrator.js.map +1 -0
  103. package/dist/agent/prompt-builder.d.ts +35 -0
  104. package/dist/agent/prompt-builder.d.ts.map +1 -0
  105. package/dist/agent/prompt-builder.js +76 -0
  106. package/dist/agent/prompt-builder.js.map +1 -0
  107. package/dist/agent/registry.d.ts +19 -0
  108. package/dist/agent/registry.d.ts.map +1 -0
  109. package/dist/agent/registry.js +48 -0
  110. package/dist/agent/registry.js.map +1 -0
  111. package/dist/agent/tools/file-system.d.ts +11 -0
  112. package/dist/agent/tools/file-system.d.ts.map +1 -0
  113. package/dist/agent/tools/file-system.js +528 -0
  114. package/dist/agent/tools/file-system.js.map +1 -0
  115. package/dist/agent/tools/index.d.ts +4 -0
  116. package/dist/agent/tools/index.d.ts.map +1 -0
  117. package/dist/agent/tools/index.js +20 -0
  118. package/dist/agent/tools/index.js.map +1 -0
  119. package/dist/agent/tools/logger.d.ts +33 -0
  120. package/dist/agent/tools/logger.d.ts.map +1 -0
  121. package/dist/agent/tools/logger.js +86 -0
  122. package/dist/agent/tools/logger.js.map +1 -0
  123. package/dist/agent/tools/tool-resolver.d.ts +7 -0
  124. package/dist/agent/tools/tool-resolver.d.ts.map +1 -0
  125. package/dist/agent/tools/tool-resolver.js +122 -0
  126. package/dist/agent/tools/tool-resolver.js.map +1 -0
  127. package/dist/execution/adapters/in-memory-checkpoint.d.ts +11 -0
  128. package/dist/execution/adapters/in-memory-checkpoint.d.ts.map +1 -0
  129. package/dist/execution/adapters/in-memory-checkpoint.js +54 -0
  130. package/dist/execution/adapters/in-memory-checkpoint.js.map +1 -0
  131. package/dist/execution/compiler.d.ts +8 -0
  132. package/dist/execution/compiler.d.ts.map +1 -0
  133. package/dist/execution/compiler.js +50 -0
  134. package/dist/execution/compiler.js.map +1 -0
  135. package/dist/execution/controller.d.ts +30 -0
  136. package/dist/execution/controller.d.ts.map +1 -0
  137. package/dist/execution/controller.js +80 -0
  138. package/dist/execution/controller.js.map +1 -0
  139. package/dist/execution/event-manager.d.ts +29 -0
  140. package/dist/execution/event-manager.d.ts.map +1 -0
  141. package/dist/execution/event-manager.js +264 -0
  142. package/dist/execution/event-manager.js.map +1 -0
  143. package/dist/execution/index.d.ts +221 -0
  144. package/dist/execution/index.d.ts.map +1 -0
  145. package/dist/execution/index.js +638 -0
  146. package/dist/execution/index.js.map +1 -0
  147. package/dist/execution/logger.d.ts +46 -0
  148. package/dist/execution/logger.d.ts.map +1 -0
  149. package/dist/execution/logger.js +69 -0
  150. package/dist/execution/logger.js.map +1 -0
  151. package/dist/execution/node.d.ts +65 -0
  152. package/dist/execution/node.d.ts.map +1 -0
  153. package/dist/execution/node.js +250 -0
  154. package/dist/execution/node.js.map +1 -0
  155. package/dist/execution/observer.d.ts +38 -0
  156. package/dist/execution/observer.d.ts.map +1 -0
  157. package/dist/execution/observer.js +111 -0
  158. package/dist/execution/observer.js.map +1 -0
  159. package/dist/execution/planner.d.ts +14 -0
  160. package/dist/execution/planner.d.ts.map +1 -0
  161. package/dist/execution/planner.js +43 -0
  162. package/dist/execution/planner.js.map +1 -0
  163. package/dist/execution/reducer.d.ts +19 -0
  164. package/dist/execution/reducer.d.ts.map +1 -0
  165. package/dist/execution/reducer.js +61 -0
  166. package/dist/execution/reducer.js.map +1 -0
  167. package/dist/execution/registry.d.ts +38 -0
  168. package/dist/execution/registry.d.ts.map +1 -0
  169. package/dist/execution/registry.js +63 -0
  170. package/dist/execution/registry.js.map +1 -0
  171. package/dist/execution/send-api.d.ts +24 -0
  172. package/dist/execution/send-api.d.ts.map +1 -0
  173. package/dist/execution/send-api.js +52 -0
  174. package/dist/execution/send-api.js.map +1 -0
  175. package/dist/execution/types.parallel.d.ts +61 -0
  176. package/dist/execution/types.parallel.d.ts.map +1 -0
  177. package/dist/execution/types.parallel.js +3 -0
  178. package/dist/execution/types.parallel.js.map +1 -0
  179. package/dist/execution/visualizer.d.ts +35 -0
  180. package/dist/execution/visualizer.d.ts.map +1 -0
  181. package/dist/execution/visualizer.js +131 -0
  182. package/dist/execution/visualizer.js.map +1 -0
  183. package/dist/index.d.ts +47 -0
  184. package/dist/index.d.ts.map +1 -0
  185. package/dist/index.js +78 -0
  186. package/dist/index.js.map +1 -0
  187. package/dist/interfaces/index.d.ts +487 -0
  188. package/dist/interfaces/index.d.ts.map +1 -0
  189. package/dist/interfaces/index.js +75 -0
  190. package/dist/interfaces/index.js.map +1 -0
  191. package/dist/modules/agenda/adapters/node-cron/index.d.ts +17 -0
  192. package/dist/modules/agenda/adapters/node-cron/index.d.ts.map +1 -0
  193. package/dist/modules/agenda/adapters/node-cron/index.js +30 -0
  194. package/dist/modules/agenda/adapters/node-cron/index.js.map +1 -0
  195. package/dist/modules/agenda/index.d.ts +63 -0
  196. package/dist/modules/agenda/index.d.ts.map +1 -0
  197. package/dist/modules/agenda/index.js +141 -0
  198. package/dist/modules/agenda/index.js.map +1 -0
  199. package/dist/modules/cli/index.d.ts +13 -0
  200. package/dist/modules/cli/index.d.ts.map +1 -0
  201. package/dist/modules/cli/index.js +672 -0
  202. package/dist/modules/cli/index.js.map +1 -0
  203. package/dist/modules/embedding/adapters/ai/index.d.ts +29 -0
  204. package/dist/modules/embedding/adapters/ai/index.d.ts.map +1 -0
  205. package/dist/modules/embedding/adapters/ai/index.js +58 -0
  206. package/dist/modules/embedding/adapters/ai/index.js.map +1 -0
  207. package/dist/modules/embedding/index.d.ts +36 -0
  208. package/dist/modules/embedding/index.d.ts.map +1 -0
  209. package/dist/modules/embedding/index.js +60 -0
  210. package/dist/modules/embedding/index.js.map +1 -0
  211. package/dist/modules/nlp/engine.d.ts +126 -0
  212. package/dist/modules/nlp/engine.d.ts.map +1 -0
  213. package/dist/modules/nlp/engine.js +299 -0
  214. package/dist/modules/nlp/engine.js.map +1 -0
  215. package/dist/modules/nlp/index.d.ts +27 -0
  216. package/dist/modules/nlp/index.d.ts.map +1 -0
  217. package/dist/modules/nlp/index.js +56 -0
  218. package/dist/modules/nlp/index.js.map +1 -0
  219. package/dist/persistence/index.d.ts +12 -0
  220. package/dist/persistence/index.d.ts.map +1 -0
  221. package/dist/persistence/index.js +24 -0
  222. package/dist/persistence/index.js.map +1 -0
  223. package/dist/persistence/neo4j/driver.d.ts +26 -0
  224. package/dist/persistence/neo4j/driver.d.ts.map +1 -0
  225. package/dist/persistence/neo4j/driver.js +64 -0
  226. package/dist/persistence/neo4j/driver.js.map +1 -0
  227. package/dist/persistence/neo4j/entity-store.d.ts +15 -0
  228. package/dist/persistence/neo4j/entity-store.d.ts.map +1 -0
  229. package/dist/persistence/neo4j/entity-store.js +136 -0
  230. package/dist/persistence/neo4j/entity-store.js.map +1 -0
  231. package/dist/persistence/neo4j/execution-tracer.d.ts +19 -0
  232. package/dist/persistence/neo4j/execution-tracer.d.ts.map +1 -0
  233. package/dist/persistence/neo4j/execution-tracer.js +166 -0
  234. package/dist/persistence/neo4j/execution-tracer.js.map +1 -0
  235. package/dist/persistence/neo4j/memory-adapter.d.ts +35 -0
  236. package/dist/persistence/neo4j/memory-adapter.d.ts.map +1 -0
  237. package/dist/persistence/neo4j/memory-adapter.js +252 -0
  238. package/dist/persistence/neo4j/memory-adapter.js.map +1 -0
  239. package/dist/persistence/neo4j/petri-checkpoint-adapter.d.ts +22 -0
  240. package/dist/persistence/neo4j/petri-checkpoint-adapter.d.ts.map +1 -0
  241. package/dist/persistence/neo4j/petri-checkpoint-adapter.js +141 -0
  242. package/dist/persistence/neo4j/petri-checkpoint-adapter.js.map +1 -0
  243. package/dist/pipeline/agent-pipeline.d.ts +99 -0
  244. package/dist/pipeline/agent-pipeline.d.ts.map +1 -0
  245. package/dist/pipeline/agent-pipeline.js +356 -0
  246. package/dist/pipeline/agent-pipeline.js.map +1 -0
  247. package/dist/routing/checkpoint-adapter.d.ts +30 -0
  248. package/dist/routing/checkpoint-adapter.d.ts.map +1 -0
  249. package/dist/routing/checkpoint-adapter.js +83 -0
  250. package/dist/routing/checkpoint-adapter.js.map +1 -0
  251. package/dist/routing/documentation-generator.d.ts +47 -0
  252. package/dist/routing/documentation-generator.d.ts.map +1 -0
  253. package/dist/routing/documentation-generator.js +320 -0
  254. package/dist/routing/documentation-generator.js.map +1 -0
  255. package/dist/routing/index.d.ts +38 -0
  256. package/dist/routing/index.d.ts.map +1 -0
  257. package/dist/routing/index.js +375 -0
  258. package/dist/routing/index.js.map +1 -0
  259. package/dist/routing/intent-classifier.d.ts +206 -0
  260. package/dist/routing/intent-classifier.d.ts.map +1 -0
  261. package/dist/routing/intent-classifier.js +267 -0
  262. package/dist/routing/intent-classifier.js.map +1 -0
  263. package/dist/routing/matrix.d.ts +6 -0
  264. package/dist/routing/matrix.d.ts.map +1 -0
  265. package/dist/routing/matrix.js +131 -0
  266. package/dist/routing/matrix.js.map +1 -0
  267. package/dist/routing/orchestrator.d.ts +87 -0
  268. package/dist/routing/orchestrator.d.ts.map +1 -0
  269. package/dist/routing/orchestrator.js +425 -0
  270. package/dist/routing/orchestrator.js.map +1 -0
  271. package/dist/routing/postgres-checkpoint-adapter.d.ts +32 -0
  272. package/dist/routing/postgres-checkpoint-adapter.d.ts.map +1 -0
  273. package/dist/routing/postgres-checkpoint-adapter.js +167 -0
  274. package/dist/routing/postgres-checkpoint-adapter.js.map +1 -0
  275. package/dist/routing/redis-checkpoint-adapter.d.ts +34 -0
  276. package/dist/routing/redis-checkpoint-adapter.d.ts.map +1 -0
  277. package/dist/routing/redis-checkpoint-adapter.js +170 -0
  278. package/dist/routing/redis-checkpoint-adapter.js.map +1 -0
  279. package/dist/routing/types.d.ts +49 -0
  280. package/dist/routing/types.d.ts.map +1 -0
  281. package/dist/routing/types.js +3 -0
  282. package/dist/routing/types.js.map +1 -0
  283. package/dist/types/agent.d.ts +289 -0
  284. package/dist/types/agent.d.ts.map +1 -0
  285. package/dist/types/agent.js +78 -0
  286. package/dist/types/agent.js.map +1 -0
  287. package/dist/types/index.d.ts +343 -0
  288. package/dist/types/index.d.ts.map +1 -0
  289. package/dist/types/index.js +3 -0
  290. package/dist/types/index.js.map +1 -0
  291. package/dist/utils/generate-action-schema.d.ts +4 -0
  292. package/dist/utils/generate-action-schema.d.ts.map +1 -0
  293. package/dist/utils/generate-action-schema.js +46 -0
  294. package/dist/utils/generate-action-schema.js.map +1 -0
  295. package/dist/utils/header-builder.d.ts +12 -0
  296. package/dist/utils/header-builder.d.ts.map +1 -0
  297. package/dist/utils/header-builder.js +35 -0
  298. package/dist/utils/header-builder.js.map +1 -0
  299. package/dist/utils/logger.d.ts +27 -0
  300. package/dist/utils/logger.d.ts.map +1 -0
  301. package/dist/utils/logger.js +45 -0
  302. package/dist/utils/logger.js.map +1 -0
  303. package/docs/.gitbook/assets/image (1).png +0 -0
  304. package/docs/.gitbook/assets/image (2).png +0 -0
  305. package/docs/.gitbook/assets/image (3).png +0 -0
  306. package/docs/.gitbook/assets/image (4).png +0 -0
  307. package/docs/.gitbook/assets/image (5).png +0 -0
  308. package/docs/.gitbook/assets/image (6).png +0 -0
  309. package/docs/.gitbook/assets/image.png +0 -0
  310. package/docs/README.md +57 -0
  311. package/docs/SUMMARY.md +34 -0
  312. package/docs/cas-dusages.md +69 -0
  313. package/docs/cli/README.md +65 -0
  314. package/docs/concepts-cles.md +50 -0
  315. package/docs/core/architecture.md +87 -0
  316. package/docs/core/benchmark.md +59 -0
  317. package/docs/core/checkpoint.md +72 -0
  318. package/docs/core/documentation.md +55 -0
  319. package/docs/core/graphcontroller.md +63 -0
  320. package/docs/core/graphflow.md +137 -0
  321. package/docs/core/introduction.md +41 -0
  322. package/docs/core/les-evenements.md +95 -0
  323. package/docs/modules/agenda/README.md +63 -0
  324. package/docs/modules/agenda/interface-iagenda.md +170 -0
  325. package/docs/modules/agenda/les-adaptateurs/README.md +237 -0
  326. package/docs/modules/agenda/les-adaptateurs/nodecronadapter.md +91 -0
  327. package/docs/modules/introduction.md +55 -0
  328. package/docs/modules/les-adaptateurs.md +52 -0
  329. package/docs/modules/memoire/README.md +68 -0
  330. package/docs/modules/memoire/interface-imemory.md +183 -0
  331. package/docs/modules/memoire/les-adaptateurs/README.md +209 -0
  332. package/docs/modules/memoire/les-adaptateurs/inmemoryadapter.md +110 -0
  333. package/docs/modules/memoire/les-adaptateurs/meilisearchadapter.md +147 -0
  334. package/docs/modules/memoire/les-adaptateurs/redisadapter.md +212 -0
  335. package/docs/modules/nlp/README.md +44 -0
  336. package/docs/philosophie.md +51 -0
  337. package/docs/tutoriels/ajouter-des-conditions.md +150 -0
  338. package/docs/tutoriels/branching.md +194 -0
  339. package/docs/tutoriels/checkpoint-usage.md +99 -0
  340. package/docs/tutoriels/creer-agent-onchain.md +1041 -0
  341. package/docs/tutoriels/creer-un-agent.md +108 -0
  342. package/docs/tutoriels/creer-un-graphe-simple.md +92 -0
  343. package/docs/tutoriels/gerer-les-erreurs.md +124 -0
  344. package/docs/tutoriels/pour-commencer.md +73 -0
  345. package/docs/tutoriels/retry.md +166 -0
  346. package/execution/adapters/in-memory-checkpoint.ts +35 -0
  347. package/execution/compiler.ts +47 -0
  348. package/execution/controller.ts +84 -0
  349. package/execution/event-manager.ts +331 -0
  350. package/execution/index.ts +800 -0
  351. package/execution/logger.ts +70 -0
  352. package/execution/node.ts +315 -0
  353. package/execution/observer.ts +192 -0
  354. package/execution/planner.ts +40 -0
  355. package/execution/reducer.ts +73 -0
  356. package/execution/registry.ts +86 -0
  357. package/execution/send-api.ts +58 -0
  358. package/execution/types.parallel.ts +81 -0
  359. package/execution/visualizer.ts +158 -0
  360. package/index.ts +55 -465
  361. package/interfaces/index.ts +597 -0
  362. package/modules/agenda/adapters/node-cron/index.ts +25 -0
  363. package/modules/agenda/index.ts +146 -0
  364. package/modules/cli/index.ts +580 -0
  365. package/modules/embedding/adapters/ai/index.ts +42 -0
  366. package/modules/embedding/index.ts +45 -0
  367. package/modules/nlp/engine.ts +324 -0
  368. package/modules/nlp/index.ts +45 -0
  369. package/package.json +81 -9
  370. package/persistence/index.ts +27 -0
  371. package/persistence/neo4j/driver.ts +34 -0
  372. package/persistence/neo4j/entity-store.ts +141 -0
  373. package/persistence/neo4j/execution-tracer.ts +194 -0
  374. package/persistence/neo4j/memory-adapter.ts +281 -0
  375. package/persistence/neo4j/petri-checkpoint-adapter.ts +153 -0
  376. package/pipeline/agent-pipeline.ts +426 -0
  377. package/routing/checkpoint-adapter.ts +79 -0
  378. package/routing/documentation-generator.ts +358 -0
  379. package/routing/index.ts +459 -0
  380. package/routing/intent-classifier.ts +360 -0
  381. package/routing/matrix.ts +138 -0
  382. package/routing/orchestrator.ts +498 -0
  383. package/routing/patterns/data-extraction.json +79 -0
  384. package/routing/patterns/human-approval.json +64 -0
  385. package/routing/patterns/rag-search.json +68 -0
  386. package/routing/postgres-checkpoint-adapter.ts +172 -0
  387. package/routing/redis-checkpoint-adapter.ts +187 -0
  388. package/routing/types.ts +59 -0
  389. package/routing/web-server.ts +260 -0
  390. package/scripts/generate-petri-docs.ts +70 -0
  391. package/scripts/get-gmail-token.js +65 -0
  392. package/scripts/get-gmail-token.ts +65 -0
  393. package/test/agent/agent.test.ts +92 -0
  394. package/test/agent/clone.test.ts +143 -0
  395. package/test/agent/cognitive-handler.test.ts +78 -0
  396. package/test/agent/entity-store.test.ts +80 -0
  397. package/test/agent/generic-executor.test.ts +230 -0
  398. package/test/agent/handoff.test.ts +163 -0
  399. package/test/agent/llm-factory.test.ts +40 -0
  400. package/test/agent/orchestrator.test.ts +156 -0
  401. package/test/agent/registry.test.ts +97 -0
  402. package/test/agent/tools.test.ts +267 -0
  403. package/test/execution/checkpoint.test.ts +811 -0
  404. package/test/execution/controller.test.ts +236 -0
  405. package/test/execution/event-manager.test.ts +118 -0
  406. package/test/execution/index.test.ts +690 -0
  407. package/test/execution/node.test.ts +464 -0
  408. package/test/execution/observer.test.ts +393 -0
  409. package/test/execution/parallel.test.ts +135 -0
  410. package/test/execution/plan-llm-integration.test.ts +290 -0
  411. package/test/execution/plan-real-onchain.test.ts +226 -0
  412. package/test/execution/send-api.test.ts +121 -0
  413. package/test/modules/agenda/node-cron.test.ts +307 -0
  414. package/test/modules/cli/index.test.ts +125 -0
  415. package/test/persistence/neo4j-execution-tracer.test.ts +96 -0
  416. package/test/persistence/neo4j-memory-adapter.test.ts +107 -0
  417. package/test/persistence/neo4j-petri-checkpoint.test.ts +89 -0
  418. package/test/pipeline/agent-pipeline.test.ts +118 -0
  419. package/test/routing/checkpoint-persistence.test.ts +58 -0
  420. package/test/routing/documentation-generator.test.ts +76 -0
  421. package/test/routing/integration.test.ts +261 -0
  422. package/test/routing/intent-classifier.test.ts +102 -0
  423. package/test/routing/petri.test.ts +156 -0
  424. package/test/routing/real-llm.test.ts +260 -0
  425. package/test-petri-features.ts +218 -0
  426. package/test-pipeline-api.ts +163 -0
  427. package/tsconfig.json +30 -108
  428. package/types/agent.ts +296 -0
  429. package/types/index.ts +387 -0
  430. package/utils/generate-action-schema.ts +47 -0
  431. package/utils/header-builder.ts +40 -0
  432. package/utils/logger.ts +40 -0
  433. package/package copy.json +0 -21
  434. package/types.ts +0 -62
  435. package/utils/executor.ts +0 -42
@@ -0,0 +1,464 @@
1
+ import { expect, use } from "chai";
2
+ import chaiAsPromised from "chai-as-promised";
3
+ import { EventEmitter } from "events";
4
+ import { BehaviorSubject, Subject } from "rxjs";
5
+ import { z } from "zod";
6
+ import { GraphEventManager } from "../../execution/event-manager";
7
+ import { GraphLogger } from "../../execution/logger";
8
+ import { GraphNode } from "../../execution/node";
9
+ import { IEventEmitter } from "../../interfaces";
10
+ import { GraphContext } from "../../types";
11
+
12
+ use(chaiAsPromised);
13
+
14
+ describe("GraphNode", () => {
15
+ const TestSchema = z.object({
16
+ counter: z.number(),
17
+ message: z.string(),
18
+ });
19
+
20
+ type TestContext = GraphContext<typeof TestSchema>;
21
+
22
+ let node: GraphNode<typeof TestSchema>;
23
+ let eventManager: GraphEventManager<typeof TestSchema>;
24
+ let logger: GraphLogger;
25
+ let eventEmitter: EventEmitter;
26
+ let eventSubject: Subject<any>;
27
+ let stateSubject: BehaviorSubject<any>;
28
+ let events: any[] = [];
29
+
30
+ beforeEach(() => {
31
+ events = [];
32
+ eventEmitter = new EventEmitter();
33
+ eventSubject = new Subject();
34
+ stateSubject = new BehaviorSubject({ counter: 0, message: "Hello" });
35
+ logger = new GraphLogger("test", false);
36
+ eventManager = new GraphEventManager(eventEmitter, new Map(), "test", {
37
+ counter: 0,
38
+ message: "Hello",
39
+ });
40
+
41
+ // Capture des événements
42
+ eventSubject.subscribe((event) => events.push(event));
43
+
44
+ node = new GraphNode(
45
+ new Map(),
46
+ logger,
47
+ eventManager,
48
+ eventSubject,
49
+ stateSubject
50
+ );
51
+ });
52
+
53
+ it("should execute a simple node", async () => {
54
+ const nodes = new Map();
55
+ nodes.set("test", {
56
+ name: "test",
57
+ execute: async (context: TestContext) => {
58
+ context.counter++;
59
+ },
60
+ });
61
+
62
+ node = new GraphNode(
63
+ nodes,
64
+ logger,
65
+ eventManager,
66
+ eventSubject,
67
+ stateSubject
68
+ );
69
+
70
+ await node.executeNode("test", { counter: 0, message: "Hello" }, undefined);
71
+
72
+ // Vérifier les événements émis
73
+ expect(events).to.have.lengthOf(3); // nodeStarted, nodeStateChanged, nodeCompleted
74
+ expect(events[0].type).to.equal("nodeStarted");
75
+ expect(events[1].type).to.equal("nodeStateChanged");
76
+ expect(events[2].type).to.equal("nodeCompleted");
77
+ });
78
+
79
+ it("should handle node condition", async () => {
80
+ const nodes = new Map();
81
+ nodes.set("test", {
82
+ name: "test",
83
+ condition: (context: TestContext) => context.counter < 5,
84
+ execute: async (context: TestContext) => {
85
+ context.counter++;
86
+ },
87
+ });
88
+
89
+ node = new GraphNode(
90
+ nodes,
91
+ logger,
92
+ eventManager,
93
+ eventSubject,
94
+ stateSubject
95
+ );
96
+
97
+ // Test avec condition vraie
98
+ await node.executeNode("test", { counter: 0, message: "Hello" }, undefined);
99
+ expect(events.some((e) => e.type === "nodeStateChanged")).to.be.true;
100
+
101
+ // Test avec condition fausse
102
+ events = [];
103
+ await node.executeNode("test", { counter: 5, message: "Hello" }, undefined);
104
+ expect(events.some((e) => e.type === "nodeStateChanged")).to.be.false;
105
+ });
106
+
107
+ it("should handle errors", async () => {
108
+ const nodes = new Map();
109
+ nodes.set("test", {
110
+ name: "test",
111
+ execute: async () => {
112
+ throw new Error("Test error");
113
+ },
114
+ });
115
+
116
+ node = new GraphNode(
117
+ nodes,
118
+ logger,
119
+ eventManager,
120
+ eventSubject,
121
+ stateSubject
122
+ );
123
+
124
+ try {
125
+ await node.executeNode("test", { counter: 0, message: "Hello" }, false);
126
+ expect.fail("Test error");
127
+ } catch (error: any) {
128
+ expect(error.message).to.equal("Test error");
129
+ const errorEvents = events.filter((e) => e.type === "nodeError");
130
+ expect(errorEvents).to.have.lengthOf(1);
131
+ }
132
+ });
133
+
134
+ it("should emit events exactly once per state change", async () => {
135
+ const nodes = new Map();
136
+ nodes.set("test", {
137
+ name: "test",
138
+ execute: async (context: TestContext) => {
139
+ context.counter++;
140
+ context.message = "Updated";
141
+ },
142
+ });
143
+
144
+ node = new GraphNode(
145
+ nodes,
146
+ logger,
147
+ eventManager,
148
+ eventSubject,
149
+ stateSubject
150
+ );
151
+ await node.executeNode("test", { counter: 0, message: "Hello" }, undefined);
152
+
153
+ // Compter les occurrences de chaque type d'événement
154
+ const eventCounts = events.reduce((acc, event) => {
155
+ acc[event.type] = (acc[event.type] || 0) + 1;
156
+ return acc;
157
+ }, {} as Record<string, number>);
158
+
159
+ expect(eventCounts).to.deep.equal({
160
+ nodeStarted: 1,
161
+ nodeStateChanged: 2, // Un pour counter, un pour message
162
+ nodeCompleted: 1,
163
+ });
164
+
165
+ // Vérifier l'ordre des événements
166
+ expect(events.map((e) => e.type)).to.deep.equal([
167
+ "nodeStarted",
168
+ "nodeStateChanged", // counter
169
+ "nodeStateChanged", // message
170
+ "nodeCompleted",
171
+ ]);
172
+ });
173
+
174
+ it("should emit nodeStateChanged only for actual changes", async () => {
175
+ const nodes = new Map();
176
+ nodes.set("test", {
177
+ name: "test",
178
+ execute: async (context: TestContext, inputs?: any) => {
179
+ context.counter = context.counter; // Même valeur
180
+ context.message = "New"; // Nouvelle valeur
181
+ },
182
+ });
183
+
184
+ node = new GraphNode(
185
+ nodes,
186
+ logger,
187
+ eventManager,
188
+ eventSubject,
189
+ stateSubject
190
+ );
191
+ await node.executeNode("test", { counter: 0, message: "Hello" }, undefined);
192
+
193
+ const stateChanges = events.filter((e) => e.type === "nodeStateChanged");
194
+ expect(stateChanges).to.have.lengthOf(1); // Seulement pour message
195
+ expect(stateChanges[0].payload.property).to.equal("message");
196
+ });
197
+
198
+ it("should execute node with parameters", async () => {
199
+ const nodes = new Map();
200
+ nodes.set("test", {
201
+ name: "test",
202
+ execute: async (context: TestContext) => {
203
+ context.counter = 42;
204
+ context.message = "Custom";
205
+ },
206
+ });
207
+
208
+ node = new GraphNode(
209
+ nodes,
210
+ logger,
211
+ eventManager,
212
+ eventSubject,
213
+ stateSubject
214
+ );
215
+
216
+ await node.executeNode("test", { counter: 0, message: "Hello" }, false);
217
+
218
+ const stateChanges = events.filter((e) => e.type === "nodeStateChanged");
219
+ expect(stateChanges).to.have.lengthOf(2);
220
+ expect(stateChanges[0].payload.newValue).to.equal(42);
221
+ expect(stateChanges[1].payload.newValue).to.equal("Custom");
222
+ });
223
+
224
+ it("should properly handle node inputs", async () => {
225
+ const nodes = new Map();
226
+ nodes.set("test", {
227
+ name: "test",
228
+ execute: async (context: TestContext) => {
229
+ context.counter = 42;
230
+ context.message = "Test Input";
231
+ },
232
+ });
233
+
234
+ node = new GraphNode(
235
+ nodes,
236
+ logger,
237
+ eventManager,
238
+ eventSubject,
239
+ stateSubject
240
+ );
241
+
242
+ await node.executeNode("test", { counter: 0, message: "Hello" }, false);
243
+
244
+ const stateChanges = events.filter((e) => e.type === "nodeStateChanged");
245
+ expect(stateChanges).to.have.lengthOf(2);
246
+ expect(stateChanges[0].payload.newValue).to.equal(42);
247
+ expect(stateChanges[1].payload.newValue).to.equal("Test Input");
248
+ });
249
+
250
+ it("should not emit duplicate state changes", async () => {
251
+ const nodes = new Map();
252
+ nodes.set("test", {
253
+ name: "test",
254
+ execute: async (context: TestContext) => {
255
+ context.counter = 1; // Valeur fixe au lieu d'incrémentations
256
+ context.counter = 1; // Même valeur
257
+ context.message = "New";
258
+ context.message = "New"; // Même valeur
259
+ },
260
+ });
261
+
262
+ node = new GraphNode(
263
+ nodes,
264
+ logger,
265
+ eventManager,
266
+ eventSubject,
267
+ stateSubject
268
+ );
269
+
270
+ await node.executeNode("test", { counter: 0, message: "Hello" }, undefined);
271
+
272
+ // Vérifier qu'il n'y a pas de doublons dans les événements
273
+ const stateChanges = events.filter((e) => e.type === "nodeStateChanged");
274
+ const uniqueChanges = new Set(
275
+ stateChanges.map(
276
+ (e) =>
277
+ `${e.payload.property}-${e.payload.oldValue}-${e.payload.newValue}`
278
+ )
279
+ );
280
+
281
+ expect(stateChanges.length).to.equal(uniqueChanges.size);
282
+ expect(stateChanges).to.have.lengthOf(2); // Un pour counter, un pour message
283
+ });
284
+
285
+ it("should handle node execution without params", async () => {
286
+ const nodes = new Map();
287
+ nodes.set("test", {
288
+ name: "test",
289
+ execute: async (
290
+ context: TestContext,
291
+ tools?: { eventEmitter: IEventEmitter }
292
+ ) => {
293
+ context.counter++;
294
+ },
295
+ });
296
+
297
+ node = new GraphNode(
298
+ nodes,
299
+ logger,
300
+ eventManager,
301
+ eventSubject,
302
+ stateSubject
303
+ );
304
+
305
+ await node.executeNode("test", { counter: 0, message: "Hello" }, undefined);
306
+ await node.executeNode("test", { counter: 1, message: "Hello" }, undefined);
307
+
308
+ const stateChanges = events.filter((e) => e.type === "nodeStateChanged");
309
+ expect(stateChanges).to.have.lengthOf(2);
310
+ expect(stateChanges[1].payload.newValue).to.equal(2);
311
+ });
312
+
313
+ it("should wait for events before executing node", async () => {
314
+ const nodes = new Map();
315
+ nodes.set("waitForEventsNode", {
316
+ name: "waitForEventsNode",
317
+ when: {
318
+ events: ["event1", "event2"],
319
+ timeout: 1000,
320
+ strategy: { type: "all" },
321
+ },
322
+ execute: async (context: TestContext) => {
323
+ context.message = "Events received";
324
+ },
325
+ });
326
+
327
+ node = new GraphNode(
328
+ nodes,
329
+ logger,
330
+ eventManager,
331
+ eventSubject,
332
+ stateSubject
333
+ );
334
+
335
+ // Lancer l'exécution du nœud
336
+ const execution = node.executeNode(
337
+ "waitForEventsNode",
338
+ { counter: 0, message: "Hello" },
339
+ undefined
340
+ );
341
+
342
+ // Simuler les événements après un court délai
343
+ setTimeout(() => {
344
+ eventEmitter.emit("event1", { data: "test1" });
345
+ eventEmitter.emit("event2", { data: "test2" });
346
+ }, 100);
347
+
348
+ await execution;
349
+
350
+ const stateChanges = events.filter((e) => e.type === "nodeStateChanged");
351
+ expect(stateChanges).to.have.lengthOf(1);
352
+ expect(stateChanges[0].payload.newValue).to.equal("Events received");
353
+ });
354
+
355
+ it("should timeout if events are not received", async () => {
356
+ const nodes = new Map();
357
+ nodes.set("timeoutNode", {
358
+ name: "timeoutNode",
359
+ when: {
360
+ events: ["event1", "event2"],
361
+ timeout: 100,
362
+ strategy: { type: "all" },
363
+ },
364
+ execute: async (context: TestContext) => {
365
+ context.message = "Should not execute";
366
+ },
367
+ });
368
+
369
+ node = new GraphNode(
370
+ nodes,
371
+ logger,
372
+ eventManager,
373
+ eventSubject,
374
+ stateSubject
375
+ );
376
+ await expect(
377
+ node.executeNode(
378
+ "timeoutNode",
379
+ { counter: 0, message: "Hello" },
380
+ undefined
381
+ )
382
+ ).to.be.rejectedWith("Timeout waiting for events");
383
+ });
384
+
385
+ it("should handle partial event reception", async () => {
386
+ const nodes = new Map();
387
+ nodes.set("partialEventsNode", {
388
+ name: "partialEventsNode",
389
+ when: {
390
+ events: ["event1", "event2"],
391
+ timeout: 1000,
392
+ strategy: { type: "all" },
393
+ },
394
+ execute: async (context: TestContext) => {
395
+ context.message = "All events received";
396
+ },
397
+ });
398
+
399
+ node = new GraphNode(
400
+ nodes,
401
+ logger,
402
+ eventManager,
403
+ eventSubject,
404
+ stateSubject
405
+ );
406
+ const execution = node.executeNode("partialEventsNode", {
407
+ counter: 0,
408
+ message: "Hello",
409
+ });
410
+
411
+ setTimeout(() => {
412
+ eventEmitter.emit("event1", { data: "test1" });
413
+ }, 100);
414
+
415
+ await expect(execution).to.be.rejectedWith("Timeout waiting for events");
416
+ });
417
+
418
+ it("should handle correlated events", (done) => {
419
+ const nodes = new Map();
420
+ nodes.set("correlatedEventsNode", {
421
+ name: "correlatedEventsNode",
422
+ when: {
423
+ events: ["payment", "stock"],
424
+ timeout: 1000,
425
+ strategy: {
426
+ type: "correlate",
427
+ correlation: (events: Array<{ type: string; payload?: any }>) => {
428
+ const paymentEvent = events.find(
429
+ (e: { type: string }) => e.type === "payment"
430
+ );
431
+ const stockEvent = events.find(
432
+ (e: { type: string }) => e.type === "stock"
433
+ );
434
+ return paymentEvent?.payload?.id === stockEvent?.payload?.id;
435
+ },
436
+ },
437
+ },
438
+ execute: (context: TestContext) => {
439
+ context.message = "Correlated events received";
440
+ done();
441
+ return Promise.resolve();
442
+ },
443
+ });
444
+
445
+ node = new GraphNode(
446
+ nodes,
447
+ logger,
448
+ eventManager,
449
+ eventSubject,
450
+ stateSubject
451
+ );
452
+
453
+ node.executeNode(
454
+ "correlatedEventsNode",
455
+ { counter: 0, message: "Hello" },
456
+ undefined
457
+ );
458
+
459
+ setTimeout(() => {
460
+ eventEmitter.emit("payment", { id: "123", status: "completed" });
461
+ eventEmitter.emit("stock", { id: "123", status: "available" });
462
+ }, 100);
463
+ });
464
+ });