@marktoflow/core 2.0.0-alpha.12 → 2.0.0-alpha.13

package/dist/built-in-operations.js

@@ -0,0 +1,414 @@
+/**
+ * Built-in Operations for marktoflow
+ *
+ * Provides common operations that eliminate the need for verbose script blocks:
+ * - core.set: Simple variable assignment
+ * - core.transform: Map/filter/reduce transformations
+ * - core.extract: Nested path access
+ * - core.format: Date/number/string formatting
+ * - file.read: Read files with format conversion (docx, pdf, xlsx)
+ * - file.write: Write files (text or binary)
+ */
+import { resolveTemplates, resolveVariablePath } from './engine.js';
+import { executeFileOperation, isFileOperation } from './file-operations.js';
+// ============================================================================
+// core.set - Simple Variable Assignment
+// ============================================================================
+/**
+ * Set multiple variables at once with expression resolution.
+ *
+ * Example:
+ * ```yaml
+ * action: core.set
+ * inputs:
+ *   owner: "{{ inputs.repo =~ /^([^\/]+)\// }}"
+ *   repo_name: "{{ inputs.repo =~ /\/(.+)$/ }}"
+ *   timestamp: "{{ now() }}"
+ * ```
+ */
+export function executeSet(inputs, context) {
+    const result = {};
+    for (const [key, value] of Object.entries(inputs)) {
+        const resolved = resolveTemplates(value, context);
+        result[key] = resolved;
+    }
+    return result;
+}
+// ============================================================================
+// core.transform - Array Transformations
+// ============================================================================
+/**
+ * Transform arrays using common operations like map, filter, reduce.
+ *
+ * Examples:
+ *
+ * Map:
+ * ```yaml
+ * action: core.transform
+ * inputs:
+ *   input: "{{ oncall_response.data.oncalls }}"
+ *   operation: map
+ *   expression: "@{{ item.user.name }}"
+ * ```
+ *
+ * Filter:
+ * ```yaml
+ * action: core.transform
+ * inputs:
+ *   input: "{{ issues }}"
+ *   operation: filter
+ *   condition: "item.priority == 'high'"
+ * ```
+ *
+ * Reduce:
+ * ```yaml
+ * action: core.transform
+ * inputs:
+ *   input: "{{ numbers }}"
+ *   operation: reduce
+ *   expression: "{{ accumulator + item }}"
+ *   initialValue: 0
+ * ```
+ */
+export function executeTransform(rawInputs, resolvedInputs, context) {
+    // Use resolved input array
+    const input = resolvedInputs.input;
+    if (!Array.isArray(input)) {
+        throw new Error('Transform input must be an array');
+    }
+    // Use raw (unresolved) expression and condition to preserve templates
+    const operation = rawInputs.operation;
+    switch (operation) {
+        case 'map':
+            return transformMap(input, rawInputs.expression || '{{ item }}', context);
+        case 'filter':
+            return transformFilter(input, rawInputs.condition || 'item', context);
+        case 'reduce':
+            return transformReduce(input, rawInputs.expression || '{{ accumulator }}', resolvedInputs.initialValue, // Resolve initialValue upfront
+            context);
+        case 'find':
+            return transformFind(input, rawInputs.condition || 'item', context);
+        case 'group_by':
+            if (!rawInputs.key) {
+                throw new Error('group_by operation requires "key" parameter');
+            }
+            return transformGroupBy(input, rawInputs.key, context);
+        case 'unique':
+            return transformUnique(input, rawInputs.key, context);
+        case 'sort':
+            return transformSort(input, rawInputs.key, resolvedInputs.reverse || false, context);
+        default:
+            throw new Error(`Unknown transform operation: ${operation}`);
+    }
+}
+/**
+ * Map transformation - transform each item in an array
+ */
+function transformMap(items, expression, context) {
+    return items.map((item) => {
+        const itemContext = { ...context, variables: { ...context.variables, item } };
+        return resolveTemplates(expression, itemContext);
+    });
+}
+/**
+ * Filter transformation - keep items that match a condition
+ */
+function transformFilter(items, condition, context) {
+    return items.filter((item) => {
+        const itemContext = { ...context, variables: { ...context.variables, item } };
+        const resolved = resolveTemplates(condition, itemContext);
+        return Boolean(resolved);
+    });
+}
+/**
+ * Reduce transformation - aggregate items to a single value
+ */
+function transformReduce(items, expression, initialValue, context) {
+    let accumulator = initialValue !== undefined ? initialValue : null;
+    for (const item of items) {
+        const reduceContext = {
+            ...context,
+            variables: { ...context.variables, item, accumulator },
+        };
+        accumulator = resolveTemplates(expression, reduceContext);
+    }
+    return accumulator;
+}
+/**
+ * Find transformation - find first item that matches condition
+ */
+function transformFind(items, condition, context) {
+    for (const item of items) {
+        const itemContext = { ...context, variables: { ...context.variables, item } };
+        const resolved = resolveTemplates(condition, itemContext);
+        if (Boolean(resolved)) {
+            return item;
+        }
+    }
+    return undefined;
+}
+/**
+ * Group by transformation - group items by a key
+ */
+function transformGroupBy(items, key, context) {
+    const groups = {};
+    for (const item of items) {
+        const itemContext = { ...context, variables: { ...context.variables, item } };
+        const groupKey = String(resolveVariablePath(key, itemContext));
+        if (!groups[groupKey]) {
+            groups[groupKey] = [];
+        }
+        groups[groupKey].push(item);
+    }
+    return groups;
+}
+/**
+ * Unique transformation - remove duplicates
+ */
+function transformUnique(items, key, context) {
+    if (!key) {
+        // Simple unique for primitive values
+        return Array.from(new Set(items));
+    }
+    // Unique based on key
+    const seen = new Set();
+    const result = [];
+    for (const item of items) {
+        const itemContext = { ...context, variables: { ...context.variables, item } };
+        const keyValue = String(resolveVariablePath(key, itemContext));
+        if (!seen.has(keyValue)) {
+            seen.add(keyValue);
+            result.push(item);
+        }
+    }
+    return result;
+}
+/**
+ * Sort transformation - sort items by key or value
+ */
+function transformSort(items, key, reverse, context) {
+    const sorted = [...items];
+    sorted.sort((a, b) => {
+        let aVal = a;
+        let bVal = b;
+        if (key) {
+            const aContext = { ...context, variables: { ...context.variables, item: a } };
+            const bContext = { ...context, variables: { ...context.variables, item: b } };
+            aVal = resolveVariablePath(key, aContext);
+            bVal = resolveVariablePath(key, bContext);
+        }
+        // Handle different types
+        if (typeof aVal === 'number' && typeof bVal === 'number') {
+            return aVal - bVal;
+        }
+        if (typeof aVal === 'string' && typeof bVal === 'string') {
+            return aVal.localeCompare(bVal);
+        }
+        // Fall back to string comparison
+        return String(aVal).localeCompare(String(bVal));
+    });
+    return reverse ? sorted.reverse() : sorted;
+}
+// ============================================================================
+// core.extract - Nested Path Access
+// ============================================================================
+/**
+ * Extract values from nested objects safely.
+ *
+ * Example:
+ * ```yaml
+ * action: core.extract
+ * inputs:
+ *   input: "{{ api_response }}"
+ *   path: "data.users[0].email"
+ *   default: "unknown@example.com"
+ * ```
+ */
+export function executeExtract(inputs, context) {
+    const input = resolveTemplates(inputs.input, context);
+    const path = inputs.path;
+    const defaultValue = inputs.default;
+    // Create a temporary context with the input as a variable
+    const tempContext = {
+        ...context,
+        variables: { ...context.variables, __extract_input: input },
+    };
+    const result = resolveVariablePath(`__extract_input.${path}`, tempContext);
+    if (result === undefined) {
+        return defaultValue !== undefined ? defaultValue : null;
+    }
+    return result;
+}
+// ============================================================================
+// core.format - Value Formatting
+// ============================================================================
+/**
+ * Format values for display (dates, numbers, strings, currency).
+ *
+ * Examples:
+ *
+ * Date:
+ * ```yaml
+ * action: core.format
+ * inputs:
+ *   value: "{{ now() }}"
+ *   type: date
+ *   format: "YYYY-MM-DD HH:mm:ss"
+ * ```
+ *
+ * Number:
+ * ```yaml
+ * action: core.format
+ * inputs:
+ *   value: 1234.56
+ *   type: number
+ *   precision: 2
+ * ```
+ *
+ * Currency:
+ * ```yaml
+ * action: core.format
+ * inputs:
+ *   value: 1234.56
+ *   type: currency
+ *   currency: USD
+ *   locale: en-US
+ * ```
+ */
+export function executeFormat(inputs, context) {
+    const value = resolveTemplates(inputs.value, context);
+    switch (inputs.type) {
+        case 'date':
+            return formatDate(value, inputs.format);
+        case 'number':
+            return formatNumber(value, inputs.precision, inputs.locale);
+        case 'currency':
+            return formatCurrency(value, inputs.currency || 'USD', inputs.locale);
+        case 'string':
+            return formatString(value, inputs.format);
+        case 'json':
+            return JSON.stringify(value, null, 2);
+        default:
+            throw new Error(`Unknown format type: ${inputs.type}`);
+    }
+}
+/**
+ * Format a date value
+ * Supports simple format tokens: YYYY, MM, DD, HH, mm, ss
+ */
+function formatDate(value, format) {
+    let date;
+    if (value instanceof Date) {
+        date = value;
+    }
+    else if (typeof value === 'string' || typeof value === 'number') {
+        date = new Date(value);
+    }
+    else {
+        date = new Date();
+    }
+    if (isNaN(date.getTime())) {
+        throw new Error('Invalid date value');
+    }
+    if (!format) {
+        return date.toISOString();
+    }
+    // Simple date formatting (basic implementation)
+    let formatted = format;
+    formatted = formatted.replace('YYYY', date.getFullYear().toString());
+    formatted = formatted.replace('MM', String(date.getMonth() + 1).padStart(2, '0'));
+    formatted = formatted.replace('DD', String(date.getDate()).padStart(2, '0'));
+    formatted = formatted.replace('HH', String(date.getHours()).padStart(2, '0'));
+    formatted = formatted.replace('mm', String(date.getMinutes()).padStart(2, '0'));
+    formatted = formatted.replace('ss', String(date.getSeconds()).padStart(2, '0'));
+    return formatted;
+}
+/**
+ * Format a number value
+ */
+function formatNumber(value, precision, locale) {
+    const num = Number(value);
+    if (isNaN(num)) {
+        throw new Error('Invalid number value');
+    }
+    if (precision !== undefined) {
+        return num.toFixed(precision);
+    }
+    if (locale) {
+        return num.toLocaleString(locale);
+    }
+    return num.toString();
+}
+/**
+ * Format a currency value
+ */
+function formatCurrency(value, currency, locale) {
+    const num = Number(value);
+    if (isNaN(num)) {
+        throw new Error('Invalid currency value');
+    }
+    return num.toLocaleString(locale || 'en-US', {
+        style: 'currency',
+        currency,
+    });
+}
+/**
+ * Format a string value
+ * Supports: upper, lower, title, capitalize, trim
+ */
+function formatString(value, format) {
+    let str = String(value);
+    if (!format) {
+        return str;
+    }
+    switch (format.toLowerCase()) {
+        case 'upper':
+        case 'uppercase':
+            return str.toUpperCase();
+        case 'lower':
+        case 'lowercase':
+            return str.toLowerCase();
+        case 'title':
+        case 'titlecase':
+            return str.replace(/\w\S*/g, (txt) => txt.charAt(0).toUpperCase() + txt.slice(1).toLowerCase());
+        case 'capitalize':
+            return str.charAt(0).toUpperCase() + str.slice(1);
+        case 'trim':
+            return str.trim();
+        default:
+            return str;
+    }
+}
+// ============================================================================
+// Helper Functions
+// ============================================================================
+/**
+ * Execute a built-in operation based on action name
+ */
+export function executeBuiltInOperation(action, rawInputs, resolvedInputs, context) {
+    switch (action) {
+        case 'core.set':
+            return executeSet(resolvedInputs, context);
+        case 'core.transform':
+            // For transform operations, use raw inputs to preserve template expressions
+            return executeTransform(rawInputs, resolvedInputs, context);
+        case 'core.extract':
+            return executeExtract(resolvedInputs, context);
+        case 'core.format':
+            return executeFormat(resolvedInputs, context);
+        default:
+            // Check if it's a file operation
+            if (isFileOperation(action)) {
+                return executeFileOperation(action, resolvedInputs, context);
+            }
+            return null; // Not a built-in operation
+    }
+}
+/**
+ * Check if an action is a built-in operation
+ */
+export function isBuiltInOperation(action) {
+    const builtInActions = ['core.set', 'core.transform', 'core.extract', 'core.format'];
+    return builtInActions.includes(action) || isFileOperation(action);
+}
+//# sourceMappingURL=built-in-operations.js.map

package/dist/built-in-operations.js.map

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

package/dist/engine.d.ts

@@ -85,7 +85,12 @@ export declare class CircuitBreaker {
 }
 /**
  * Resolve template variables in a value.
- * Supports {{variable}} and {{inputs.name}} syntax.
+ * Supports {{variable}}, {{inputs.name}}, and Nunjucks filters.
+ *
+ * Uses Nunjucks as the template engine with:
+ * - Legacy regex operator support (=~, !~, //) converted to filters
+ * - Custom filters for string, array, object, date operations
+ * - Jinja2-style control flow ({% for %}, {% if %}, etc.)
  */
 export declare function resolveTemplates(value: unknown, context: ExecutionContext): unknown;
 /**
@@ -177,6 +182,7 @@ export declare class WorkflowEngine {
     /**
      * Resolve a condition value with support for nested properties.
      * Handles direct variable references and nested paths.
+     * Uses Nunjucks for template expressions with filters/regex.
      */
     private resolveConditionValue;
     /**
@@ -227,6 +233,10 @@ export declare class WorkflowEngine {
      * Execute try/catch/finally step.
      */
     private executeTryStep;
+    /**
+     * Execute a script step (inline JavaScript).
+     */
+    private executeScriptStep;
     /**
      * Clone execution context for parallel branches.
      */

package/dist/engine.d.ts.map

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

package/dist/engine.js

@@ -4,12 +4,15 @@
  * Executes workflow steps with retry logic, variable resolution,
  * and SDK invocation.
  */
-import { StepStatus, WorkflowStatus, createExecutionContext, createStepResult, isActionStep, isSubWorkflowStep, isIfStep, isSwitchStep, isForEachStep, isWhileStep, isMapStep, isFilterStep, isReduceStep, isParallelStep, isTryStep, } from './models.js';
+import { StepStatus, WorkflowStatus, createExecutionContext, createStepResult, isActionStep, isSubWorkflowStep, isIfStep, isSwitchStep, isForEachStep, isWhileStep, isMapStep, isFilterStep, isReduceStep, isParallelStep, isTryStep, isScriptStep, } from './models.js';
 import { mergePermissions, toSecurityPolicy, } from './permissions.js';
 import { loadPromptFile, resolvePromptTemplate, validatePromptInputs, } from './prompt-loader.js';
 import { DEFAULT_FAILOVER_CONFIG, AgentHealthTracker, FailoverReason, } from './failover.js';
 import { parseFile } from './parser.js';
 import { resolve, dirname } from 'node:path';
+import { executeBuiltInOperation, isBuiltInOperation } from './built-in-operations.js';
+import { renderTemplate } from './template-engine.js';
+import { executeScriptAsync } from './script-executor.js';
 // ============================================================================
 // Helper Functions
 // ============================================================================
@@ -112,50 +115,27 @@ export class CircuitBreaker {
 // ============================================================================
 // Variable Resolution
 // ============================================================================
-/**
- * Smart serialization for template interpolation.
- * Converts values to strings in a meaningful way for different types.
- */
-function serializeValue(value) {
-    if (value === undefined || value === null) {
-        return '';
-    }
-    // For primitives, use standard string conversion
-    if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') {
-        return String(value);
-    }
-    // For objects and arrays, use JSON serialization for readability
-    // This makes them useful in prompts and messages instead of "[object Object]"
-    try {
-        return JSON.stringify(value, null, 2);
-    }
-    catch (error) {
-        // Fallback to string conversion if JSON serialization fails
-        return String(value);
-    }
-}
 /**
  * Resolve template variables in a value.
- * Supports {{variable}} and {{inputs.name}} syntax.
+ * Supports {{variable}}, {{inputs.name}}, and Nunjucks filters.
+ *
+ * Uses Nunjucks as the template engine with:
+ * - Legacy regex operator support (=~, !~, //) converted to filters
+ * - Custom filters for string, array, object, date operations
+ * - Jinja2-style control flow ({% for %}, {% if %}, etc.)
  */
 export function resolveTemplates(value, context) {
     if (typeof value === 'string') {
-        // Check if the entire string is a single template expression
-        const singleTemplateMatch = value.match(/^\{\{([^}]+)\}\}$/);
-        if (singleTemplateMatch) {
-            // Return the actual value without converting to string
-            const path = singleTemplateMatch[1].trim();
-            const resolved = resolveVariablePath(path, context);
-            // For single template expressions, return the actual value (could be object, array, etc.)
-            // If undefined, return empty string for backward compatibility
-            return resolved !== undefined ? resolved : '';
-        }
-        // Otherwise, do string interpolation with smart serialization
-        return value.replace(/\{\{([^}]+)\}\}/g, (_, varPath) => {
-            const path = varPath.trim();
-            const resolved = resolveVariablePath(path, context);
-            return serializeValue(resolved);
-        });
+        // Build the template context with all available variables
+        // Spread inputs first, then variables (variables override inputs if same key)
+        // Also keep inputs accessible via inputs.* for explicit access
+        const templateContext = {
+            ...context.inputs, // Spread inputs at root level for direct access ({{ path }})
+            ...context.variables, // Variables override inputs if same key
+            inputs: context.inputs, // Also keep inputs accessible as inputs.*
+        };
+        // Use the new Nunjucks-based template engine with legacy syntax support
+        return renderTemplate(value, templateContext);
     }
     if (Array.isArray(value)) {
         return value.map((v) => resolveTemplates(v, context));
@@ -185,6 +165,11 @@ export function resolveVariablePath(path, context) {
     if (fromVars !== undefined) {
         return fromVars;
     }
+    // Check inputs (for bare variable names like "value" instead of "inputs.value")
+    const fromInputs = getNestedValue(context.inputs, path);
+    if (fromInputs !== undefined) {
+        return fromInputs;
+    }
     // Check step metadata (for status checks like: step_id.status)
     const fromStepMeta = getNestedValue(context.stepMetadata, path);
     if (fromStepMeta !== undefined) {
@@ -317,6 +302,9 @@ export class WorkflowEngine {
         if (isTryStep(step)) {
             return this.executeTryStep(step, context, sdkRegistry, stepExecutor);
         }
+        if (isScriptStep(step)) {
+            return this.executeScriptStep(step, context);
+        }
         // Default: action or workflow step
         return this.executeStepWithFailover(step, context, sdkRegistry, stepExecutor);
     }
@@ -834,8 +822,19 @@ Execute the workflow steps in order and return the final outputs as JSON.`;
                     resolvedInputs = resolveTemplates(step.inputs, context);
                 }
                 const stepWithResolvedInputs = { ...step, inputs: resolvedInputs };
-                // Execute step with executor context
-                const output = await this.executeWithTimeout(() => stepExecutor(stepWithResolvedInputs, context, sdkRegistry, executorContext), step.timeout ?? this.config.defaultTimeout);
+                // Check if this is a built-in operation
+                let output;
+                if (isBuiltInOperation(step.action)) {
+                    // Execute built-in operation directly (no timeout, no SDK executor needed)
+                    // For built-in operations, pass both resolved and unresolved inputs
+                    // to allow selective resolution of template expressions
+                    // Await in case operation is async (e.g., file operations)
+                    output = await executeBuiltInOperation(step.action, step.inputs, resolvedInputs, context);
+                }
+                else {
+                    // Execute step with executor context
+                    output = await this.executeWithTimeout(() => stepExecutor(stepWithResolvedInputs, context, sdkRegistry, executorContext), step.timeout ?? this.config.defaultTimeout);
+                }
                 circuitBreaker.recordSuccess();
                 const result = createStepResult(step.id, StepStatus.COMPLETED, output, startedAt, attempt);
                 this.events.onStepComplete?.(step, result);
@@ -977,8 +976,18 @@ Execute the workflow steps in order and return the final outputs as JSON.`;
     /**
      * Resolve a condition value with support for nested properties.
      * Handles direct variable references and nested paths.
+     * Uses Nunjucks for template expressions with filters/regex.
      */
     resolveConditionValue(path, context) {
+        // If it looks like a template expression, resolve it
+        if (path.includes('|') || path.includes('=~') || path.includes('!~')) {
+            // Build template context
+            const templateContext = {
+                inputs: context.inputs,
+                ...context.variables,
+            };
+            return renderTemplate(`{{ ${path} }}`, templateContext);
+        }
         // First try to parse as a literal value (true, false, numbers, etc.)
         const parsedValue = this.parseValue(path);
         // If parseValue returned the same string, try to resolve as a variable
@@ -1401,6 +1410,31 @@ Execute the workflow steps in order and return the final outputs as JSON.`;
             return createStepResult(step.id, StepStatus.FAILED, null, startedAt, 0, error instanceof Error ? error.message : String(error));
         }
     }
+    /**
+     * Execute a script step (inline JavaScript).
+     */
+    async executeScriptStep(step, context) {
+        const startedAt = new Date();
+        try {
+            // Resolve any templates in the code
+            const resolvedInputs = resolveTemplates(step.inputs, context);
+            // Execute the script with the workflow context
+            const result = await executeScriptAsync(resolvedInputs.code, {
+                variables: context.variables,
+                inputs: context.inputs,
+                steps: context.stepMetadata,
+            }, {
+                timeout: resolvedInputs.timeout ?? 5000,
+            });
+            if (!result.success) {
+                return createStepResult(step.id, StepStatus.FAILED, null, startedAt, 0, result.error ?? 'Script execution failed');
+            }
+            return createStepResult(step.id, StepStatus.COMPLETED, result.value, startedAt);
+        }
+        catch (error) {
+            return createStepResult(step.id, StepStatus.FAILED, null, startedAt, 0, error instanceof Error ? error.message : String(error));
+        }
+    }
     // ============================================================================
     // Helper Methods for Control Flow
     // ============================================================================