@q1k-oss/btree-workflows 0.0.1 → 0.0.2

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 (206) hide show
  1. package/README.md +13 -13
  2. package/dist/index.cjs +5011 -0
  3. package/dist/index.d.cts +3320 -0
  4. package/dist/index.d.ts +3320 -0
  5. package/dist/index.js +4879 -0
  6. package/package.json +33 -3
  7. package/.claude/settings.local.json +0 -31
  8. package/CLAUDE.md +0 -181
  9. package/behaviour-tree-workflows-landing/index.html +0 -16
  10. package/behaviour-tree-workflows-landing/package-lock.json +0 -2074
  11. package/behaviour-tree-workflows-landing/package.json +0 -31
  12. package/behaviour-tree-workflows-landing/public/favicon.svg +0 -17
  13. package/behaviour-tree-workflows-landing/src/App.css +0 -103
  14. package/behaviour-tree-workflows-landing/src/App.tsx +0 -176
  15. package/behaviour-tree-workflows-landing/src/components/BlackboardInspector.css +0 -89
  16. package/behaviour-tree-workflows-landing/src/components/BlackboardInspector.tsx +0 -64
  17. package/behaviour-tree-workflows-landing/src/components/ExampleSelector.css +0 -64
  18. package/behaviour-tree-workflows-landing/src/components/ExampleSelector.tsx +0 -34
  19. package/behaviour-tree-workflows-landing/src/components/ExecutionLog.css +0 -107
  20. package/behaviour-tree-workflows-landing/src/components/ExecutionLog.tsx +0 -85
  21. package/behaviour-tree-workflows-landing/src/components/Header.css +0 -50
  22. package/behaviour-tree-workflows-landing/src/components/Header.tsx +0 -26
  23. package/behaviour-tree-workflows-landing/src/components/StatusBadge.css +0 -45
  24. package/behaviour-tree-workflows-landing/src/components/StatusBadge.tsx +0 -15
  25. package/behaviour-tree-workflows-landing/src/components/Toolbar.css +0 -74
  26. package/behaviour-tree-workflows-landing/src/components/Toolbar.tsx +0 -53
  27. package/behaviour-tree-workflows-landing/src/components/TreeVisualizer.css +0 -67
  28. package/behaviour-tree-workflows-landing/src/components/TreeVisualizer.tsx +0 -192
  29. package/behaviour-tree-workflows-landing/src/components/YamlEditor.css +0 -18
  30. package/behaviour-tree-workflows-landing/src/components/YamlEditor.tsx +0 -96
  31. package/behaviour-tree-workflows-landing/src/lib/count-nodes.ts +0 -11
  32. package/behaviour-tree-workflows-landing/src/lib/execution-engine.ts +0 -96
  33. package/behaviour-tree-workflows-landing/src/lib/tree-layout.ts +0 -136
  34. package/behaviour-tree-workflows-landing/src/lib/yaml-examples.ts +0 -549
  35. package/behaviour-tree-workflows-landing/src/main.tsx +0 -9
  36. package/behaviour-tree-workflows-landing/src/stubs/activepieces.ts +0 -18
  37. package/behaviour-tree-workflows-landing/src/stubs/fs.ts +0 -24
  38. package/behaviour-tree-workflows-landing/src/stubs/path.ts +0 -16
  39. package/behaviour-tree-workflows-landing/src/stubs/temporal-activity.ts +0 -6
  40. package/behaviour-tree-workflows-landing/src/stubs/temporal-workflow.ts +0 -22
  41. package/behaviour-tree-workflows-landing/tsconfig.json +0 -25
  42. package/behaviour-tree-workflows-landing/vite.config.ts +0 -40
  43. package/demo-google-sheets.ts +0 -181
  44. package/demo-runtime-variables.ts +0 -174
  45. package/demo-template.ts +0 -208
  46. package/docs/ARCHITECTURE_SUMMARY.md +0 -613
  47. package/docs/NODE_REFERENCE.md +0 -504
  48. package/docs/README.md +0 -53
  49. package/docs/custom-nodes-architecture.md +0 -826
  50. package/docs/observability.md +0 -175
  51. package/docs/yaml-specification.md +0 -990
  52. package/examples/temporal/README.md +0 -117
  53. package/examples/temporal/activities.ts +0 -373
  54. package/examples/temporal/client.ts +0 -115
  55. package/examples/temporal/python-worker/activities.py +0 -339
  56. package/examples/temporal/python-worker/requirements.txt +0 -12
  57. package/examples/temporal/python-worker/worker.py +0 -106
  58. package/examples/temporal/worker.ts +0 -66
  59. package/examples/temporal/workflows.ts +0 -6
  60. package/examples/temporal/yaml-workflow-loader.ts +0 -105
  61. package/examples/yaml-test.ts +0 -97
  62. package/examples/yaml-workflows/01-simple-sequence.yaml +0 -25
  63. package/examples/yaml-workflows/02-parallel-timeout.yaml +0 -45
  64. package/examples/yaml-workflows/03-ecommerce-checkout.yaml +0 -94
  65. package/examples/yaml-workflows/04-ai-agent-workflow.yaml +0 -346
  66. package/examples/yaml-workflows/05-order-processing.yaml +0 -146
  67. package/examples/yaml-workflows/06-activity-test.yaml +0 -71
  68. package/examples/yaml-workflows/07-activity-simple-test.yaml +0 -43
  69. package/examples/yaml-workflows/08-file-processing.yaml +0 -141
  70. package/examples/yaml-workflows/09-http-request.yaml +0 -137
  71. package/examples/yaml-workflows/README.md +0 -211
  72. package/src/actions/code-execution.schema.ts +0 -27
  73. package/src/actions/code-execution.ts +0 -218
  74. package/src/actions/generate-file.test.ts +0 -516
  75. package/src/actions/generate-file.ts +0 -166
  76. package/src/actions/http-request.test.ts +0 -784
  77. package/src/actions/http-request.ts +0 -228
  78. package/src/actions/index.ts +0 -20
  79. package/src/actions/parse-file.test.ts +0 -448
  80. package/src/actions/parse-file.ts +0 -139
  81. package/src/actions/python-script.test.ts +0 -439
  82. package/src/actions/python-script.ts +0 -154
  83. package/src/base-node.test.ts +0 -511
  84. package/src/base-node.ts +0 -605
  85. package/src/behavior-tree.test.ts +0 -431
  86. package/src/behavior-tree.ts +0 -283
  87. package/src/blackboard.test.ts +0 -222
  88. package/src/blackboard.ts +0 -192
  89. package/src/composites/conditional.schema.ts +0 -19
  90. package/src/composites/conditional.test.ts +0 -309
  91. package/src/composites/conditional.ts +0 -129
  92. package/src/composites/for-each.schema.ts +0 -23
  93. package/src/composites/for-each.test.ts +0 -254
  94. package/src/composites/for-each.ts +0 -132
  95. package/src/composites/index.ts +0 -15
  96. package/src/composites/memory-sequence.schema.ts +0 -19
  97. package/src/composites/memory-sequence.test.ts +0 -223
  98. package/src/composites/memory-sequence.ts +0 -98
  99. package/src/composites/parallel.schema.ts +0 -28
  100. package/src/composites/parallel.test.ts +0 -502
  101. package/src/composites/parallel.ts +0 -157
  102. package/src/composites/reactive-sequence.schema.ts +0 -19
  103. package/src/composites/reactive-sequence.test.ts +0 -170
  104. package/src/composites/reactive-sequence.ts +0 -85
  105. package/src/composites/recovery.schema.ts +0 -19
  106. package/src/composites/recovery.test.ts +0 -366
  107. package/src/composites/recovery.ts +0 -90
  108. package/src/composites/selector.schema.ts +0 -19
  109. package/src/composites/selector.test.ts +0 -387
  110. package/src/composites/selector.ts +0 -85
  111. package/src/composites/sequence.schema.ts +0 -19
  112. package/src/composites/sequence.test.ts +0 -337
  113. package/src/composites/sequence.ts +0 -72
  114. package/src/composites/sub-tree.schema.ts +0 -21
  115. package/src/composites/sub-tree.test.ts +0 -893
  116. package/src/composites/sub-tree.ts +0 -177
  117. package/src/composites/while.schema.ts +0 -24
  118. package/src/composites/while.test.ts +0 -381
  119. package/src/composites/while.ts +0 -149
  120. package/src/data-store/index.ts +0 -10
  121. package/src/data-store/memory-store.ts +0 -161
  122. package/src/data-store/types.ts +0 -94
  123. package/src/debug/breakpoint.test.ts +0 -47
  124. package/src/debug/breakpoint.ts +0 -30
  125. package/src/debug/index.ts +0 -17
  126. package/src/debug/resume-point.test.ts +0 -49
  127. package/src/debug/resume-point.ts +0 -29
  128. package/src/decorators/delay.schema.ts +0 -21
  129. package/src/decorators/delay.test.ts +0 -261
  130. package/src/decorators/delay.ts +0 -140
  131. package/src/decorators/force-result.schema.ts +0 -32
  132. package/src/decorators/force-result.test.ts +0 -133
  133. package/src/decorators/force-result.ts +0 -63
  134. package/src/decorators/index.ts +0 -13
  135. package/src/decorators/invert.schema.ts +0 -19
  136. package/src/decorators/invert.test.ts +0 -135
  137. package/src/decorators/invert.ts +0 -42
  138. package/src/decorators/keep-running.schema.ts +0 -20
  139. package/src/decorators/keep-running.test.ts +0 -105
  140. package/src/decorators/keep-running.ts +0 -49
  141. package/src/decorators/precondition.schema.ts +0 -19
  142. package/src/decorators/precondition.test.ts +0 -351
  143. package/src/decorators/precondition.ts +0 -139
  144. package/src/decorators/repeat.schema.ts +0 -21
  145. package/src/decorators/repeat.test.ts +0 -187
  146. package/src/decorators/repeat.ts +0 -94
  147. package/src/decorators/run-once.schema.ts +0 -19
  148. package/src/decorators/run-once.test.ts +0 -140
  149. package/src/decorators/run-once.ts +0 -61
  150. package/src/decorators/soft-assert.schema.ts +0 -19
  151. package/src/decorators/soft-assert.test.ts +0 -107
  152. package/src/decorators/soft-assert.ts +0 -68
  153. package/src/decorators/timeout.schema.ts +0 -21
  154. package/src/decorators/timeout.test.ts +0 -274
  155. package/src/decorators/timeout.ts +0 -159
  156. package/src/errors.test.ts +0 -63
  157. package/src/errors.ts +0 -34
  158. package/src/events.test.ts +0 -347
  159. package/src/events.ts +0 -183
  160. package/src/index.ts +0 -80
  161. package/src/integrations/index.ts +0 -30
  162. package/src/integrations/integration-action.test.ts +0 -571
  163. package/src/integrations/integration-action.ts +0 -233
  164. package/src/integrations/piece-executor.ts +0 -320
  165. package/src/observability/execution-tracker.ts +0 -320
  166. package/src/observability/index.ts +0 -23
  167. package/src/observability/sinks.ts +0 -138
  168. package/src/observability/types.ts +0 -130
  169. package/src/registry-utils.ts +0 -147
  170. package/src/registry.test.ts +0 -466
  171. package/src/registry.ts +0 -334
  172. package/src/schemas/base.schema.ts +0 -104
  173. package/src/schemas/index.ts +0 -223
  174. package/src/schemas/integration.test.ts +0 -238
  175. package/src/schemas/tree-definition.schema.ts +0 -170
  176. package/src/schemas/validation.test.ts +0 -146
  177. package/src/schemas/validation.ts +0 -122
  178. package/src/scripting/index.ts +0 -22
  179. package/src/templates/template-loader.test.ts +0 -281
  180. package/src/templates/template-loader.ts +0 -152
  181. package/src/temporal-integration.test.ts +0 -213
  182. package/src/test-nodes.ts +0 -259
  183. package/src/types.ts +0 -503
  184. package/src/utilities/index.ts +0 -17
  185. package/src/utilities/log-message.test.ts +0 -275
  186. package/src/utilities/log-message.ts +0 -134
  187. package/src/utilities/regex-extract.test.ts +0 -138
  188. package/src/utilities/regex-extract.ts +0 -108
  189. package/src/utilities/variable-resolver.test.ts +0 -416
  190. package/src/utilities/variable-resolver.ts +0 -318
  191. package/src/utils/error-handler.test.ts +0 -117
  192. package/src/utils/error-handler.ts +0 -48
  193. package/src/utils/signal-check.test.ts +0 -234
  194. package/src/utils/signal-check.ts +0 -140
  195. package/src/yaml/errors.ts +0 -143
  196. package/src/yaml/index.ts +0 -30
  197. package/src/yaml/loader.ts +0 -39
  198. package/src/yaml/parser.ts +0 -286
  199. package/src/yaml/validation/semantic-validator.ts +0 -196
  200. package/templates/google-sheets/insert-row.yaml +0 -76
  201. package/templates/notification-sender.yaml +0 -33
  202. package/templates/order-validation.yaml +0 -44
  203. package/tsconfig.json +0 -24
  204. package/vitest.config.ts +0 -25
  205. package/workflows/order-processor.yaml +0 -59
  206. package/workflows/process-order-workflow.yaml +0 -142
@@ -1,59 +0,0 @@
1
- # Order Processor SubTree
2
- # A reusable workflow that processes an order and calculates totals
3
- #
4
- # Params (passed in):
5
- # - orderId: string
6
- # - items: Array<{ name: string, price: number, quantity: number }>
7
- # - customerName: string
8
- #
9
- # Outputs (exported back):
10
- # - orderResult: { orderId, subtotal, tax, total, itemCount }
11
- # - orderStatus: "SUCCESS" | "FAILED"
12
-
13
- type: Sequence
14
- id: order-processor-flow
15
- children:
16
- # Calculate order totals
17
- - type: CodeExecution
18
- id: calculate-totals
19
- props:
20
- language: javascript
21
- code: |
22
- // Read params from blackboard (passed via SubTree params)
23
- const orderId = getBB('orderId');
24
- const items = getBB('items') || [];
25
- const customerName = getBB('customerName');
26
-
27
- // Tax rate (could be configured)
28
- const taxRate = 0.08;
29
-
30
- // Calculate totals
31
- let subtotal = 0;
32
- let itemCount = 0;
33
-
34
- for (const item of items) {
35
- subtotal += item.price * item.quantity;
36
- itemCount += item.quantity;
37
- }
38
-
39
- const tax = Math.round(subtotal * taxRate * 100) / 100;
40
- const total = Math.round((subtotal + tax) * 100) / 100;
41
-
42
- // Store results
43
- setBB('orderResult', {
44
- orderId,
45
- customerName,
46
- subtotal,
47
- tax,
48
- taxRate,
49
- total,
50
- itemCount,
51
- processedAt: new Date().toISOString()
52
- });
53
- setBB('orderStatus', 'SUCCESS');
54
-
55
- - type: LogMessage
56
- id: log-result
57
- props:
58
- message: "Order ${bb.orderId} processed: ${bb.orderResult.itemCount} items, total $${bb.orderResult.total}"
59
- level: info
@@ -1,142 +0,0 @@
1
- # Process Order Workflow
2
- #
3
- # This workflow demonstrates runtime variables:
4
- # - ${input.key} - Workflow input parameters (immutable)
5
- # - ${bb.key} - Blackboard state (mutable)
6
- # - SubTree params/outputs for function-like reusability
7
- # - CodeExecution node with getBB/setBB/getInput functions
8
- #
9
- # Input parameters (passed when workflow starts):
10
- # - orderId: string
11
- # - customerId: string
12
- # - items: Array<{ name: string, price: number, quantity: number }>
13
- #
14
- # Output:
15
- # - Final blackboard state with orderResult, notifications sent, etc.
16
-
17
- type: Sequence
18
- id: process-order-workflow
19
- children:
20
- # Step 1: Log workflow start using input parameters
21
- - type: LogMessage
22
- id: log-start
23
- props:
24
- message: "Starting order processing for Order: ${input.orderId}, Customer: ${input.customerId}"
25
- level: info
26
-
27
- # Step 2: Fetch customer info
28
- - type: CodeExecution
29
- id: fetch-customer
30
- props:
31
- language: javascript
32
- code: |
33
- // Access workflow input via getInput (read-only)
34
- const customerId = getInput('customerId');
35
-
36
- // Simulate customer lookup
37
- const customers = {
38
- 'CUST-001': { name: 'John Doe', email: 'john@example.com', tier: 'gold' },
39
- 'CUST-002': { name: 'Jane Smith', email: 'jane@example.com', tier: 'silver' },
40
- 'CUST-003': { name: 'Bob Wilson', email: 'bob@example.com', tier: 'bronze' }
41
- };
42
-
43
- const customer = customers[customerId] || {
44
- name: 'Guest Customer',
45
- email: 'guest@example.com',
46
- tier: 'standard'
47
- };
48
-
49
- // Store in blackboard for later steps
50
- setBB('customer', customer);
51
-
52
- - type: LogMessage
53
- id: log-customer
54
- props:
55
- message: "Customer found: ${bb.customer.name} (${bb.customer.tier} tier)"
56
- level: info
57
-
58
- # Step 3: Call SubTree with params and outputs
59
- # This demonstrates function-like reusability
60
- - type: SubTree
61
- id: process-order
62
- props:
63
- treeId: "order-processor"
64
- # Pass resolved values to subtree
65
- params:
66
- orderId: "${input.orderId}"
67
- items: "${input.items}"
68
- customerName: "${bb.customer.name}"
69
- # Export results back to parent blackboard
70
- outputs:
71
- - orderResult
72
- - orderStatus
73
-
74
- - type: LogMessage
75
- id: log-order-complete
76
- props:
77
- message: "Order processing complete. Status: ${bb.orderStatus}"
78
- level: info
79
-
80
- # Step 4: Apply tier discount
81
- - type: CodeExecution
82
- id: apply-discount
83
- props:
84
- language: javascript
85
- code: |
86
- // Access from different sources
87
- const orderId = getInput('orderId');
88
- const customer = getBB('customer');
89
- const baseDiscount = 0; // Could be configured
90
-
91
- // Tier-based discounts
92
- const tierDiscounts = {
93
- 'gold': 0.15,
94
- 'silver': 0.10,
95
- 'bronze': 0.05,
96
- 'standard': 0
97
- };
98
-
99
- const tierDiscount = tierDiscounts[customer.tier] || 0;
100
- const totalDiscount = baseDiscount + tierDiscount;
101
-
102
- // Calculate final price
103
- const orderResult = getBB('orderResult');
104
- const discountAmount = Math.round(orderResult.total * totalDiscount * 100) / 100;
105
- const finalTotal = Math.round((orderResult.total - discountAmount) * 100) / 100;
106
-
107
- setBB('finalOrder', {
108
- ...orderResult,
109
- customerTier: customer.tier,
110
- discountPercent: totalDiscount * 100,
111
- discountAmount,
112
- finalTotal
113
- });
114
-
115
- - type: LogMessage
116
- id: log-final
117
- props:
118
- message: "Final order for ${bb.customer.name}: $${bb.finalOrder.finalTotal} (${bb.finalOrder.discountPercent}% discount applied)"
119
- level: info
120
-
121
- # Step 5: Send notification (simulated)
122
- - type: CodeExecution
123
- id: send-notification
124
- props:
125
- language: javascript
126
- code: |
127
- const customer = getBB('customer');
128
- const order = getBB('finalOrder');
129
-
130
- // Simulate sending email
131
- setBB('notification', {
132
- to: customer.email,
133
- subject: 'Order Confirmation - ' + order.orderId,
134
- body: 'Thank you for your order! Total: $' + order.finalTotal,
135
- sentAt: new Date().toISOString()
136
- });
137
-
138
- - type: LogMessage
139
- id: log-notification
140
- props:
141
- message: "Notification sent to ${bb.notification.to}"
142
- level: info