jsfe 0.1.0 → 0.2.0

package/README.md

@@ -15,170 +15,190 @@ npm i jsfe
 *For detailed tutorials, step-by-step examples, and comprehensive workflow patterns, see the **[User Guide](JavaScript%20Flow%20Engine.md)**.*
 
 ## Usage
-\`\`\`ts
+
+```typescript
 import { WorkflowEngine } from "jsfe";
+
+// 1. Create the engine
 const engine = new WorkflowEngine(
-  hostLogger: Logger, // logger instance like winston - supporting .info/.debug/.warn/.error methods
-  aiCallback: AiCallbackFunction, // host provided access to AI fetch function aiFetcher(systemInstructions, userMessage) -> response string
-  flowsMenu: FlowDefinition[], // host defined available flows
-  toolsRegistry: ToolDefinition[], // host defined tools registry
-  APPROVED_FUNCTIONS: ApprovedFunctions, // Optional host provided safe functions map
-  globalVariables?: Record<string, unknown> // Optional global variables shared across all new flows
-  validateOnInit: boolean = true, // Optional validate all flows an enggine initialization
-  language?: string, // Optional language code
-  messageRegistry?: MessageRegistry, // Optional override all engine internationalized messages
-  guidanceConfig?: GuidanceConfig, // Optional overide default internationalized guidance prompts
+  hostLogger,          // Your logging instance
+  aiCallback,          // Your AI communication function
+  flowsMenu,           // Array of flow definitions
+  toolsRegistry,       // Array of tool definitions
+  APPROVED_FUNCTIONS,  // Pre-approved local functions
+  globalVariables,     // Optional: Session-wide variables
+  validateOnInit,      // Optional: Enable pre-flight validation (default: true)
+  language,            // Optional: User's preferred language
+  messageRegistry,     // Optional: Custom message templates
+  guidanceConfig       // Optional: User assistance configuration
 );
 
-\`\`\`
+// 2. Initialize a session for each user
+const sessionContext = engine.initSession(yourLogger, 'user-123', 'session-456');
+
+// 3. Process user input and assistant responses
+const result = await engine.updateActivity(contextEntry, sessionContext);
+```
+
+### Session Management
+
+- Each user requires a unique session context via `initSession(logger, userId, sessionId)`
+- The `EngineSessionContext` object should be persisted by your application
+- Pass the same session context to `updateActivity` for conversation continuity
+
+### Context Entry Types
+
+- User input: `contextEntry.role = 'user'` - analyzed and may trigger flow execution
+- Assistant response: `contextEntry.role = 'assistant'` - added to context for awareness
+
+### ContextEntry Structure
 
-/*
-==========================================
-ENHANCED FLOW ENGINE ARCHITECTURE OVERVIEW
-==========================================
+```typescript
+interface ContextEntry {
+  role: 'user' | 'assistant' | 'system' | 'tool';  // Message role type
+  content: string | Record<string, unknown>;       // Message content (text, object, etc.)
+  timestamp: number;                               // Unix timestamp in milliseconds
+  stepId?: string;                                 // Optional: Associated flow step ID
+  toolName?: string;                               // Optional: Tool name for tool messages
+  metadata?: Record<string, unknown>;              // Optional: Additional context data
+}
+```
+
+### Example Usage
+
+```typescript
+// User message
+const userEntry = {
+  role: 'user',
+  content: 'I need help with my account',
+  timestamp: Date.now()
+};
+// Process the message
+await engine.updateActivity(userEntry, sessionContext);
+
+// Assistant response  
+const assistantEntry = {
+  role: 'assistant',
+  content: 'I can help you with your account. What specific issue are you experiencing?',
+  timestamp: Date.now(),
+  stepId: 'greeting-step'
+};
+// Process the message
+await engine.updateActivity(assistantEntry, sessionContext);
+```
+
+## Architecture Overview
 
-MAJOR DESIGN ENHANCEMENT: Stack-of-Stacks Architecture for Flow Interruption/Resumption
+### Stack-of-Stacks Design
 
-This Flow Engine implements a sophisticated "stack-of-stacks" architecture that allows flows to be 
-suspended and resumed, enabling users to naturally interrupt one workflow to handle another task,
-then return to their original workflow seamlessly.
+The Flow Engine implements a sophisticated "stack-of-stacks" architecture that allows flows to be suspended and resumed, enabling users to naturally interrupt one workflow to handle another task, then return to their original workflow seamlessly.
 
-==========================================
-CORE ARCHITECTURE COMPONENTS
-==========================================
+#### Core Components
 
-1. STACK-OF-STACKS DESIGN:
-   - Multiple independent flow execution stacks
+1. **Multiple Independent Flow Execution Stacks**
    - Active stack index tracks current execution context
    - Automatic stack switching for flow interruption/resumption
    - Proper isolation between different workflow contexts
 
-2. FLOW FRAME STRUCTURE:
+2. **Flow Frame Structure**
    Each flow execution maintains a complete context frame:
-   - flowName, flowId, flowVersion: Flow identity and versioning
-   - flowStepsStack: Remaining steps (reversed for efficient pop operations)
-   - contextStack: Complete history of inputs and responses
-   - inputStack: Current input context for step execution
-   - variables: Unified flat variable storage (shared across sub-flows)
-   - transaction: Comprehensive transaction management and audit trail
-   - userId, startTime: User context and timing metadata
-
-3. HELPER FUNCTION ARCHITECTURE:
+   ```typescript
+   {
+     flowName: string,          // Human-readable flow name
+     flowId: string,            // Unique flow identifier
+     flowVersion: string,       // Flow version for compatibility
+     flowStepsStack: [...],     // Remaining steps (reversed)
+     contextStack: [...],       // Complete interaction history
+     inputStack: [...],         // Current input context
+     variables: {},             // Unified variable storage
+     transaction: TransactionObj, // Audit and transaction tracking
+     userId: string,            // User identifier
+     startTime: number,         // Flow start timestamp
+     pendingVariable: string,   // Variable awaiting user input
+     lastSayMessage: string,    // Last SAY step output
+     pendingInterruption: {}    // Interruption state management
+   }
+   ```
+
+3. **Helper Function Architecture**
    All stack operations go through centralized helper functions:
-   - initializeFlowStacks(engine): Ensures proper structure
-   - getCurrentStack(engine): Gets currently active stack
-   - getCurrentStackLength(engine): Safe length checking
-   - pushToCurrentStack(engine, frame): Adds flow to active stack
-   - popFromCurrentStack(engine): Removes flow from active stack
-   - createNewStack(engine): Creates new stack for interruptions
-   - switchToPreviousStack(engine): Returns to previous context
-
-==========================================
-DATA STRUCTURES & PROPERTIES
-==========================================
-
-FLOW FRAME PROPERTIES:
-{
-  flowName: string,          // Human-readable flow name
-  flowId: string,            // Unique flow identifier
-  flowVersion: string,       // Flow version for compatibility
-  flowStepsStack: [...],     // Remaining steps (reversed)
-  contextStack: [...],       // Complete interaction history
-  inputStack: [...],         // Current input context
-  variables: {},             // Unified variable storage
-  transaction: TransactionObj, // Audit and transaction tracking
-  userId: string,            // User identifier
-  startTime: number,         // Flow start timestamp
-  pendingVariable: string,   // Variable awaiting user input
-  lastSayMessage: string,    // Last SAY step output
-  pendingInterruption: {}    // Interruption state management
-}
+   - `initializeFlowStacks(engine)`: Ensures proper structure
+   - `getCurrentStack(engine)`: Gets currently active stack
+   - `pushToCurrentStack(engine, frame)`: Adds flow to active stack
+   - `popFromCurrentStack(engine)`: Removes flow from active stack
 
-========================================
-SUPPORTED FEATURES & CAPABILITIES
-========================================
-
-FLOW EXECUTION MODES:
-✅ Linear Flow Execution - Sequential step processing
-✅ Sub-Flow Calls - Nested workflow execution
-✅ Flow Interruption - Suspend current flow for new task
-✅ Flow Resumption - Return to previously suspended flows
-✅ Flow Replacement - Replace current flow with new flow
-✅ Flow Reboot - Nuclear option: clear all flows and restart
-
-CALL TYPE BEHAVIORS:
-✅ "call" (default) - Normal sub-flow, preserves parent on stack
-✅ "replace" - Replace current flow with new flow
-✅ "reboot" - Clear entire stack and start fresh (emergency recovery)
-
-STEP TYPE SUPPORT:
-✅ SAY - Non-blocking output messages (accumulated)
-✅ SAY-GET - Blocking output with user input request
-✅ SET - Variable assignment with interpolation support
-✅ CALL-TOOL - External tool execution with error handling
-✅ FLOW - Sub-flow execution with multiple call types
-✅ SWITCH - Enhanced conditional branching with expressions
-
-ADVANCED SWITCH CONDITIONS:
-✅ Exact Value Matching - Traditional switch behavior
-✅ Expression Evaluation - Dynamic condition evaluation using safe JavaScript expressions
-✅ Mixed Branches - Combine exact matches with conditions
-✅ Secure Evaluation - No eval(), no code injection, safe expression parsing
-✅ Expression Templates - {{variable + otherVar}} and {{complex.expression > threshold}} support
-
-EXPRESSION TEMPLATE SYSTEM:
-The engine supports safe JavaScript expressions within {{}} templates:
-- Simple variables: {{userName}}, {{account.balance}}
-- Arithmetic: {{amount + fee}}, {{price * quantity}}
-- Comparisons: {{age >= 18}}, {{status === 'active'}}
-- Logical: {{isAdmin && hasAccess}}, {{retryCount < maxRetries}}
-- Complex: {{user.permissions.includes('admin') && creditScore > 700}}
-
-SAFE METHOD CALLS:
-The engine includes comprehensive security controls that allow only pre-approved methods:
+## Features & Capabilities
 
-**String Methods:**
-✅ Case conversion: toLowerCase(), toUpperCase()
-✅ Whitespace: trim(), padStart(), padEnd()
-✅ Access: charAt(), charCodeAt(), indexOf(), lastIndexOf()
-✅ Extraction: substring(), substr(), slice(), split()
-✅ Search: includes(), startsWith(), endsWith(), match(), search()
-✅ Manipulation: replace(), repeat(), concat()
-✅ Utility: toString(), valueOf(), length, localeCompare(), normalize()
+### Flow Execution Modes
+- ✅ **Linear Flow Execution** - Sequential step processing
+- ✅ **Sub-Flow Calls** - Nested workflow execution
+- ✅ **Flow Interruption** - Suspend current flow for new task
+- ✅ **Flow Resumption** - Return to previously suspended flows
+- ✅ **Flow Replacement** - Replace current flow with new flow
+- ✅ **Flow Reboot** - Nuclear option: clear all flows and restart
 
-**Array Methods:**
-✅ Inspection: length, includes(), indexOf(), lastIndexOf()
-✅ Extraction: slice(), join()
-✅ Conversion: toString(), valueOf()
+### Step Types
+- ✅ **SAY** - Non-blocking output messages (accumulated)
+- ✅ **SAY-GET** - Blocking output with user input request
+- ✅ **SET** - Variable assignment with interpolation support
+- ✅ **CALL-TOOL** - External tool execution with error handling
+- ✅ **FLOW** - Sub-flow execution with multiple call types
+- ✅ **SWITCH** - Enhanced conditional branching with expressions
 
-**Math Methods:**
-✅ Basic: abs(), ceil(), floor(), round()
-✅ Comparison: max(), min()
-✅ Advanced: pow(), sqrt(), random()
+### Expression Template System
 
-**Examples:**
+The engine supports safe JavaScript expressions within `{{}}` templates:
+
+```javascript
+// Simple variables
+{{userName}}, {{account.balance}}
+
+// Arithmetic
+{{amount + fee}}, {{price * quantity}}
+
+// Comparisons
+{{age >= 18}}, {{status === 'active'}}
+
+// Logical operations
+{{isAdmin && hasAccess}}, {{retryCount < maxRetries}}
+
+// Complex expressions
+{{user.permissions.includes('admin') && creditScore > 700}}
+```
+
+### Safe Method Calls
+
+**String Methods:**
 ```javascript
-// String processing
+// Case conversion
 {{userInput.toLowerCase().trim()}}
+
+// Email validation
 {{email.includes('@') && email.length > 5}}
+
+// Text processing
 {{text.substring(0, 10).padEnd(15, '...')}}
+```
 
-// Array operations  
+**Array Methods:**
+```javascript
+// Length and content checks
 {{items.length > 0 && items.includes('premium')}}
-{{categories.slice(0, 3).join(', ')}}
 
-// Mathematical operations
-{{Math.round(price * 1.08)}} // Tax calculation
-{{Math.max(balance, 0)}} // Ensure non-negative
+// Array manipulation
+{{categories.slice(0, 3).join(', ')}}
 ```
 
-SAFE FUNCTIONS:
-✅ **Built-in Functions:** parseInt(), parseFloat(), isNaN(), isFinite()
-✅ **Type Conversion:** String(), Number(), Boolean() (non-constructor forms)
-✅ **URI Encoding:** encodeURIComponent(), decodeURIComponent(), encodeURI(), decodeURI()
-✅ **User-Defined Functions:** Any functions registered in the APPROVED_FUNCTIONS registry
+**Math Methods:**
+```javascript
+// Tax calculation
+{{Math.round(price * 1.08)}}
 
-**Examples:**
+// Ensure non-negative
+{{Math.max(balance, 0)}}
+```
+
+**Safe Functions:**
 ```javascript
 // Type conversion and validation
 {{Number(input) > 0 && !isNaN(Number(input))}}
@@ -189,422 +209,51 @@ SAFE FUNCTIONS:
 
 // User-defined approved functions
 {{currentTime()}} // If registered as approved function
-{{extractCryptoFromInput(userMessage)}} // If registered as approved function to provide Custom business logic
+{{extractCryptoFromInput(userMessage)}} // Custom business logic
 ```
 
-INTELLIGENT ERROR HANDLING:
-✅ Smart Default OnFail - Context-aware error recovery
-✅ Financial Operation Protection - Special handling for sensitive flows
-✅ Network Error Recovery - Intelligent retry and messaging
-✅ Graceful Degradation - Maintain user experience during failures
-✅ Transaction Rollback - Proper cleanup on critical failures
-
-FLOW CONTROL COMMANDS:
-✅ Universal Commands - Work in any flow context
-✅ "cancel"/"abort" - Exit current flow
-✅ "help" - Context-sensitive help messages
-✅ "status" - Current flow state information
-
-
-INTENT INTERRUPTION SYSTEM:
-✅ AI-Powered Intent Detection - Recognize new workflow requests (when `aiCallback` is provided)
-✅ Fallback Flow Matching - If `aiCallback` is `null`, the engine will match the user input to a flow by id or name (case-insensitive), and if no exact match is found, will attempt a partial match. This allows demos and tests to run without requiring a real AI function.
-✅ Three-Tier Intent Strength - Weak/Medium/Strong intent classification
-✅ Financial Flow Protection - Require explicit confirmation
-✅ Graceful Interruption - Preserve context while switching
-✅ Smart Resume Logic - Automatic return to suspended flows
+## Demo/Test Mode: Flow Matching Without AI
 
----
-
-## ⚡️ Demo/Test Mode: Flow Matching Without AI
-
-For demos, tests, or developer convenience, you can now set `aiCallback` to `null` when constructing the engine. In this mode, intent detection will:
+For demos, tests, or developer convenience, you can set `aiCallback` to `null` when constructing the engine. In this mode, intent detection will:
 
 1. **Match by Flow Name or ID (case-insensitive):**
-  - If the user input exactly matches a flow's `name` or `id`, that flow is activated.
+   - If the user input exactly matches a flow's `name` or `id`, that flow is activated.
 2. **Partial Match Fallback:**
-  - If no exact match is found, the engine will look for a flow whose `name` or `id` contains the input (case-insensitive).
+   - If no exact match is found, the engine will look for a flow whose `name` or `id` contains the input (case-insensitive).
 3. **No Match:**
-  - If no match is found, no flow is activated.
+   - If no match is found, no flow is activated.
 
 This makes it easy to run demos and tests without requiring a real AI intent detection function. In production, always provide a real `aiCallback` for robust intent detection.
 
-========================================
-SECURITY & COMPLIANCE FEATURES
-========================================
-
-EXPRESSION SECURITY:
-✅ Safe Expression Evaluation - No eval(), no code injection, allowlist-based safe method calls
-✅ Safe Method Allowlist - Only pre-approved string, array, and math methods allowed
-✅ Safe Function Registry - Built-in safe functions + user-defined approved functions
-✅ Pattern-Based Security - Block dangerous operations (constructors, eval, etc.)
-✅ Variable Path Validation - Secure nested property access
-✅ Input Sanitization - Clean and validate all user inputs
-
-TRANSACTION MANAGEMENT:
-✅ Comprehensive Audit Trail - Every action logged
-✅ Transaction State Tracking - Success/failure/pending states
-✅ Error Recovery Logging - Detailed failure analysis
-✅ User Context Isolation - Prevent cross-user data leaks
-
-RATE LIMITING & VALIDATION:
-✅ Per-User Rate Limiting - Prevent abuse
-✅ JSON Schema Validation - Type-safe parameter handling
-✅ Input Size Limits - Prevent memory exhaustion
-✅ Timeout Management - Prevent hanging operations
-
-========================================
-INTEGRATION CAPABILITIES
-========================================
-
-REST API SUPPORT:
-✅ HTTP Methods: GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS
-✅ Content Types: JSON, Form-data, URL-encoded, XML/SOAP, Plain text, Multipart
-✅ Authentication: Bearer tokens, Basic auth, API keys, HMAC signatures
-✅ Parameter Handling: Path params, Query params, Request body, Headers
-✅ Advanced Features: Retries with exponential backoff, Timeouts, Rate limiting
-✅ Response Handling: JSON, XML, Text with automatic content-type detection
-✅ DECLARATIVE RESPONSE MAPPING: Secure, generic transformation without code injection
-✅ Error Handling: Status-based retry logic, Detailed error messages
-✅ Security: Input sanitization, Credential management, Audit logging
-
-DECLARATIVE RESPONSE MAPPING SYSTEM:
-The engine supports completely generic response transformation through declarative 
-JSON configuration, eliminating the need for users to inject code. This maintains 
-complete engine security while supporting complex API response handling.
-
-MAPPING TYPES SUPPORTED:
-
-1. JSONPATH MAPPING - Extract and transform specific fields:
-{
-  responseMapping: {
-    type: "jsonPath",
-    mappings: {
-      "output_field": {
-        path: "api.response.field[0].value",
-        transform: { type: "parseInt", fallback: 0 },
-        fallback: "$args.inputField"
-      }
-    }
-  }
-}
+## Security & Compliance
 
-2. OBJECT MAPPING - Restructure response objects:
-{
-  responseMapping: {
-    type: "object", 
-    mappings: {
-      "user_name": "name",
-      "contact": {
-        "email": "email",
-        "phone": "phone"
-      },
-      "metadata": {
-        "processed": true,
-        "timestamp": "{{new Date().toISOString()}}"
-      }
-    }
-  }
-}
+### Expression Security
+- ✅ **Safe Expression Evaluation** - No eval(), no code injection
+- ✅ **Safe Method Allowlist** - Only pre-approved methods allowed
+- ✅ **Pattern-Based Security** - Block dangerous operations
+- ✅ **Variable Path Validation** - Secure nested property access
 
-3. ARRAY MAPPING - Filter and transform arrays:
-{
-  responseMapping: {
-    type: "array",
-    source: "results",
-    limit: 10,
-    filter: { field: "status", operator: "equals", value: "active" },
-    itemMapping: {
-      type: "object",
-      mappings: { "id": "id", "name": "name" }
-    }
-  }
-}
+### Transaction Management
+- ✅ **Comprehensive Audit Trail** - Every action logged
+- ✅ **Transaction State Tracking** - Success/failure/pending states
+- ✅ **Error Recovery Logging** - Detailed failure analysis
+- ✅ **User Context Isolation** - Prevent cross-user data leaks
 
-4. TEMPLATE MAPPING - String interpolation:
-{
-  responseMapping: {
-    type: "template",
-    template: "User {{name}} ({{email}}) from {$args.source}"
-  }
-}
+## Integration Capabilities
 
-5. CONDITIONAL MAPPING - Different mapping based on response structure:
-{
-  responseMapping: {
-    type: "conditional",
-    conditions: [
-      {
-        if: { field: "status", operator: "equals", value: "success" },
-        then: { type: "object", mappings: { "result": "data" } }
-      }
-    ],
-    else: { type: "object", mappings: { "error": "message" } }
-  }
-}
+### REST API Support
+- ✅ **HTTP Methods:** GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS
+- ✅ **Content Types:** JSON, Form-data, URL-encoded, XML/SOAP, Plain text, Multipart
+- ✅ **Authentication:** Bearer tokens, Basic auth, API keys, HMAC signatures
+- ✅ **Parameter Handling:** Path params, Query params, Request body, Headers
+- ✅ **Advanced Features:** Retries with exponential backoff, Timeouts, Rate limiting
 
-VALUE TRANSFORMATIONS SUPPORTED:
-- parseInt, parseFloat: Number conversion
-- toLowerCase, toUpperCase, trim: String manipulation  
-- replace: Regex replacement
-- concat: Add prefix/suffix
-- regex: Extract with regex groups
-- date: Convert to ISO date string
-- default: Fallback values
-
-SECURITY & BEST PRACTICES:
-- No code injection possible - all transformations are declarative
-- Secure path traversal with validation
-- Fallback handling for missing data
-- Type coercion with validation
-- Error handling with graceful degradation
-
-========================================
-IMPLEMENTATION NOTES & BEST PRACTICES
-========================================
-
-PROPER USAGE PATTERNS:
-1. Always use helper functions for stack operations
-2. Never directly access flowStacks arrays
-3. Maintain transaction state consistency
-4. Use proper error handling with smart defaults
-5. Implement comprehensive logging for debugging
-
-========================================
-🚀 ENHANCED TRANSFORMATION CAPABILITIES
-========================================
-
-The JavaScript Flow Engine now includes a comprehensive suite of mathematical, temporal, 
-and template processing enhancements that enable sophisticated data transformations 
-without code injection risks.
-
-MATHEMATICAL OPERATIONS:
-✅ `add` - Addition with precision control: `{ type: "add", addend: 10, precision: 2 }`
-✅ `subtract` - Subtraction with precision control: `{ type: "subtract", subtrahend: 5, precision: 2 }`
-✅ `multiply` - Multiplication: `{ type: "multiply", multiplier: 1.08, precision: 2 }`
-✅ `divide` - Division with zero protection: `{ type: "divide", divisor: 100, precision: 2 }`
-✅ `percentage` - Percentage calculation: `{ type: "percentage", divisor: 1000, precision: 1 }`
-✅ `abs`, `round`, `floor`, `ceil` - Mathematical functions
-
-DATE-BASED CALCULATIONS:
-✅ `currentYear` - Get current year: `{ type: "currentYear" }`
-✅ `yearDifference` - Calculate age/duration: `{ type: "yearDifference" }` (current year - value)
-✅ Dynamic age calculations, time-based transformations
-
-ARRAY AGGREGATIONS:
-✅ `sum` - Sum array values: `{ type: "sum", field: "budget" }` (for object arrays)
-✅ `average` - Calculate mean: `{ type: "average", field: "employees", precision: 1 }`
-✅ `count` - Count non-null values: `{ type: "count", field: "active" }`
-✅ `min` - Find minimum: `{ type: "min", field: "price" }`
-✅ `max` - Find maximum: `{ type: "max", field: "score" }`
-
-ENHANCED TEMPLATE SYSTEM:
-✅ **Array Length Access**: `{{array.length}}` automatically supported
-✅ **Handlebars-Style Iteration**: `{{#each items}}...{{/each}}` with full nesting
-✅ **Context Variables**: `{{@index}}` (current index), `{{@last}}` (is last item)
-✅ **Conditional Rendering**: `{{#unless @last}}separator{{/unless}}`
-✅ **Nested Property Access**: `{{item.nested.property}}`
-
-REAL-WORLD EXAMPLES:
-
-**Age Calculation:**
-```json
-{
-  "path": "user.birthYear", 
-  "transform": { "type": "yearDifference" }
-}
-```
-Input: `2015` → Output: `10` (automatically calculated as 2025 - 2015)
-
-**Financial Aggregations:**
-```json
-{
-  "path": "departments",
-  "transform": { 
-    "type": "sum", 
-    "field": "budget",
-    "precision": 0
-  }
-}
-```
-Input: `[{budget: 8500000}, {budget: 3200000}]` → Output: `11700000`
+### Declarative Response Mapping
 
-**Complex Template with Arrays:**
-```json
-{
-  "type": "template",
-  "template": "Operating in {{locations.length}} locations: {{#each locations}}{{city}}, {{country}} ({{employees}} employees){{#unless @last}}; {{/unless}}{{/each}}"
-}
-```
-Input: Array of locations → Output: `"Operating in 3 locations: San Francisco, USA (150 employees); London, UK (60 employees); Toronto, Canada (40 employees)"`
+The engine supports completely generic response transformation through declarative JSON configuration:
 
-**Percentage Calculations:**
-```json
-{
-  "path": "completedProjects",
-  "transform": {
-    "type": "percentage", 
-    "divisor": "{{totalProjects}}",
-    "precision": 1
-  }
-}
-```
-Input: `19` completed, `30` total → Output: `63.3` (percentage)
-
-CONTRIBUTORS: Areas for Future Enhancement
-✅ **Current Coverage**: Mathematical, temporal, aggregation, template processing
-⚠️ **Missing Operations**: Trigonometric functions (sin, cos, tan)
-⚠️ **Missing Date Functions**: Date formatting, timezone conversions, date arithmetic
-⚠️ **Missing String Functions**: Advanced regex operations, locale-specific formatting
-⚠️ **Missing Array Functions**: Complex filtering, sorting, grouping operations
-⚠️ **Missing Template Features**: Nested loops, advanced conditionals, custom helpers
-
-========================================
-📋 COMPREHENSIVE FEATURE MATRIX FOR CONTRIBUTORS
-========================================
-
-This section provides a complete overview of implemented features and identifies 
-areas where contributors can add value. All features maintain the engine's security 
-model (no code injection, declarative-only transformations).
-
-FLOW EXECUTION ENGINE:
-✅ **Stack-of-stacks architecture** - Complete with interruption/resumption
-✅ **Flow frame management** - Variables, context, transaction tracking
-✅ **Step types** - SAY, SAY-GET, SET, CALL-TOOL, FLOW, SWITCH
-✅ **Expression evaluation** - Safe JavaScript expressions with allowlist
-✅ **Error handling** - Smart defaults, financial protection, graceful degradation
-✅ **Intent detection** - AI-powered + fallback flow matching
-✅ **Universal commands** - help, status, cancel, exit
-
-TRANSFORMATION SYSTEM:
-✅ **Basic types** - parseInt, parseFloat, toLowerCase, toUpperCase, trim
-✅ **String operations** - replace, concat, regex, substring, split, join
-✅ **Mathematical** - add, subtract, multiply, divide, percentage, abs, round, floor, ceil
-✅ **Date/Time** - currentYear, yearDifference, ISO date conversion
-✅ **Array aggregations** - sum, average, count, min, max (with field targeting)
-✅ **Conditional logic** - Multi-branch conditions with operators
-✅ **Template processing** - Simple placeholders + Handlebars-style iteration
-✅ **Default/fallback** - Robust null handling
-
-RESPONSE MAPPING SYSTEM:
-✅ **JSONPath mapping** - Deep object extraction with transformations
-✅ **Object mapping** - Restructuring and field remapping
-✅ **Array mapping** - Filtering, limiting, item transformation
-✅ **Template mapping** - String interpolation with complex iteration
-✅ **Conditional mapping** - Response-structure-based branching
-
-REST API INTEGRATION:
-✅ **HTTP methods** - GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS
-✅ **Content types** - JSON, form-data, URL-encoded, XML/SOAP, text, multipart
-✅ **Authentication** - Bearer, Basic, API keys, HMAC signatures
-✅ **Parameters** - Path params, query params, body, headers
-✅ **Advanced features** - Retries, timeouts, rate limiting
-✅ **Response handling** - Auto content-type detection, declarative mapping
-
-SECURITY & COMPLIANCE:
-✅ **Expression security** - Safe evaluation, method allowlist, no eval()
-✅ **Transaction management** - Audit trails, state tracking, recovery
-✅ **Rate limiting** - Per-user controls, abuse prevention
-✅ **Input validation** - JSON Schema, size limits, sanitization
-✅ **Credential management** - Secure token handling, audit logging
-
-AREAS FOR CONTRIBUTOR ENHANCEMENT (very liberal AI based 🫣 ):
-
-🔢 **MATHEMATICAL EXTENSIONS:**
-⚠️ Trigonometric functions (sin, cos, tan, asin, acos, atan)
-⚠️ Logarithmic functions (log, log10, ln)
-⚠️ Statistical functions (median, mode, standard deviation)
-⚠️ Financial functions (compound interest, NPV, IRR)
-
-📅 **DATE/TIME ENHANCEMENTS:**
-⚠️ Date formatting with locale support (MM/DD/YYYY, DD-MM-YYYY)
-⚠️ Timezone conversions and handling
-⚠️ Date arithmetic (add days, subtract months, etc.)
-⚠️ Relative date calculations (next Monday, last quarter)
-⚠️ Duration calculations (time between dates)
-
-🔤 **STRING PROCESSING EXPANSIONS:**
-⚠️ Advanced regex operations (lookahead, lookbehind)
-⚠️ Locale-specific formatting (currency, numbers)
-⚠️ String similarity and distance algorithms
-⚠️ Text normalization and cleaning utilities
-⚠️ Encoding/decoding beyond URI (Base64, hex)
-
-🔗 **ARRAY OPERATION ENHANCEMENTS:**
-⚠️ Complex filtering with multiple conditions
-⚠️ Sorting with custom comparators
-⚠️ Grouping and partitioning operations
-⚠️ Set operations (union, intersection, difference)
-⚠️ Array flattening and nested operations
-
-🎨 **TEMPLATE SYSTEM EXTENSIONS:**
-⚠️ Nested loop support (each within each)
-⚠️ Advanced conditionals (if/else if/else blocks)
-⚠️ Custom helper functions (user-defined template functions)
-⚠️ Template caching and optimization
-⚠️ Internationalization and localization support
-
-🔧 **INTEGRATION CAPABILITIES:**
-⚠️ Database connectivity (with secure query building)
-⚠️ File system operations (secure read/write)
-⚠️ Message queue integration (Kafka, RabbitMQ, SQS)
-⚠️ Real-time capabilities (WebSocket, Server-Sent Events)
-⚠️ Monitoring and metrics collection
-
-⚡ **PERFORMANCE OPTIMIZATIONS:**
-⚠️ Expression caching and compilation
-⚠️ Lazy evaluation for expensive operations
-⚠️ Memory usage optimization for large datasets
-⚠️ Parallel processing for independent operations
-⚠️ Streaming processing for large arrays
-
-IMPLEMENTATION GUIDELINES FOR CONTRIBUTORS:
-1. **Security First**: All new features must maintain no-code-injection principle
-2. **Declarative Design**: Use JSON configuration, not executable code
-3. **Error Handling**: Implement comprehensive fallbacks and validation
-4. **Testing**: Add to the 40+ test comprehensive test suite
-5. **Documentation**: Update both README.md and User Guide
-6. **Type Safety**: Maintain TypeScript compliance with proper interfaces
-7. **Performance**: Consider memory and computational impact
-
-CURRENT TEST COVERAGE:
-✅ **40 Comprehensive Test Scenarios** - 100% pass rate validated
-✅ **Flow execution patterns** - Linear, nested, interrupted, resumed
-✅ **Mathematical transformations** - All operations with edge cases
-✅ **Template processing** - Simple and complex Handlebars-style
-✅ **API integrations** - HTTP methods, auth, error handling
-✅ **Error scenarios** - Network failures, invalid data, timeouts
-✅ **Security validation** - Expression safety, input sanitization
-
-========================================
-
-- OpenAI Function Calling Standard schemas
-- JSON Schema validation with ajv
-- Secure function registry
-- Comprehensive error handling & transaction management
-- Audit logging for compliance
-- Rate limiting and input validation
-- COMPREHENSIVE REST API SUPPORT with all common conventions:
-
-REST API FEATURES SUPPORTED:
-✅ HTTP Methods: GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS
-✅ Content Types: JSON, Form-data, URL-encoded, XML/SOAP, Plain text, Multipart
-✅ Authentication: Bearer tokens, Basic auth, API keys, HMAC signatures
-✅ Parameter Handling: Path params, Query params, Request body, Headers
-✅ Advanced Features: Retries with exponential backoff, Timeouts, Rate limiting
-✅ Response Handling: JSON, XML, Text with automatic content-type detection
-✅ DECLARATIVE RESPONSE MAPPING: Secure, generic transformation without code injection
-✅ Error Handling: Status-based retry logic, Detailed error messages
-✅ Security: Input sanitization, Credential management, Audit logging
-
-DECLARATIVE RESPONSE MAPPING SYSTEM:
-The engine now supports completely generic response transformation through declarative 
-JSON configuration, eliminating the need for users to inject code. This maintains 
-complete engine security while supporting complex API response handling.
-
-MAPPING TYPES SUPPORTED:
-
-1. JSONPATH MAPPING - Extract and transform specific fields:
+#### JSONPath Mapping
+```javascript
 {
   responseMapping: {
     type: "jsonPath",
@@ -617,8 +266,10 @@ MAPPING TYPES SUPPORTED:
     }
   }
 }
+```
 
-2. OBJECT MAPPING - Restructure response objects:
+#### Object Mapping
+```javascript
 {
   responseMapping: {
     type: "object", 
@@ -635,62 +286,47 @@ MAPPING TYPES SUPPORTED:
     }
   }
 }
+```
 
-3. ARRAY MAPPING - Filter and transform arrays:
-{
-  responseMapping: {
-    type: "array",
-    source: "results",
-    limit: 10,
-    filter: { field: "status", operator: "equals", value: "active" },
-    itemMapping: {
-      type: "object",
-      mappings: { "id": "id", "name": "name" }
-    }
-  }
-}
-
-4. TEMPLATE MAPPING - String interpolation:
+#### Template Mapping
+```javascript
 {
   responseMapping: {
     type: "template",
-    template: "User {{name}} ({{email}}) from {$args.source}"
+    template: "User {{name}} ({{email}}) from {{$args.source}}"
   }
 }
+```
 
-5. CONDITIONAL MAPPING - Different mapping based on response structure:
-{
-  responseMapping: {
-    type: "conditional",
-    conditions: [
-      {
-        if: { field: "status", operator: "equals", value: "success" },
-        then: { type: "object", mappings: { "result": "data" } }
-      }
-    ],
-    else: { type: "object", mappings: { "error": "message" } }
-  }
-}
+## Core Features
+
+- **OpenAI Function Calling Standard** schemas
+- **JSON Schema validation** with ajv
+- **Secure function registry**
+- **Comprehensive error handling** & transaction management
+- **Audit logging** for compliance
+- **Rate limiting** and input validation
+
+## Value Transformations
 
-VALUE TRANSFORMATIONS SUPPORTED:
-- parseInt, parseFloat: Number conversion
-- toLowerCase, toUpperCase, trim: String manipulation  
-- replace: Regex replacement
-- concat: Add prefix/suffix
-- regex: Extract with regex groups
-- date: Convert to ISO date string
-- default: Fallback values
-
-SECURITY & BEST PRACTICES:
-- No code injection possible - all transformations are declarative
-- Secure path traversal with validation
-- Fallback handling for missing data
-- Type coercion with validation
-- Error handling with graceful degradation
-
-EXAMPLE TOOL CONFIGURATIONS:
-
-1. SIMPLE GET REQUEST:
+### Supported Transforms
+- **Number conversion:** parseInt, parseFloat
+- **String manipulation:** toLowerCase, toUpperCase, trim
+- **Text processing:** replace (regex), concat (prefix/suffix)
+- **Date handling:** Convert to ISO date string
+- **Fallback values:** Default handling for missing data
+
+### Security & Best Practices
+- ✅ No code injection possible - all transformations are declarative
+- ✅ Secure path traversal with validation
+- ✅ Fallback handling for missing data
+- ✅ Type coercion with validation
+- ✅ Error handling with graceful degradation
+
+## Example Tool Configurations
+
+### Simple GET Request
+```javascript
 {
   implementation: {
     type: "http",
@@ -698,8 +334,10 @@ EXAMPLE TOOL CONFIGURATIONS:
     method: "GET"
   }
 }
+```
 
-2. AUTHENTICATED POST WITH JSON:
+### Authenticated POST with JSON
+```javascript
 {
   implementation: {
     type: "http", 
@@ -709,8 +347,10 @@ EXAMPLE TOOL CONFIGURATIONS:
   },
   apiKey: "your-bearer-token"
 }
+```
 
-3. PATH PARAMETERS WITH RESPONSE MAPPING:
+### Path Parameters with Response Mapping
+```javascript
 {
   implementation: {
     type: "http",
@@ -727,57 +367,4 @@ EXAMPLE TOOL CONFIGURATIONS:
     }
   }
 }
-
-4. COMPLEX API WITH ARRAY PROCESSING:
-{
-  implementation: {
-    type: "http",
-    url: "https://api.example.com/search",
-    method: "GET",
-    responseMapping: {
-      type: "array",
-      source: "results",
-      limit: 5,
-      filter: { field: "active", operator: "equals", value: true },
-      itemMapping: {
-        type: "object",
-        mappings: {
-          "id": "id",
-          "title": "name",
-          "snippet": {
-            path: "description", 
-            transform: { type: "regex", pattern: "^(.{100})", group: 1 }
-          }
-        }
-      }
-    }
-  }
-}
-
-5. WEATHER API WITH DECLARATIVE MAPPING:
-{
-  implementation: {
-    type: "http",
-    url: "https://wttr.in/{city}",
-    pathParams: ["city"],
-    customQuery: "format=j1",
-    responseMapping: {
-      type: "jsonPath",
-      mappings: {
-        "location.name": {
-          path: "nearest_area[0].areaName[0].value",
-          fallback: "$args.city"
-        },
-        "current.temp_c": {
-          path: "current_condition[0].temp_C",
-          transform: { type: "parseInt", fallback: 0 }
-        },
-        "current.condition": {
-          path: "current_condition[0].weatherDesc[0].value",
-          fallback: "Unknown"
-        }
-      }
-    }
-  }
-}
-*/
+```

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -17,48 +17,132 @@ DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 **/
 /**
- * Flows Engine for any conversational platform
- * ============================================
+ * JavaScript Flow Engine for Conversational Platforms
+ * ==================================================
  *
  * Overview:
  * ---------
- * This module implements a robust, extensible, and secure workflow orchestration engine
- * for conversational and automation platforms. It is designed to power production-grade,
- * multi-flow, multi-step user journeys with advanced interruption, resumption, and tool
- * integration capabilities.
+ * The JavaScript Flow Engine is a sophisticated, host-agnostic workflow orchestration system
+ * designed to serve as a pluggable intent detector and workflows orchestrator for any
+ * conversational platform. Whether integrated with AI chat assistants, live agent systems,
+ * customer service platforms, or any other conversational interface, the engine provides
+ * reliable, secure, and intelligent workflow automation.
  *
  * Key Features:
  * -------------
- * - Stack-of-stacks model for flow frames, enabling nested flows, interruptions, and resumptions.
- * - Modular step handlers for SAY, SAY-GET, SET, SWITCH, TOOL, and SUBFLOW steps.
- * - Secure, pattern-based expression evaluation for variable interpolation and flow logic.
- * - AI-powered intent detection, argument extraction, and flow activation, with robust fallbacks.
- * - Universal flow control commands (help, status, cancel, exit) available at any point in a flow.
- * - Comprehensive error handling, logging, and audit support for production reliability.
- * - Flexible tool integration: supports local functions, HTTP APIs, and mock/test tools withvalidation and authentication.
- * - Metadata-driven flow definitions (risk, auth, category) for security and analytics.
+ * - Advanced response mapping with 25+ transform types including mathematical operations,
+ *   statistical aggregations, date/time processing, and Handlebars-style templates
+ * - Stack-of-stacks architecture for flow frames, enabling nested flows, interruptions, and resumptions
+ * - Comprehensive step handlers: SAY, SAY-GET, SET, SWITCH, CASE, CALL-TOOL, and CALL-FLOW
+ * - Secure, pattern-based expression evaluation for variable interpolation and flow logic
+ * - AI-powered intent detection, argument extraction, and flow activation with robust fallbacks
+ * - Universal flow control commands (help, status, cancel, exit) available at any point in a flow
+ * - Enterprise-grade error handling, logging, and audit support for production reliability
+ * - Flexible tool integration: HTTP APIs, local functions, and mock/test tools with validation
+ * - Comprehensive internationalization (i18n) support with language-specific properties
+ * - Metadata-driven flow definitions (risk, auth, category) for security and analytics
+ *
+ * Enhanced Transformation System:
+ * ------------------------------
+ * - Mathematical Operations: add, subtract, multiply, divide, percentage, abs, round, floor, ceil
+ * - Statistical Functions: sum, average, count, min, max for array aggregations
+ * - Date/Time Processing: currentYear, yearDifference for dynamic temporal calculations
+ * - Advanced Templates: Handlebars-style iteration with {{#each}}, @index, @last context
+ * - Enhanced Path Resolution: Support for array.length and complex object navigation
  *
  * Security Model:
  * --------------
- * - All user-supplied expressions are evaluated with strict pattern checks to prevent code injection or unsafe operations.
- * - No arbitrary code execution is allowed in variable interpolation or flow logic.
- * - Tool calls support secure authentication (Bearer, Basic, HMAC/hash) and header management.
+ * - All user-supplied expressions are evaluated with strict pattern checks to prevent code injection
+ * - No arbitrary code execution is allowed in variable interpolation or flow logic
+ * - Tool calls support secure authentication (Bearer, Basic, API Key) and header management
+ * - Comprehensive input validation with JSON Schema for all tool parameters
  *
  * Usage:
  * ------
- * - Instantiate the WorkflowEngine with a flows menu, tools registry, and approved local functions.
- * - Use `updateActivity(contextEntry, userId)` to share user input before your processing and assistant responses after processing.
- * - For user inputs: contextEntry.role = 'user' - analyzed and optionally triggers full flow logic
- * - For assistant responses: contextEntry.role = 'assistant' - adds to context stack only
- * - Extend with new step handlers or tool integrations as needed for your platform.
+ * ```javascript
+ * // 1. Create the engine
+ * const engine = new WorkflowEngine(
+ *   hostLogger,          // Your logging instance
+ *   aiCallback,          // Your AI communication function
+ *   flowsMenu,           // Array of flow definitions
+ *   toolsRegistry,       // Array of tool definitions
+ *   APPROVED_FUNCTIONS,  // Pre-approved local functions
+ *   globalVariables,     // Optional: Session-wide variables
+ *   validateOnInit,      // Optional: Enable pre-flight validation (default: true)
+ *   language,            // Optional: User's preferred language
+ *   messageRegistry,     // Optional: Custom message templates
+ *   guidanceConfig       // Optional: User assistance configuration
+ * );
+ *
+ * // 2. Initialize a session for each user
+ * const sessionContext = engine.initSession(yourLogger, 'user-123', 'session-456');
+ *
+ * // 3. Process user input and assistant responses
+ * const result = await engine.updateActivity(contextEntry, sessionContext);
+ * ```
+ *
+ * Session Management:
+ * ------------------
+ * - Each user requires a unique session context via `initSession(logger, userId, sessionId)`
+ * - The `EngineSessionContext` object should be persisted by your application
+ * - Pass the same session context to `updateActivity` for conversation continuity
+ *
+ * Context Entry Types:
+ * -------------------
+ * - User input: contextEntry.role = 'user' - analyzed and may trigger flow execution
+ * - Assistant response: contextEntry.role = 'assistant' - added to context for awareness
+ *
+ * ContextEntry Structure:
+ * ----------------------
+ * ```typescript
+ * interface ContextEntry {
+ *   role: 'user' | 'assistant' | 'system' | 'tool';  // Message role type
+ *   content: string | Record<string, unknown>;       // Message content (text, object, etc.)
+ *   timestamp: number;                               // Unix timestamp in milliseconds
+ *   stepId?: string;                                 // Optional: Associated flow step ID
+ *   toolName?: string;                               // Optional: Tool name for tool messages
+ *   metadata?: Record<string, unknown>;              // Optional: Additional context data
+ * }
+ * ```
  *
- * Maintenance:
- * ------------
- * - Review and update security patterns regularly.
- * - Ensure comprehensive test coverage for all step handlers and flow control logic.
- * - Monitor logs and audit trails for production issues and user behavior analytics.
+ * Example Usage:
+ * ```javascript
+ * // User message
+ * const userEntry = {
+ *   role: 'user',
+ *   content: 'I need help with my account',
+ *   timestamp: Date.now()
+ * };
+ * // Process the message
+ * await engine.updateActivity(userEntry, sessionContext);
+ *
+ *
+ * // Assistant response
+ * const assistantEntry = {
+ *   role: 'assistant',
+ *   content: 'I can help you with your account. What specific issue are you experiencing?',
+ *   timestamp: Date.now(),
+ *   stepId: 'greeting-step'
+ * };
+ * // Process the message
+ * await engine.updateActivity(assistantEntry, sessionContext);
+ * ```
+ *
+ * Production Deployment:
+ * ---------------------
+ * - Comprehensive test coverage with 40+ validation scenarios
+ * - Built-in monitoring and metrics collection
+ * - Containerization support with Docker and Kubernetes
+ * - Horizontal scaling capabilities
+ * - Enterprise security and compliance features
+ *
+ * Documentation:
+ * --------------
+ * - Complete User Guide: JavaScript Flow Engine.md
+ * - API Reference: README.md
+ * - Examples: Comprehensive test scenarios and real-world implementations
  *
- * Author: instantAIguru.com Team
+ * Author: InstantAIGuru.com Team
  * Last updated: August 2025
  **/
 import * as crypto from "crypto";

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "jsfe",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "TypeScript workflow engine for conversational/automation apps: multi-flow orchestration, interrupt/resume, stack-based control, robust errors, and flexible tool/REST integration.",
   "license": "MIT",
   "author": "Ron Pinkas",
   "repository": {
     "type": "git",
-    "url": "https://github.com/ronpinkas/jsfe.git"
+    "url": "git+https://github.com/ronpinkas/jsfe.git"
   },
   "type": "module",
   "sideEffects": false,
@@ -46,5 +46,9 @@
     "ajv": "^8.17.1",
     "ajv-formats": "^3.0.1",
     "winston": "^3.17.0"
+  },
+  "homepage": "https://github.com/ronpinkas/jsfe#readme",
+  "bugs": {
+    "url": "https://github.com/ronpinkas/jsfe/issues"
   }
 }