@q1k-oss/btree-workflows 0.0.1

package/behaviour-tree-workflows-landing/src/lib/yaml-examples.ts

@@ -0,0 +1,549 @@
+export interface YamlExample {
+  id: string;
+  name: string;
+  description: string;
+  yaml: string;
+  executable: boolean;
+}
+
+export const examples: YamlExample[] = [
+  {
+    id: 'simple-sequence',
+    name: 'Simple Sequence',
+    description: 'Basic sequential PrintActions',
+    executable: true,
+    yaml: `# Simple Sequence Workflow
+type: Sequence
+id: simple-sequence
+name: Simple Sequence Workflow
+children:
+  - type: PrintAction
+    id: step1
+    name: Start Step
+    props:
+      message: "Starting workflow..."
+  - type: PrintAction
+    id: step2
+    name: Process Step
+    props:
+      message: "Processing data..."
+  - type: PrintAction
+    id: step3
+    name: Complete Step
+    props:
+      message: "Workflow complete!"`,
+  },
+  {
+    id: 'parallel-timeout',
+    name: 'Parallel + Timeout',
+    description: 'Concurrent tasks with timeout protection',
+    executable: true,
+    yaml: `# Parallel Execution with Timeout
+type: Sequence
+id: parallel-timeout-root
+name: Parallel with Timeout Workflow
+children:
+  - type: Timeout
+    id: timeout
+    name: 5 Second Timeout
+    props:
+      timeoutMs: 5000
+    children:
+      - type: Parallel
+        id: parallelTasks
+        name: Parallel Tasks
+        props:
+          strategy: "strict"
+        children:
+          - type: PrintAction
+            id: task1
+            name: Task 1
+            props:
+              message: "Task 1: Fetching data..."
+          - type: PrintAction
+            id: task2
+            name: Task 2
+            props:
+              message: "Task 2: Processing..."
+          - type: PrintAction
+            id: task3
+            name: Task 3
+            props:
+              message: "Task 3: Validating..."
+  - type: PrintAction
+    id: complete
+    name: Completion Message
+    props:
+      message: "All tasks completed successfully!"`,
+  },
+  {
+    id: 'ecommerce-checkout',
+    name: 'Checkout Flow',
+    description: 'Multi-phase checkout with validation & parallel post-processing',
+    executable: true,
+    yaml: `# E-commerce Checkout Workflow
+type: Sequence
+id: checkout-workflow
+name: E-commerce Checkout
+children:
+  - type: Sequence
+    id: validation-phase
+    name: Validation Phase
+    children:
+      - type: PrintAction
+        id: validate-cart
+        props:
+          message: "Validating shopping cart..."
+      - type: PrintAction
+        id: check-inventory
+        props:
+          message: "Checking inventory availability..."
+  - type: Timeout
+    id: payment-timeout
+    props:
+      timeoutMs: 30000
+    children:
+      - type: Sequence
+        id: payment-sequence
+        children:
+          - type: PrintAction
+            id: init-payment
+            props:
+              message: "Initializing payment gateway..."
+          - type: PrintAction
+            id: charge-card
+            props:
+              message: "Charging credit card..."
+  - type: Parallel
+    id: post-checkout-tasks
+    name: Post-Checkout Tasks
+    props:
+      strategy: strict
+    children:
+      - type: Sequence
+        id: order-confirmation
+        children:
+          - type: PrintAction
+            id: send-confirmation-email
+            props:
+              message: "Sending order confirmation email..."
+          - type: PrintAction
+            id: send-sms
+            props:
+              message: "Sending SMS notification..."
+      - type: PrintAction
+        id: update-inventory
+        props:
+          message: "Updating inventory levels..."
+      - type: PrintAction
+        id: create-shipment
+        props:
+          message: "Creating shipment record..."
+  - type: PrintAction
+    id: checkout-complete
+    props:
+      message: "Checkout completed successfully!"`,
+  },
+  {
+    id: 'ai-agent',
+    name: 'AI Agent',
+    description: 'Complex: Selector, While, Recovery, Conditional',
+    executable: true,
+    yaml: `# AI Agent Decision Workflow
+type: Sequence
+id: ai-agent-workflow
+name: AI Agent Task Execution
+children:
+  - type: Sequence
+    id: agent-initialization
+    name: Agent Initialization
+    children:
+      - type: PrintAction
+        id: load-agent
+        props:
+          message: "Initializing AI agent..."
+      - type: PrintAction
+        id: load-context
+        props:
+          message: "Loading conversation context..."
+  - type: Selector
+    id: task-router
+    name: Task Type Router
+    children:
+      - type: Sequence
+        id: research-path
+        name: Research & Information Gathering
+        children:
+          - type: PrintAction
+            id: default-route
+            props:
+              message: "Executing research task..."
+          - type: Sequence
+            id: research-step
+            children:
+              - type: Selector
+                id: information-gathering
+                name: Multi-Source Info Gathering
+                children:
+                  - type: Sequence
+                    id: web-search
+                    children:
+                      - type: Timeout
+                        id: search-timeout
+                        props:
+                          timeoutMs: 10000
+                        children:
+                          - type: PrintAction
+                            id: execute-search
+                            props:
+                              message: "Searching web for information..."
+                  - type: Sequence
+                    id: knowledge-base-lookup
+                    children:
+                      - type: PrintAction
+                        id: query-kb
+                        props:
+                          message: "Querying internal knowledge base..."
+                      - type: ForceSuccess
+                        id: ensure-progress
+                        children:
+                          - type: PrintAction
+                            id: use-cached
+                            props:
+                              message: "Using cached knowledge..."
+              - type: PrintAction
+                id: synthesize-info
+                props:
+                  message: "Synthesizing information..."
+  - type: Recovery
+    id: quality-with-recovery
+    children:
+      - type: Parallel
+        id: quality-checks
+        name: Quality Assurance
+        props:
+          strategy: strict
+        children:
+          - type: PrintAction
+            id: verify-accuracy
+            props:
+              message: "Verifying accuracy of results..."
+          - type: PrintAction
+            id: verify-completeness
+            props:
+              message: "Checking completeness of response..."
+          - type: PrintAction
+            id: run-safety-filters
+            props:
+              message: "Running safety and content filters..."
+      - type: PrintAction
+        id: fallback-quality
+        props:
+          message: "Running simplified quality check..."
+      - type: PrintAction
+        id: save-results
+        props:
+          message: "Saving quality results..."
+  - type: Conditional
+    id: check-format-preference
+    props:
+      condition:
+        key: user.preferMarkdown
+        operator: "=="
+        value: true
+    children:
+      - type: PrintAction
+        id: format-markdown
+        props:
+          message: "Formatting as markdown..."
+      - type: PrintAction
+        id: format-plaintext
+        props:
+          message: "Formatting as plain text..."
+  - type: Sequence
+    id: delivery
+    name: Response Delivery
+    children:
+      - type: PrintAction
+        id: send-response
+        props:
+          message: "Sending response to user..."
+      - type: Parallel
+        id: post-delivery
+        props:
+          strategy: any
+        children:
+          - type: PrintAction
+            id: log-interaction
+            props:
+              message: "Logging interaction for analytics..."
+          - type: PrintAction
+            id: update-context
+            props:
+              message: "Updating conversation context..."
+      - type: PrintAction
+        id: agent-complete
+        props:
+          message: "AI agent workflow completed!"`,
+  },
+  {
+    id: 'order-processing',
+    name: 'Order Pipeline',
+    description: 'Order pipeline with Timeout, Parallel, Delay',
+    executable: true,
+    yaml: `# Order Processing Workflow
+type: Sequence
+id: order-processing
+name: Order Processing Workflow
+children:
+  - type: PrintAction
+    id: start
+    name: Start Order Processing
+    props:
+      message: "Starting Order Processing"
+  - 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..."
+  - 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!"
+  - 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..."
+  - type: PrintAction
+    id: success
+    name: Success Message
+    props:
+      message: "Order processed successfully!"`,
+  },
+  {
+    id: 'activity-test',
+    name: 'Activity Test',
+    description: 'CodeExecution + IntegrationAction (view-only)',
+    executable: false,
+    yaml: `# Activity Test Workflow (requires Temporal activities)
+type: Sequence
+id: activity-test-workflow
+children:
+  - type: LogMessage
+    id: log-start
+    props:
+      message: "Starting activity test workflow"
+      level: info
+  - type: CodeExecution
+    id: prepare-row
+    props:
+      language: javascript
+      code: |
+        const timestamp = new Date().toISOString();
+        setBB('rowData', ['ORD-001', 'Alice', 99.99, timestamp]);
+  - type: IntegrationAction
+    id: append-to-sheet
+    props:
+      provider: google-sheets
+      action: append_row
+      inputs:
+        spreadsheetId: "example-spreadsheet-id"
+        sheetName: "Orders"
+        values: "\${bb.rowData}"
+      resultKey: "sheetResult"
+  - type: LogMessage
+    id: log-result
+    props:
+      message: "Appended row to sheet"
+      level: info`,
+  },
+  {
+    id: 'file-processing',
+    name: 'File Processing',
+    description: 'ParseFile + GenerateFile pipeline (view-only)',
+    executable: false,
+    yaml: `# File Processing Workflow (requires Temporal activities)
+type: Sequence
+id: file-processing-workflow
+children:
+  - type: LogMessage
+    id: log-start
+    props:
+      message: "Starting file processing"
+      level: info
+  - type: ParseFile
+    id: parse-input
+    props:
+      file: "input.csv"
+      format: csv
+      outputKey: "rawData"
+      options:
+        trim: true
+  - type: CodeExecution
+    id: transform-data
+    props:
+      language: javascript
+      code: |
+        const data = getBB('rawData') || [];
+        const processed = data.map(row => ({
+          ...row,
+          lineTotal: row.quantity * row.price
+        }));
+        setBB('processedData', processed);
+  - type: GenerateFile
+    id: export-csv
+    props:
+      format: csv
+      dataKey: "processedData"
+      columns:
+        - header: "Order ID"
+          key: "orderId"
+        - header: "Product"
+          key: "product"
+        - header: "Total"
+          key: "lineTotal"
+      filename: "output.csv"
+      storage: temp
+      outputKey: "outputFile"
+  - type: LogMessage
+    id: log-complete
+    props:
+      message: "File processing complete"
+      level: info`,
+  },
+  {
+    id: 'http-request',
+    name: 'HTTP Request',
+    description: 'HttpRequest + CodeExecution pipeline (view-only)',
+    executable: false,
+    yaml: `# HTTP Request Workflow (requires Temporal activities)
+type: Sequence
+id: http-request-workflow
+children:
+  - type: LogMessage
+    id: log-start
+    props:
+      message: "Starting HTTP request workflow"
+      level: info
+  - type: CodeExecution
+    id: setup-config
+    props:
+      language: javascript
+      code: |
+        setBB('apiBaseUrl', 'https://api.example.com');
+        setBB('authToken', 'mock-auth-token-123');
+  - type: HttpRequest
+    id: fetch-user
+    props:
+      url: "\${bb.apiBaseUrl}/users/123"
+      method: GET
+      headers:
+        Authorization: "Bearer \${bb.authToken}"
+      timeout: 5000
+      responseType: json
+      outputKey: "userResponse"
+  - type: CodeExecution
+    id: process-user-data
+    props:
+      language: javascript
+      code: |
+        const response = getBB('userResponse') || {};
+        setBB('user', { id: '123', name: response.data?.name || 'User' });
+  - 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
+      responseType: json
+      outputKey: "orderResponse"
+  - type: LogMessage
+    id: log-complete
+    props:
+      message: "HTTP workflow complete"
+      level: info`,
+  },
+];

package/behaviour-tree-workflows-landing/src/main.tsx

@@ -0,0 +1,9 @@
+import React from 'react';
+import ReactDOM from 'react-dom/client';
+import App from './App';
+
+ReactDOM.createRoot(document.getElementById('root')!).render(
+  <React.StrictMode>
+    <App />
+  </React.StrictMode>,
+);

package/behaviour-tree-workflows-landing/src/stubs/activepieces.ts

@@ -0,0 +1,18 @@
+// Stub for @activepieces/* packages -- not available in the browser
+export const googleSheets = { _actions: {} };
+export const createPiece = () => ({});
+export const Property = {
+  ShortText: () => ({}),
+  LongText: () => ({}),
+  Number: () => ({}),
+  Checkbox: () => ({}),
+  Dropdown: () => ({}),
+  Array: () => ({}),
+  Object: () => ({}),
+  Json: () => ({}),
+  DateTime: () => ({}),
+  File: () => ({}),
+  OAuth2: () => ({}),
+};
+export const PieceAuth = { OAuth2: () => ({}) };
+export default { googleSheets, createPiece, Property, PieceAuth };

package/behaviour-tree-workflows-landing/src/stubs/fs.ts

@@ -0,0 +1,24 @@
+// Stub for fs and fs/promises -- not available in the browser
+export function readFileSync(): string { return ''; }
+export function writeFileSync(): void {}
+export function existsSync(): boolean { return false; }
+export function readdirSync(): string[] { return []; }
+export function mkdirSync(): void {}
+export async function readFile(): Promise<string> { return ''; }
+export async function writeFile(): Promise<void> {}
+export async function readdir(): Promise<string[]> { return []; }
+export async function mkdir(): Promise<undefined> { return undefined; }
+export async function stat(): Promise<{ isFile: () => boolean; isDirectory: () => boolean }> {
+  return { isFile: () => false, isDirectory: () => false };
+}
+export async function access(): Promise<void> {}
+
+export const promises = {
+  readFile,
+  writeFile,
+  readdir,
+  mkdir,
+  stat,
+  access,
+};
+export default { readFileSync, writeFileSync, existsSync, readdirSync, mkdirSync, promises };

package/behaviour-tree-workflows-landing/src/stubs/path.ts

@@ -0,0 +1,16 @@
+// Stub for path -- not available in the browser
+export function join(...parts: string[]): string { return parts.join('/'); }
+export function resolve(...parts: string[]): string { return parts.join('/'); }
+export function basename(p: string, ext?: string): string {
+  const base = p.split('/').pop() || p;
+  return ext && base.endsWith(ext) ? base.slice(0, -ext.length) : base;
+}
+export function extname(p: string): string {
+  const dot = p.lastIndexOf('.');
+  return dot >= 0 ? p.slice(dot) : '';
+}
+export function dirname(p: string): string {
+  return p.split('/').slice(0, -1).join('/') || '.';
+}
+export const sep = '/';
+export default { join, resolve, basename, extname, dirname, sep };

package/behaviour-tree-workflows-landing/src/stubs/temporal-activity.ts

@@ -0,0 +1,6 @@
+// Stub for @temporalio/activity -- not available in the browser
+export const Context = {
+  current() {
+    return { heartbeat() {} };
+  },
+};

package/behaviour-tree-workflows-landing/src/stubs/temporal-workflow.ts

@@ -0,0 +1,22 @@
+// Stub for @temporalio/workflow -- not available in the browser
+export function proxyActivities<T>(): T {
+  return {} as T;
+}
+export function sleep(_ms: number): Promise<void> {
+  return new Promise((r) => setTimeout(r, _ms));
+}
+export function setHandler() {}
+export function defineQuery() { return () => {}; }
+export function defineSignal() { return () => {}; }
+export function defineUpdate() { return () => {}; }
+export function isCancellation(_err: unknown): boolean { return false; }
+export function proxySinks<T>(): T { return {} as T; }
+export const condition = () => Promise.resolve(true);
+export const workflowInfo = () => ({ workflowId: 'playground', runId: 'local', namespace: 'default' });
+export class CancellationScope {
+  static cancellable<T>(fn: () => Promise<T>): Promise<T> { return fn(); }
+  static nonCancellable<T>(fn: () => Promise<T>): Promise<T> { return fn(); }
+}
+
+// Type stubs
+export interface Sinks { [name: string]: Record<string, (...args: unknown[]) => void>; }

package/behaviour-tree-workflows-landing/tsconfig.json

@@ -0,0 +1,25 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "useDefineForClassFields": true,
+    "lib": ["ES2020", "DOM", "DOM.Iterable"],
+    "module": "ESNext",
+    "skipLibCheck": true,
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "isolatedModules": true,
+    "moduleDetection": "force",
+    "noEmit": true,
+    "jsx": "react-jsx",
+    "strict": true,
+    "noUnusedLocals": false,
+    "noUnusedParameters": false,
+    "noFallthroughCasesInSwitch": true,
+    "forceConsistentCasingInFileNames": true,
+    "baseUrl": ".",
+    "paths": {
+      "@btree/*": ["../src/*"]
+    }
+  },
+  "include": ["src", "../src"]
+}