groundswell 0.0.1 → 0.0.3

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 (451) hide show
  1. package/CHANGELOG.md +188 -0
  2. package/README.md +99 -5
  3. package/dist/__tests__/adversarial/attachChild-performance.test.d.ts +16 -0
  4. package/dist/__tests__/adversarial/attachChild-performance.test.d.ts.map +1 -0
  5. package/dist/__tests__/adversarial/attachChild-performance.test.js +187 -0
  6. package/dist/__tests__/adversarial/attachChild-performance.test.js.map +1 -0
  7. package/dist/__tests__/adversarial/circular-reference.test.d.ts +13 -0
  8. package/dist/__tests__/adversarial/circular-reference.test.d.ts.map +1 -0
  9. package/dist/__tests__/adversarial/circular-reference.test.js +92 -0
  10. package/dist/__tests__/adversarial/circular-reference.test.js.map +1 -0
  11. package/dist/__tests__/adversarial/complex-circular-reference.test.d.ts +16 -0
  12. package/dist/__tests__/adversarial/complex-circular-reference.test.d.ts.map +1 -0
  13. package/dist/__tests__/adversarial/complex-circular-reference.test.js +127 -0
  14. package/dist/__tests__/adversarial/complex-circular-reference.test.js.map +1 -0
  15. package/dist/__tests__/adversarial/concurrent-task-failures.test.d.ts +21 -0
  16. package/dist/__tests__/adversarial/concurrent-task-failures.test.d.ts.map +1 -0
  17. package/dist/__tests__/adversarial/concurrent-task-failures.test.js +667 -0
  18. package/dist/__tests__/adversarial/concurrent-task-failures.test.js.map +1 -0
  19. package/dist/__tests__/adversarial/deep-analysis.test.d.ts +6 -0
  20. package/dist/__tests__/adversarial/deep-analysis.test.d.ts.map +1 -0
  21. package/dist/__tests__/adversarial/deep-analysis.test.js +877 -0
  22. package/dist/__tests__/adversarial/deep-analysis.test.js.map +1 -0
  23. package/dist/__tests__/adversarial/deep-hierarchy-stress.test.d.ts +13 -0
  24. package/dist/__tests__/adversarial/deep-hierarchy-stress.test.d.ts.map +1 -0
  25. package/dist/__tests__/adversarial/deep-hierarchy-stress.test.js +186 -0
  26. package/dist/__tests__/adversarial/deep-hierarchy-stress.test.js.map +1 -0
  27. package/dist/__tests__/adversarial/e2e-prd-validation.test.d.ts +6 -0
  28. package/dist/__tests__/adversarial/e2e-prd-validation.test.d.ts.map +1 -0
  29. package/dist/__tests__/adversarial/e2e-prd-validation.test.js +626 -0
  30. package/dist/__tests__/adversarial/e2e-prd-validation.test.js.map +1 -0
  31. package/dist/__tests__/adversarial/edge-case.test.d.ts +6 -0
  32. package/dist/__tests__/adversarial/edge-case.test.d.ts.map +1 -0
  33. package/dist/__tests__/adversarial/edge-case.test.js +857 -0
  34. package/dist/__tests__/adversarial/edge-case.test.js.map +1 -0
  35. package/dist/__tests__/adversarial/error-merge-strategy.test.d.ts +20 -0
  36. package/dist/__tests__/adversarial/error-merge-strategy.test.d.ts.map +1 -0
  37. package/dist/__tests__/adversarial/error-merge-strategy.test.js +907 -0
  38. package/dist/__tests__/adversarial/error-merge-strategy.test.js.map +1 -0
  39. package/dist/__tests__/adversarial/incremental-performance.test.d.ts +2 -0
  40. package/dist/__tests__/adversarial/incremental-performance.test.d.ts.map +1 -0
  41. package/dist/__tests__/adversarial/incremental-performance.test.js +113 -0
  42. package/dist/__tests__/adversarial/incremental-performance.test.js.map +1 -0
  43. package/dist/__tests__/adversarial/node-map-update-benchmarks.test.d.ts +22 -0
  44. package/dist/__tests__/adversarial/node-map-update-benchmarks.test.d.ts.map +1 -0
  45. package/dist/__tests__/adversarial/node-map-update-benchmarks.test.js +383 -0
  46. package/dist/__tests__/adversarial/node-map-update-benchmarks.test.js.map +1 -0
  47. package/dist/__tests__/adversarial/observer-propagation.test.d.ts +21 -0
  48. package/dist/__tests__/adversarial/observer-propagation.test.d.ts.map +1 -0
  49. package/dist/__tests__/adversarial/observer-propagation.test.js +404 -0
  50. package/dist/__tests__/adversarial/observer-propagation.test.js.map +1 -0
  51. package/dist/__tests__/adversarial/parent-validation.test.d.ts +13 -0
  52. package/dist/__tests__/adversarial/parent-validation.test.d.ts.map +1 -0
  53. package/dist/__tests__/adversarial/parent-validation.test.js +128 -0
  54. package/dist/__tests__/adversarial/parent-validation.test.js.map +1 -0
  55. package/dist/__tests__/adversarial/prd-12-2-compliance.test.d.ts +20 -0
  56. package/dist/__tests__/adversarial/prd-12-2-compliance.test.d.ts.map +1 -0
  57. package/dist/__tests__/adversarial/prd-12-2-compliance.test.js +482 -0
  58. package/dist/__tests__/adversarial/prd-12-2-compliance.test.js.map +1 -0
  59. package/dist/__tests__/adversarial/prd-compliance.test.d.ts +6 -0
  60. package/dist/__tests__/adversarial/prd-compliance.test.d.ts.map +1 -0
  61. package/dist/__tests__/adversarial/prd-compliance.test.js +886 -0
  62. package/dist/__tests__/adversarial/prd-compliance.test.js.map +1 -0
  63. package/dist/__tests__/compatibility/backward-compatibility.test.d.ts +22 -0
  64. package/dist/__tests__/compatibility/backward-compatibility.test.d.ts.map +1 -0
  65. package/dist/__tests__/compatibility/backward-compatibility.test.js +1843 -0
  66. package/dist/__tests__/compatibility/backward-compatibility.test.js.map +1 -0
  67. package/dist/__tests__/helpers/index.d.ts +10 -0
  68. package/dist/__tests__/helpers/index.d.ts.map +1 -0
  69. package/dist/__tests__/helpers/index.js +10 -0
  70. package/dist/__tests__/helpers/index.js.map +1 -0
  71. package/dist/__tests__/helpers/tree-verification.d.ts +90 -0
  72. package/dist/__tests__/helpers/tree-verification.d.ts.map +1 -0
  73. package/dist/__tests__/helpers/tree-verification.js +202 -0
  74. package/dist/__tests__/helpers/tree-verification.js.map +1 -0
  75. package/dist/__tests__/integration/agent-workflow.test.d.ts +2 -0
  76. package/dist/__tests__/integration/agent-workflow.test.d.ts.map +1 -0
  77. package/dist/__tests__/integration/agent-workflow.test.js +256 -0
  78. package/dist/__tests__/integration/agent-workflow.test.js.map +1 -0
  79. package/dist/__tests__/integration/bidirectional-consistency.test.d.ts +14 -0
  80. package/dist/__tests__/integration/bidirectional-consistency.test.d.ts.map +1 -0
  81. package/dist/__tests__/integration/bidirectional-consistency.test.js +668 -0
  82. package/dist/__tests__/integration/bidirectional-consistency.test.js.map +1 -0
  83. package/dist/__tests__/integration/observer-logging.test.d.ts +2 -0
  84. package/dist/__tests__/integration/observer-logging.test.d.ts.map +1 -0
  85. package/dist/__tests__/integration/observer-logging.test.js +517 -0
  86. package/dist/__tests__/integration/observer-logging.test.js.map +1 -0
  87. package/dist/__tests__/integration/tree-mirroring.test.d.ts +2 -0
  88. package/dist/__tests__/integration/tree-mirroring.test.d.ts.map +1 -0
  89. package/dist/__tests__/integration/tree-mirroring.test.js +117 -0
  90. package/dist/__tests__/integration/tree-mirroring.test.js.map +1 -0
  91. package/dist/__tests__/integration/workflow-reparenting.test.d.ts +12 -0
  92. package/dist/__tests__/integration/workflow-reparenting.test.d.ts.map +1 -0
  93. package/dist/__tests__/integration/workflow-reparenting.test.js +239 -0
  94. package/dist/__tests__/integration/workflow-reparenting.test.js.map +1 -0
  95. package/dist/__tests__/unit/agent.test.d.ts +2 -0
  96. package/dist/__tests__/unit/agent.test.d.ts.map +1 -0
  97. package/dist/__tests__/unit/agent.test.js +143 -0
  98. package/dist/__tests__/unit/agent.test.js.map +1 -0
  99. package/dist/__tests__/unit/cache-key.test.d.ts +5 -0
  100. package/dist/__tests__/unit/cache-key.test.d.ts.map +1 -0
  101. package/dist/__tests__/unit/cache-key.test.js +145 -0
  102. package/dist/__tests__/unit/cache-key.test.js.map +1 -0
  103. package/dist/__tests__/unit/cache.test.d.ts +5 -0
  104. package/dist/__tests__/unit/cache.test.d.ts.map +1 -0
  105. package/dist/__tests__/unit/cache.test.js +132 -0
  106. package/dist/__tests__/unit/cache.test.js.map +1 -0
  107. package/dist/__tests__/unit/context.test.d.ts +2 -0
  108. package/dist/__tests__/unit/context.test.d.ts.map +1 -0
  109. package/dist/__tests__/unit/context.test.js +220 -0
  110. package/dist/__tests__/unit/context.test.js.map +1 -0
  111. package/dist/__tests__/unit/decorators.test.d.ts +2 -0
  112. package/dist/__tests__/unit/decorators.test.d.ts.map +1 -0
  113. package/dist/__tests__/unit/decorators.test.js +162 -0
  114. package/dist/__tests__/unit/decorators.test.js.map +1 -0
  115. package/dist/__tests__/unit/introspection-tools.test.d.ts +5 -0
  116. package/dist/__tests__/unit/introspection-tools.test.d.ts.map +1 -0
  117. package/dist/__tests__/unit/introspection-tools.test.js +191 -0
  118. package/dist/__tests__/unit/introspection-tools.test.js.map +1 -0
  119. package/dist/__tests__/unit/logger.test.d.ts +2 -0
  120. package/dist/__tests__/unit/logger.test.d.ts.map +1 -0
  121. package/dist/__tests__/unit/logger.test.js +241 -0
  122. package/dist/__tests__/unit/logger.test.js.map +1 -0
  123. package/dist/__tests__/unit/observable.test.d.ts +2 -0
  124. package/dist/__tests__/unit/observable.test.d.ts.map +1 -0
  125. package/dist/__tests__/unit/observable.test.js +251 -0
  126. package/dist/__tests__/unit/observable.test.js.map +1 -0
  127. package/dist/__tests__/unit/prompt.test.d.ts +2 -0
  128. package/dist/__tests__/unit/prompt.test.d.ts.map +1 -0
  129. package/dist/__tests__/unit/prompt.test.js +113 -0
  130. package/dist/__tests__/unit/prompt.test.js.map +1 -0
  131. package/dist/__tests__/unit/reflection.test.d.ts +5 -0
  132. package/dist/__tests__/unit/reflection.test.d.ts.map +1 -0
  133. package/dist/__tests__/unit/reflection.test.js +160 -0
  134. package/dist/__tests__/unit/reflection.test.js.map +1 -0
  135. package/dist/__tests__/unit/tree-debugger-incremental.test.d.ts +2 -0
  136. package/dist/__tests__/unit/tree-debugger-incremental.test.d.ts.map +1 -0
  137. package/dist/__tests__/unit/tree-debugger-incremental.test.js +136 -0
  138. package/dist/__tests__/unit/tree-debugger-incremental.test.js.map +1 -0
  139. package/dist/__tests__/unit/tree-debugger.test.d.ts +2 -0
  140. package/dist/__tests__/unit/tree-debugger.test.d.ts.map +1 -0
  141. package/dist/__tests__/unit/tree-debugger.test.js +69 -0
  142. package/dist/__tests__/unit/tree-debugger.test.js.map +1 -0
  143. package/dist/__tests__/unit/utils/workflow-error-utils.test.d.ts +2 -0
  144. package/dist/__tests__/unit/utils/workflow-error-utils.test.d.ts.map +1 -0
  145. package/dist/__tests__/unit/utils/workflow-error-utils.test.js +154 -0
  146. package/dist/__tests__/unit/utils/workflow-error-utils.test.js.map +1 -0
  147. package/dist/__tests__/unit/workflow-detachChild.test.d.ts +2 -0
  148. package/dist/__tests__/unit/workflow-detachChild.test.d.ts.map +1 -0
  149. package/dist/__tests__/unit/workflow-detachChild.test.js +76 -0
  150. package/dist/__tests__/unit/workflow-detachChild.test.js.map +1 -0
  151. package/dist/__tests__/unit/workflow-emitEvent-childDetached.test.d.ts +2 -0
  152. package/dist/__tests__/unit/workflow-emitEvent-childDetached.test.d.ts.map +1 -0
  153. package/dist/__tests__/unit/workflow-emitEvent-childDetached.test.js +122 -0
  154. package/dist/__tests__/unit/workflow-emitEvent-childDetached.test.js.map +1 -0
  155. package/dist/__tests__/unit/workflow-isDescendantOf.test.d.ts +2 -0
  156. package/dist/__tests__/unit/workflow-isDescendantOf.test.d.ts.map +1 -0
  157. package/dist/__tests__/unit/workflow-isDescendantOf.test.js +140 -0
  158. package/dist/__tests__/unit/workflow-isDescendantOf.test.js.map +1 -0
  159. package/dist/__tests__/unit/workflow.test.d.ts +2 -0
  160. package/dist/__tests__/unit/workflow.test.d.ts.map +1 -0
  161. package/dist/__tests__/unit/workflow.test.js +330 -0
  162. package/dist/__tests__/unit/workflow.test.js.map +1 -0
  163. package/dist/cache/cache-key.d.ts +66 -0
  164. package/dist/cache/cache-key.d.ts.map +1 -0
  165. package/dist/cache/cache-key.js +195 -0
  166. package/dist/cache/cache-key.js.map +1 -0
  167. package/dist/cache/cache.d.ts +104 -0
  168. package/dist/cache/cache.d.ts.map +1 -0
  169. package/dist/cache/cache.js +179 -0
  170. package/dist/cache/cache.js.map +1 -0
  171. package/{src/cache/index.ts → dist/cache/index.d.ts} +1 -1
  172. package/dist/cache/index.d.ts.map +1 -0
  173. package/dist/cache/index.js +6 -0
  174. package/dist/cache/index.js.map +1 -0
  175. package/dist/core/agent.d.ts +112 -0
  176. package/dist/core/agent.d.ts.map +1 -0
  177. package/dist/core/agent.js +426 -0
  178. package/dist/core/agent.js.map +1 -0
  179. package/{src/core/context.ts → dist/core/context.d.ts} +16 -67
  180. package/dist/core/context.d.ts.map +1 -0
  181. package/dist/core/context.js +80 -0
  182. package/dist/core/context.js.map +1 -0
  183. package/dist/core/event-tree.d.ts +72 -0
  184. package/dist/core/event-tree.d.ts.map +1 -0
  185. package/dist/core/event-tree.js +211 -0
  186. package/dist/core/event-tree.js.map +1 -0
  187. package/{src/core/factory.ts → dist/core/factory.d.ts} +6 -27
  188. package/dist/core/factory.d.ts.map +1 -0
  189. package/dist/core/factory.js +110 -0
  190. package/dist/core/factory.js.map +1 -0
  191. package/{src/core/index.ts → dist/core/index.d.ts} +2 -10
  192. package/dist/core/index.d.ts.map +1 -0
  193. package/dist/core/index.js +9 -0
  194. package/dist/core/index.js.map +1 -0
  195. package/dist/core/logger.d.ts +50 -0
  196. package/dist/core/logger.d.ts.map +1 -0
  197. package/dist/core/logger.js +91 -0
  198. package/dist/core/logger.js.map +1 -0
  199. package/dist/core/mcp-handler.d.ts +69 -0
  200. package/dist/core/mcp-handler.d.ts.map +1 -0
  201. package/dist/core/mcp-handler.js +143 -0
  202. package/dist/core/mcp-handler.js.map +1 -0
  203. package/dist/core/prompt.d.ts +80 -0
  204. package/dist/core/prompt.d.ts.map +1 -0
  205. package/dist/core/prompt.js +120 -0
  206. package/dist/core/prompt.js.map +1 -0
  207. package/dist/core/workflow-context.d.ts +57 -0
  208. package/dist/core/workflow-context.d.ts.map +1 -0
  209. package/dist/core/workflow-context.js +263 -0
  210. package/dist/core/workflow-context.js.map +1 -0
  211. package/dist/core/workflow.d.ts +241 -0
  212. package/dist/core/workflow.d.ts.map +1 -0
  213. package/dist/core/workflow.js +464 -0
  214. package/dist/core/workflow.js.map +1 -0
  215. package/dist/debugger/index.d.ts +2 -0
  216. package/dist/debugger/index.d.ts.map +1 -0
  217. package/{src/debugger/index.ts → dist/debugger/index.js} +1 -0
  218. package/dist/debugger/index.js.map +1 -0
  219. package/dist/debugger/tree-debugger.d.ts +71 -0
  220. package/dist/debugger/tree-debugger.d.ts.map +1 -0
  221. package/dist/debugger/tree-debugger.js +198 -0
  222. package/dist/debugger/tree-debugger.js.map +1 -0
  223. package/dist/decorators/index.d.ts +4 -0
  224. package/dist/decorators/index.d.ts.map +1 -0
  225. package/{src/decorators/index.ts → dist/decorators/index.js} +1 -0
  226. package/dist/decorators/index.js.map +1 -0
  227. package/dist/decorators/observed-state.d.ts +32 -0
  228. package/dist/decorators/observed-state.d.ts.map +1 -0
  229. package/dist/decorators/observed-state.js +79 -0
  230. package/dist/decorators/observed-state.js.map +1 -0
  231. package/dist/decorators/step.d.ts +15 -0
  232. package/dist/decorators/step.d.ts.map +1 -0
  233. package/dist/decorators/step.js +110 -0
  234. package/dist/decorators/step.js.map +1 -0
  235. package/dist/decorators/task.d.ts +50 -0
  236. package/dist/decorators/task.d.ts.map +1 -0
  237. package/dist/decorators/task.js +118 -0
  238. package/dist/decorators/task.js.map +1 -0
  239. package/dist/examples/index.d.ts +3 -0
  240. package/dist/examples/index.d.ts.map +1 -0
  241. package/{src/examples/index.ts → dist/examples/index.js} +1 -0
  242. package/dist/examples/index.js.map +1 -0
  243. package/dist/examples/tdd-orchestrator.d.ts +15 -0
  244. package/dist/examples/tdd-orchestrator.d.ts.map +1 -0
  245. package/dist/examples/tdd-orchestrator.js +121 -0
  246. package/dist/examples/tdd-orchestrator.js.map +1 -0
  247. package/dist/examples/test-cycle-workflow.d.ts +14 -0
  248. package/dist/examples/test-cycle-workflow.d.ts.map +1 -0
  249. package/dist/examples/test-cycle-workflow.js +116 -0
  250. package/dist/examples/test-cycle-workflow.js.map +1 -0
  251. package/dist/index.d.ts +27 -0
  252. package/dist/index.d.ts.map +1 -0
  253. package/dist/index.js +40 -0
  254. package/dist/index.js.map +1 -0
  255. package/dist/reflection/index.d.ts +5 -0
  256. package/dist/reflection/index.d.ts.map +1 -0
  257. package/{src/reflection/index.ts → dist/reflection/index.js} +1 -1
  258. package/dist/reflection/index.js.map +1 -0
  259. package/dist/reflection/reflection.d.ts +84 -0
  260. package/dist/reflection/reflection.d.ts.map +1 -0
  261. package/dist/reflection/reflection.js +329 -0
  262. package/dist/reflection/reflection.js.map +1 -0
  263. package/dist/tools/index.d.ts +6 -0
  264. package/dist/tools/index.d.ts.map +1 -0
  265. package/dist/tools/index.js +11 -0
  266. package/dist/tools/index.js.map +1 -0
  267. package/dist/tools/introspection.d.ts +165 -0
  268. package/dist/tools/introspection.d.ts.map +1 -0
  269. package/dist/tools/introspection.js +324 -0
  270. package/dist/tools/introspection.js.map +1 -0
  271. package/dist/types/agent.d.ts +66 -0
  272. package/dist/types/agent.d.ts.map +1 -0
  273. package/dist/types/agent.js +6 -0
  274. package/dist/types/agent.js.map +1 -0
  275. package/dist/types/decorators.d.ts +31 -0
  276. package/dist/types/decorators.d.ts.map +1 -0
  277. package/dist/types/decorators.js +2 -0
  278. package/dist/types/decorators.js.map +1 -0
  279. package/dist/types/error-strategy.d.ts +13 -0
  280. package/dist/types/error-strategy.d.ts.map +1 -0
  281. package/dist/types/error-strategy.js +2 -0
  282. package/dist/types/error-strategy.js.map +1 -0
  283. package/dist/types/error.d.ts +20 -0
  284. package/dist/types/error.d.ts.map +1 -0
  285. package/dist/types/error.js +2 -0
  286. package/dist/types/error.js.map +1 -0
  287. package/dist/types/events.d.ts +87 -0
  288. package/dist/types/events.d.ts.map +1 -0
  289. package/dist/types/events.js +2 -0
  290. package/dist/types/events.js.map +1 -0
  291. package/dist/types/index.d.ts +15 -0
  292. package/dist/types/index.d.ts.map +1 -0
  293. package/dist/types/index.js +2 -0
  294. package/dist/types/index.js.map +1 -0
  295. package/dist/types/logging.d.ts +24 -0
  296. package/dist/types/logging.d.ts.map +1 -0
  297. package/dist/types/logging.js +2 -0
  298. package/dist/types/logging.js.map +1 -0
  299. package/dist/types/observer.d.ts +18 -0
  300. package/dist/types/observer.d.ts.map +1 -0
  301. package/dist/types/observer.js +2 -0
  302. package/dist/types/observer.js.map +1 -0
  303. package/dist/types/prompt.d.ts +31 -0
  304. package/dist/types/prompt.d.ts.map +1 -0
  305. package/dist/types/prompt.js +6 -0
  306. package/dist/types/prompt.js.map +1 -0
  307. package/dist/types/reflection.d.ts +96 -0
  308. package/dist/types/reflection.d.ts.map +1 -0
  309. package/dist/types/reflection.js +24 -0
  310. package/dist/types/reflection.js.map +1 -0
  311. package/dist/types/sdk-primitives.d.ts +118 -0
  312. package/dist/types/sdk-primitives.d.ts.map +1 -0
  313. package/dist/types/sdk-primitives.js +6 -0
  314. package/dist/types/sdk-primitives.js.map +1 -0
  315. package/{src/types/snapshot.ts → dist/types/snapshot.d.ts} +5 -5
  316. package/dist/types/snapshot.d.ts.map +1 -0
  317. package/dist/types/snapshot.js +2 -0
  318. package/dist/types/snapshot.js.map +1 -0
  319. package/dist/types/workflow-context.d.ts +139 -0
  320. package/dist/types/workflow-context.d.ts.map +1 -0
  321. package/dist/types/workflow-context.js +8 -0
  322. package/dist/types/workflow-context.js.map +1 -0
  323. package/dist/types/workflow.d.ts +30 -0
  324. package/dist/types/workflow.d.ts.map +1 -0
  325. package/dist/types/workflow.js +2 -0
  326. package/dist/types/workflow.js.map +1 -0
  327. package/dist/utils/id.d.ts +6 -0
  328. package/dist/utils/id.d.ts.map +1 -0
  329. package/dist/utils/id.js +12 -0
  330. package/dist/utils/id.js.map +1 -0
  331. package/{src/utils/index.ts → dist/utils/index.d.ts} +2 -0
  332. package/dist/utils/index.d.ts.map +1 -0
  333. package/dist/utils/index.js +4 -0
  334. package/dist/utils/index.js.map +1 -0
  335. package/dist/utils/observable.d.ts +54 -0
  336. package/dist/utils/observable.d.ts.map +1 -0
  337. package/dist/utils/observable.js +82 -0
  338. package/dist/utils/observable.js.map +1 -0
  339. package/dist/utils/workflow-error-utils.d.ts +22 -0
  340. package/dist/utils/workflow-error-utils.d.ts.map +1 -0
  341. package/dist/utils/workflow-error-utils.js +45 -0
  342. package/dist/utils/workflow-error-utils.js.map +1 -0
  343. package/package.json +7 -2
  344. package/.claude/settings.local.json +0 -9
  345. package/.claude/system_prompts/task-breakdown.md +0 -100
  346. package/PRPs/001-hierarchical-workflow-engine.md +0 -2438
  347. package/PRPs/PRDs/001-hierarchical-workflow-engine.md +0 -543
  348. package/PRPs/PRDs/002-agent-prompt.md +0 -390
  349. package/PRPs/PRDs/003-agent-prompt.md +0 -943
  350. package/PRPs/PRDs/004-agent-prompt.md +0 -1136
  351. package/PRPs/PRDs/tasks-001.json +0 -492
  352. package/PRPs/README.md +0 -83
  353. package/PRPs/templates/prp_base.md +0 -222
  354. package/docs/agent.md +0 -422
  355. package/docs/prompt.md +0 -419
  356. package/docs/workflow.md +0 -600
  357. package/examples/README.md +0 -244
  358. package/examples/examples/01-basic-workflow.ts +0 -100
  359. package/examples/examples/02-decorator-options.ts +0 -217
  360. package/examples/examples/03-parent-child.ts +0 -241
  361. package/examples/examples/04-observers-debugger.ts +0 -340
  362. package/examples/examples/05-error-handling.ts +0 -387
  363. package/examples/examples/06-concurrent-tasks.ts +0 -352
  364. package/examples/examples/07-agent-loops.ts +0 -432
  365. package/examples/examples/08-sdk-features.ts +0 -667
  366. package/examples/examples/09-reflection.ts +0 -573
  367. package/examples/examples/10-introspection.ts +0 -550
  368. package/examples/index.ts +0 -143
  369. package/examples/utils/helpers.ts +0 -57
  370. package/llms_full.txt +0 -5890
  371. package/plan/P1P2/PRP.md +0 -527
  372. package/plan/P1P2/research/LRU_CACHE_BEST_PRACTICES.md +0 -1929
  373. package/plan/P1P2/research/LRU_CACHE_CODE_PATTERNS.md +0 -857
  374. package/plan/P1P2/research/LRU_CACHE_INTEGRATION_GUIDE.md +0 -738
  375. package/plan/P1P2/research/LRU_CACHE_RESEARCH_INDEX.md +0 -424
  376. package/plan/P1P2/research/REFLECTION_INDEX.md +0 -291
  377. package/plan/P1P2/research/REFLECTION_RESEARCH_REPORT.md +0 -1342
  378. package/plan/P1P2/research/RESEARCH_SUMMARY.md +0 -342
  379. package/plan/P1P2/research/anthropic-sdk.md +0 -174
  380. package/plan/P1P2/research/async-local-storage.md +0 -200
  381. package/plan/P1P2/research/reflection-code-patterns.md +0 -1205
  382. package/plan/P1P2/research/reflection-decision-matrix.md +0 -421
  383. package/plan/P1P2/research/reflection-implementation-guide.md +0 -1341
  384. package/plan/P1P2/research/reflection-integration-guide.md +0 -834
  385. package/plan/P1P2/research/reflection-patterns.md +0 -1468
  386. package/plan/P1P2/research/reflection-quick-reference.md +0 -558
  387. package/plan/P1P2/research/zod-schema.md +0 -152
  388. package/plan/P3P4/PRP.md +0 -1388
  389. package/plan/P3P4/research/caching-lru.md +0 -116
  390. package/plan/P3P4/research/introspection-tools.md +0 -177
  391. package/plan/P3P4/research/reflection-patterns.md +0 -117
  392. package/plan/P4P5/PRP.md +0 -1136
  393. package/plan/P4P5/research/RESEARCH_SUMMARY.md +0 -151
  394. package/plan/architecture/external_deps.md +0 -358
  395. package/plan/architecture/system_context.md +0 -242
  396. package/plan/backlog.json +0 -867
  397. package/plan/research/INTROSPECTION_RESEARCH_SUMMARY.md +0 -378
  398. package/plan/research/README-INTROSPECTION.md +0 -352
  399. package/plan/research/agent-introspection-patterns.md +0 -1085
  400. package/plan/research/introspection-security-guide.md +0 -928
  401. package/plan/research/introspection-tool-examples.md +0 -875
  402. package/scripts/generate-llms-full.ts +0 -206
  403. package/src/__tests__/integration/agent-workflow.test.ts +0 -256
  404. package/src/__tests__/integration/tree-mirroring.test.ts +0 -114
  405. package/src/__tests__/unit/agent.test.ts +0 -169
  406. package/src/__tests__/unit/cache-key.test.ts +0 -182
  407. package/src/__tests__/unit/cache.test.ts +0 -172
  408. package/src/__tests__/unit/context.test.ts +0 -138
  409. package/src/__tests__/unit/decorators.test.ts +0 -100
  410. package/src/__tests__/unit/introspection-tools.test.ts +0 -277
  411. package/src/__tests__/unit/prompt.test.ts +0 -135
  412. package/src/__tests__/unit/reflection.test.ts +0 -210
  413. package/src/__tests__/unit/tree-debugger.test.ts +0 -85
  414. package/src/__tests__/unit/workflow.test.ts +0 -81
  415. package/src/cache/cache-key.ts +0 -244
  416. package/src/cache/cache.ts +0 -236
  417. package/src/core/agent.ts +0 -573
  418. package/src/core/event-tree.ts +0 -260
  419. package/src/core/logger.ts +0 -87
  420. package/src/core/mcp-handler.ts +0 -184
  421. package/src/core/prompt.ts +0 -150
  422. package/src/core/workflow-context.ts +0 -349
  423. package/src/core/workflow.ts +0 -302
  424. package/src/debugger/tree-debugger.ts +0 -210
  425. package/src/decorators/observed-state.ts +0 -95
  426. package/src/decorators/step.ts +0 -139
  427. package/src/decorators/task.ts +0 -96
  428. package/src/examples/tdd-orchestrator.ts +0 -65
  429. package/src/examples/test-cycle-workflow.ts +0 -64
  430. package/src/index.ts +0 -140
  431. package/src/reflection/reflection.ts +0 -407
  432. package/src/tools/index.ts +0 -36
  433. package/src/tools/introspection.ts +0 -464
  434. package/src/types/agent.ts +0 -90
  435. package/src/types/decorators.ts +0 -25
  436. package/src/types/error-strategy.ts +0 -13
  437. package/src/types/error.ts +0 -20
  438. package/src/types/events.ts +0 -74
  439. package/src/types/index.ts +0 -55
  440. package/src/types/logging.ts +0 -24
  441. package/src/types/observer.ts +0 -18
  442. package/src/types/prompt.ts +0 -40
  443. package/src/types/reflection.ts +0 -117
  444. package/src/types/sdk-primitives.ts +0 -128
  445. package/src/types/workflow-context.ts +0 -163
  446. package/src/types/workflow.ts +0 -37
  447. package/src/utils/id.ts +0 -11
  448. package/src/utils/observable.ts +0 -77
  449. package/tasks.json +0 -0
  450. package/tsconfig.json +0 -22
  451. package/vitest.config.ts +0 -16
@@ -0,0 +1,3 @@
1
+ export { TestCycleWorkflow } from './test-cycle-workflow.js';
2
+ export { TDDOrchestrator } from './tdd-orchestrator.js';
3
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/examples/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}
@@ -1,2 +1,3 @@
1
1
  export { TestCycleWorkflow } from './test-cycle-workflow.js';
2
2
  export { TDDOrchestrator } from './tdd-orchestrator.js';
3
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/examples/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}
@@ -0,0 +1,15 @@
1
+ import { Workflow } from '../core/workflow.js';
2
+ import { TestCycleWorkflow } from './test-cycle-workflow.js';
3
+ /**
4
+ * Example parent workflow demonstrating TDD orchestration
5
+ */
6
+ export declare class TDDOrchestrator extends Workflow {
7
+ cycleCount: number;
8
+ maxCycles: number;
9
+ apiKey: string;
10
+ setupEnvironment(): Promise<void>;
11
+ runCycle(): Promise<TestCycleWorkflow>;
12
+ run(): Promise<void>;
13
+ private delay;
14
+ }
15
+ //# sourceMappingURL=tdd-orchestrator.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tdd-orchestrator.d.ts","sourceRoot":"","sources":["../../src/examples/tdd-orchestrator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAI/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D;;GAEG;AACH,qBAAa,eAAgB,SAAQ,QAAQ;IAE3C,UAAU,EAAE,MAAM,CAAK;IAGvB,SAAS,EAAE,MAAM,CAAK;IAGtB,MAAM,EAAE,MAAM,CAAgB;IAGxB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAQjC,QAAQ,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAMtC,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IA2B1B,OAAO,CAAC,KAAK;CAGd"}
@@ -0,0 +1,121 @@
1
+ var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
2
+ var useValue = arguments.length > 2;
3
+ for (var i = 0; i < initializers.length; i++) {
4
+ value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
5
+ }
6
+ return useValue ? value : void 0;
7
+ };
8
+ var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
9
+ function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
10
+ var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
11
+ var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
12
+ var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
13
+ var _, done = false;
14
+ for (var i = decorators.length - 1; i >= 0; i--) {
15
+ var context = {};
16
+ for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
17
+ for (var p in contextIn.access) context.access[p] = contextIn.access[p];
18
+ context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
19
+ var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
20
+ if (kind === "accessor") {
21
+ if (result === void 0) continue;
22
+ if (result === null || typeof result !== "object") throw new TypeError("Object expected");
23
+ if (_ = accept(result.get)) descriptor.get = _;
24
+ if (_ = accept(result.set)) descriptor.set = _;
25
+ if (_ = accept(result.init)) initializers.unshift(_);
26
+ }
27
+ else if (_ = accept(result)) {
28
+ if (kind === "field") initializers.unshift(_);
29
+ else descriptor[key] = _;
30
+ }
31
+ }
32
+ if (target) Object.defineProperty(target, contextIn.name, descriptor);
33
+ done = true;
34
+ };
35
+ import { Workflow } from '../core/workflow.js';
36
+ import { Step } from '../decorators/step.js';
37
+ import { Task } from '../decorators/task.js';
38
+ import { ObservedState } from '../decorators/observed-state.js';
39
+ import { TestCycleWorkflow } from './test-cycle-workflow.js';
40
+ /**
41
+ * Example parent workflow demonstrating TDD orchestration
42
+ */
43
+ let TDDOrchestrator = (() => {
44
+ let _classSuper = Workflow;
45
+ let _instanceExtraInitializers = [];
46
+ let _cycleCount_decorators;
47
+ let _cycleCount_initializers = [];
48
+ let _cycleCount_extraInitializers = [];
49
+ let _maxCycles_decorators;
50
+ let _maxCycles_initializers = [];
51
+ let _maxCycles_extraInitializers = [];
52
+ let _apiKey_decorators;
53
+ let _apiKey_initializers = [];
54
+ let _apiKey_extraInitializers = [];
55
+ let _setupEnvironment_decorators;
56
+ let _runCycle_decorators;
57
+ return class TDDOrchestrator extends _classSuper {
58
+ static {
59
+ const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
60
+ _cycleCount_decorators = [ObservedState()];
61
+ _maxCycles_decorators = [ObservedState()];
62
+ _apiKey_decorators = [ObservedState({ redact: true })];
63
+ _setupEnvironment_decorators = [Step({ logStart: true, logFinish: true })];
64
+ _runCycle_decorators = [Task()];
65
+ __esDecorate(this, null, _setupEnvironment_decorators, { kind: "method", name: "setupEnvironment", static: false, private: false, access: { has: obj => "setupEnvironment" in obj, get: obj => obj.setupEnvironment }, metadata: _metadata }, null, _instanceExtraInitializers);
66
+ __esDecorate(this, null, _runCycle_decorators, { kind: "method", name: "runCycle", static: false, private: false, access: { has: obj => "runCycle" in obj, get: obj => obj.runCycle }, metadata: _metadata }, null, _instanceExtraInitializers);
67
+ __esDecorate(null, null, _cycleCount_decorators, { kind: "field", name: "cycleCount", static: false, private: false, access: { has: obj => "cycleCount" in obj, get: obj => obj.cycleCount, set: (obj, value) => { obj.cycleCount = value; } }, metadata: _metadata }, _cycleCount_initializers, _cycleCount_extraInitializers);
68
+ __esDecorate(null, null, _maxCycles_decorators, { kind: "field", name: "maxCycles", static: false, private: false, access: { has: obj => "maxCycles" in obj, get: obj => obj.maxCycles, set: (obj, value) => { obj.maxCycles = value; } }, metadata: _metadata }, _maxCycles_initializers, _maxCycles_extraInitializers);
69
+ __esDecorate(null, null, _apiKey_decorators, { kind: "field", name: "apiKey", static: false, private: false, access: { has: obj => "apiKey" in obj, get: obj => obj.apiKey, set: (obj, value) => { obj.apiKey = value; } }, metadata: _metadata }, _apiKey_initializers, _apiKey_extraInitializers);
70
+ if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
71
+ }
72
+ cycleCount = (__runInitializers(this, _instanceExtraInitializers), __runInitializers(this, _cycleCount_initializers, 0));
73
+ maxCycles = (__runInitializers(this, _cycleCount_extraInitializers), __runInitializers(this, _maxCycles_initializers, 3));
74
+ apiKey = (__runInitializers(this, _maxCycles_extraInitializers), __runInitializers(this, _apiKey_initializers, 'secret-key'));
75
+ async setupEnvironment() {
76
+ this.logger.info('Setting up TDD environment');
77
+ // Simulate environment setup
78
+ await this.delay(50);
79
+ this.logger.debug('Environment ready');
80
+ }
81
+ async runCycle() {
82
+ this.cycleCount++;
83
+ this.logger.info(`Starting cycle ${this.cycleCount}/${this.maxCycles}`);
84
+ return new TestCycleWorkflow(`Cycle-${this.cycleCount}`, this);
85
+ }
86
+ async run() {
87
+ this.setStatus('running');
88
+ this.logger.info('TDD Orchestrator starting');
89
+ try {
90
+ await this.setupEnvironment();
91
+ while (this.cycleCount < this.maxCycles) {
92
+ try {
93
+ const cycle = await this.runCycle();
94
+ await cycle.run();
95
+ this.logger.info(`Cycle ${this.cycleCount} completed successfully`);
96
+ }
97
+ catch (error) {
98
+ this.logger.warn(`Cycle ${this.cycleCount} failed, continuing...`);
99
+ // In real implementation, analyze error and potentially restart
100
+ }
101
+ }
102
+ this.setStatus('completed');
103
+ this.logger.info('TDD Orchestrator completed all cycles');
104
+ }
105
+ catch (error) {
106
+ this.setStatus('failed');
107
+ this.logger.error('TDD Orchestrator failed', { error });
108
+ throw error;
109
+ }
110
+ }
111
+ delay(ms) {
112
+ return new Promise((resolve) => setTimeout(resolve, ms));
113
+ }
114
+ constructor() {
115
+ super(...arguments);
116
+ __runInitializers(this, _apiKey_extraInitializers);
117
+ }
118
+ };
119
+ })();
120
+ export { TDDOrchestrator };
121
+ //# sourceMappingURL=tdd-orchestrator.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tdd-orchestrator.js","sourceRoot":"","sources":["../../src/examples/tdd-orchestrator.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,14 @@
1
+ import { Workflow } from '../core/workflow.js';
2
+ /**
3
+ * Example child workflow demonstrating test cycle
4
+ */
5
+ export declare class TestCycleWorkflow extends Workflow {
6
+ currentTest: string;
7
+ testResult: 'pending' | 'passed' | 'failed';
8
+ generateTest(): Promise<string>;
9
+ runTest(): Promise<boolean>;
10
+ updateImplementation(): Promise<void>;
11
+ run(): Promise<void>;
12
+ private delay;
13
+ }
14
+ //# sourceMappingURL=test-cycle-workflow.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"test-cycle-workflow.d.ts","sourceRoot":"","sources":["../../src/examples/test-cycle-workflow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAI/C;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,QAAQ;IAE7C,WAAW,EAAE,MAAM,CAAM;IAGzB,UAAU,EAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAa;IAGlD,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;IAS/B,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;IAiB3B,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;IAKrC,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAc1B,OAAO,CAAC,KAAK;CAGd"}
@@ -0,0 +1,116 @@
1
+ var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
2
+ var useValue = arguments.length > 2;
3
+ for (var i = 0; i < initializers.length; i++) {
4
+ value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
5
+ }
6
+ return useValue ? value : void 0;
7
+ };
8
+ var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
9
+ function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
10
+ var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
11
+ var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
12
+ var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
13
+ var _, done = false;
14
+ for (var i = decorators.length - 1; i >= 0; i--) {
15
+ var context = {};
16
+ for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
17
+ for (var p in contextIn.access) context.access[p] = contextIn.access[p];
18
+ context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
19
+ var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
20
+ if (kind === "accessor") {
21
+ if (result === void 0) continue;
22
+ if (result === null || typeof result !== "object") throw new TypeError("Object expected");
23
+ if (_ = accept(result.get)) descriptor.get = _;
24
+ if (_ = accept(result.set)) descriptor.set = _;
25
+ if (_ = accept(result.init)) initializers.unshift(_);
26
+ }
27
+ else if (_ = accept(result)) {
28
+ if (kind === "field") initializers.unshift(_);
29
+ else descriptor[key] = _;
30
+ }
31
+ }
32
+ if (target) Object.defineProperty(target, contextIn.name, descriptor);
33
+ done = true;
34
+ };
35
+ import { Workflow } from '../core/workflow.js';
36
+ import { Step } from '../decorators/step.js';
37
+ import { ObservedState } from '../decorators/observed-state.js';
38
+ /**
39
+ * Example child workflow demonstrating test cycle
40
+ */
41
+ let TestCycleWorkflow = (() => {
42
+ let _classSuper = Workflow;
43
+ let _instanceExtraInitializers = [];
44
+ let _currentTest_decorators;
45
+ let _currentTest_initializers = [];
46
+ let _currentTest_extraInitializers = [];
47
+ let _testResult_decorators;
48
+ let _testResult_initializers = [];
49
+ let _testResult_extraInitializers = [];
50
+ let _generateTest_decorators;
51
+ let _runTest_decorators;
52
+ let _updateImplementation_decorators;
53
+ return class TestCycleWorkflow extends _classSuper {
54
+ static {
55
+ const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
56
+ _currentTest_decorators = [ObservedState()];
57
+ _testResult_decorators = [ObservedState()];
58
+ _generateTest_decorators = [Step({ snapshotState: true, trackTiming: true, logStart: true })];
59
+ _runTest_decorators = [Step({ trackTiming: true })];
60
+ _updateImplementation_decorators = [Step({ snapshotState: true })];
61
+ __esDecorate(this, null, _generateTest_decorators, { kind: "method", name: "generateTest", static: false, private: false, access: { has: obj => "generateTest" in obj, get: obj => obj.generateTest }, metadata: _metadata }, null, _instanceExtraInitializers);
62
+ __esDecorate(this, null, _runTest_decorators, { kind: "method", name: "runTest", static: false, private: false, access: { has: obj => "runTest" in obj, get: obj => obj.runTest }, metadata: _metadata }, null, _instanceExtraInitializers);
63
+ __esDecorate(this, null, _updateImplementation_decorators, { kind: "method", name: "updateImplementation", static: false, private: false, access: { has: obj => "updateImplementation" in obj, get: obj => obj.updateImplementation }, metadata: _metadata }, null, _instanceExtraInitializers);
64
+ __esDecorate(null, null, _currentTest_decorators, { kind: "field", name: "currentTest", static: false, private: false, access: { has: obj => "currentTest" in obj, get: obj => obj.currentTest, set: (obj, value) => { obj.currentTest = value; } }, metadata: _metadata }, _currentTest_initializers, _currentTest_extraInitializers);
65
+ __esDecorate(null, null, _testResult_decorators, { kind: "field", name: "testResult", static: false, private: false, access: { has: obj => "testResult" in obj, get: obj => obj.testResult, set: (obj, value) => { obj.testResult = value; } }, metadata: _metadata }, _testResult_initializers, _testResult_extraInitializers);
66
+ if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
67
+ }
68
+ currentTest = (__runInitializers(this, _instanceExtraInitializers), __runInitializers(this, _currentTest_initializers, ''));
69
+ testResult = (__runInitializers(this, _currentTest_extraInitializers), __runInitializers(this, _testResult_initializers, 'pending'));
70
+ async generateTest() {
71
+ this.logger.info('Generating test case');
72
+ this.currentTest = `test_${Date.now()}`;
73
+ // Simulate test generation
74
+ await this.delay(100);
75
+ return this.currentTest;
76
+ }
77
+ async runTest() {
78
+ this.logger.info(`Running test: ${this.currentTest}`);
79
+ // Simulate test execution
80
+ await this.delay(200);
81
+ // Randomly pass or fail for demonstration
82
+ const passed = Math.random() > 0.3;
83
+ this.testResult = passed ? 'passed' : 'failed';
84
+ if (!passed) {
85
+ throw new Error(`Test ${this.currentTest} failed`);
86
+ }
87
+ return true;
88
+ }
89
+ async updateImplementation() {
90
+ this.logger.info('Updating implementation based on test results');
91
+ await this.delay(150);
92
+ }
93
+ async run() {
94
+ this.setStatus('running');
95
+ try {
96
+ await this.generateTest();
97
+ await this.runTest();
98
+ await this.updateImplementation();
99
+ this.setStatus('completed');
100
+ }
101
+ catch (error) {
102
+ this.setStatus('failed');
103
+ throw error;
104
+ }
105
+ }
106
+ delay(ms) {
107
+ return new Promise((resolve) => setTimeout(resolve, ms));
108
+ }
109
+ constructor() {
110
+ super(...arguments);
111
+ __runInitializers(this, _testResult_extraInitializers);
112
+ }
113
+ };
114
+ })();
115
+ export { TestCycleWorkflow };
116
+ //# sourceMappingURL=test-cycle-workflow.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"test-cycle-workflow.js","sourceRoot":"","sources":["../../src/examples/test-cycle-workflow.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAEhE;;GAEG;IACU,iBAAiB;sBAAS,QAAQ;;;;;;;;;;;iBAAlC,iBAAkB,SAAQ,WAAQ;;;uCAC5C,aAAa,EAAE;sCAGf,aAAa,EAAE;wCAGf,IAAI,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;mCAShE,IAAI,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;gDAiB3B,IAAI,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;YAzB9B,uLAAM,YAAY,6DAMjB;YAGD,wKAAM,OAAO,6DAcZ;YAGD,+MAAM,oBAAoB,6DAGzB;YAnCD,mLAAA,WAAW,6BAAX,WAAW,iGAAc;YAGzB,gLAAA,UAAU,6BAAV,UAAU,+FAA8C;;;QAHxD,WAAW,IAFA,mDAAiB,qDAEN,EAAE,GAAC;QAGzB,UAAU,+GAAoC,SAAS,GAAC;QAGxD,KAAK,CAAC,YAAY;YAChB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;YACzC,IAAI,CAAC,WAAW,GAAG,QAAQ,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;YACxC,2BAA2B;YAC3B,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACtB,OAAO,IAAI,CAAC,WAAW,CAAC;QAC1B,CAAC;QAGD,KAAK,CAAC,OAAO;YACX,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,iBAAiB,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;YACtD,0BAA0B;YAC1B,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAEtB,0CAA0C;YAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC;YACnC,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC;YAE/C,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,IAAI,KAAK,CAAC,QAAQ,IAAI,CAAC,WAAW,SAAS,CAAC,CAAC;YACrD,CAAC;YAED,OAAO,IAAI,CAAC;QACd,CAAC;QAGD,KAAK,CAAC,oBAAoB;YACxB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC;YAClE,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACxB,CAAC;QAED,KAAK,CAAC,GAAG;YACP,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;YAE1B,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;gBAC1B,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;gBACrB,MAAM,IAAI,CAAC,oBAAoB,EAAE,CAAC;gBAClC,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;YAC9B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;gBACzB,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;QAEO,KAAK,CAAC,EAAU;YACtB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;QAC3D,CAAC;;;;;;;SAvDU,iBAAiB"}
@@ -0,0 +1,27 @@
1
+ export type { WorkflowStatus, WorkflowNode, LogLevel, LogEntry, SerializedWorkflowState, StateFieldMetadata, WorkflowError, WorkflowEvent, WorkflowObserver, StepOptions, TaskOptions, ErrorMergeStrategy, Tool, ToolResult, MCPServer, Skill, HookHandler, PreToolUseContext, PostToolUseContext, SessionStartContext, SessionEndContext, AgentHooks, TokenUsage, AgentConfig, PromptOverrides, PromptConfig, WorkflowContext, WorkflowConfig, WorkflowResult, EventTreeHandle, EventNode, EventMetrics, AgentLike, PromptLike, ReflectionAPI, ReflectionConfig, ReflectionContext, ReflectionResult, ReflectionEntry, } from './types/index.js';
2
+ export { DEFAULT_REFLECTION_CONFIG, createReflectionConfig, } from './types/index.js';
3
+ export { Workflow, type WorkflowExecutor } from './core/workflow.js';
4
+ export { WorkflowLogger } from './core/logger.js';
5
+ export { Agent, type PromptResult } from './core/agent.js';
6
+ export { Prompt } from './core/prompt.js';
7
+ export { MCPHandler, type ToolExecutor } from './core/mcp-handler.js';
8
+ export { EventTreeHandleImpl, createEventTreeHandle } from './core/event-tree.js';
9
+ export { WorkflowContextImpl, createWorkflowContext } from './core/workflow-context.js';
10
+ export { getExecutionContext, requireExecutionContext, runInContext, runInContextSync, hasExecutionContext, createChildContext, agentExecutionStorage, type AgentExecutionContext, } from './core/context.js';
11
+ export { Step } from './decorators/step.js';
12
+ export { Task } from './decorators/task.js';
13
+ export { ObservedState, getObservedState } from './decorators/observed-state.js';
14
+ export { WorkflowTreeDebugger } from './debugger/tree-debugger.js';
15
+ export { Observable } from './utils/observable.js';
16
+ export type { Subscription, Observer } from './utils/observable.js';
17
+ export { generateId } from './utils/id.js';
18
+ export { mergeWorkflowErrors } from './utils/workflow-error-utils.js';
19
+ export { createWorkflow, createAgent, createPrompt, quickWorkflow, quickAgent, } from './core/factory.js';
20
+ export { LLMCache, defaultCache } from './cache/cache.js';
21
+ export { generateCacheKey, deterministicStringify, getSchemaHash } from './cache/cache-key.js';
22
+ export type { CacheConfig, CacheMetrics } from './cache/cache.js';
23
+ export type { CacheKeyInputs } from './cache/cache-key.js';
24
+ export { ReflectionManager, executeWithReflection } from './reflection/reflection.js';
25
+ export { INTROSPECTION_TOOLS, INTROSPECTION_HANDLERS, registerIntrospectionTools, executeIntrospectionTool, inspectCurrentNodeTool, readAncestorChainTool, listSiblingsChildrenTool, inspectPriorOutputsTool, inspectCacheStatusTool, requestSpawnWorkflowTool, handleInspectCurrentNode, handleReadAncestorChain, handleListSiblingsChildren, handleInspectPriorOutputs, handleInspectCacheStatus, handleRequestSpawnWorkflow, } from './tools/introspection.js';
26
+ export type { CurrentNodeInfo, AncestorInfo, AncestorChainResult, NodeInfo, SiblingsChildrenResult, PriorOutputInfo, CacheStatusResult, SpawnWorkflowRequest, } from './tools/introspection.js';
27
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
package/dist/index.js ADDED
@@ -0,0 +1,40 @@
1
+ // Re-export reflection utilities
2
+ export { DEFAULT_REFLECTION_CONFIG, createReflectionConfig, } from './types/index.js';
3
+ // Core classes
4
+ export { Workflow } from './core/workflow.js';
5
+ export { WorkflowLogger } from './core/logger.js';
6
+ export { Agent } from './core/agent.js';
7
+ export { Prompt } from './core/prompt.js';
8
+ export { MCPHandler } from './core/mcp-handler.js';
9
+ // Context and event tree
10
+ export { EventTreeHandleImpl, createEventTreeHandle } from './core/event-tree.js';
11
+ export { WorkflowContextImpl, createWorkflowContext } from './core/workflow-context.js';
12
+ export { getExecutionContext, requireExecutionContext, runInContext, runInContextSync, hasExecutionContext, createChildContext, agentExecutionStorage, } from './core/context.js';
13
+ // Decorators
14
+ export { Step } from './decorators/step.js';
15
+ export { Task } from './decorators/task.js';
16
+ export { ObservedState, getObservedState } from './decorators/observed-state.js';
17
+ // Debugger
18
+ export { WorkflowTreeDebugger } from './debugger/tree-debugger.js';
19
+ // Utilities
20
+ export { Observable } from './utils/observable.js';
21
+ export { generateId } from './utils/id.js';
22
+ export { mergeWorkflowErrors } from './utils/workflow-error-utils.js';
23
+ // Factory functions
24
+ export { createWorkflow, createAgent, createPrompt, quickWorkflow, quickAgent, } from './core/factory.js';
25
+ // Cache
26
+ export { LLMCache, defaultCache } from './cache/cache.js';
27
+ export { generateCacheKey, deterministicStringify, getSchemaHash } from './cache/cache-key.js';
28
+ // Reflection
29
+ export { ReflectionManager, executeWithReflection } from './reflection/reflection.js';
30
+ // Introspection Tools
31
+ export { INTROSPECTION_TOOLS, INTROSPECTION_HANDLERS, registerIntrospectionTools, executeIntrospectionTool,
32
+ // Individual tools
33
+ inspectCurrentNodeTool, readAncestorChainTool, listSiblingsChildrenTool, inspectPriorOutputsTool, inspectCacheStatusTool, requestSpawnWorkflowTool,
34
+ // Handlers
35
+ handleInspectCurrentNode, handleReadAncestorChain, handleListSiblingsChildren, handleInspectPriorOutputs, handleInspectCacheStatus, handleRequestSpawnWorkflow, } from './tools/introspection.js';
36
+ // Examples (for reference)
37
+ // Temporarily commented out due to decorator compatibility issues with vitest
38
+ // export { TestCycleWorkflow } from './examples/test-cycle-workflow.js';
39
+ // export { TDDOrchestrator } from './examples/tdd-orchestrator.js';
40
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA+CA,iCAAiC;AACjC,OAAO,EACL,yBAAyB,EACzB,sBAAsB,GACvB,MAAM,kBAAkB,CAAC;AAE1B,eAAe;AACf,OAAO,EAAE,QAAQ,EAAyB,MAAM,oBAAoB,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,KAAK,EAAqB,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAqB,MAAM,uBAAuB,CAAC;AAEtE,yBAAyB;AACzB,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAClF,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACxF,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,YAAY,EACZ,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,GAEtB,MAAM,mBAAmB,CAAC;AAE3B,aAAa;AACb,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAEjF,WAAW;AACX,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAEnE,YAAY;AACZ,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAEnD,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAEtE,oBAAoB;AACpB,OAAO,EACL,cAAc,EACd,WAAW,EACX,YAAY,EACZ,aAAa,EACb,UAAU,GACX,MAAM,mBAAmB,CAAC;AAE3B,QAAQ;AACR,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAI/F,aAAa;AACb,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAEtF,sBAAsB;AACtB,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,0BAA0B,EAC1B,wBAAwB;AACxB,mBAAmB;AACnB,sBAAsB,EACtB,qBAAqB,EACrB,wBAAwB,EACxB,uBAAuB,EACvB,sBAAsB,EACtB,wBAAwB;AACxB,WAAW;AACX,wBAAwB,EACxB,uBAAuB,EACvB,0BAA0B,EAC1B,yBAAyB,EACzB,wBAAwB,EACxB,0BAA0B,GAC3B,MAAM,0BAA0B,CAAC;AAYlC,2BAA2B;AAC3B,8EAA8E;AAC9E,yEAAyE;AACzE,oEAAoE"}
@@ -0,0 +1,5 @@
1
+ /**
2
+ * Reflection module exports
3
+ */
4
+ export { ReflectionManager, executeWithReflection } from './reflection.js';
5
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/reflection/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC"}
@@ -1,5 +1,5 @@
1
1
  /**
2
2
  * Reflection module exports
3
3
  */
4
-
5
4
  export { ReflectionManager, executeWithReflection } from './reflection.js';
5
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/reflection/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC"}
@@ -0,0 +1,84 @@
1
+ /**
2
+ * ReflectionManager - Implements reflection and self-correction for agents
3
+ *
4
+ * Provides multi-level reflection (workflow, agent, prompt) with configurable
5
+ * retry limits and history tracking.
6
+ */
7
+ import type { ReflectionAPI, ReflectionConfig, ReflectionContext, ReflectionResult, ReflectionEntry, WorkflowEvent } from '../types/index.js';
8
+ import type { Agent } from '../core/agent.js';
9
+ /**
10
+ * ReflectionManager - Manages reflection and self-correction
11
+ */
12
+ export declare class ReflectionManager implements ReflectionAPI {
13
+ private readonly config;
14
+ private readonly history;
15
+ private readonly agent?;
16
+ private eventEmitter?;
17
+ /**
18
+ * Create a new ReflectionManager
19
+ * @param config Reflection configuration
20
+ * @param agent Optional agent to use for reflection analysis
21
+ */
22
+ constructor(config: ReflectionConfig, agent?: Agent);
23
+ /**
24
+ * Set the event emitter for workflow events
25
+ */
26
+ setEventEmitter(emitter: (event: WorkflowEvent) => void): void;
27
+ /**
28
+ * Check if reflection is enabled
29
+ */
30
+ isEnabled(): boolean;
31
+ /**
32
+ * Get the maximum number of attempts
33
+ */
34
+ getMaxAttempts(): number;
35
+ /**
36
+ * Get the retry delay in milliseconds
37
+ */
38
+ getRetryDelayMs(): number;
39
+ /**
40
+ * Trigger a reflection on the current context
41
+ */
42
+ triggerReflection(reason?: string): Promise<void>;
43
+ /**
44
+ * Get the history of reflection attempts
45
+ */
46
+ getReflectionHistory(): ReflectionEntry[];
47
+ /**
48
+ * Perform reflection analysis on an error
49
+ */
50
+ reflect(context: ReflectionContext): Promise<ReflectionResult>;
51
+ /**
52
+ * Mark the last reflection entry as successful
53
+ */
54
+ markLastReflectionSuccessful(): void;
55
+ /**
56
+ * Check if an error is non-retryable
57
+ */
58
+ private isNonRetryableError;
59
+ /**
60
+ * Perform reflection using an agent
61
+ */
62
+ private reflectWithAgent;
63
+ /**
64
+ * Perform reflection using simple heuristics
65
+ */
66
+ private reflectWithHeuristics;
67
+ /**
68
+ * Build the reflection prompt from context
69
+ */
70
+ private buildReflectionPrompt;
71
+ /**
72
+ * Helper to create a delay
73
+ */
74
+ private delay;
75
+ }
76
+ /**
77
+ * Execute a function with reflection support
78
+ * @param fn Function to execute
79
+ * @param reflection ReflectionManager instance
80
+ * @param createContext Function to create reflection context from error
81
+ * @returns Result of the function
82
+ */
83
+ export declare function executeWithReflection<T>(fn: () => Promise<T>, reflection: ReflectionManager, createContext: (error: Error, attempt: number, history: ReflectionEntry[]) => ReflectionContext): Promise<T>;
84
+ //# sourceMappingURL=reflection.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"reflection.d.ts","sourceRoot":"","sources":["../../src/reflection/reflection.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,aAAa,EACd,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAgD9C;;GAEG;AACH,qBAAa,iBAAkB,YAAW,aAAa;IACrD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAC1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;IACjD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAQ;IAC/B,OAAO,CAAC,YAAY,CAAC,CAAiC;IAEtD;;;;OAIG;gBACS,MAAM,EAAE,gBAAgB,EAAE,KAAK,CAAC,EAAE,KAAK;IAKnD;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,GAAG,IAAI;IAI9D;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;OAEG;IACH,eAAe,IAAI,MAAM;IAIzB;;OAEG;IACG,iBAAiB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBvD;;OAEG;IACH,oBAAoB,IAAI,eAAe,EAAE;IAIzC;;OAEG;IACG,OAAO,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA0DpE;;OAEG;IACH,4BAA4B,IAAI,IAAI;IAMpC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAmC3B;;OAEG;YACW,gBAAgB;IAiC9B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAsC7B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAqB7B;;OAEG;IACH,OAAO,CAAC,KAAK;CAGd;AAED;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CAAC,CAAC,EAC3C,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,UAAU,EAAE,iBAAiB,EAC7B,aAAa,EAAE,CACb,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,eAAe,EAAE,KACvB,iBAAiB,GACrB,OAAO,CAAC,CAAC,CAAC,CAoCZ"}