@orbytautomation/engine 0.1.2 → 0.2.0

package/dist/execution/IntentAnalyzer.js

@@ -0,0 +1,348 @@
+/**
+ * Intent Layer
+ *
+ * Intelligence layer that understands WHAT the workflow is trying to do.
+ *
+ * This layer analyzes workflow structure, metadata, and annotations to:
+ * - Classify workflow intent
+ * - Provide better errors
+ * - Enable optimization
+ * - Generate smart explanations
+ *
+ * Foundation: Basic intent detection from annotations.
+ * Future: Pattern recognition, ML-based classification.
+ */
+/**
+ * Intent Layer Analyzer
+ *
+ * Understands what workflows are trying to do.
+ * Foundation for intelligent behavior.
+ */
+export class IntentAnalyzer {
+    /**
+     * Classify workflow intent
+     *
+     * Foundation: Checks annotations and basic patterns
+     * Future: ML-based classification, pattern recognition
+     */
+    static classify(workflow) {
+        // 1. Check explicit intent annotation
+        const explicitIntent = this.checkExplicitIntent(workflow);
+        if (explicitIntent) {
+            return explicitIntent;
+        }
+        // 2. Analyze workflow structure
+        const structuralIntent = this.analyzeStructure(workflow);
+        if (structuralIntent.confidence !== 'low') {
+            return structuralIntent;
+        }
+        // 3. Analyze step patterns
+        const patternIntent = this.analyzeStepPatterns(workflow);
+        return patternIntent;
+    }
+    /**
+     * Check for explicit intent annotation
+     */
+    static checkExplicitIntent(workflow) {
+        // Check annotations['ai.intent']
+        const aiIntent = workflow.annotations?.['ai.intent'];
+        if (aiIntent && this.isKnownIntent(aiIntent)) {
+            return {
+                intent: aiIntent,
+                confidence: 'high',
+                reasoning: 'Explicit ai.intent annotation',
+                patterns: ['explicit-annotation'],
+            };
+        }
+        return null;
+    }
+    /**
+     * Analyze workflow structure for intent
+     */
+    static analyzeStructure(workflow) {
+        const patterns = [];
+        // Check workflow name/description for keywords
+        const name = workflow.name?.toLowerCase() || '';
+        const description = workflow.metadata?.description?.toLowerCase() || '';
+        const text = `${name} ${description}`;
+        // Data pipeline patterns
+        if (this.containsKeywords(text, ['etl', 'pipeline', 'transform', 'extract'])) {
+            patterns.push('data-keywords');
+            return {
+                intent: 'data-pipeline',
+                confidence: 'medium',
+                reasoning: 'Found data pipeline keywords in name/description',
+                patterns,
+            };
+        }
+        // Deployment patterns
+        if (this.containsKeywords(text, ['deploy', 'release', 'rollout'])) {
+            patterns.push('deployment-keywords');
+            return {
+                intent: 'deployment',
+                confidence: 'medium',
+                reasoning: 'Found deployment keywords',
+                patterns,
+            };
+        }
+        // Testing patterns
+        if (this.containsKeywords(text, ['test', 'qa', 'validate', 'verify'])) {
+            patterns.push('testing-keywords');
+            return {
+                intent: 'testing',
+                confidence: 'medium',
+                reasoning: 'Found testing keywords',
+                patterns,
+            };
+        }
+        return {
+            intent: 'unknown',
+            confidence: 'low',
+            reasoning: 'No clear intent from structure',
+            patterns,
+        };
+    }
+    /**
+     * Analyze step patterns for intent
+     */
+    static analyzeStepPatterns(workflow) {
+        const patterns = [];
+        const stepAdapters = workflow.steps.map(s => s.adapter);
+        // Data pipeline pattern: fetch -> process -> store
+        const hasDataFlow = this.hasPattern(stepAdapters, ['http', 'cli', 'fs']);
+        if (hasDataFlow) {
+            patterns.push('data-flow-pattern');
+            return {
+                intent: 'data-pipeline',
+                confidence: 'medium',
+                reasoning: 'Detected fetch-process-store pattern',
+                patterns,
+            };
+        }
+        // Notification pattern: multiple http/webhook calls
+        const httpCount = stepAdapters.filter(a => a === 'http').length;
+        if (httpCount >= 2) {
+            patterns.push('multiple-http-calls');
+            return {
+                intent: 'notification',
+                confidence: 'low',
+                reasoning: 'Multiple HTTP calls detected',
+                patterns,
+            };
+        }
+        // Orchestration: many different adapters
+        const uniqueAdapters = new Set(stepAdapters).size;
+        if (uniqueAdapters >= 4) {
+            patterns.push('multi-adapter');
+            return {
+                intent: 'orchestration',
+                confidence: 'low',
+                reasoning: 'Multiple adapter types suggest orchestration',
+                patterns,
+            };
+        }
+        return {
+            intent: 'automation',
+            confidence: 'low',
+            reasoning: 'General automation (no specific pattern detected)',
+            patterns: ['generic'],
+        };
+    }
+    /**
+     * Get recommendations based on intent
+     */
+    static getRecommendations(intent) {
+        // Foundation: Basic recommendations
+        // Future: Context-aware, experience-based recommendations
+        const recommendations = {
+            'data-pipeline': {
+                optimizations: [
+                    'Consider enabling caching for expensive transformations',
+                    'Use parallel processing when steps are independent',
+                ],
+                warnings: [
+                    'Ensure data validation at each stage',
+                    'Add retry logic for network-based data fetching',
+                ],
+                bestPractices: [
+                    'Implement idempotent operations',
+                    'Add data quality checks',
+                ],
+            },
+            'deployment': {
+                optimizations: [
+                    'Use health checks after deployment',
+                    'Implement rollback logic',
+                ],
+                warnings: [
+                    'Always have a rollback plan',
+                    'Test in staging before production',
+                ],
+                bestPractices: [
+                    'Use blue-green or canary deployments',
+                    'Implement smoke tests',
+                ],
+            },
+            'testing': {
+                optimizations: [
+                    'Run fast tests first',
+                    'Parallelize independent test suites',
+                ],
+                bestPractices: [
+                    'Fail fast on critical failures',
+                    'Generate test reports',
+                ],
+            },
+            'monitoring': {
+                optimizations: [
+                    'Use appropriate check intervals',
+                    'Implement alerting thresholds',
+                ],
+                bestPractices: [
+                    'Define clear success criteria',
+                    'Log monitoring results',
+                ],
+            },
+            'notification': {
+                optimizations: [
+                    'Batch notifications when possible',
+                    'Use async delivery',
+                ],
+                warnings: [
+                    'Implement rate limiting',
+                    'Handle delivery failures gracefully',
+                ],
+                bestPractices: [
+                    'Template notifications',
+                    'Track delivery status',
+                ],
+            },
+            'integration': {
+                optimizations: [
+                    'Use webhook retention policies',
+                    'Implement circuit breakers',
+                ],
+                warnings: [
+                    'Validate external service health',
+                    'Handle service unavailability',
+                ],
+                bestPractices: [
+                    'Use API versioning',
+                    'Implement proper error handling',
+                ],
+            },
+            'automation': {
+                optimizations: [
+                    'Identify parallelization opportunities',
+                    'Cache repeated operations',
+                ],
+                bestPractices: [
+                    'Make operations idempotent',
+                    'Add proper logging',
+                ],
+            },
+            'orchestration': {
+                optimizations: [
+                    'Optimize step dependencies',
+                    'Use parallel execution',
+                ],
+                warnings: [
+                    'Manage service dependencies carefully',
+                    'Implement timeout strategies',
+                ],
+                bestPractices: [
+                    'Document service interactions',
+                    'Implement comprehensive error handling',
+                ],
+            },
+            'unknown': {
+                warnings: [
+                    'Consider adding ai.intent annotation for better optimization',
+                ],
+            },
+        };
+        return recommendations[intent] || {};
+    }
+    /**
+     * Generate human-friendly explanation of workflow
+     */
+    static explain(workflow) {
+        const classified = this.classify(workflow);
+        const intentDescriptions = {
+            'data-pipeline': 'processes and transforms data',
+            'deployment': 'deploys applications or services',
+            'testing': 'validates and tests functionality',
+            'monitoring': 'monitors system health',
+            'notification': 'sends notifications',
+            'integration': 'integrates multiple services',
+            'automation': 'automates tasks',
+            'orchestration': 'orchestrates multiple services',
+            'unknown': 'performs automated tasks',
+        };
+        const description = intentDescriptions[classified.intent];
+        const name = workflow.name || 'This workflow';
+        return `${name} ${description} (${classified.confidence} confidence)`;
+    }
+    // Helper methods
+    static isKnownIntent(intent) {
+        const knownIntents = [
+            'data-pipeline', 'deployment', 'testing', 'monitoring',
+            'notification', 'integration', 'automation', 'orchestration',
+        ];
+        return knownIntents.includes(intent);
+    }
+    static containsKeywords(text, keywords) {
+        return keywords.some(keyword => text.includes(keyword));
+    }
+    static hasPattern(adapters, pattern) {
+        // Simple pattern matching: check if all pattern adapters exist in sequence
+        let patternIndex = 0;
+        for (const adapter of adapters) {
+            if (adapter === pattern[patternIndex]) {
+                patternIndex++;
+                if (patternIndex === pattern.length) {
+                    return true;
+                }
+            }
+        }
+        return false;
+    }
+}
+/**
+ * Intent-based error messages
+ *
+ * Provides context-aware error messages based on workflow intent
+ */
+export class IntentAwareErrors {
+    /**
+     * Get intent-aware error message
+     */
+    static getMessage(intent, error, context) {
+        // Foundation: Basic error enhancement
+        // Future: Smart error suggestions based on intent and context
+        const baseMessage = error;
+        // Add intent-specific context
+        const intentContext = {
+            'data-pipeline': 'For data pipelines, ensure data sources are accessible and formats are correct.',
+            'deployment': 'For deployments, verify permissions and target environment status.',
+            'testing': 'For tests, check test data and environment setup.',
+            'monitoring': 'For monitoring, ensure endpoints are accessible.',
+            'notification': 'For notifications, verify API keys and endpoints.',
+            'integration': 'For integrations, check service connectivity.',
+            'automation': 'Check that all required resources are available.',
+            'orchestration': 'Verify all services are healthy.',
+            'unknown': 'Review workflow configuration.',
+        };
+        const suggestion = intentContext[intent] || '';
+        // Add context-specific details if provided
+        let enhancedMessage = suggestion ? `${baseMessage}\n\n💡 ${suggestion}` : baseMessage;
+        if (context && Object.keys(context).length > 0) {
+            const contextStr = Object.entries(context)
+                .map(([key, value]) => `${key}: ${value}`)
+                .join(', ');
+            enhancedMessage += `\n\nContext: ${contextStr}`;
+        }
+        return enhancedMessage;
+    }
+}
+//# sourceMappingURL=IntentAnalyzer.js.map

package/dist/execution/IntentAnalyzer.js.map

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

package/dist/execution/InternalExecutionContext.d.ts

@@ -0,0 +1,255 @@
+/**
+ * Internal Execution Context
+ *
+ * These fields are NEVER user-controlled.
+ * Engine injects them automatically at runtime.
+ *
+ * Security: User workflow YAML cannot override these values.
+ */
+import type { TierLimits } from './ExecutionLimits.js';
+/**
+ * Execution Identity (Engine-Generated)
+ * Generated for each workflow execution
+ */
+export interface ExecutionIdentity {
+    /** Unique execution ID (generated by engine) */
+    executionId: string;
+    /** Run ID for this workflow execution */
+    runId: string;
+    /** Trace ID for distributed tracing */
+    traceId: string;
+    /** Parent run ID if this is a nested workflow */
+    parentRunId?: string;
+    /** Execution start timestamp */
+    startedAt: Date;
+    /** Engine version that executed this workflow */
+    engineVersion: string;
+    /** Node ID for future distributed execution */
+    nodeId?: string;
+}
+/**
+ * Ownership Context (From Bridge/API)
+ * Passed from website/bridge to engine
+ */
+export interface OwnershipContext {
+    /** User ID who triggered execution */
+    userId: string;
+    /** Workspace/organization ID */
+    workspaceId: string;
+    /** Subscription ID */
+    subscriptionId: string;
+    /** Subscription tier (free, pro, enterprise) */
+    subscriptionTier: string;
+    /** Geographic region */
+    region: string;
+    /** Pricing model (ecosystem | component) */
+    pricingModel: 'ecosystem' | 'component';
+    /** Billing mode  */
+    billingMode: 'ecosystem' | 'component';
+}
+/**
+ * Billing Snapshot (Frozen at Execution Start)
+ * Prevents billing disputes when pricing changes
+ */
+export interface BillingSnapshot {
+    /** Base cost per automation execution */
+    baseExecutionCost: number;
+    /** Base cost per step */
+    baseStepCost: number;
+    /** Pricing tier at execution time */
+    pricingTier: string;
+    /** Discount applied (%) */
+    discountApplied: number;
+    /** Promo code applied */
+    promoApplied?: string;
+    /** Effective rate after discounts */
+    effectiveRate: number;
+    /** Billing snapshot version (for audit) */
+    snapshotVersion: string;
+    /** Timestamp when snapshot was taken */
+    snapshotAt: Date;
+}
+/**
+ * Usage Counters (Engine-Calculated)
+ * Never user-editable
+ */
+export interface UsageCounters {
+    /** Number of automations executed (always 1 per workflow) */
+    automationCount: number;
+    /** Total number of steps executed */
+    stepCount: number;
+    /** Weighted step count (sum of step weights) */
+    weightedStepCount: number;
+    /** Execution duration in seconds */
+    durationSeconds: number;
+    /** CPU usage (future) */
+    resourceUsageCpu?: number;
+    /** Memory usage (future) */
+    resourceUsageMemory?: number;
+}
+/**
+ * Derived Billing Context (Engine-Computed)
+ * Calculated based on ownership + snapshot
+ */
+export interface DerivedBillingContext {
+    /** Is this execution billable */
+    isBillable: boolean;
+    /** Billing scope resolved */
+    billingScopeResolved: 'workflow' | 'step' | 'both';
+    /** Effective product billing to */
+    effectiveProduct: string;
+    /** Pricing tier resolved from subscription */
+    pricingTierResolved: string;
+    /** Final cost calculated */
+    totalCost: number;
+}
+/**
+ * Security Metadata (Engine-Controlled)
+ * Security boundaries and permissions
+ */
+export interface SecurityMetadata {
+    /** Payment status (affects execution) */
+    paymentStatus: 'active' | 'past_due' | 'canceled' | 'trial';
+    /** Request source IP (optional) */
+    ipAddress?: string;
+    /** Security policy version */
+    securityPolicyVersion?: string;
+    /** Execution isolation level */
+    isolationLevel: 'process' | 'container' | 'vm';
+    /** Permissions granted for this execution */
+    permissionsGranted: string[];
+}
+/**
+ * Runtime State (Engine-Managed)
+ * Current execution state
+ */
+export interface RuntimeState {
+    /** Current workflow state */
+    workflowState: 'pending' | 'running' | 'completed' | 'failed' | 'timeout' | 'cancelled';
+    /** Actual retry count (not user-defined max) */
+    retryCountActual: number;
+    /** Was timeout triggered? */
+    timeoutTriggered: boolean;
+    /** Execution graph (resolved dependencies) */
+    executionGraph?: Record<string, string[]>;
+    /** Steps state map */
+    stepsState: Record<string, 'pending' | 'running' | 'completed' | 'failed' | 'skipped'>;
+}
+/**
+ * Request Context (Origin Information)
+ * Where the execution request came from
+ */
+export interface RequestContext {
+    /** Request origin */
+    origin: 'cli' | 'api' | 'sdk' | 'webhook' | 'scheduler';
+    /** Execution mode */
+    mode: 'local' | 'server' | 'embedded' | 'dry-run';
+    /** Who/what triggered this */
+    triggeredBy?: string;
+}
+/**
+ * Internal Execution Context (Complete)
+ * This is what engine maintains internally. NEVER exposed to workflow.
+ */
+export interface InternalExecutionContext {
+    /** Execution identity */
+    _identity: ExecutionIdentity;
+    /** Ownership from bridge */
+    _ownership: OwnershipContext;
+    /** Billing snapshot (frozen) */
+    _billingSnapshot: BillingSnapshot;
+    /** Usage counters */
+    _usage: UsageCounters;
+    /** Derived billing context */
+    _billing: DerivedBillingContext;
+    /** Tier-based execution limits (ENFORCED by engine) */
+    _limits: TierLimits;
+    /** Security metadata */
+    _security: SecurityMetadata;
+    /** Runtime state */
+    _runtime: RuntimeState;
+    /** Request context */
+    _request: RequestContext;
+    /** Audit metadata */
+    _audit: {
+        engineVersion: string;
+        billingSnapshotVersion: string;
+        executionVersion: string;
+    };
+}
+/**
+ * Step-level Internal Context
+ * Injected into each step execution
+ */
+export interface InternalStepContext {
+    /** Step usage (engine-calculated from user weight or default) */
+    usage: {
+        billable: boolean;
+        unit: string;
+        weight: number;
+        computedCost: number;
+    };
+    /** Step requirements (engine-validated) */
+    requires: {
+        capabilities: string[];
+        validated: boolean;
+    };
+    /** Execution hints (engine-optimized) */
+    hints: {
+        cacheable: boolean;
+        idempotent: boolean;
+        heavy: boolean;
+        cost: 'free' | 'low' | 'medium' | 'high';
+    };
+}
+/**
+ * Context Builder
+ * Used by engine to create internal context
+ */
+export declare class InternalContextBuilder {
+    /**
+     * Create execution identity
+     */
+    static createIdentity(engineVersion: string): ExecutionIdentity;
+    /**
+     * Create default ownership context (local mode)
+     */
+    static createDefaultOwnership(): OwnershipContext;
+    /**
+     * Create billing snapshot
+     */
+    static createBillingSnapshot(subscriptionTier: string, billingMode: 'ecosystem' | 'component'): BillingSnapshot;
+    /**
+     * Initialize usage counters
+     */
+    static initializeCounters(): UsageCounters;
+    /**
+     * Create derived billing context
+     */
+    static createDerivedBilling(ownership: OwnershipContext, snapshot: BillingSnapshot): DerivedBillingContext;
+    /**
+     * Build complete internal context
+     */
+    static build(engineVersion: string, ownershipContext?: Partial<OwnershipContext>, requestOrigin?: 'cli' | 'api' | 'sdk' | 'webhook' | 'scheduler', executionMode?: 'local' | 'server' | 'embedded' | 'dry-run'): InternalExecutionContext;
+    /**
+     * Create security metadata
+     */
+    static createSecurityMetadata(ownership: OwnershipContext): SecurityMetadata;
+    /**
+     * Initialize runtime state
+     */
+    static initializeRuntimeState(): RuntimeState;
+    /**
+     * Create request context
+     */
+    static createRequestContext(origin: 'cli' | 'api' | 'sdk' | 'webhook' | 'scheduler', mode: 'local' | 'server' | 'embedded' | 'dry-run'): RequestContext;
+    /**
+     * Create step internal context
+     */
+    static createStepContext(userWeight?: number, userUnit?: string): InternalStepContext;
+    /**
+     * Generate unique ID
+     */
+    private static generateId;
+}
+//# sourceMappingURL=InternalExecutionContext.d.ts.map

package/dist/execution/InternalExecutionContext.d.ts.map

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