@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,30 @@
1
+ import { PetriNet } from '../routing/index';
2
+ import { Session } from '../routing/orchestrator';
3
+ export interface IPetriCheckpointAdapter {
4
+ save(net: PetriNet, session?: Session): Promise<string>;
5
+ load(checkpointId: string): Promise<{
6
+ net: PetriNet;
7
+ session?: Session;
8
+ } | null>;
9
+ list(): Promise<Array<{
10
+ id: string;
11
+ timestamp: number;
12
+ sessionId?: string;
13
+ }>>;
14
+ delete(checkpointId: string): Promise<void>;
15
+ }
16
+ export declare class InMemoryPetriCheckpointAdapter implements IPetriCheckpointAdapter {
17
+ private checkpoints;
18
+ save(net: PetriNet, session?: Session): Promise<string>;
19
+ load(checkpointId: string): Promise<{
20
+ net: PetriNet;
21
+ session?: Session;
22
+ } | null>;
23
+ list(): Promise<Array<{
24
+ id: string;
25
+ timestamp: number;
26
+ sessionId?: string;
27
+ }>>;
28
+ delete(checkpointId: string): Promise<void>;
29
+ }
30
+ //# sourceMappingURL=checkpoint-adapter.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"checkpoint-adapter.d.ts","sourceRoot":"","sources":["../../routing/checkpoint-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAElD,MAAM,WAAW,uBAAuB;IACtC,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACxD,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,GAAG,EAAE,QAAQ,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IACjF,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IAC9E,MAAM,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7C;AAED,qBAAa,8BAA+B,YAAW,uBAAuB;IAC5E,OAAO,CAAC,WAAW,CAA+B;IAE5C,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IA0BvD,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,GAAG,EAAE,QAAQ,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IA4BhF,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAQ7E,MAAM,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGlD"}
@@ -0,0 +1,83 @@
1
+ "use strict";
2
+ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
3
+ function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
4
+ return new (P || (P = Promise))(function (resolve, reject) {
5
+ function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
6
+ function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
7
+ function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
8
+ step((generator = generator.apply(thisArg, _arguments || [])).next());
9
+ });
10
+ };
11
+ Object.defineProperty(exports, "__esModule", { value: true });
12
+ exports.InMemoryPetriCheckpointAdapter = void 0;
13
+ const index_1 = require("../routing/index");
14
+ class InMemoryPetriCheckpointAdapter {
15
+ constructor() {
16
+ this.checkpoints = new Map();
17
+ }
18
+ save(net, session) {
19
+ return __awaiter(this, void 0, void 0, function* () {
20
+ const checkpointId = `petri-cp-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
21
+ // Serialize marking
22
+ const marking = net.state.marking;
23
+ const serializedMarking = [];
24
+ for (const [pid, tokens] of marking) {
25
+ serializedMarking.push({
26
+ placeId: pid,
27
+ tokens: tokens.map(t => ({ id: t.id, data: t.data, createdAt: t.createdAt }))
28
+ });
29
+ }
30
+ const checkpoint = {
31
+ id: checkpointId,
32
+ timestamp: Date.now(),
33
+ sessionId: session === null || session === void 0 ? void 0 : session.id,
34
+ marking: serializedMarking,
35
+ history: net.state.history || [],
36
+ sessionContext: session === null || session === void 0 ? void 0 : session.context,
37
+ };
38
+ this.checkpoints.set(checkpointId, checkpoint);
39
+ return checkpointId;
40
+ });
41
+ }
42
+ load(checkpointId) {
43
+ return __awaiter(this, void 0, void 0, function* () {
44
+ const cp = this.checkpoints.get(checkpointId);
45
+ if (!cp)
46
+ return null;
47
+ const net = new index_1.PetriNet(cp.id);
48
+ const marking = net.state.marking;
49
+ for (const item of cp.marking) {
50
+ marking.set(item.placeId, item.tokens.map((t) => (Object.assign({}, t))));
51
+ }
52
+ net.state.history = [...cp.history];
53
+ let session;
54
+ if (cp.sessionId) {
55
+ session = {
56
+ id: cp.sessionId,
57
+ petriNet: net,
58
+ context: cp.sessionContext || {},
59
+ history: [...cp.history],
60
+ createdAt: cp.timestamp,
61
+ traceId: `trace-restored-${Date.now()}`,
62
+ };
63
+ }
64
+ return { net, session };
65
+ });
66
+ }
67
+ list() {
68
+ return __awaiter(this, void 0, void 0, function* () {
69
+ return Array.from(this.checkpoints.values()).map((cp) => ({
70
+ id: cp.id,
71
+ timestamp: cp.timestamp,
72
+ sessionId: cp.sessionId,
73
+ })).sort((a, b) => b.timestamp - a.timestamp);
74
+ });
75
+ }
76
+ delete(checkpointId) {
77
+ return __awaiter(this, void 0, void 0, function* () {
78
+ this.checkpoints.delete(checkpointId);
79
+ });
80
+ }
81
+ }
82
+ exports.InMemoryPetriCheckpointAdapter = InMemoryPetriCheckpointAdapter;
83
+ //# sourceMappingURL=checkpoint-adapter.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"checkpoint-adapter.js","sourceRoot":"","sources":["../../routing/checkpoint-adapter.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,47 @@
1
+ import { PetriNet } from '../routing/index';
2
+ import { CortexFlowOrchestrator } from '../routing/orchestrator';
3
+ export interface DocumentationOptions {
4
+ outputDir: string;
5
+ format: 'markdown' | 'all';
6
+ includeHistory?: boolean;
7
+ includeState?: boolean;
8
+ }
9
+ export declare class PetriDocumentationGenerator {
10
+ /**
11
+ * Generate living documentation for a Petri net
12
+ */
13
+ generateForPetri(net: PetriNet, options: DocumentationOptions): Promise<void>;
14
+ /**
15
+ * Generate living documentation for an orchestrator session
16
+ */
17
+ generateForSession(orchestrator: CortexFlowOrchestrator, sessionId: string, options: DocumentationOptions): Promise<void>;
18
+ /**
19
+ * Generate Mermaid diagram for Petri net
20
+ */
21
+ private generateMermaid;
22
+ /**
23
+ * Generate Mermaid with current state highlighted
24
+ */
25
+ private generateMermaidWithState;
26
+ /**
27
+ * Generate Markdown documentation
28
+ */
29
+ private generateMarkdown;
30
+ /**
31
+ * Generate state documentation
32
+ */
33
+ private generateStateDoc;
34
+ /**
35
+ * Generate session report
36
+ */
37
+ private generateSessionReport;
38
+ /**
39
+ * Generate HTML preview
40
+ */
41
+ private generateHTML;
42
+ /**
43
+ * Sanitize filename
44
+ */
45
+ private sanitizeFilename;
46
+ }
47
+ //# sourceMappingURL=documentation-generator.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"documentation-generator.d.ts","sourceRoot":"","sources":["../../routing/documentation-generator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAKjE,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,UAAU,GAAG,KAAK,CAAC;IAC3B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,qBAAa,2BAA2B;IAEtC;;OAEG;IACG,gBAAgB,CACpB,GAAG,EAAE,QAAQ,EACb,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,IAAI,CAAC;IA8BhB;;OAEG;IACG,kBAAkB,CACtB,YAAY,EAAE,sBAAsB,EACpC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,IAAI,CAAC;IAoChB;;OAEG;IACH,OAAO,CAAC,eAAe;IAsCvB;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAsBhC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA0CxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA0DxB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAsC7B;;OAEG;IACH,OAAO,CAAC,YAAY;IAyCpB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAGzB"}
@@ -0,0 +1,320 @@
1
+ "use strict";
2
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
3
+ if (k2 === undefined) k2 = k;
4
+ var desc = Object.getOwnPropertyDescriptor(m, k);
5
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
6
+ desc = { enumerable: true, get: function() { return m[k]; } };
7
+ }
8
+ Object.defineProperty(o, k2, desc);
9
+ }) : (function(o, m, k, k2) {
10
+ if (k2 === undefined) k2 = k;
11
+ o[k2] = m[k];
12
+ }));
13
+ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
14
+ Object.defineProperty(o, "default", { enumerable: true, value: v });
15
+ }) : function(o, v) {
16
+ o["default"] = v;
17
+ });
18
+ var __importStar = (this && this.__importStar) || (function () {
19
+ var ownKeys = function(o) {
20
+ ownKeys = Object.getOwnPropertyNames || function (o) {
21
+ var ar = [];
22
+ for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
23
+ return ar;
24
+ };
25
+ return ownKeys(o);
26
+ };
27
+ return function (mod) {
28
+ if (mod && mod.__esModule) return mod;
29
+ var result = {};
30
+ if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
31
+ __setModuleDefault(result, mod);
32
+ return result;
33
+ };
34
+ })();
35
+ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
36
+ function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
37
+ return new (P || (P = Promise))(function (resolve, reject) {
38
+ function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
39
+ function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
40
+ function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
41
+ step((generator = generator.apply(thisArg, _arguments || [])).next());
42
+ });
43
+ };
44
+ Object.defineProperty(exports, "__esModule", { value: true });
45
+ exports.PetriDocumentationGenerator = void 0;
46
+ const fs = __importStar(require("fs/promises"));
47
+ const path = __importStar(require("path"));
48
+ class PetriDocumentationGenerator {
49
+ /**
50
+ * Generate living documentation for a Petri net
51
+ */
52
+ generateForPetri(net, options) {
53
+ return __awaiter(this, void 0, void 0, function* () {
54
+ const { outputDir, format } = options;
55
+ yield fs.mkdir(outputDir, { recursive: true });
56
+ // Generate Mermaid diagram
57
+ const mermaid = this.generateMermaid(net);
58
+ yield fs.writeFile(path.join(outputDir, `${this.sanitizeFilename(net.name)}-diagram.mmd`), mermaid);
59
+ // Generate Markdown documentation
60
+ const markdown = this.generateMarkdown(net, mermaid);
61
+ yield fs.writeFile(path.join(outputDir, `${this.sanitizeFilename(net.name)}.md`), markdown);
62
+ // Generate HTML preview if 'all' format
63
+ if (format === 'all') {
64
+ const html = this.generateHTML(net, mermaid);
65
+ yield fs.writeFile(path.join(outputDir, `${this.sanitizeFilename(net.name)}.html`), html);
66
+ }
67
+ console.log(`✅ Documentation generated in ${outputDir}`);
68
+ });
69
+ }
70
+ /**
71
+ * Generate living documentation for an orchestrator session
72
+ */
73
+ generateForSession(orchestrator, sessionId, options) {
74
+ return __awaiter(this, void 0, void 0, function* () {
75
+ var _a;
76
+ const { outputDir } = options;
77
+ yield fs.mkdir(outputDir, { recursive: true });
78
+ const net = orchestrator.petri;
79
+ const session = (_a = orchestrator.sessions) === null || _a === void 0 ? void 0 : _a.get(sessionId);
80
+ // Current state
81
+ const marking = net.state.marking;
82
+ const history = net.state.history || [];
83
+ const enabled = net.getEnabledTransitions();
84
+ // Generate state documentation
85
+ const stateDoc = this.generateStateDoc(net, marking, history, enabled, session);
86
+ yield fs.writeFile(path.join(outputDir, `session-${sessionId}-state.md`), stateDoc);
87
+ // Generate Mermaid with current state highlighted
88
+ const mermaidWithState = this.generateMermaidWithState(net, marking, enabled);
89
+ yield fs.writeFile(path.join(outputDir, `session-${sessionId}-state.mmd`), mermaidWithState);
90
+ // Generate full session report
91
+ const sessionReport = this.generateSessionReport(net, session, history, enabled);
92
+ yield fs.writeFile(path.join(outputDir, `session-${sessionId}-report.md`), sessionReport);
93
+ console.log(`✅ Session documentation generated in ${outputDir}`);
94
+ });
95
+ }
96
+ /**
97
+ * Generate Mermaid diagram for Petri net
98
+ */
99
+ generateMermaid(net) {
100
+ const lines = ['graph TD'];
101
+ // Add places
102
+ for (const [id, place] of net.places) {
103
+ const label = `${id}\\n(${place.type})`;
104
+ const shape = place.type === 'initial' ? `((${label}))` :
105
+ place.type === 'final' ? `(((${label})))` :
106
+ `[${label}]`;
107
+ lines.push(` ${id}${shape}`);
108
+ }
109
+ // Add transitions
110
+ for (const [id, trans] of net.transitions) {
111
+ const desc = trans.description || id;
112
+ lines.push(` ${id}[/${desc}/]`);
113
+ }
114
+ // Add arcs (from transitions to places = output, places to transitions = input)
115
+ for (const [tid, trans] of net.transitions) {
116
+ // Input arcs (place -> transition)
117
+ for (const pid of trans.from) {
118
+ lines.push(` ${pid} -->|${tid}| ${tid}`);
119
+ }
120
+ // Output arcs (transition -> place)
121
+ for (const pid of trans.to) {
122
+ lines.push(` ${tid} -->|${tid}| ${pid}`);
123
+ }
124
+ }
125
+ // Add style for initial/final places
126
+ lines.push('');
127
+ lines.push(' style initial fill:#90EE90,stroke:#228B22');
128
+ lines.push(' style final fill:#FFB6C1,stroke:#DC143C');
129
+ return lines.join('\n');
130
+ }
131
+ /**
132
+ * Generate Mermaid with current state highlighted
133
+ */
134
+ generateMermaidWithState(net, marking, enabled) {
135
+ const lines = this.generateMermaid(net).split('\n');
136
+ // Highlight places with tokens
137
+ for (const [pid, tokens] of marking) {
138
+ if (tokens.length > 0) {
139
+ lines.push(` style ${pid} fill:#FFD700,stroke:#FFA500`);
140
+ }
141
+ }
142
+ // Highlight enabled transitions
143
+ for (const tid of enabled) {
144
+ lines.push(` style ${tid} fill:#90EE90,stroke:#228B22`);
145
+ }
146
+ return lines.join('\n');
147
+ }
148
+ /**
149
+ * Generate Markdown documentation
150
+ */
151
+ generateMarkdown(net, mermaid) {
152
+ const lines = [
153
+ `# Petri Net: ${net.name}`,
154
+ '',
155
+ '## Overview',
156
+ '',
157
+ `- **Name**: ${net.name}`,
158
+ `- **Places**: ${net.places.size}`,
159
+ `- **Transitions**: ${net.transitions.size}`,
160
+ '',
161
+ '## Mermaid Diagram',
162
+ '',
163
+ '```mermaid',
164
+ mermaid,
165
+ '```',
166
+ '',
167
+ '## Places',
168
+ '',
169
+ ];
170
+ for (const [id, place] of net.places) {
171
+ lines.push(`### ${id} (${place.type})`);
172
+ lines.push('');
173
+ lines.push(`- Type: ${place.type}`);
174
+ lines.push('');
175
+ }
176
+ lines.push('## Transitions');
177
+ lines.push('');
178
+ for (const [id, trans] of net.transitions) {
179
+ lines.push(`### ${id}`);
180
+ lines.push('');
181
+ lines.push(`- **Description**: ${trans.description || id}`);
182
+ lines.push(`- **From**: ${Array.isArray(trans.from) ? trans.from.join(', ') : trans.from}`);
183
+ lines.push(`- **To**: ${Array.isArray(trans.to) ? trans.to.join(', ') : trans.to}`);
184
+ lines.push('');
185
+ }
186
+ return lines.join('\n');
187
+ }
188
+ /**
189
+ * Generate state documentation
190
+ */
191
+ generateStateDoc(net, marking, history, enabled, session) {
192
+ const lines = [
193
+ `# Session State: ${(session === null || session === void 0 ? void 0 : session.id) || 'unknown'}`,
194
+ '',
195
+ '## Current Marking',
196
+ '',
197
+ ];
198
+ for (const [pid, tokens] of marking) {
199
+ const place = net.places.get(pid);
200
+ lines.push(`- **${pid}** (${place === null || place === void 0 ? void 0 : place.type}): ${tokens.length} token(s)`);
201
+ if (tokens.length > 0) {
202
+ tokens.forEach((t, i) => {
203
+ lines.push(` - Token ${i + 1}: ${JSON.stringify(t.data).substring(0, 100)}`);
204
+ });
205
+ }
206
+ }
207
+ lines.push('');
208
+ lines.push('## Enabled Transitions');
209
+ lines.push('');
210
+ if (enabled.length === 0) {
211
+ lines.push('*No enabled transitions*');
212
+ }
213
+ else {
214
+ enabled.forEach(tid => {
215
+ const trans = net.transitions.get(tid);
216
+ lines.push(`- **${tid}**: ${(trans === null || trans === void 0 ? void 0 : trans.description) || tid}`);
217
+ });
218
+ }
219
+ lines.push('');
220
+ lines.push('## Session Context');
221
+ lines.push('');
222
+ if (session === null || session === void 0 ? void 0 : session.context) {
223
+ lines.push('```json');
224
+ lines.push(JSON.stringify(session.context, null, 2));
225
+ lines.push('```');
226
+ }
227
+ else {
228
+ lines.push('*No context*');
229
+ }
230
+ lines.push('');
231
+ lines.push('## History (last 20)');
232
+ lines.push('');
233
+ history.slice(-20).forEach((h, i) => {
234
+ lines.push(`${history.length - 20 + i + 1}. ${h}`);
235
+ });
236
+ return lines.join('\n');
237
+ }
238
+ /**
239
+ * Generate session report
240
+ */
241
+ generateSessionReport(net, session, history, enabled) {
242
+ const lines = [
243
+ `# Session Report: ${(session === null || session === void 0 ? void 0 : session.id) || 'unknown'}`,
244
+ '',
245
+ `Generated: ${new Date().toISOString()}`,
246
+ '',
247
+ '## Summary',
248
+ '',
249
+ `- **Petri Net**: ${net.name}`,
250
+ `- **Session ID**: ${(session === null || session === void 0 ? void 0 : session.id) || 'N/A'}`,
251
+ `- **Total Transitions Fired**: ${history.length}`,
252
+ `- **Enabled Transitions**: ${enabled.length}`,
253
+ '',
254
+ '## Timeline',
255
+ '',
256
+ ];
257
+ history.forEach((h, i) => {
258
+ lines.push(`${i + 1}. ${h}`);
259
+ });
260
+ lines.push('');
261
+ lines.push('## Final State');
262
+ lines.push('');
263
+ const marking = net.state.marking;
264
+ for (const [pid, tokens] of marking) {
265
+ lines.push(`- **${pid}**: ${tokens.length} token(s)`);
266
+ }
267
+ return lines.join('\n');
268
+ }
269
+ /**
270
+ * Generate HTML preview
271
+ */
272
+ generateHTML(net, mermaid) {
273
+ return `<!DOCTYPE html>
274
+ <html>
275
+ <head>
276
+ <title>Petri Net: ${net.name}</title>
277
+ <script src="https://cdn.jsdelivr.net/npm/mermaid@10/dist/mermaid.min.js"></script>
278
+ <style>
279
+ body { font-family: Arial, sans-serif; margin: 40px; background: #f5f5f5; }
280
+ .container { background: white; padding: 30px; border-radius: 8px; box-shadow: 0 2px 4px rgba(0,0,0,0.1); }
281
+ h1 { color: #333; }
282
+ .mermaid { background: white; padding: 20px; border: 1px solid #ddd; border-radius: 4px; }
283
+ pre { background: #f8f8f8; padding: 15px; border-radius: 4px; overflow-x: auto; }
284
+ </style>
285
+ </head>
286
+ <body>
287
+ <div class="container">
288
+ <h1>Petri Net: ${net.name}</h1>
289
+
290
+ <h2>Visualization</h2>
291
+ <div class="mermaid">
292
+ ${mermaid}
293
+ </div>
294
+
295
+ <h2>Places</h2>
296
+ <ul>
297
+ ${Array.from(net.places.entries()).map(([id, p]) => `<li><strong>${id}</strong> (${p.type})</li>`).join('\n ')}
298
+ </ul>
299
+
300
+ <h2>Transitions</h2>
301
+ <ul>
302
+ ${Array.from(net.transitions.entries()).map(([id, t]) => `<li><strong>${id}</strong>: ${t.description || id} | from: ${Array.isArray(t.from) ? t.from.join(', ') : t.from} → to: ${Array.isArray(t.to) ? t.to.join(', ') : t.to}</li>`).join('\n ')}
303
+ </ul>
304
+ </div>
305
+
306
+ <script>
307
+ mermaid.initialize({ startOnLoad: true, theme: 'default' });
308
+ </script>
309
+ </body>
310
+ </html>`;
311
+ }
312
+ /**
313
+ * Sanitize filename
314
+ */
315
+ sanitizeFilename(name) {
316
+ return name.replace(/[^a-zA-Z0-9_-]/g, '_');
317
+ }
318
+ }
319
+ exports.PetriDocumentationGenerator = PetriDocumentationGenerator;
320
+ //# sourceMappingURL=documentation-generator.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"documentation-generator.js","sourceRoot":"","sources":["../../routing/documentation-generator.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,38 @@
1
+ import { Place, Transition, PetriNetState, TransitionResult, GuardLLMExecutor, ActionExecutor } from './types';
2
+ export { Token, Place, Transition, PetriNetState, TransitionResult, Guard, GuardLLMExecutor, ActionExecutor, TransitionAction, } from './types';
3
+ export { IPetriCheckpointAdapter, InMemoryPetriCheckpointAdapter, } from './checkpoint-adapter';
4
+ export { RedisPetriCheckpointAdapter } from './redis-checkpoint-adapter';
5
+ export { PostgresPetriCheckpointAdapter } from './postgres-checkpoint-adapter';
6
+ export declare class PetriNet {
7
+ name: string;
8
+ places: Map<string, Place>;
9
+ transitions: Map<string, Transition>;
10
+ state: PetriNetState;
11
+ private guardFunctions;
12
+ private llmExecutor?;
13
+ private actionExecutor?;
14
+ constructor(name: string);
15
+ addPlace(place: Place): void;
16
+ addTransition(transition: Transition): void;
17
+ registerGuardFunction(name: string, func: (ctx: any) => boolean): void;
18
+ setLLMExecutor(executor: GuardLLMExecutor): void;
19
+ setActionExecutor(executor: ActionExecutor): void;
20
+ getEnabledTransitions(context?: any): string[];
21
+ getEventDrivenTransitions(): string[];
22
+ private evaluateGuard;
23
+ private getTokenContext;
24
+ fireTransition(transitionId: string, tokenData?: Record<string, any>): Promise<TransitionResult>;
25
+ fireTransitionByEvent(transitionId: string, eventData?: Record<string, any>): Promise<TransitionResult>;
26
+ fireTransitionWithAction(transitionId: string, tokenData?: Record<string, any>): Promise<TransitionResult & {
27
+ actionResult?: any;
28
+ }>;
29
+ detectDeadlock(): boolean;
30
+ private hasActiveTokens;
31
+ validateBoundedness(): {
32
+ bounded: boolean;
33
+ details?: string;
34
+ };
35
+ toDot(): string;
36
+ private cloneMarking;
37
+ }
38
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../routing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,EACL,UAAU,EACV,aAAa,EACb,gBAAgB,EAEhB,gBAAgB,EAChB,cAAc,EAEf,MAAM,SAAS,CAAC;AAUjB,OAAO,EACL,KAAK,EACL,KAAK,EACL,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,KAAK,EACL,gBAAgB,EAChB,cAAc,EACd,gBAAgB,GACjB,MAAM,SAAS,CAAC;AAEjB,OAAO,EACL,uBAAuB,EACvB,8BAA8B,GAC/B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AACzE,OAAO,EAAE,8BAA8B,EAAE,MAAM,+BAA+B,CAAC;AAE/E,qBAAa,QAAQ;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAa;IACvC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAa;IACjD,KAAK,EAAE,aAAa,CAAC;IACrB,OAAO,CAAC,cAAc,CAAiD;IACvE,OAAO,CAAC,WAAW,CAAC,CAAmB;IACvC,OAAO,CAAC,cAAc,CAAC,CAAiB;gBAE5B,IAAI,EAAE,MAAM;IAQxB,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAK5B,aAAa,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;IAI3C,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,GAAG,IAAI;IAItE,cAAc,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI;IAIhD,iBAAiB,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI;IAIjD,qBAAqB,CAAC,OAAO,CAAC,EAAE,GAAG,GAAG,MAAM,EAAE;IAqB9C,yBAAyB,IAAI,MAAM,EAAE;IAUrC,OAAO,CAAC,aAAa;IAqBrB,OAAO,CAAC,eAAe;IAWjB,cAAc,CAClB,YAAY,EAAE,MAAM,EACpB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC9B,OAAO,CAAC,gBAAgB,CAAC;IAyFtB,qBAAqB,CACzB,YAAY,EAAE,MAAM,EACpB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC9B,OAAO,CAAC,gBAAgB,CAAC;IA0EtB,wBAAwB,CAC5B,YAAY,EAAE,MAAM,EACpB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC9B,OAAO,CAAC,gBAAgB,GAAG;QAAE,YAAY,CAAC,EAAE,GAAG,CAAA;KAAE,CAAC;IAuCrD,cAAc,IAAI,OAAO;IASzB,OAAO,CAAC,eAAe;IAMvB,mBAAmB,IAAI;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE;IAiD7D,KAAK,IAAI,MAAM;IAiCf,OAAO,CAAC,YAAY;CASrB"}