groundswell 0.0.3 → 1.0.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 (292) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +26 -9
  3. package/dist/cache/cache-key.d.ts +20 -0
  4. package/dist/cache/cache-key.d.ts.map +1 -1
  5. package/dist/cache/cache-key.js +9 -0
  6. package/dist/cache/cache-key.js.map +1 -1
  7. package/dist/core/agent.d.ts +120 -29
  8. package/dist/core/agent.d.ts.map +1 -1
  9. package/dist/core/agent.js +584 -177
  10. package/dist/core/agent.js.map +1 -1
  11. package/dist/core/mcp-handler.d.ts +63 -5
  12. package/dist/core/mcp-handler.d.ts.map +1 -1
  13. package/dist/core/mcp-handler.js +184 -4
  14. package/dist/core/mcp-handler.js.map +1 -1
  15. package/dist/core/workflow-context.d.ts +6 -2
  16. package/dist/core/workflow-context.d.ts.map +1 -1
  17. package/dist/core/workflow-context.js +99 -4
  18. package/dist/core/workflow-context.js.map +1 -1
  19. package/dist/core/workflow.d.ts +315 -13
  20. package/dist/core/workflow.d.ts.map +1 -1
  21. package/dist/core/workflow.js +552 -30
  22. package/dist/core/workflow.js.map +1 -1
  23. package/dist/debugger/event-replayer.d.ts +422 -0
  24. package/dist/debugger/event-replayer.d.ts.map +1 -0
  25. package/dist/debugger/event-replayer.js +639 -0
  26. package/dist/debugger/event-replayer.js.map +1 -0
  27. package/dist/debugger/tree-debugger.d.ts +170 -1
  28. package/dist/debugger/tree-debugger.d.ts.map +1 -1
  29. package/dist/debugger/tree-debugger.js +423 -1
  30. package/dist/debugger/tree-debugger.js.map +1 -1
  31. package/dist/decorators/step.d.ts.map +1 -1
  32. package/dist/decorators/step.js +129 -47
  33. package/dist/decorators/step.js.map +1 -1
  34. package/dist/harnesses/claude-code-harness.d.ts +391 -0
  35. package/dist/harnesses/claude-code-harness.d.ts.map +1 -0
  36. package/dist/harnesses/claude-code-harness.js +1076 -0
  37. package/dist/harnesses/claude-code-harness.js.map +1 -0
  38. package/dist/harnesses/harness-registry.d.ts +440 -0
  39. package/dist/harnesses/harness-registry.d.ts.map +1 -0
  40. package/dist/harnesses/harness-registry.js +543 -0
  41. package/dist/harnesses/harness-registry.js.map +1 -0
  42. package/dist/harnesses/index.d.ts +12 -0
  43. package/dist/harnesses/index.d.ts.map +1 -0
  44. package/dist/harnesses/index.js +11 -0
  45. package/dist/harnesses/index.js.map +1 -0
  46. package/dist/harnesses/pi-harness.d.ts +219 -0
  47. package/dist/harnesses/pi-harness.d.ts.map +1 -0
  48. package/dist/harnesses/pi-harness.js +676 -0
  49. package/dist/harnesses/pi-harness.js.map +1 -0
  50. package/dist/harnesses/pi-schema-converter.d.ts +24 -0
  51. package/dist/harnesses/pi-schema-converter.d.ts.map +1 -0
  52. package/dist/harnesses/pi-schema-converter.js +81 -0
  53. package/dist/harnesses/pi-schema-converter.js.map +1 -0
  54. package/dist/harnesses/register-defaults.d.ts +24 -0
  55. package/dist/harnesses/register-defaults.d.ts.map +1 -0
  56. package/dist/harnesses/register-defaults.js +40 -0
  57. package/dist/harnesses/register-defaults.js.map +1 -0
  58. package/dist/harnesses/session-store.d.ts +201 -0
  59. package/dist/harnesses/session-store.d.ts.map +1 -0
  60. package/dist/harnesses/session-store.js +254 -0
  61. package/dist/harnesses/session-store.js.map +1 -0
  62. package/dist/index.d.ts +12 -2
  63. package/dist/index.d.ts.map +1 -1
  64. package/dist/index.js +17 -0
  65. package/dist/index.js.map +1 -1
  66. package/dist/reflection/reflection.d.ts.map +1 -1
  67. package/dist/reflection/reflection.js +19 -4
  68. package/dist/reflection/reflection.js.map +1 -1
  69. package/dist/types/agent.d.ts +1253 -2
  70. package/dist/types/agent.d.ts.map +1 -1
  71. package/dist/types/agent.js +418 -1
  72. package/dist/types/agent.js.map +1 -1
  73. package/dist/types/decorators.d.ts +10 -1
  74. package/dist/types/decorators.d.ts.map +1 -1
  75. package/dist/types/events.d.ts +26 -0
  76. package/dist/types/events.d.ts.map +1 -1
  77. package/dist/types/harnesses.d.ts +474 -0
  78. package/dist/types/harnesses.d.ts.map +1 -0
  79. package/dist/types/harnesses.js +2 -0
  80. package/dist/types/harnesses.js.map +1 -0
  81. package/dist/types/index.d.ts +9 -1
  82. package/dist/types/index.d.ts.map +1 -1
  83. package/dist/types/index.js +6 -0
  84. package/dist/types/index.js.map +1 -1
  85. package/dist/types/providers.d.ts +691 -0
  86. package/dist/types/providers.d.ts.map +1 -0
  87. package/dist/types/providers.js +14 -0
  88. package/dist/types/providers.js.map +1 -0
  89. package/dist/types/restart.d.ts +132 -0
  90. package/dist/types/restart.d.ts.map +1 -0
  91. package/dist/types/restart.js +2 -0
  92. package/dist/types/restart.js.map +1 -0
  93. package/dist/types/streaming.d.ts +194 -0
  94. package/dist/types/streaming.d.ts.map +1 -0
  95. package/dist/types/streaming.js +67 -0
  96. package/dist/types/streaming.js.map +1 -0
  97. package/dist/types/workflow-context.d.ts +137 -1
  98. package/dist/types/workflow-context.d.ts.map +1 -1
  99. package/dist/utils/agent-validation.d.ts +88 -0
  100. package/dist/utils/agent-validation.d.ts.map +1 -0
  101. package/dist/utils/agent-validation.js +87 -0
  102. package/dist/utils/agent-validation.js.map +1 -0
  103. package/dist/utils/delay.d.ts +7 -0
  104. package/dist/utils/delay.d.ts.map +1 -0
  105. package/dist/utils/delay.js +9 -0
  106. package/dist/utils/delay.js.map +1 -0
  107. package/dist/utils/harness-config.d.ts +180 -0
  108. package/dist/utils/harness-config.d.ts.map +1 -0
  109. package/dist/utils/harness-config.js +311 -0
  110. package/dist/utils/harness-config.js.map +1 -0
  111. package/dist/utils/index.d.ts +9 -1
  112. package/dist/utils/index.d.ts.map +1 -1
  113. package/dist/utils/index.js +8 -1
  114. package/dist/utils/index.js.map +1 -1
  115. package/dist/utils/model-spec.d.ts +110 -0
  116. package/dist/utils/model-spec.d.ts.map +1 -0
  117. package/dist/utils/model-spec.js +149 -0
  118. package/dist/utils/model-spec.js.map +1 -0
  119. package/dist/utils/provider-config.d.ts +10 -0
  120. package/dist/utils/provider-config.d.ts.map +1 -0
  121. package/dist/utils/provider-config.js +10 -0
  122. package/dist/utils/provider-config.js.map +1 -0
  123. package/dist/utils/restart-analysis.d.ts +202 -0
  124. package/dist/utils/restart-analysis.d.ts.map +1 -0
  125. package/dist/utils/restart-analysis.js +426 -0
  126. package/dist/utils/restart-analysis.js.map +1 -0
  127. package/dist/utils/session-serialization.d.ts +118 -0
  128. package/dist/utils/session-serialization.d.ts.map +1 -0
  129. package/dist/utils/session-serialization.js +217 -0
  130. package/dist/utils/session-serialization.js.map +1 -0
  131. package/package.json +31 -5
  132. package/CHANGELOG.md +0 -188
  133. package/dist/__tests__/adversarial/attachChild-performance.test.d.ts +0 -16
  134. package/dist/__tests__/adversarial/attachChild-performance.test.d.ts.map +0 -1
  135. package/dist/__tests__/adversarial/attachChild-performance.test.js +0 -187
  136. package/dist/__tests__/adversarial/attachChild-performance.test.js.map +0 -1
  137. package/dist/__tests__/adversarial/circular-reference.test.d.ts +0 -13
  138. package/dist/__tests__/adversarial/circular-reference.test.d.ts.map +0 -1
  139. package/dist/__tests__/adversarial/circular-reference.test.js +0 -92
  140. package/dist/__tests__/adversarial/circular-reference.test.js.map +0 -1
  141. package/dist/__tests__/adversarial/complex-circular-reference.test.d.ts +0 -16
  142. package/dist/__tests__/adversarial/complex-circular-reference.test.d.ts.map +0 -1
  143. package/dist/__tests__/adversarial/complex-circular-reference.test.js +0 -127
  144. package/dist/__tests__/adversarial/complex-circular-reference.test.js.map +0 -1
  145. package/dist/__tests__/adversarial/concurrent-task-failures.test.d.ts +0 -21
  146. package/dist/__tests__/adversarial/concurrent-task-failures.test.d.ts.map +0 -1
  147. package/dist/__tests__/adversarial/concurrent-task-failures.test.js +0 -667
  148. package/dist/__tests__/adversarial/concurrent-task-failures.test.js.map +0 -1
  149. package/dist/__tests__/adversarial/deep-analysis.test.d.ts +0 -6
  150. package/dist/__tests__/adversarial/deep-analysis.test.d.ts.map +0 -1
  151. package/dist/__tests__/adversarial/deep-analysis.test.js +0 -877
  152. package/dist/__tests__/adversarial/deep-analysis.test.js.map +0 -1
  153. package/dist/__tests__/adversarial/deep-hierarchy-stress.test.d.ts +0 -13
  154. package/dist/__tests__/adversarial/deep-hierarchy-stress.test.d.ts.map +0 -1
  155. package/dist/__tests__/adversarial/deep-hierarchy-stress.test.js +0 -186
  156. package/dist/__tests__/adversarial/deep-hierarchy-stress.test.js.map +0 -1
  157. package/dist/__tests__/adversarial/e2e-prd-validation.test.d.ts +0 -6
  158. package/dist/__tests__/adversarial/e2e-prd-validation.test.d.ts.map +0 -1
  159. package/dist/__tests__/adversarial/e2e-prd-validation.test.js +0 -626
  160. package/dist/__tests__/adversarial/e2e-prd-validation.test.js.map +0 -1
  161. package/dist/__tests__/adversarial/edge-case.test.d.ts +0 -6
  162. package/dist/__tests__/adversarial/edge-case.test.d.ts.map +0 -1
  163. package/dist/__tests__/adversarial/edge-case.test.js +0 -857
  164. package/dist/__tests__/adversarial/edge-case.test.js.map +0 -1
  165. package/dist/__tests__/adversarial/error-merge-strategy.test.d.ts +0 -20
  166. package/dist/__tests__/adversarial/error-merge-strategy.test.d.ts.map +0 -1
  167. package/dist/__tests__/adversarial/error-merge-strategy.test.js +0 -907
  168. package/dist/__tests__/adversarial/error-merge-strategy.test.js.map +0 -1
  169. package/dist/__tests__/adversarial/incremental-performance.test.d.ts +0 -2
  170. package/dist/__tests__/adversarial/incremental-performance.test.d.ts.map +0 -1
  171. package/dist/__tests__/adversarial/incremental-performance.test.js +0 -113
  172. package/dist/__tests__/adversarial/incremental-performance.test.js.map +0 -1
  173. package/dist/__tests__/adversarial/node-map-update-benchmarks.test.d.ts +0 -22
  174. package/dist/__tests__/adversarial/node-map-update-benchmarks.test.d.ts.map +0 -1
  175. package/dist/__tests__/adversarial/node-map-update-benchmarks.test.js +0 -383
  176. package/dist/__tests__/adversarial/node-map-update-benchmarks.test.js.map +0 -1
  177. package/dist/__tests__/adversarial/observer-propagation.test.d.ts +0 -21
  178. package/dist/__tests__/adversarial/observer-propagation.test.d.ts.map +0 -1
  179. package/dist/__tests__/adversarial/observer-propagation.test.js +0 -404
  180. package/dist/__tests__/adversarial/observer-propagation.test.js.map +0 -1
  181. package/dist/__tests__/adversarial/parent-validation.test.d.ts +0 -13
  182. package/dist/__tests__/adversarial/parent-validation.test.d.ts.map +0 -1
  183. package/dist/__tests__/adversarial/parent-validation.test.js +0 -128
  184. package/dist/__tests__/adversarial/parent-validation.test.js.map +0 -1
  185. package/dist/__tests__/adversarial/prd-12-2-compliance.test.d.ts +0 -20
  186. package/dist/__tests__/adversarial/prd-12-2-compliance.test.d.ts.map +0 -1
  187. package/dist/__tests__/adversarial/prd-12-2-compliance.test.js +0 -482
  188. package/dist/__tests__/adversarial/prd-12-2-compliance.test.js.map +0 -1
  189. package/dist/__tests__/adversarial/prd-compliance.test.d.ts +0 -6
  190. package/dist/__tests__/adversarial/prd-compliance.test.d.ts.map +0 -1
  191. package/dist/__tests__/adversarial/prd-compliance.test.js +0 -886
  192. package/dist/__tests__/adversarial/prd-compliance.test.js.map +0 -1
  193. package/dist/__tests__/compatibility/backward-compatibility.test.d.ts +0 -22
  194. package/dist/__tests__/compatibility/backward-compatibility.test.d.ts.map +0 -1
  195. package/dist/__tests__/compatibility/backward-compatibility.test.js +0 -1843
  196. package/dist/__tests__/compatibility/backward-compatibility.test.js.map +0 -1
  197. package/dist/__tests__/helpers/index.d.ts +0 -10
  198. package/dist/__tests__/helpers/index.d.ts.map +0 -1
  199. package/dist/__tests__/helpers/index.js +0 -10
  200. package/dist/__tests__/helpers/index.js.map +0 -1
  201. package/dist/__tests__/helpers/tree-verification.d.ts +0 -90
  202. package/dist/__tests__/helpers/tree-verification.d.ts.map +0 -1
  203. package/dist/__tests__/helpers/tree-verification.js +0 -202
  204. package/dist/__tests__/helpers/tree-verification.js.map +0 -1
  205. package/dist/__tests__/integration/agent-workflow.test.d.ts +0 -2
  206. package/dist/__tests__/integration/agent-workflow.test.d.ts.map +0 -1
  207. package/dist/__tests__/integration/agent-workflow.test.js +0 -256
  208. package/dist/__tests__/integration/agent-workflow.test.js.map +0 -1
  209. package/dist/__tests__/integration/bidirectional-consistency.test.d.ts +0 -14
  210. package/dist/__tests__/integration/bidirectional-consistency.test.d.ts.map +0 -1
  211. package/dist/__tests__/integration/bidirectional-consistency.test.js +0 -668
  212. package/dist/__tests__/integration/bidirectional-consistency.test.js.map +0 -1
  213. package/dist/__tests__/integration/observer-logging.test.d.ts +0 -2
  214. package/dist/__tests__/integration/observer-logging.test.d.ts.map +0 -1
  215. package/dist/__tests__/integration/observer-logging.test.js +0 -517
  216. package/dist/__tests__/integration/observer-logging.test.js.map +0 -1
  217. package/dist/__tests__/integration/tree-mirroring.test.d.ts +0 -2
  218. package/dist/__tests__/integration/tree-mirroring.test.d.ts.map +0 -1
  219. package/dist/__tests__/integration/tree-mirroring.test.js +0 -117
  220. package/dist/__tests__/integration/tree-mirroring.test.js.map +0 -1
  221. package/dist/__tests__/integration/workflow-reparenting.test.d.ts +0 -12
  222. package/dist/__tests__/integration/workflow-reparenting.test.d.ts.map +0 -1
  223. package/dist/__tests__/integration/workflow-reparenting.test.js +0 -239
  224. package/dist/__tests__/integration/workflow-reparenting.test.js.map +0 -1
  225. package/dist/__tests__/unit/agent.test.d.ts +0 -2
  226. package/dist/__tests__/unit/agent.test.d.ts.map +0 -1
  227. package/dist/__tests__/unit/agent.test.js +0 -143
  228. package/dist/__tests__/unit/agent.test.js.map +0 -1
  229. package/dist/__tests__/unit/cache-key.test.d.ts +0 -5
  230. package/dist/__tests__/unit/cache-key.test.d.ts.map +0 -1
  231. package/dist/__tests__/unit/cache-key.test.js +0 -145
  232. package/dist/__tests__/unit/cache-key.test.js.map +0 -1
  233. package/dist/__tests__/unit/cache.test.d.ts +0 -5
  234. package/dist/__tests__/unit/cache.test.d.ts.map +0 -1
  235. package/dist/__tests__/unit/cache.test.js +0 -132
  236. package/dist/__tests__/unit/cache.test.js.map +0 -1
  237. package/dist/__tests__/unit/context.test.d.ts +0 -2
  238. package/dist/__tests__/unit/context.test.d.ts.map +0 -1
  239. package/dist/__tests__/unit/context.test.js +0 -220
  240. package/dist/__tests__/unit/context.test.js.map +0 -1
  241. package/dist/__tests__/unit/decorators.test.d.ts +0 -2
  242. package/dist/__tests__/unit/decorators.test.d.ts.map +0 -1
  243. package/dist/__tests__/unit/decorators.test.js +0 -162
  244. package/dist/__tests__/unit/decorators.test.js.map +0 -1
  245. package/dist/__tests__/unit/introspection-tools.test.d.ts +0 -5
  246. package/dist/__tests__/unit/introspection-tools.test.d.ts.map +0 -1
  247. package/dist/__tests__/unit/introspection-tools.test.js +0 -191
  248. package/dist/__tests__/unit/introspection-tools.test.js.map +0 -1
  249. package/dist/__tests__/unit/logger.test.d.ts +0 -2
  250. package/dist/__tests__/unit/logger.test.d.ts.map +0 -1
  251. package/dist/__tests__/unit/logger.test.js +0 -241
  252. package/dist/__tests__/unit/logger.test.js.map +0 -1
  253. package/dist/__tests__/unit/observable.test.d.ts +0 -2
  254. package/dist/__tests__/unit/observable.test.d.ts.map +0 -1
  255. package/dist/__tests__/unit/observable.test.js +0 -251
  256. package/dist/__tests__/unit/observable.test.js.map +0 -1
  257. package/dist/__tests__/unit/prompt.test.d.ts +0 -2
  258. package/dist/__tests__/unit/prompt.test.d.ts.map +0 -1
  259. package/dist/__tests__/unit/prompt.test.js +0 -113
  260. package/dist/__tests__/unit/prompt.test.js.map +0 -1
  261. package/dist/__tests__/unit/reflection.test.d.ts +0 -5
  262. package/dist/__tests__/unit/reflection.test.d.ts.map +0 -1
  263. package/dist/__tests__/unit/reflection.test.js +0 -160
  264. package/dist/__tests__/unit/reflection.test.js.map +0 -1
  265. package/dist/__tests__/unit/tree-debugger-incremental.test.d.ts +0 -2
  266. package/dist/__tests__/unit/tree-debugger-incremental.test.d.ts.map +0 -1
  267. package/dist/__tests__/unit/tree-debugger-incremental.test.js +0 -136
  268. package/dist/__tests__/unit/tree-debugger-incremental.test.js.map +0 -1
  269. package/dist/__tests__/unit/tree-debugger.test.d.ts +0 -2
  270. package/dist/__tests__/unit/tree-debugger.test.d.ts.map +0 -1
  271. package/dist/__tests__/unit/tree-debugger.test.js +0 -69
  272. package/dist/__tests__/unit/tree-debugger.test.js.map +0 -1
  273. package/dist/__tests__/unit/utils/workflow-error-utils.test.d.ts +0 -2
  274. package/dist/__tests__/unit/utils/workflow-error-utils.test.d.ts.map +0 -1
  275. package/dist/__tests__/unit/utils/workflow-error-utils.test.js +0 -154
  276. package/dist/__tests__/unit/utils/workflow-error-utils.test.js.map +0 -1
  277. package/dist/__tests__/unit/workflow-detachChild.test.d.ts +0 -2
  278. package/dist/__tests__/unit/workflow-detachChild.test.d.ts.map +0 -1
  279. package/dist/__tests__/unit/workflow-detachChild.test.js +0 -76
  280. package/dist/__tests__/unit/workflow-detachChild.test.js.map +0 -1
  281. package/dist/__tests__/unit/workflow-emitEvent-childDetached.test.d.ts +0 -2
  282. package/dist/__tests__/unit/workflow-emitEvent-childDetached.test.d.ts.map +0 -1
  283. package/dist/__tests__/unit/workflow-emitEvent-childDetached.test.js +0 -122
  284. package/dist/__tests__/unit/workflow-emitEvent-childDetached.test.js.map +0 -1
  285. package/dist/__tests__/unit/workflow-isDescendantOf.test.d.ts +0 -2
  286. package/dist/__tests__/unit/workflow-isDescendantOf.test.d.ts.map +0 -1
  287. package/dist/__tests__/unit/workflow-isDescendantOf.test.js +0 -140
  288. package/dist/__tests__/unit/workflow-isDescendantOf.test.js.map +0 -1
  289. package/dist/__tests__/unit/workflow.test.d.ts +0 -2
  290. package/dist/__tests__/unit/workflow.test.d.ts.map +0 -1
  291. package/dist/__tests__/unit/workflow.test.js +0 -330
  292. package/dist/__tests__/unit/workflow.test.js.map +0 -1
@@ -1,857 +0,0 @@
1
- /**
2
- * Adversarial and Edge Case Tests for Hierarchical Workflow Engine
3
- * These tests explore potential bugs, edge cases, and PRD compliance issues
4
- */
5
- var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
6
- var useValue = arguments.length > 2;
7
- for (var i = 0; i < initializers.length; i++) {
8
- value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
9
- }
10
- return useValue ? value : void 0;
11
- };
12
- var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
13
- function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
14
- var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
15
- var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
16
- var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
17
- var _, done = false;
18
- for (var i = decorators.length - 1; i >= 0; i--) {
19
- var context = {};
20
- for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
21
- for (var p in contextIn.access) context.access[p] = contextIn.access[p];
22
- context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
23
- var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
24
- if (kind === "accessor") {
25
- if (result === void 0) continue;
26
- if (result === null || typeof result !== "object") throw new TypeError("Object expected");
27
- if (_ = accept(result.get)) descriptor.get = _;
28
- if (_ = accept(result.set)) descriptor.set = _;
29
- if (_ = accept(result.init)) initializers.unshift(_);
30
- }
31
- else if (_ = accept(result)) {
32
- if (kind === "field") initializers.unshift(_);
33
- else descriptor[key] = _;
34
- }
35
- }
36
- if (target) Object.defineProperty(target, contextIn.name, descriptor);
37
- done = true;
38
- };
39
- var __setFunctionName = (this && this.__setFunctionName) || function (f, name, prefix) {
40
- if (typeof name === "symbol") name = name.description ? "[".concat(name.description, "]") : "";
41
- return Object.defineProperty(f, "name", { configurable: true, value: prefix ? "".concat(prefix, " ", name) : name });
42
- };
43
- import { describe, it, expect } from 'vitest';
44
- import { Workflow, Step, Task, ObservedState } from '../../index.js';
45
- import { WorkflowTreeDebugger } from '../../debugger/tree-debugger.js';
46
- describe('Adversarial Edge Case Tests', () => {
47
- describe('PRD Requirement: Step Decorator Defaults', () => {
48
- /**
49
- * PRD Section 8.1 specifies @Step options with defaults
50
- * - trackTiming should be true by default (mentioned in skeleton but not explicit)
51
- */
52
- it('should track timing by default when trackTiming is not specified', async () => {
53
- let stepEndEmitted = false;
54
- let durationEmitted;
55
- let TestWorkflow = (() => {
56
- let _classSuper = Workflow;
57
- let _instanceExtraInitializers = [];
58
- let _testStep_decorators;
59
- return class TestWorkflow extends _classSuper {
60
- static {
61
- const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
62
- _testStep_decorators = [Step()];
63
- __esDecorate(this, null, _testStep_decorators, { kind: "method", name: "testStep", static: false, private: false, access: { has: obj => "testStep" in obj, get: obj => obj.testStep }, metadata: _metadata }, null, _instanceExtraInitializers);
64
- if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
65
- }
66
- async testStep() {
67
- return 'done';
68
- }
69
- async run() {
70
- return this.testStep();
71
- }
72
- constructor() {
73
- super(...arguments);
74
- __runInitializers(this, _instanceExtraInitializers);
75
- }
76
- };
77
- })();
78
- const workflow = new TestWorkflow();
79
- const debuggerInstance = new WorkflowTreeDebugger(workflow);
80
- // Subscribe to events correctly
81
- debuggerInstance.events.subscribe({
82
- next: (event) => {
83
- if (event.type === 'stepEnd') {
84
- stepEndEmitted = true;
85
- durationEmitted = event.duration;
86
- }
87
- },
88
- });
89
- await workflow.run();
90
- expect(stepEndEmitted).toBe(true);
91
- expect(typeof durationEmitted).toBe('number');
92
- expect(durationEmitted).toBeGreaterThanOrEqual(0);
93
- });
94
- it('should NOT track timing when explicitly set to false', async () => {
95
- let stepEndEmitted = false;
96
- let TestWorkflow = (() => {
97
- let _classSuper = Workflow;
98
- let _instanceExtraInitializers = [];
99
- let _testStep_decorators;
100
- return class TestWorkflow extends _classSuper {
101
- static {
102
- const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
103
- _testStep_decorators = [Step({ trackTiming: false })];
104
- __esDecorate(this, null, _testStep_decorators, { kind: "method", name: "testStep", static: false, private: false, access: { has: obj => "testStep" in obj, get: obj => obj.testStep }, metadata: _metadata }, null, _instanceExtraInitializers);
105
- if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
106
- }
107
- async testStep() {
108
- return 'done';
109
- }
110
- async run() {
111
- return this.testStep();
112
- }
113
- constructor() {
114
- super(...arguments);
115
- __runInitializers(this, _instanceExtraInitializers);
116
- }
117
- };
118
- })();
119
- const workflow = new TestWorkflow();
120
- const debuggerInstance = new WorkflowTreeDebugger(workflow);
121
- debuggerInstance.events.subscribe({
122
- next: (event) => {
123
- if (event.type === 'stepEnd') {
124
- stepEndEmitted = true;
125
- }
126
- },
127
- });
128
- await workflow.run();
129
- // stepEnd should NOT be emitted when trackTiming is false
130
- // This is based on the implementation: trackTiming !== false controls emission
131
- expect(stepEndEmitted).toBe(false);
132
- });
133
- });
134
- describe('PRD Requirement: WorkflowLogger.child() Behavior', () => {
135
- /**
136
- * PRD Section 12.1 shows WorkflowLogger.child(meta: Partial<LogEntry>)
137
- * But implementation shows: child(parentLogId: string)
138
- * This is a mismatch between PRD and implementation
139
- */
140
- it('should have child() method that accepts parentLogId', async () => {
141
- class TestWorkflow extends Workflow {
142
- async run() {
143
- // Access logger to verify child method exists
144
- const childLogger = this.logger.child('parent-id-123');
145
- expect(childLogger).toBeDefined();
146
- }
147
- }
148
- const workflow = new TestWorkflow();
149
- await workflow.run();
150
- });
151
- });
152
- describe('Edge Case: Empty and Null Values', () => {
153
- it('should reject empty string workflow name', async () => {
154
- class TestWorkflow extends Workflow {
155
- async run() {
156
- return 'done';
157
- }
158
- }
159
- expect(() => new TestWorkflow('')).toThrow('Workflow name cannot be empty or whitespace only');
160
- });
161
- it('should handle null and undefined observed state values', async () => {
162
- let TestWorkflow = (() => {
163
- let _classSuper = Workflow;
164
- let _nullableValue_decorators;
165
- let _nullableValue_initializers = [];
166
- let _nullableValue_extraInitializers = [];
167
- let _undefinedValue_decorators;
168
- let _undefinedValue_initializers = [];
169
- let _undefinedValue_extraInitializers = [];
170
- let _emptyValue_decorators;
171
- let _emptyValue_initializers = [];
172
- let _emptyValue_extraInitializers = [];
173
- return class TestWorkflow extends _classSuper {
174
- static {
175
- const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
176
- _nullableValue_decorators = [ObservedState()];
177
- _undefinedValue_decorators = [ObservedState()];
178
- _emptyValue_decorators = [ObservedState()];
179
- __esDecorate(null, null, _nullableValue_decorators, { kind: "field", name: "nullableValue", static: false, private: false, access: { has: obj => "nullableValue" in obj, get: obj => obj.nullableValue, set: (obj, value) => { obj.nullableValue = value; } }, metadata: _metadata }, _nullableValue_initializers, _nullableValue_extraInitializers);
180
- __esDecorate(null, null, _undefinedValue_decorators, { kind: "field", name: "undefinedValue", static: false, private: false, access: { has: obj => "undefinedValue" in obj, get: obj => obj.undefinedValue, set: (obj, value) => { obj.undefinedValue = value; } }, metadata: _metadata }, _undefinedValue_initializers, _undefinedValue_extraInitializers);
181
- __esDecorate(null, null, _emptyValue_decorators, { kind: "field", name: "emptyValue", static: false, private: false, access: { has: obj => "emptyValue" in obj, get: obj => obj.emptyValue, set: (obj, value) => { obj.emptyValue = value; } }, metadata: _metadata }, _emptyValue_initializers, _emptyValue_extraInitializers);
182
- if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
183
- }
184
- nullableValue = __runInitializers(this, _nullableValue_initializers, null);
185
- undefinedValue = (__runInitializers(this, _nullableValue_extraInitializers), __runInitializers(this, _undefinedValue_initializers, undefined));
186
- emptyValue = (__runInitializers(this, _undefinedValue_extraInitializers), __runInitializers(this, _emptyValue_initializers, ''));
187
- async run() {
188
- this.snapshotState();
189
- return this.node.stateSnapshot;
190
- }
191
- constructor() {
192
- super(...arguments);
193
- __runInitializers(this, _emptyValue_extraInitializers);
194
- }
195
- };
196
- })();
197
- const workflow = new TestWorkflow();
198
- const snapshot = await workflow.run();
199
- expect(snapshot).toHaveProperty('nullableValue', null);
200
- expect(snapshot).toHaveProperty('undefinedValue', undefined);
201
- expect(snapshot).toHaveProperty('emptyValue', '');
202
- });
203
- it('should handle empty array from @Task', async () => {
204
- class ChildWorkflow extends Workflow {
205
- async run() {
206
- return 'child';
207
- }
208
- }
209
- let ParentWorkflow = (() => {
210
- let _classSuper = Workflow;
211
- let _instanceExtraInitializers = [];
212
- let _returnsEmpty_decorators;
213
- return class ParentWorkflow extends _classSuper {
214
- static {
215
- const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
216
- _returnsEmpty_decorators = [Task()];
217
- __esDecorate(this, null, _returnsEmpty_decorators, { kind: "method", name: "returnsEmpty", static: false, private: false, access: { has: obj => "returnsEmpty" in obj, get: obj => obj.returnsEmpty }, metadata: _metadata }, null, _instanceExtraInitializers);
218
- if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
219
- }
220
- async returnsEmpty() {
221
- return [];
222
- }
223
- async run() {
224
- return this.returnsEmpty();
225
- }
226
- constructor() {
227
- super(...arguments);
228
- __runInitializers(this, _instanceExtraInitializers);
229
- }
230
- };
231
- })();
232
- const workflow = new ParentWorkflow();
233
- const result = await workflow.run();
234
- expect(Array.isArray(result)).toBe(true);
235
- expect(result.length).toBe(0);
236
- });
237
- it('should handle null return from @Task', async () => {
238
- let ParentWorkflow = (() => {
239
- let _classSuper = Workflow;
240
- let _instanceExtraInitializers = [];
241
- let _returnsNull_decorators;
242
- return class ParentWorkflow extends _classSuper {
243
- static {
244
- const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
245
- _returnsNull_decorators = [Task()];
246
- __esDecorate(this, null, _returnsNull_decorators, { kind: "method", name: "returnsNull", static: false, private: false, access: { has: obj => "returnsNull" in obj, get: obj => obj.returnsNull }, metadata: _metadata }, null, _instanceExtraInitializers);
247
- if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
248
- }
249
- async returnsNull() {
250
- return null;
251
- }
252
- async run() {
253
- return this.returnsNull();
254
- }
255
- constructor() {
256
- super(...arguments);
257
- __runInitializers(this, _instanceExtraInitializers);
258
- }
259
- };
260
- })();
261
- const workflow = new ParentWorkflow();
262
- const result = await workflow.run();
263
- expect(result).toBe(null);
264
- });
265
- it('should handle undefined return from @Task', async () => {
266
- let ParentWorkflow = (() => {
267
- let _classSuper = Workflow;
268
- let _instanceExtraInitializers = [];
269
- let _returnsUndefined_decorators;
270
- return class ParentWorkflow extends _classSuper {
271
- static {
272
- const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
273
- _returnsUndefined_decorators = [Task()];
274
- __esDecorate(this, null, _returnsUndefined_decorators, { kind: "method", name: "returnsUndefined", static: false, private: false, access: { has: obj => "returnsUndefined" in obj, get: obj => obj.returnsUndefined }, metadata: _metadata }, null, _instanceExtraInitializers);
275
- if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
276
- }
277
- async returnsUndefined() {
278
- return undefined;
279
- }
280
- async run() {
281
- return this.returnsUndefined();
282
- }
283
- constructor() {
284
- super(...arguments);
285
- __runInitializers(this, _instanceExtraInitializers);
286
- }
287
- };
288
- })();
289
- const workflow = new ParentWorkflow();
290
- const result = await workflow.run();
291
- expect(result).toBe(undefined);
292
- });
293
- });
294
- describe('Edge Case: Unicode and Special Characters', () => {
295
- it('should handle unicode in workflow names', async () => {
296
- class TestWorkflow extends Workflow {
297
- async run() {
298
- return 'done';
299
- }
300
- }
301
- const unicodeNames = [
302
- '🚀 Rocket',
303
- '测试工作流',
304
- 'العملية',
305
- '🎯Target',
306
- ];
307
- for (const name of unicodeNames) {
308
- const workflow = new TestWorkflow(name);
309
- expect(workflow.node.name).toBe(name);
310
- await workflow.run();
311
- }
312
- });
313
- it('should handle unicode in log messages', async () => {
314
- class TestWorkflow extends Workflow {
315
- async run() {
316
- this.logger.info('测试消息 🚀');
317
- this.logger.warn('⚠️ Warning');
318
- this.logger.error('❌ Error with emoji');
319
- }
320
- }
321
- const workflow = new TestWorkflow();
322
- await workflow.run();
323
- expect(workflow.node.logs.length).toBe(3);
324
- expect(workflow.node.logs[0].message).toBe('测试消息 🚀');
325
- });
326
- it('should handle unicode in observed state values', async () => {
327
- let TestWorkflow = (() => {
328
- let _classSuper = Workflow;
329
- let _unicodeField_decorators;
330
- let _unicodeField_initializers = [];
331
- let _unicodeField_extraInitializers = [];
332
- return class TestWorkflow extends _classSuper {
333
- static {
334
- const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
335
- _unicodeField_decorators = [ObservedState()];
336
- __esDecorate(null, null, _unicodeField_decorators, { kind: "field", name: "unicodeField", static: false, private: false, access: { has: obj => "unicodeField" in obj, get: obj => obj.unicodeField, set: (obj, value) => { obj.unicodeField = value; } }, metadata: _metadata }, _unicodeField_initializers, _unicodeField_extraInitializers);
337
- if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
338
- }
339
- unicodeField = __runInitializers(this, _unicodeField_initializers, '测试 🎯');
340
- async run() {
341
- this.snapshotState();
342
- return this.node.stateSnapshot;
343
- }
344
- constructor() {
345
- super(...arguments);
346
- __runInitializers(this, _unicodeField_extraInitializers);
347
- }
348
- };
349
- })();
350
- const workflow = new TestWorkflow();
351
- const snapshot = await workflow.run();
352
- expect(snapshot?.unicodeField).toBe('测试 🎯');
353
- });
354
- });
355
- describe('Edge Case: Deep Hierarchies', () => {
356
- it('should handle very deep workflow hierarchies', async () => {
357
- // Create a chain of 100 nested workflows
358
- let lastWorkflow = null;
359
- for (let i = 0; i < 100; i++) {
360
- const name = `Workflow-${i}`;
361
- const DynamicWorkflow = (() => {
362
- let _classSuper = Workflow;
363
- let _instanceExtraInitializers = [];
364
- let _doWork_decorators;
365
- return class extends _classSuper {
366
- static { __setFunctionName(this, "DynamicWorkflow"); }
367
- static {
368
- const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
369
- _doWork_decorators = [Step()];
370
- __esDecorate(this, null, _doWork_decorators, { kind: "method", name: "doWork", static: false, private: false, access: { has: obj => "doWork" in obj, get: obj => obj.doWork }, metadata: _metadata }, null, _instanceExtraInitializers);
371
- if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
372
- }
373
- async doWork() {
374
- return `level-${i}`;
375
- }
376
- async run() {
377
- return this.doWork();
378
- }
379
- constructor() {
380
- super(...arguments);
381
- __runInitializers(this, _instanceExtraInitializers);
382
- }
383
- };
384
- })();
385
- lastWorkflow = new DynamicWorkflow(name, lastWorkflow);
386
- }
387
- await lastWorkflow.run();
388
- // Verify hierarchy depth
389
- let depth = 0;
390
- let current = lastWorkflow;
391
- while (current.parent) {
392
- depth++;
393
- current = current.parent;
394
- }
395
- expect(depth).toBe(99);
396
- });
397
- it('should handle wide workflow hierarchies (many siblings)', async () => {
398
- let ChildWorkflow = (() => {
399
- let _classSuper = Workflow;
400
- let _instanceExtraInitializers = [];
401
- let _doWork_decorators;
402
- return class ChildWorkflow extends _classSuper {
403
- static {
404
- const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
405
- _doWork_decorators = [Step()];
406
- __esDecorate(this, null, _doWork_decorators, { kind: "method", name: "doWork", static: false, private: false, access: { has: obj => "doWork" in obj, get: obj => obj.doWork }, metadata: _metadata }, null, _instanceExtraInitializers);
407
- if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
408
- }
409
- async doWork() {
410
- return 'child-work';
411
- }
412
- async run() {
413
- return this.doWork();
414
- }
415
- constructor() {
416
- super(...arguments);
417
- __runInitializers(this, _instanceExtraInitializers);
418
- }
419
- };
420
- })();
421
- let ParentWorkflow = (() => {
422
- let _classSuper = Workflow;
423
- let _instanceExtraInitializers = [];
424
- let _spawnMany_decorators;
425
- return class ParentWorkflow extends _classSuper {
426
- static {
427
- const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
428
- _spawnMany_decorators = [Task({ concurrent: true })];
429
- __esDecorate(this, null, _spawnMany_decorators, { kind: "method", name: "spawnMany", static: false, private: false, access: { has: obj => "spawnMany" in obj, get: obj => obj.spawnMany }, metadata: _metadata }, null, _instanceExtraInitializers);
430
- if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
431
- }
432
- async spawnMany() {
433
- return Array.from({ length: 50 }, (_, i) => new ChildWorkflow(`Child-${i}`, this));
434
- }
435
- async run() {
436
- return this.spawnMany();
437
- }
438
- constructor() {
439
- super(...arguments);
440
- __runInitializers(this, _instanceExtraInitializers);
441
- }
442
- };
443
- })();
444
- const workflow = new ParentWorkflow();
445
- await workflow.run();
446
- expect(workflow.children.length).toBe(50);
447
- });
448
- });
449
- describe('Edge Case: Rapid State Changes', () => {
450
- it('should handle rapid status changes', async () => {
451
- class TestWorkflow extends Workflow {
452
- async run() {
453
- this.setStatus('running');
454
- this.setStatus('running');
455
- this.setStatus('running');
456
- this.setStatus('completed');
457
- }
458
- }
459
- const workflow = new TestWorkflow();
460
- await workflow.run();
461
- expect(workflow.status).toBe('completed');
462
- expect(workflow.node.status).toBe('completed');
463
- });
464
- it('should handle multiple rapid snapshots', async () => {
465
- let TestWorkflow = (() => {
466
- let _classSuper = Workflow;
467
- let _counter_decorators;
468
- let _counter_initializers = [];
469
- let _counter_extraInitializers = [];
470
- return class TestWorkflow extends _classSuper {
471
- static {
472
- const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
473
- _counter_decorators = [ObservedState()];
474
- __esDecorate(null, null, _counter_decorators, { kind: "field", name: "counter", static: false, private: false, access: { has: obj => "counter" in obj, get: obj => obj.counter, set: (obj, value) => { obj.counter = value; } }, metadata: _metadata }, _counter_initializers, _counter_extraInitializers);
475
- if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
476
- }
477
- counter = __runInitializers(this, _counter_initializers, 0);
478
- async run() {
479
- for (let i = 0; i < 10; i++) {
480
- this.counter = i;
481
- this.snapshotState();
482
- }
483
- }
484
- constructor() {
485
- super(...arguments);
486
- __runInitializers(this, _counter_extraInitializers);
487
- }
488
- };
489
- })();
490
- const workflow = new TestWorkflow();
491
- await workflow.run();
492
- expect(workflow.node.stateSnapshot?.counter).toBe(9);
493
- });
494
- });
495
- describe('Edge Case: Concurrent Execution', () => {
496
- it('should handle concurrent task execution with errors', async () => {
497
- class GoodChild extends Workflow {
498
- async run() {
499
- return 'good';
500
- }
501
- }
502
- class BadChild extends Workflow {
503
- async run() {
504
- throw new Error('Bad child error');
505
- }
506
- }
507
- let ParentWorkflow = (() => {
508
- let _classSuper = Workflow;
509
- let _instanceExtraInitializers = [];
510
- let _spawnMixed_decorators;
511
- return class ParentWorkflow extends _classSuper {
512
- static {
513
- const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
514
- _spawnMixed_decorators = [Task({ concurrent: true })];
515
- __esDecorate(this, null, _spawnMixed_decorators, { kind: "method", name: "spawnMixed", static: false, private: false, access: { has: obj => "spawnMixed" in obj, get: obj => obj.spawnMixed }, metadata: _metadata }, null, _instanceExtraInitializers);
516
- if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
517
- }
518
- async spawnMixed() {
519
- return [
520
- new GoodChild('Good', this),
521
- new BadChild('Bad', this),
522
- ];
523
- }
524
- async run() {
525
- // This should throw because concurrent runs happen
526
- try {
527
- await this.spawnMixed();
528
- }
529
- catch (err) {
530
- // Expected to throw
531
- }
532
- }
533
- constructor() {
534
- super(...arguments);
535
- __runInitializers(this, _instanceExtraInitializers);
536
- }
537
- };
538
- })();
539
- const workflow = new ParentWorkflow();
540
- await workflow.run();
541
- // Both children should be attached
542
- expect(workflow.children.length).toBe(2);
543
- });
544
- it('should handle @Task with concurrent: true on single workflow', async () => {
545
- class ChildWorkflow extends Workflow {
546
- async run() {
547
- return 'child-result';
548
- }
549
- }
550
- let ParentWorkflow = (() => {
551
- let _classSuper = Workflow;
552
- let _instanceExtraInitializers = [];
553
- let _spawnOne_decorators;
554
- return class ParentWorkflow extends _classSuper {
555
- static {
556
- const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
557
- _spawnOne_decorators = [Task({ concurrent: true })];
558
- __esDecorate(this, null, _spawnOne_decorators, { kind: "method", name: "spawnOne", static: false, private: false, access: { has: obj => "spawnOne" in obj, get: obj => obj.spawnOne }, metadata: _metadata }, null, _instanceExtraInitializers);
559
- if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
560
- }
561
- async spawnOne() {
562
- return new ChildWorkflow('SingleChild', this);
563
- }
564
- async run() {
565
- return this.spawnOne();
566
- }
567
- constructor() {
568
- super(...arguments);
569
- __runInitializers(this, _instanceExtraInitializers);
570
- }
571
- };
572
- })();
573
- const workflow = new ParentWorkflow();
574
- const result = await workflow.run();
575
- // Single workflow should still be returned
576
- expect(result).toBeDefined();
577
- expect(workflow.children.length).toBe(1);
578
- });
579
- });
580
- describe('Edge Case: Observers and Event Handling', () => {
581
- it('should handle observer that throws errors', async () => {
582
- class TestWorkflow extends Workflow {
583
- async run() {
584
- this.emitEvent({ type: 'stepStart', node: this.node, step: 'test' });
585
- }
586
- }
587
- const workflow = new TestWorkflow();
588
- // Add an observer that throws
589
- workflow.addObserver({
590
- onLog: () => {
591
- throw new Error('Observer error');
592
- },
593
- onEvent: () => {
594
- throw new Error('Event observer error');
595
- },
596
- onStateUpdated: () => {
597
- throw new Error('State observer error');
598
- },
599
- onTreeChanged: () => {
600
- throw new Error('Tree observer error');
601
- },
602
- });
603
- // Should not throw, errors are caught and console.error'd
604
- await workflow.run();
605
- });
606
- it('should handle multiple observers', async () => {
607
- class TestWorkflow extends Workflow {
608
- async run() {
609
- this.emitEvent({ type: 'stepStart', node: this.node, step: 'test' });
610
- }
611
- }
612
- const workflow = new TestWorkflow();
613
- const counts = { onLog: 0, onEvent: 0, onStateUpdated: 0, onTreeChanged: 0 };
614
- // Add multiple observers
615
- for (let i = 0; i < 5; i++) {
616
- workflow.addObserver({
617
- onLog: () => counts.onLog++,
618
- onEvent: () => counts.onEvent++,
619
- onStateUpdated: () => counts.onStateUpdated++,
620
- onTreeChanged: () => counts.onTreeChanged++,
621
- });
622
- }
623
- await workflow.run();
624
- // Each observer should have been called
625
- expect(counts.onEvent).toBe(5);
626
- });
627
- });
628
- describe('Edge Case: Circular References', () => {
629
- it('should detect circular parent-child relationships', async () => {
630
- class TestWorkflow extends Workflow {
631
- async run() {
632
- return 'done';
633
- }
634
- }
635
- const parent = new TestWorkflow('Parent');
636
- const child = new TestWorkflow('Child', parent);
637
- // Try to create a circular reference
638
- expect(() => {
639
- parent.attachChild(child); // This should throw
640
- }).toThrow('Child already attached');
641
- });
642
- it('should prevent creating cycles through getRoot', async () => {
643
- class TestWorkflow extends Workflow {
644
- async run() {
645
- return 'done';
646
- }
647
- }
648
- const root = new TestWorkflow('Root');
649
- const child = new TestWorkflow('Child', root);
650
- // getRoot should work correctly
651
- const rootFromChild = child.getRoot();
652
- expect(rootFromChild.id).toBe(root.id);
653
- });
654
- });
655
- describe('Edge Case: Memory and Performance', () => {
656
- it('should handle large number of events', async () => {
657
- class TestWorkflow extends Workflow {
658
- async run() {
659
- for (let i = 0; i < 1000; i++) {
660
- this.emitEvent({ type: 'stepStart', node: this.node, step: `step-${i}` });
661
- }
662
- }
663
- }
664
- const workflow = new TestWorkflow();
665
- await workflow.run();
666
- expect(workflow.node.events.length).toBe(1000);
667
- });
668
- it('should handle large number of logs', async () => {
669
- class TestWorkflow extends Workflow {
670
- async run() {
671
- for (let i = 0; i < 1000; i++) {
672
- this.logger.info(`Log entry ${i}`);
673
- }
674
- }
675
- }
676
- const workflow = new TestWorkflow();
677
- await workflow.run();
678
- expect(workflow.node.logs.length).toBe(1000);
679
- });
680
- });
681
- describe('PRD Compliance: Error Event Format', () => {
682
- /**
683
- * PRD Section 5.1 specifies WorkflowError interface
684
- * Verifying the error structure matches PRD
685
- */
686
- it('should emit error with all required fields', async () => {
687
- let TestWorkflow = (() => {
688
- let _classSuper = Workflow;
689
- let _instanceExtraInitializers = [];
690
- let _testField_decorators;
691
- let _testField_initializers = [];
692
- let _testField_extraInitializers = [];
693
- let _failingStep_decorators;
694
- return class TestWorkflow extends _classSuper {
695
- static {
696
- const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
697
- _testField_decorators = [ObservedState()];
698
- _failingStep_decorators = [Step()];
699
- __esDecorate(this, null, _failingStep_decorators, { kind: "method", name: "failingStep", static: false, private: false, access: { has: obj => "failingStep" in obj, get: obj => obj.failingStep }, metadata: _metadata }, null, _instanceExtraInitializers);
700
- __esDecorate(null, null, _testField_decorators, { kind: "field", name: "testField", static: false, private: false, access: { has: obj => "testField" in obj, get: obj => obj.testField, set: (obj, value) => { obj.testField = value; } }, metadata: _metadata }, _testField_initializers, _testField_extraInitializers);
701
- if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
702
- }
703
- testField = (__runInitializers(this, _instanceExtraInitializers), __runInitializers(this, _testField_initializers, 'test-value'));
704
- async failingStep() {
705
- this.logger.info('About to fail');
706
- throw new Error('Test error');
707
- }
708
- async run() {
709
- try {
710
- await this.failingStep();
711
- }
712
- catch (err) {
713
- // Expected
714
- }
715
- }
716
- constructor() {
717
- super(...arguments);
718
- __runInitializers(this, _testField_extraInitializers);
719
- }
720
- };
721
- })();
722
- const workflow = new TestWorkflow();
723
- let capturedError = null;
724
- workflow.addObserver({
725
- onLog: () => { },
726
- onEvent: (event) => {
727
- if (event.type === 'error') {
728
- capturedError = event.error;
729
- }
730
- },
731
- onStateUpdated: () => { },
732
- onTreeChanged: () => { },
733
- });
734
- await workflow.run();
735
- expect(capturedError).not.toBeNull();
736
- expect(capturedError.message).toBe('Test error');
737
- expect(capturedError.workflowId).toBe(workflow.id);
738
- expect(capturedError.original).toBeDefined();
739
- expect(capturedError.state).toBeDefined();
740
- expect(capturedError.logs).toBeDefined();
741
- expect(Array.isArray(capturedError.logs)).toBe(true);
742
- });
743
- });
744
- describe('PRD Compliance: Event Types', () => {
745
- /**
746
- * PRD Section 4.2 specifies all WorkflowEvent types
747
- * Verifying all event types are properly emitted
748
- */
749
- it('should emit childAttached event', async () => {
750
- class ChildWorkflow extends Workflow {
751
- async run() {
752
- return 'child';
753
- }
754
- }
755
- let ParentWorkflow = (() => {
756
- let _classSuper = Workflow;
757
- let _instanceExtraInitializers = [];
758
- let _spawnChild_decorators;
759
- return class ParentWorkflow extends _classSuper {
760
- static {
761
- const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
762
- _spawnChild_decorators = [Task()];
763
- __esDecorate(this, null, _spawnChild_decorators, { kind: "method", name: "spawnChild", static: false, private: false, access: { has: obj => "spawnChild" in obj, get: obj => obj.spawnChild }, metadata: _metadata }, null, _instanceExtraInitializers);
764
- if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
765
- }
766
- async spawnChild() {
767
- return new ChildWorkflow('Child', this);
768
- }
769
- async run() {
770
- return this.spawnChild();
771
- }
772
- constructor() {
773
- super(...arguments);
774
- __runInitializers(this, _instanceExtraInitializers);
775
- }
776
- };
777
- })();
778
- const workflow = new ParentWorkflow();
779
- let childAttachedFired = false;
780
- workflow.addObserver({
781
- onLog: () => { },
782
- onEvent: (event) => {
783
- if (event.type === 'childAttached') {
784
- childAttachedFired = true;
785
- expect(event.parentId).toBe(workflow.id);
786
- expect(event.child).toBeDefined();
787
- }
788
- },
789
- onStateUpdated: () => { },
790
- onTreeChanged: () => { },
791
- });
792
- await workflow.run();
793
- expect(childAttachedFired).toBe(true);
794
- });
795
- it('should emit stateSnapshot event', async () => {
796
- let TestWorkflow = (() => {
797
- let _classSuper = Workflow;
798
- let _testField_decorators;
799
- let _testField_initializers = [];
800
- let _testField_extraInitializers = [];
801
- return class TestWorkflow extends _classSuper {
802
- static {
803
- const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
804
- _testField_decorators = [ObservedState()];
805
- __esDecorate(null, null, _testField_decorators, { kind: "field", name: "testField", static: false, private: false, access: { has: obj => "testField" in obj, get: obj => obj.testField, set: (obj, value) => { obj.testField = value; } }, metadata: _metadata }, _testField_initializers, _testField_extraInitializers);
806
- if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
807
- }
808
- testField = __runInitializers(this, _testField_initializers, 'value');
809
- async run() {
810
- this.snapshotState();
811
- }
812
- constructor() {
813
- super(...arguments);
814
- __runInitializers(this, _testField_extraInitializers);
815
- }
816
- };
817
- })();
818
- const workflow = new TestWorkflow();
819
- let snapshotFired = false;
820
- workflow.addObserver({
821
- onLog: () => { },
822
- onEvent: (event) => {
823
- if (event.type === 'stateSnapshot') {
824
- snapshotFired = true;
825
- expect(event.node).toBeDefined();
826
- }
827
- },
828
- onStateUpdated: () => { },
829
- onTreeChanged: () => { },
830
- });
831
- await workflow.run();
832
- expect(snapshotFired).toBe(true);
833
- });
834
- it('should emit treeUpdated event', async () => {
835
- class TestWorkflow extends Workflow {
836
- async run() {
837
- this.emitEvent({ type: 'treeUpdated', root: this.node });
838
- }
839
- }
840
- const workflow = new TestWorkflow();
841
- let treeUpdatedFired = false;
842
- workflow.addObserver({
843
- onLog: () => { },
844
- onEvent: (event) => {
845
- if (event.type === 'treeUpdated') {
846
- treeUpdatedFired = true;
847
- }
848
- },
849
- onStateUpdated: () => { },
850
- onTreeChanged: () => { },
851
- });
852
- await workflow.run();
853
- expect(treeUpdatedFired).toBe(true);
854
- });
855
- });
856
- });
857
- //# sourceMappingURL=edge-case.test.js.map