@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,236 @@
1
+ import { expect } from "chai";
2
+ import { z } from "zod";
3
+ import { GraphController } from "../../execution/controller";
4
+ import { GraphFlow } from "../../execution/index";
5
+ import { GraphContext, GraphNodeConfig } from "../../types";
6
+
7
+ describe("GraphController", () => {
8
+ const TestSchema = z.object({
9
+ counter: z.number(),
10
+ message: z.string(),
11
+ value: z.number().optional(),
12
+ prefix: z.string().optional(),
13
+ });
14
+
15
+ const createTestGraph = (name: string): GraphFlow<typeof TestSchema> => {
16
+ const nodes: GraphNodeConfig<typeof TestSchema>[] = [
17
+ {
18
+ name: "start",
19
+ execute: async (context) => {
20
+ if (context.value !== undefined) {
21
+ context.counter = context.value;
22
+ }
23
+ if (context.prefix) {
24
+ context.message = `${context.prefix}-${name}`;
25
+ } else {
26
+ context.message = name;
27
+ }
28
+ },
29
+ },
30
+ {
31
+ name: "increment",
32
+ execute: async (context) => {
33
+ context.counter += 1;
34
+ },
35
+ },
36
+ ];
37
+
38
+ return new GraphFlow({
39
+ name,
40
+ nodes,
41
+ schema: TestSchema,
42
+ context: { counter: 0, message: "" },
43
+ });
44
+ };
45
+
46
+ describe("Sequential Execution", () => {
47
+ it("should execute graphs sequentially with different contexts", async () => {
48
+ const graph1 = createTestGraph("graph1");
49
+ const graph2 = createTestGraph("graph2");
50
+ const graph3 = createTestGraph("graph3");
51
+
52
+ const contexts = [
53
+ { value: 10, prefix: "test1" },
54
+ { value: 20, prefix: "test2" },
55
+ { value: 30, prefix: "test3" },
56
+ ];
57
+
58
+ const results = await GraphController.executeSequential(
59
+ [graph1, graph2, graph3],
60
+ ["start", "start", "start"],
61
+ contexts
62
+ );
63
+
64
+ expect(results).to.have.length(3);
65
+ expect(results[0].context.counter).to.equal(10);
66
+ expect(results[1].context.counter).to.equal(20);
67
+ expect(results[2].context.counter).to.equal(30);
68
+ expect(results[0].context.message).to.equal("test1-graph1");
69
+ expect(results[1].context.message).to.equal("test2-graph2");
70
+ expect(results[2].context.message).to.equal("test3-graph3");
71
+ expect(results[0].graphName).to.equal("graph1");
72
+ expect(results[0].nodeName).to.equal("start");
73
+ });
74
+
75
+ it("should handle missing contexts gracefully", async () => {
76
+ const graph1 = createTestGraph("graph1");
77
+ const graph2 = createTestGraph("graph2");
78
+
79
+ const results = await GraphController.executeSequential(
80
+ [graph1, graph2],
81
+ ["start", "start"]
82
+ );
83
+
84
+ expect(results).to.have.length(2);
85
+ expect(results[0].context.counter).to.equal(0);
86
+ expect(results[1].context.counter).to.equal(0);
87
+ expect(results[0].context.message).to.equal("graph1");
88
+ expect(results[1].context.message).to.equal("graph2");
89
+ });
90
+ });
91
+
92
+ describe("Parallel Execution", () => {
93
+ it("should execute graphs in parallel with concurrency limit", async () => {
94
+ const graphs = Array.from({ length: 5 }, (_, i) =>
95
+ createTestGraph(`graph${i + 1}`)
96
+ );
97
+
98
+ const contexts = Array.from({ length: 5 }, (_, i) => ({
99
+ value: (i + 1) * 10,
100
+ prefix: `test${i + 1}`,
101
+ }));
102
+
103
+ // Ajouter un délai dans l'exécution
104
+ const originalExecute = graphs[0].execute;
105
+ graphs[0].execute = async (...args) => {
106
+ await new Promise((resolve) => setTimeout(resolve, 100));
107
+ return originalExecute.apply(graphs[0], args);
108
+ };
109
+
110
+ const startTime = Date.now();
111
+ const results = await GraphController.executeParallel(
112
+ graphs,
113
+ Array(5).fill("start"),
114
+ 2,
115
+ contexts
116
+ );
117
+ const executionTime = Date.now() - startTime;
118
+
119
+ expect(executionTime).to.be.greaterThan(0);
120
+ expect(results).to.have.length(5);
121
+ results.forEach((result, i) => {
122
+ expect(result.context.counter).to.equal((i + 1) * 10);
123
+ expect(result.context.message).to.equal(`test${i + 1}-graph${i + 1}`);
124
+ });
125
+ });
126
+
127
+ it("should handle errors in parallel execution", async () => {
128
+ const errorGraph = new GraphFlow({
129
+ name: "errorGraph",
130
+ nodes: [
131
+ {
132
+ name: "start",
133
+ execute: async () => {
134
+ throw new Error("Test error");
135
+ },
136
+ },
137
+ ],
138
+ schema: TestSchema,
139
+ context: { counter: 0, message: "" },
140
+ });
141
+
142
+ const successGraph = createTestGraph("successGraph");
143
+
144
+ try {
145
+ await GraphController.executeParallel(
146
+ [errorGraph, successGraph],
147
+ ["start", "start"],
148
+ 2
149
+ );
150
+ expect.fail("Should have thrown an error");
151
+ } catch (error: any) {
152
+ expect(error.message).to.equal("Test error");
153
+ }
154
+ });
155
+ });
156
+
157
+ describe("Complex Workflows", () => {
158
+ it("should handle mixed sequential and parallel execution", async () => {
159
+ const graphs = Array.from({ length: 4 }, (_, i) =>
160
+ createTestGraph(`graph${i + 1}`)
161
+ );
162
+
163
+ // Exécuter les deux premiers graphes en parallèle
164
+ const parallelResults = await GraphController.executeParallel(
165
+ graphs.slice(0, 2),
166
+ ["start", "start"],
167
+ 2,
168
+ [
169
+ { value: 10, prefix: "parallel1" },
170
+ { value: 20, prefix: "parallel2" },
171
+ ]
172
+ );
173
+
174
+ // Puis exécuter les deux suivants séquentiellement
175
+ const sequentialResults = await GraphController.executeSequential(
176
+ graphs.slice(2),
177
+ ["start", "start"],
178
+ [
179
+ { value: 30, prefix: "seq1" },
180
+ { value: 40, prefix: "seq2" },
181
+ ]
182
+ );
183
+
184
+ const allResults = [...parallelResults, ...sequentialResults];
185
+ expect(allResults).to.have.length(4);
186
+ expect(allResults.map((r) => r.context.counter)).to.deep.equal([
187
+ 10, 20, 30, 40,
188
+ ]);
189
+ expect(allResults.map((r) => r.context.message)).to.deep.equal([
190
+ "parallel1-graph1",
191
+ "parallel2-graph2",
192
+ "seq1-graph3",
193
+ "seq2-graph4",
194
+ ]);
195
+ });
196
+ });
197
+
198
+ it("should wait for correlated events", async function () {
199
+ const graph = new GraphFlow({
200
+ name: "test",
201
+ schema: TestSchema,
202
+ nodes: [
203
+ {
204
+ name: "correlatedEventsNode",
205
+ when: {
206
+ events: ["eventA", "eventB"],
207
+ timeout: 1000,
208
+ strategy: {
209
+ type: "correlate",
210
+ correlation: (events) => {
211
+ const eventA = events.find((e) => e.type === "eventA");
212
+ const eventB = events.find((e) => e.type === "eventB");
213
+ return eventA?.payload?.id === eventB?.payload?.id;
214
+ },
215
+ },
216
+ },
217
+ execute: async (context: GraphContext<typeof TestSchema>) => {
218
+ context.message = "Correlated events received";
219
+ },
220
+ },
221
+ ],
222
+ context: { value: 0, counter: 0, message: "" },
223
+ });
224
+
225
+ const execution = graph.execute("correlatedEventsNode");
226
+
227
+ // Émettre les événements corrélés
228
+ setTimeout(() => {
229
+ graph.emit("eventA", { id: "123", status: "completed" });
230
+ graph.emit("eventB", { id: "123", status: "available" });
231
+ }, 100);
232
+
233
+ await execution;
234
+ expect(graph.getContext().message).to.equal("Correlated events received");
235
+ });
236
+ });
@@ -0,0 +1,118 @@
1
+ import { expect } from "chai";
2
+ import { EventEmitter } from "events";
3
+ import { z } from "zod";
4
+ import { GraphEventManager } from "../../execution/event-manager";
5
+
6
+ describe("GraphEventManager", () => {
7
+ const TestSchema = z.object({
8
+ counter: z.number(),
9
+ message: z.string(),
10
+ });
11
+
12
+ let eventManager: GraphEventManager<typeof TestSchema>;
13
+ let eventEmitter: EventEmitter;
14
+ let events: any[] = [];
15
+
16
+ beforeEach(() => {
17
+ events = [];
18
+ eventEmitter = new EventEmitter();
19
+ eventManager = new GraphEventManager(eventEmitter, new Map(), "test", {
20
+ counter: 0,
21
+ message: "Hello",
22
+ });
23
+ });
24
+
25
+ it("should emit events without duplication", () => {
26
+ const emittedEvents: any[] = [];
27
+ eventEmitter.on("test", (event) => emittedEvents.push(event));
28
+
29
+ eventManager.emitEvent("test", { data: "test" });
30
+
31
+ expect(emittedEvents).to.have.lengthOf(1);
32
+ expect(emittedEvents[0]).to.deep.equal({ data: "test" });
33
+ });
34
+
35
+ it("should handle nodeStateChanged events correctly", () => {
36
+ const stateChanges: any[] = [];
37
+ eventEmitter.on("nodeStateChanged", (event) => stateChanges.push(event));
38
+
39
+ eventManager.emitEvent("nodeStateChanged", {
40
+ nodeName: "test",
41
+ property: "counter",
42
+ oldValue: 0,
43
+ newValue: 1,
44
+ context: { counter: 1, message: "Hello" },
45
+ });
46
+
47
+ expect(stateChanges).to.have.lengthOf(1);
48
+ expect(stateChanges[0].nodeName).to.equal("test");
49
+ expect(stateChanges[0].context.counter).to.equal(1);
50
+ });
51
+
52
+ it("should setup and cleanup event listeners", () => {
53
+ const nodes = new Map();
54
+ nodes.set("test", {
55
+ name: "test",
56
+ events: ["customEvent"],
57
+ execute: async () => {},
58
+ });
59
+
60
+ eventManager = new GraphEventManager(eventEmitter, nodes, "test", {
61
+ counter: 0,
62
+ message: "Hello",
63
+ });
64
+
65
+ eventManager.setupEventListeners();
66
+ expect(eventEmitter.listenerCount("customEvent")).to.equal(1);
67
+
68
+ // Réinitialiser les listeners
69
+ eventManager.setupEventListeners();
70
+ expect(eventEmitter.listenerCount("customEvent")).to.equal(1);
71
+ });
72
+
73
+ it("should handle timeout for correlated events", async () => {
74
+ const timeout = 100;
75
+
76
+ try {
77
+ // N'émettre qu'un seul événement pour provoquer le timeout
78
+ eventManager.emitEvent("event1", { data: "test1" });
79
+
80
+ await eventManager.waitForCorrelatedEvents(
81
+ ["event1", "event2"],
82
+ timeout,
83
+ () => false // La fonction de corrélation retourne toujours false pour forcer le timeout
84
+ );
85
+ throw new Error("Should have timed out");
86
+ } catch (error: any) {
87
+ expect(error.message).to.include("Timeout waiting for correlated events");
88
+ }
89
+ });
90
+
91
+ it("should wait for multiple events before continuing", async () => {
92
+ let receivedEvents = 0;
93
+ let resolvePromise: (value: unknown) => void;
94
+ const eventPromise = new Promise((resolve) => {
95
+ resolvePromise = resolve;
96
+ });
97
+
98
+ // Configurer les écouteurs d'événements AVANT d'émettre
99
+ eventEmitter.on("event1", () => {
100
+ receivedEvents++;
101
+ if (receivedEvents === 2) resolvePromise(true);
102
+ });
103
+ eventEmitter.on("event2", () => {
104
+ receivedEvents++;
105
+ if (receivedEvents === 2) resolvePromise(true);
106
+ });
107
+
108
+ // Émettre les événements AVANT de démarrer l'attente
109
+ eventManager.emitEvent("event1", { data: "test1" });
110
+ eventManager.emitEvent("event2", { data: "test2" });
111
+
112
+ // Démarrer l'attente
113
+ const waitPromise = eventManager.waitForEvents(["event1", "event2"], 1000);
114
+
115
+ await Promise.race([waitPromise, eventPromise]);
116
+ expect(receivedEvents).to.equal(2);
117
+ });
118
+ });