@q1k-oss/btree-workflows 0.0.1

package/examples/yaml-workflows/05-order-processing.yaml

@@ -0,0 +1,146 @@
+# Temporal Workflow Demo
+# E-commerce order processing with parallel operations and timeouts
+
+type: Sequence
+id: order-processing
+name: Order Processing Workflow
+
+children:
+  # Step 1: Initialize order
+  - type: PrintAction
+    id: start
+    name: Start Order Processing
+    props:
+      message: "=== Starting Order Processing ==="
+
+  # Step 2: Validate order in parallel with timeout
+  - type: PrintAction
+    id: validation-phase
+    props:
+      message: "=== Phase 1: Validation ==="
+
+  - type: Timeout
+    id: validation-timeout
+    name: Validation Timeout (5s)
+    props:
+      timeoutMs: 5000
+    children:
+      - type: Parallel
+        id: validation-checks
+        name: Run Validation Checks
+        props:
+          strategy: "strict"
+        children:
+          - type: PrintAction
+            id: validate-inventory
+            props:
+              message: "✓ Validating inventory availability..."
+
+          - type: PrintAction
+            id: validate-payment
+            props:
+              message: "✓ Validating payment method..."
+
+          - type: PrintAction
+            id: validate-shipping
+            props:
+              message: "✓ Validating shipping address..."
+
+  # Step 3: Process payment
+  - type: PrintAction
+    id: payment-phase
+    props:
+      message: "=== Phase 2: Payment Processing ==="
+
+  - type: Timeout
+    id: payment-timeout
+    name: Payment Timeout (10s)
+    props:
+      timeoutMs: 10000
+    children:
+      - type: Sequence
+        id: payment-sequence
+        children:
+          - type: PrintAction
+            id: charge-card
+            props:
+              message: "💳 Processing payment..."
+
+          - type: Delay
+            id: payment-delay
+            name: Simulate Payment Processing
+            props:
+              delayMs: 1000
+            children:
+              - type: PrintAction
+                id: payment-success
+                props:
+                  message: "✓ Payment processed successfully!"
+
+  # Step 4: Fulfill order in parallel
+  - type: PrintAction
+    id: fulfillment-phase
+    props:
+      message: "=== Phase 3: Order Fulfillment ==="
+
+  - type: Parallel
+    id: fulfillment-tasks
+    name: Parallel Fulfillment
+    props:
+      strategy: "strict"
+    children:
+      - type: Sequence
+        id: inventory-update
+        name: Update Inventory
+        children:
+          - type: PrintAction
+            id: reserve-items
+            props:
+              message: "📦 Reserving items from inventory..."
+
+          - type: Delay
+            id: inventory-delay
+            props:
+              delayMs: 500
+            children:
+              - type: PrintAction
+                id: inventory-complete
+                props:
+                  message: "✓ Inventory updated"
+
+      - type: Sequence
+        id: shipping-label
+        name: Generate Shipping Label
+        children:
+          - type: PrintAction
+            id: create-label
+            props:
+              message: "🏷️  Generating shipping label..."
+
+          - type: Delay
+            id: shipping-delay
+            props:
+              delayMs: 500
+            children:
+              - type: PrintAction
+                id: label-complete
+                props:
+                  message: "✓ Shipping label created"
+
+      - type: PrintAction
+        id: send-confirmation
+        name: Send Confirmation Email
+        props:
+          message: "📧 Sending order confirmation email..."
+
+  # Step 5: Complete
+  - type: PrintAction
+    id: completion
+    props:
+      message: "=== Order Processing Complete ==="
+
+  - type: PrintAction
+    id: success
+    name: Success Message
+    props:
+      message: "✅ Order #12345 processed successfully!"

package/examples/yaml-workflows/06-activity-test.yaml

@@ -0,0 +1,71 @@
+# Activity Test Workflow
+#
+# This workflow demonstrates the activity execution pattern where
+# I/O operations (IntegrationAction, ParseFile, etc.) are executed
+# via Temporal activities for deterministic replay.
+#
+# Run with: BTREE_MOCK_ACTIVITIES=true to use mock responses
+#
+# Expected input:
+#   spreadsheetId: string - Google Sheets spreadsheet ID
+#   orderId: string - Order ID to append
+#   customerName: string - Customer name
+#   amount: number - Order amount
+
+type: Sequence
+id: activity-test-workflow
+children:
+  # Step 1: Log what we're about to do
+  - type: LogMessage
+    id: log-start
+    props:
+      message: "Starting activity test workflow for order ${input.orderId}"
+      level: info
+
+  # Step 2: Prepare the row data
+  - type: CodeExecution
+    id: prepare-row
+    props:
+      language: javascript
+      code: |
+        const timestamp = new Date().toISOString();
+        const orderId = getInput('orderId');
+        const customerName = getInput('customerName');
+        const amount = getInput('amount');
+
+        setBB('rowData', [orderId, customerName, amount, timestamp]);
+        setBB('timestamp', timestamp);
+        console.log('Prepared row data');
+
+  # Step 3: Execute IntegrationAction (will use activity in Temporal mode)
+  - type: IntegrationAction
+    id: append-to-sheet
+    props:
+      provider: google-sheets
+      action: append_row
+      inputs:
+        spreadsheetId: "${input.spreadsheetId}"
+        sheetName: "Orders"
+        values: "${bb.rowData}"
+      resultKey: "sheetResult"
+
+  # Step 4: Log the result
+  - type: LogMessage
+    id: log-result
+    props:
+      message: "Successfully appended row to sheet. Result: ${bb.sheetResult}"
+      level: info
+
+  # Step 5: Store summary in blackboard
+  - type: CodeExecution
+    id: create-summary
+    props:
+      language: javascript
+      code: |
+        setBB('summary', {
+          orderId: getInput('orderId'),
+          customer: getInput('customerName'),
+          amount: getInput('amount'),
+          processedAt: getBB('timestamp'),
+          sheetUpdated: true
+        });

package/examples/yaml-workflows/07-activity-simple-test.yaml

@@ -0,0 +1,43 @@
+# Simple Activity Test Workflow
+#
+# This workflow tests the activity execution pattern for IntegrationAction.
+# Uses input values directly (no Script node needed).
+#
+# Run with: BTREE_MOCK_ACTIVITIES=true to use mock responses
+#
+# Expected input:
+#   spreadsheetId: string - Google Sheets spreadsheet ID
+#   orderId: string - Order ID to append
+#   customerName: string - Customer name
+#   amount: number - Order amount
+
+type: Sequence
+id: simple-activity-test
+children:
+  # Step 1: Simple print to verify workflow starts
+  - type: PrintAction
+    id: print-start
+    props:
+      message: "Starting activity test"
+
+  # Step 2: Execute IntegrationAction (will use activity in Temporal mode)
+  # Pass input values directly - no blackboard prep needed
+  - type: IntegrationAction
+    id: append-to-sheet
+    props:
+      provider: google-sheets
+      action: append_row
+      inputs:
+        spreadsheetId: "${input.spreadsheetId}"
+        sheetName: "Orders"
+        values:
+          - "${input.orderId}"
+          - "${input.customerName}"
+          - "${input.amount}"
+      resultKey: "sheetResult"
+
+  # Step 3: Print success
+  - type: PrintAction
+    id: print-result
+    props:
+      message: "Successfully appended row"

package/examples/yaml-workflows/08-file-processing.yaml

@@ -0,0 +1,141 @@
+# File Processing Workflow
+#
+# This workflow demonstrates the complete data pipeline:
+# 1. Parse a CSV file into structured data
+# 2. Transform data using CodeExecution node
+# 3. Generate output file (CSV/Excel/JSON)
+#
+# Run with: BTREE_MOCK_ACTIVITIES=true to use mock responses
+#
+# Expected input:
+#   csvFile: string - Path to input CSV file
+
+type: Sequence
+id: file-processing-workflow
+children:
+  # Step 1: Log start
+  - type: LogMessage
+    id: log-start
+    props:
+      message: "Starting file processing workflow for ${input.csvFile}"
+      level: info
+
+  # Step 2: Parse input CSV file
+  - type: ParseFile
+    id: parse-input
+    props:
+      file: "${input.csvFile}"
+      format: csv
+      outputKey: "rawData"
+      options:
+        trim: true
+
+  # Step 3: Log parsed data info
+  - type: CodeExecution
+    id: log-parse-result
+    props:
+      language: javascript
+      code: |
+        const data = getBB('rawData') || [];
+        console.log('Parsed ' + data.length + ' rows');
+        setBB('rowCount', data.length);
+
+  - type: LogMessage
+    id: log-parsed
+    props:
+      message: "Parsed ${bb.rowCount} rows from input file"
+      level: info
+
+  # Step 4: Transform data
+  - type: CodeExecution
+    id: transform-data
+    props:
+      language: javascript
+      code: |
+        const data = getBB('rawData') || [];
+
+        // Calculate totals
+        let totalAmount = 0;
+        let totalQuantity = 0;
+
+        const processedData = data.map(function(row) {
+          const quantity = parseFloat(row.quantity) || 0;
+          const price = parseFloat(row.price) || 0;
+          const lineTotal = quantity * price;
+
+          totalAmount += lineTotal;
+          totalQuantity += quantity;
+
+          return {
+            orderId: row.orderId,
+            product: row.product,
+            quantity: quantity,
+            price: price,
+            lineTotal: lineTotal
+          };
+        });
+
+        setBB('processedData', processedData);
+        setBB('totalAmount', totalAmount);
+        setBB('totalQuantity', totalQuantity);
+        setBB('timestamp', new Date().toISOString().split('T')[0]);
+
+        console.log('Processed ' + processedData.length + ' items');
+        console.log('Total amount: ' + totalAmount);
+
+  # Step 5: Log transformation result
+  - type: LogMessage
+    id: log-transform
+    props:
+      message: "Transformed data: ${bb.processedData.length} items, total: $${bb.totalAmount}"
+      level: info
+
+  # Step 6: Generate output CSV file
+  - type: GenerateFile
+    id: export-csv
+    props:
+      format: csv
+      dataKey: "processedData"
+      columns:
+        - header: "Order ID"
+          key: "orderId"
+        - header: "Product"
+          key: "product"
+        - header: "Quantity"
+          key: "quantity"
+        - header: "Unit Price"
+          key: "price"
+        - header: "Line Total"
+          key: "lineTotal"
+      filename: "output-${bb.timestamp}.csv"
+      storage: temp
+      outputKey: "outputFile"
+
+  # Step 7: Log output file info
+  - type: LogMessage
+    id: log-output
+    props:
+      message: "Generated output file: ${bb.outputFile.filename} (${bb.outputFile.size} bytes)"
+      level: info
+
+  # Step 8: Create summary
+  - type: CodeExecution
+    id: create-summary
+    props:
+      language: javascript
+      code: |
+        setBB('summary', {
+          inputFile: getInput('csvFile'),
+          rowsProcessed: getBB('rowCount'),
+          totalQuantity: getBB('totalQuantity'),
+          totalAmount: getBB('totalAmount'),
+          outputFile: getBB('outputFile').filename,
+          outputPath: getBB('outputFile').path,
+          processedAt: new Date().toISOString()
+        });
+
+  - type: LogMessage
+    id: log-complete
+    props:
+      message: "File processing complete. Summary: ${bb.summary}"
+      level: info

package/examples/yaml-workflows/09-http-request.yaml

@@ -0,0 +1,137 @@
+# HTTP Request Workflow
+#
+# This workflow demonstrates the HttpRequest node for making API calls:
+# 1. Fetch data from an API
+# 2. Process the response
+# 3. Make a POST request with the processed data
+#
+# Run with: BTREE_MOCK_ACTIVITIES=true to use mock responses
+#
+# Expected input:
+#   userId: string - User ID to fetch
+#   apiBaseUrl: string - Base URL for API (optional, defaults to example.com)
+
+type: Sequence
+id: http-request-workflow
+children:
+  # Step 1: Log start
+  - type: LogMessage
+    id: log-start
+    props:
+      message: "Starting HTTP request workflow for user ${input.userId}"
+      level: info
+
+  # Step 2: Set default base URL if not provided
+  - type: CodeExecution
+    id: setup-config
+    props:
+      language: javascript
+      code: |
+        const apiBaseUrl = getInput('apiBaseUrl') || 'https://api.example.com';
+        setBB('apiBaseUrl', apiBaseUrl);
+        setBB('authToken', 'mock-auth-token-123');
+        console.log('API Base URL:', apiBaseUrl);
+
+  # Step 3: Fetch user data via GET request
+  - type: HttpRequest
+    id: fetch-user
+    props:
+      url: "${bb.apiBaseUrl}/users/${input.userId}"
+      method: GET
+      headers:
+        Authorization: "Bearer ${bb.authToken}"
+        Accept: "application/json"
+      timeout: 5000
+      responseType: json
+      outputKey: "userResponse"
+
+  # Step 4: Log user response
+  - type: LogMessage
+    id: log-user-response
+    props:
+      message: "Fetched user data: status=${bb.userResponse.status}"
+      level: info
+
+  # Step 5: Process user data
+  - type: CodeExecution
+    id: process-user-data
+    props:
+      language: javascript
+      code: |
+        const response = getBB('userResponse') || {};
+        const userData = response.data || {};
+        const userId = getInput('userId');
+
+        setBB('user', {
+          id: userData.id || userId,
+          name: userData.name || 'Unknown',
+          email: userData.email || 'unknown@example.com'
+        });
+
+        // Prepare order to create
+        const user = getBB('user');
+        setBB('newOrder', {
+          userId: user.id,
+          items: [
+            { productId: 'PROD-001', quantity: 2 },
+            { productId: 'PROD-002', quantity: 1 }
+          ],
+          timestamp: new Date().toISOString()
+        });
+
+        console.log('Prepared order for user:', user.name);
+
+  # Step 6: Create order via POST request
+  - type: HttpRequest
+    id: create-order
+    props:
+      url: "${bb.apiBaseUrl}/orders"
+      method: POST
+      headers:
+        Authorization: "Bearer ${bb.authToken}"
+        Content-Type: "application/json"
+      body: "${bb.newOrder}"
+      timeout: 10000
+      retry:
+        maxAttempts: 3
+        backoffMs: 1000
+      responseType: json
+      outputKey: "orderResponse"
+
+  # Step 7: Log order response
+  - type: LogMessage
+    id: log-order-response
+    props:
+      message: "Created order: status=${bb.orderResponse.status}, orderId=${bb.orderResponse.data.orderId}"
+      level: info
+
+  # Step 8: Create final summary
+  - type: CodeExecution
+    id: create-summary
+    props:
+      language: javascript
+      code: |
+        const user = getBB('user');
+        const orderResponse = getBB('orderResponse');
+        const userResponse = getBB('userResponse');
+        const newOrder = getBB('newOrder');
+
+        setBB('summary', {
+          user: user,
+          order: {
+            id: orderResponse.data?.orderId || 'unknown',
+            status: orderResponse.data?.status || 'created',
+            itemCount: newOrder.items.length
+          },
+          apiCalls: {
+            getUserStatus: userResponse.status,
+            createOrderStatus: orderResponse.status
+          },
+          completedAt: new Date().toISOString()
+        });
+
+  - type: LogMessage
+    id: log-complete
+    props:
+      message: "HTTP workflow complete. Summary: ${bb.summary}"
+      level: info