@acorex/platform 21.0.0-next.3 → 21.0.0-next.34

package/fesm2022/acorex-platform-workflow.mjs

@@ -1,14 +1,9 @@
 import * as i0 from '@angular/core';
-import { Injectable, inject, InjectionToken, Optional, SkipSelf, Inject, NgModule } from '@angular/core';
+import { Injectable, inject, InjectionToken, Optional, Inject, NgModule } from '@angular/core';
 import { Subject, filter } from 'rxjs';
 import { cloneDeep, get, set } from 'lodash-es';
-import { setSmart } from '@acorex/platform/core';
-import { AXPCommandService, AXPCommandRegistry, AXPQueryService, provideCommandSetups, AXP_COMMAND_SETUP } from '@acorex/platform/runtime';
-import { AXDialogService } from '@acorex/components/dialog';
-import { AXTranslationService } from '@acorex/core/translation';
-import { AXPLayoutBuilderService } from '@acorex/platform/layout/builder';
-import { AXToastService } from '@acorex/components/toast';
-import { Router } from '@angular/router';
+import { setSmart, AXPExpressionEvaluatorService, AXPDataGenerator } from '@acorex/platform/core';
+import { AXPCommandService } from '@acorex/platform/runtime';
 
 class AXPWorkflowError extends Error {
     constructor(message, inner = null) {
@@ -28,10 +23,10 @@ class AXPWorkflowEventService {
     get events$() {
         return this.eventSubject.asObservable();
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.12", ngImport: i0, type: AXPWorkflowEventService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
-    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.3.12", ngImport: i0, type: AXPWorkflowEventService, providedIn: 'root' }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPWorkflowEventService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPWorkflowEventService, providedIn: 'root' }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.12", ngImport: i0, type: AXPWorkflowEventService, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPWorkflowEventService, decorators: [{
             type: Injectable,
             args: [{
                     providedIn: 'root',
@@ -121,10 +116,10 @@ class AXPWorkflowRegistryService {
             });
         }
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.12", ngImport: i0, type: AXPWorkflowRegistryService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
-    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.3.12", ngImport: i0, type: AXPWorkflowRegistryService, providedIn: 'root' }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPWorkflowRegistryService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPWorkflowRegistryService, providedIn: 'root' }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.12", ngImport: i0, type: AXPWorkflowRegistryService, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPWorkflowRegistryService, decorators: [{
             type: Injectable,
             args: [{
                     providedIn: 'root',
@@ -163,17 +158,17 @@ class AXPWorkflowAction {
     dispatch(event) {
         this.eventService.dispatch(event);
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.12", ngImport: i0, type: AXPWorkflowAction, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
-    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.3.12", ngImport: i0, type: AXPWorkflowAction }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPWorkflowAction, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPWorkflowAction }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.12", ngImport: i0, type: AXPWorkflowAction, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPWorkflowAction, decorators: [{
             type: Injectable
         }] });
 class AXPWorkflowFunction {
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.12", ngImport: i0, type: AXPWorkflowFunction, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
-    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.3.12", ngImport: i0, type: AXPWorkflowFunction }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPWorkflowFunction, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPWorkflowFunction }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.12", ngImport: i0, type: AXPWorkflowFunction, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPWorkflowFunction, decorators: [{
             type: Injectable
         }] });
 function createWorkFlowEvent(type) {
@@ -189,10 +184,10 @@ class AXPWorkflowDecideAction extends AXPWorkflowAction {
     async execute(context) {
         // its a fake action
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.12", ngImport: i0, type: AXPWorkflowDecideAction, deps: null, target: i0.ɵɵFactoryTarget.Injectable }); }
-    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.3.12", ngImport: i0, type: AXPWorkflowDecideAction, providedIn: 'root' }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPWorkflowDecideAction, deps: null, target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPWorkflowDecideAction, providedIn: 'root' }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.12", ngImport: i0, type: AXPWorkflowDecideAction, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPWorkflowDecideAction, decorators: [{
             type: Injectable,
             args: [{
                     providedIn: 'root',
@@ -378,10 +373,10 @@ class AXPWorkflowService {
         }
         return this.injector.get(functionType);
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.12", ngImport: i0, type: AXPWorkflowService, deps: [{ token: AXPWorkflowRegistryService }, { token: i0.Injector }], target: i0.ɵɵFactoryTarget.Injectable }); }
-    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.3.12", ngImport: i0, type: AXPWorkflowService, providedIn: 'root' }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPWorkflowService, deps: [{ token: AXPWorkflowRegistryService }, { token: i0.Injector }], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPWorkflowService, providedIn: 'root' }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.12", ngImport: i0, type: AXPWorkflowService, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPWorkflowService, decorators: [{
             type: Injectable,
             args: [{
                     providedIn: 'root',
@@ -406,711 +401,769 @@ class AXPStartWorkflowAction extends AXPWorkflowAction {
             throw e;
         }
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.12", ngImport: i0, type: AXPStartWorkflowAction, deps: null, target: i0.ɵɵFactoryTarget.Injectable }); }
-    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.3.12", ngImport: i0, type: AXPStartWorkflowAction, providedIn: 'root' }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPStartWorkflowAction, deps: null, target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPStartWorkflowAction, providedIn: 'root' }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.12", ngImport: i0, type: AXPStartWorkflowAction, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPStartWorkflowAction, decorators: [{
             type: Injectable,
             args: [{
                     providedIn: 'root',
                 }]
         }] });
 
+// ============================================
+// WORKFLOW INSTANCE v3.0.0 TYPES
+// Based on Elsa Workflow Instance schema: https://elsaworkflows.io/schemas/workflow-instance/v3.0.0/schema.json
+// Compatible with Elsa backend while using ACoreX naming conventions
+// ============================================
+
+// Note:
+// Previous versions defined dedicated activity result/command types here
+// (AXPActivityResult / AXPActivity) that wrapped output and outcome.
+// Activities are now modeled directly as AXPCommand with outcome stored in
+// AXPExecuteCommandResult.metadata.outcome.
+
+const AXP_ACTIVITY_PROVIDER = new InjectionToken('AXP_ACTIVITY_PROVIDER', {
+    factory: () => [],
+});
+const AXP_ACTIVITY_CATEGORY_PROVIDER = new InjectionToken('AXP_ACTIVITY_CATEGORY_PROVIDER', {
+    factory: () => [],
+});
+
+//#region ----   Imports   ----
+//#endregion
 /**
- * Injection token for workflow definition loaders.
- * Multiple loaders can be provided (multi: true).
- */
-const AXP_WORKFLOW_DEFINITION_LOADER = new InjectionToken('AXP_WORKFLOW_DEFINITION_LOADER');
-/**
- * Resolver service for workflow definitions.
- * Aggregates all registered loaders and resolves workflow definitions.
+ * Optimized Activity Definition Service
+ *
+ * Manages activity definitions (metadata) for UI and tooling.
+ * Similar to AXPReportDefinitionService - only handles metadata, not execution.
+ *
+ * Performance optimizations:
+ * 1. Uses childrenCount to determine if category has children (no query needed)
+ * 2. Uses itemsCount to determine if category has activities (no query needed)
+ * 3. Aggressive caching prevents duplicate API calls
+ * 4. Single pending request per resource prevents race conditions
+ * 5. Lazy loading - only loads data when needed
  */
-class AXPWorkflowDefinitionResolver {
+class AXPActivityDefinitionService {
     constructor() {
-        this.loaders = inject(AXP_WORKFLOW_DEFINITION_LOADER, { optional: true });
+        //#region ----   Providers & Caches   ----
+        this.categoryProviders = inject(AXP_ACTIVITY_CATEGORY_PROVIDER, { optional: true }) || [];
+        this.activityProviders = inject(AXP_ACTIVITY_PROVIDER, { optional: true }) || [];
+        //#endregion
+        //#region ----   Cache Storage   ----
+        /** Cache for categories by id - O(1) lookup */
+        this.categoriesById = new Map();
+        /** Cache for categories by parentId - O(1) lookup */
+        this.categoriesByParentId = new Map();
+        /** Cache for activity definitions by categoryId - O(1) lookup */
+        this.activitiesByCategory = new Map();
+        /** Cache for individual activity definitions by name - O(1) lookup */
+        this.activitiesByName = new Map();
+        /** Track which provider index owns each category (by category ID) */
+        this.categoryOwnership = new Map(); // Maps categoryId → provider index
+        /** Pending API requests to prevent duplicate calls */
+        this.pendingCategoriesRequests = new Map();
+        this.pendingActivitiesRequests = new Map();
+        this.pendingActivityRequests = new Map();
     }
+    //#endregion
+    //#region ----   Initialization   ----
+    //#endregion
+    //#region ----   Public API: Categories   ----
     /**
-     * Get workflow definition by name (unique key).
-     * Tries all registered loaders until one returns a definition.
-     * @param name - The workflow name (unique key)
-     * @returns Workflow definition or null if not found
+     * Get categories by parentId with aggressive caching
+     *
+     * Optimization: Returns cached result immediately if available,
+     * preventing unnecessary API calls during navigation
+     *
+     * @param parentId - Parent category ID (undefined = root categories)
+     * @returns Array of categories with count metadata (childrenCount, itemsCount)
      */
-    async get(name) {
-        const loaderArray = Array.isArray(this.loaders) ? this.loaders : this.loaders ? [this.loaders] : [];
-        for (const loader of loaderArray) {
-            try {
-                const definition = await loader.get(name);
-                if (definition) {
-                    return definition;
-                }
+    async getCategories(parentId) {
+        // ✅ Fast path: Return cached result
+        if (this.categoriesByParentId.has(parentId)) {
+            return this.categoriesByParentId.get(parentId);
+        }
+        // ✅ Prevent duplicate requests: Return pending promise
+        if (this.pendingCategoriesRequests.has(parentId)) {
+            return this.pendingCategoriesRequests.get(parentId);
+        }
+        // ✅ Create single request and cache it
+        const requestPromise = this.loadCategoriesFromProviders(parentId);
+        this.pendingCategoriesRequests.set(parentId, requestPromise);
+        return requestPromise;
+    }
+    /**
+     * Get single category by ID with O(1) lookup
+     *
+     * Optimization: Uses Map for instant retrieval, falls back to
+     * searching cache, then providers if not found
+     */
+    async getCategoryById(categoryId) {
+        // ✅ Fast path: O(1) lookup in cache
+        if (this.categoriesById.has(categoryId)) {
+            return this.categoriesById.get(categoryId);
+        }
+        // ✅ Search in cached parent-child lists
+        for (const categories of this.categoriesByParentId.values()) {
+            const found = categories.find(cat => cat.id === categoryId);
+            if (found) {
+                this.categoriesById.set(categoryId, found);
+                return found;
             }
-            catch (error) {
-                console.warn(`[AXPWorkflowDefinitionResolver] Loader failed for ${name}:`, error);
+        }
+        // ✅ Load root categories if not loaded
+        if (!this.categoriesByParentId.has(undefined)) {
+            await this.getCategories();
+            if (this.categoriesById.has(categoryId)) {
+                return this.categoriesById.get(categoryId);
             }
         }
-        return null;
+        // ✅ Breadth-first search through hierarchy
+        return this.searchCategoryInHierarchy(categoryId);
     }
     /**
-     * Get all available workflow names from all loaders.
-     * @returns Array of unique workflow names
+     * Get category path from root to specified category
+     *
+     * Optimization: Builds path using cached categories only
      */
-    async getAllNames() {
-        const loaderArray = Array.isArray(this.loaders) ? this.loaders : this.loaders ? [this.loaders] : [];
-        const allNames = new Set();
-        for (const loader of loaderArray) {
-            if (loader.getAllNames) {
-                try {
-                    const names = await loader.getAllNames();
-                    names.forEach((name) => allNames.add(name));
-                }
-                catch (error) {
-                    console.warn('[AXPWorkflowDefinitionResolver] Failed to get names from loader:', error);
-                }
+    async getCategoriesPathById(categoryId) {
+        const path = [];
+        let currentCategoryId = categoryId;
+        while (currentCategoryId) {
+            const category = await this.getCategoryById(currentCategoryId);
+            if (!category) {
+                throw new Error(`Category '${currentCategoryId}' not found`);
             }
+            path.unshift(category);
+            currentCategoryId = category.parentId;
         }
-        return Array.from(allNames);
-    }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.12", ngImport: i0, type: AXPWorkflowDefinitionResolver, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
-    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.3.12", ngImport: i0, type: AXPWorkflowDefinitionResolver, providedIn: 'root' }); }
-}
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.12", ngImport: i0, type: AXPWorkflowDefinitionResolver, decorators: [{
-            type: Injectable,
-            args: [{ providedIn: 'root' }]
-        }] });
-
-/**
- * Registry service for workflow definitions.
- * Caches loaded definitions and provides change notifications.
- */
-class AXPWorkflowDefinitionRegistryService {
-    constructor() {
-        this.resolver = inject(AXPWorkflowDefinitionResolver);
-        this.cache = new Map();
-        this.onChanged = new Subject();
+        return path;
     }
+    //#endregion
+    //#region ----   Public API: Activity Definitions   ----
     /**
-     * Observable for workflow definition changes.
+     * Get activity definitions for a category with smart caching
+     *
+     * Optimization: Checks itemsCount before querying
+     * - If itemsCount = 0, returns empty array (no API call)
+     * - If itemsCount > 0, loads and caches activity definitions
+     * - Returns cached result on subsequent calls
+     *
+     * @param categoryId - Category ID to get activity definitions from
+     * @returns Array of activity definitions
      */
-    get onChanged$() {
-        return this.onChanged.asObservable();
+    async getActivitiesByCategoryId(categoryId) {
+        // ✅ Fast path: Return cached result
+        if (this.activitiesByCategory.has(categoryId)) {
+            return this.activitiesByCategory.get(categoryId);
+        }
+        // ✅ Smart optimization: Check itemsCount before querying
+        const category = await this.getCategoryById(categoryId);
+        if (category && category.itemsCount !== undefined && category.itemsCount === 0) {
+            // Category has no activities - cache empty array and skip API call
+            const emptyArray = [];
+            this.activitiesByCategory.set(categoryId, emptyArray);
+            return emptyArray;
+        }
+        // ✅ Prevent duplicate requests
+        if (this.pendingActivitiesRequests.has(categoryId)) {
+            return this.pendingActivitiesRequests.get(categoryId);
+        }
+        // ✅ Load from providers
+        const requestPromise = this.loadActivitiesFromProviders(categoryId);
+        this.pendingActivitiesRequests.set(categoryId, requestPromise);
+        return requestPromise;
     }
     /**
-     * Get workflow definition by name (unique key).
-     * Uses cache if available, otherwise loads from resolver.
-     * @param name - The workflow name (unique key)
-     * @returns Workflow definition or null if not found
+     * Get single activity definition by name with O(1) lookup
+     *
+     * Optimization: Uses Map for instant retrieval
+     *
+     * @param name - Activity name (unique identifier and command key)
+     * @returns Activity definition or undefined if not found
      */
-    async get(name) {
-        // Check cache first
-        if (this.cache.has(name)) {
-            return this.cache.get(name);
+    async getActivityByName(name) {
+        // ✅ Fast path: O(1) lookup in cache
+        if (this.activitiesByName.has(name)) {
+            return this.activitiesByName.get(name);
         }
-        // Load from resolver
-        const definition = await this.resolver.get(name);
-        if (definition) {
-            this.cache.set(name, definition);
-            this.onChanged.next({ name, action: 'registered' });
+        // ✅ Prevent duplicate requests
+        if (this.pendingActivityRequests.has(name)) {
+            return this.pendingActivityRequests.get(name);
         }
-        return definition;
+        // ✅ Load from providers
+        const requestPromise = this.loadActivityFromProviders(name);
+        this.pendingActivityRequests.set(name, requestPromise);
+        return requestPromise;
     }
     /**
-     * Register a workflow definition in the cache.
-     * @param definition - The workflow definition to register
+     * Get all activity definitions (flat list) by loading root categories and their activities.
+     * Used by activity selector UIs (e.g. automation command configurator).
      */
-    register(definition) {
-        this.cache.set(definition.name, definition);
-        this.onChanged.next({ name: definition.name, action: 'registered' });
+    async getAllActivities() {
+        const categories = await this.getCategories(undefined);
+        const all = [];
+        for (const cat of categories) {
+            const activities = await this.getActivitiesByCategoryId(cat.id);
+            all.push(...activities);
+        }
+        return all;
     }
     /**
-     * Update a workflow definition in the cache.
-     * @param definition - The updated workflow definition
+     * Get category ID containing a specific activity definition
+     *
+     * Optimization: Searches cache first, loads on-demand if needed
      */
-    update(definition) {
-        if (this.cache.has(definition.name)) {
-            this.cache.set(definition.name, definition);
-            this.onChanged.next({ name: definition.name, action: 'updated' });
+    async getCategoryIdByActivityName(activityName) {
+        // ✅ Search in cached activity definitions
+        for (const [categoryId, definitions] of this.activitiesByCategory.entries()) {
+            if (definitions.some(def => def.name === activityName)) {
+                return categoryId;
+            }
         }
+        // ✅ Try loading the activity definition to find its category
+        const definition = await this.getActivityByName(activityName);
+        if (definition && definition.category) {
+            // Try to find category by name/id
+            const categories = await this.getCategories();
+            const found = categories.find(cat => cat.id === definition.category || cat.title === definition.category);
+            if (found) {
+                return found.id;
+            }
+        }
+        return undefined;
     }
     /**
-     * Remove a workflow definition from the cache.
-     * @param name - The workflow name to remove
+     * Get category path for an activity
      */
-    remove(name) {
-        if (this.cache.has(name)) {
-            this.cache.delete(name);
-            this.onChanged.next({ name, action: 'removed' });
+    async getCategoriesPathByActivityName(activityName) {
+        const categoryId = await this.getCategoryIdByActivityName(activityName);
+        if (!categoryId) {
+            throw new Error(`Activity '${activityName}' not found in any category`);
         }
+        return this.getCategoriesPathById(categoryId);
     }
+    //#endregion
+    //#region ----   Private: Data Loading   ----
     /**
-     * Clear all cached workflow definitions.
+     * Load categories from providers and cache results
+     *
+     * Optimization: Tracks provider ownership to avoid unnecessary API calls
+     * - For root (parentId = undefined): Query ALL providers
+     * - For children: Only query the provider that owns the parent
      */
-    clear() {
-        this.cache.clear();
+    async loadCategoriesFromProviders(parentId) {
+        try {
+            const resolvedProviders = await Promise.allSettled(this.categoryProviders);
+            const categories = [];
+            // Determine which provider(s) to query
+            const providerIndicesToQuery = parentId
+                ? this.getProviderIndexForCategory(parentId)
+                : null; // Root: query all providers
+            for (let i = 0; i < resolvedProviders.length; i++) {
+                const p = resolvedProviders[i];
+                // Skip if we have a specific provider index and this isn't it
+                if (providerIndicesToQuery !== null && !providerIndicesToQuery.includes(i)) {
+                    continue;
+                }
+                if (p.status === 'fulfilled' && p.value && typeof p.value.getList === 'function') {
+                    try {
+                        const cats = await p.value.getList(parentId);
+                        if (Array.isArray(cats) && cats.length > 0) {
+                            categories.push(...cats);
+                            // ✅ Track ownership: This provider INDEX owns these categories
+                            cats.forEach(cat => this.categoryOwnership.set(cat.id, i));
+                        }
+                    }
+                    catch {
+                        // Continue on error - try other providers
+                    }
+                }
+            }
+            // ✅ Cache results for fast subsequent access
+            this.categoriesByParentId.set(parentId, categories);
+            categories.forEach(cat => this.categoriesById.set(cat.id, cat));
+            return categories;
+        }
+        finally {
+            this.pendingCategoriesRequests.delete(parentId);
+        }
     }
     /**
-     * Check if a workflow definition is cached.
-     * @param definitionId - The workflow definition ID
-     * @returns True if cached, false otherwise
+     * Get the provider index that owns a specific category
+     *
+     * @returns Array with provider index, or null if ownership unknown (query all)
      */
-    has(definitionId) {
-        return this.cache.has(definitionId);
+    getProviderIndexForCategory(categoryId) {
+        const ownerIndex = this.categoryOwnership.get(categoryId);
+        if (ownerIndex !== undefined) {
+            return [ownerIndex];
+        }
+        // Ownership unknown - will query all providers (fallback)
+        return null;
     }
     /**
-     * Get all cached workflow definition IDs.
-     * @returns Array of definition IDs (only those that have been loaded)
+     * Load activity definitions from providers and cache results
+     *
+     * Optimization: Only queries the provider that owns the category
+     * Uses provider INDEX to match category provider with activity provider
      */
-    getAllIds() {
-        return Array.from(this.cache.keys());
-    }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.12", ngImport: i0, type: AXPWorkflowDefinitionRegistryService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
-    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.3.12", ngImport: i0, type: AXPWorkflowDefinitionRegistryService, providedIn: 'root' }); }
-}
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.12", ngImport: i0, type: AXPWorkflowDefinitionRegistryService, decorators: [{
-            type: Injectable,
-            args: [{
-                    providedIn: 'root',
-                }]
-        }] });
-
-// ============================================
-// WORKFLOW INSTANCE v3.0.0 TYPES
-// Based on Elsa Workflow Instance schema: https://elsaworkflows.io/schemas/workflow-instance/v3.0.0/schema.json
-// Compatible with Elsa backend while using ACoreX naming conventions
-// ============================================
-
-/**
- * Base abstract class for activities.
- * Extend this to create custom activities.
- */
-class Activity {
-    constructor(type, name) {
-        this.type = type;
-        this.name = name;
+    async loadActivitiesFromProviders(categoryId) {
+        try {
+            const resolvedProviders = await Promise.allSettled(this.activityProviders);
+            const definitions = [];
+            // ✅ Smart routing: Get provider INDEX that owns this category
+            const ownerIndex = this.categoryOwnership.get(categoryId);
+            const providerIndicesToQuery = ownerIndex !== undefined ? [ownerIndex] : null;
+            for (let i = 0; i < resolvedProviders.length; i++) {
+                const p = resolvedProviders[i];
+                // Skip if we have a specific provider index and this isn't it
+                if (providerIndicesToQuery !== null && !providerIndicesToQuery.includes(i)) {
+                    continue;
+                }
+                if (p.status === 'fulfilled' && p.value && typeof p.value.getList === 'function') {
+                    try {
+                        const defs = await p.value.getList(categoryId);
+                        if (Array.isArray(defs)) {
+                            definitions.push(...defs);
+                        }
+                    }
+                    catch {
+                        // Continue on error - try other providers
+                    }
+                }
+            }
+            // ✅ Cache results for fast subsequent access
+            this.activitiesByCategory.set(categoryId, definitions);
+            definitions.forEach(def => {
+                if (def.name) {
+                    this.activitiesByName.set(def.name, def);
+                }
+            });
+            return definitions;
+        }
+        finally {
+            this.pendingActivitiesRequests.delete(categoryId);
+        }
     }
     /**
-     * Helper method that returns Done outcome by default.
+     * Load single activity definition from providers and cache result
      */
-    createResult(output, outcome = 'Done') {
-        return {
-            success: true,
-            data: {
-                output,
-                outcomes: { [outcome]: true },
-            },
-        };
-    }
-}
-/**
- * Activity registry for registering and creating activities.
- */
-class ActivityRegistry {
-    constructor() {
-        this.registry = new Map();
-        this.descriptors = new Map();
+    async loadActivityFromProviders(name) {
+        try {
+            const resolvedProviders = await Promise.allSettled(this.activityProviders);
+            // Try providers first
+            for (const p of resolvedProviders) {
+                if (p.status === 'fulfilled' && p.value && typeof p.value.getById === 'function') {
+                    try {
+                        const result = await p.value.getById(name);
+                        if (result) {
+                            this.activitiesByName.set(name, result);
+                            return result;
+                        }
+                    }
+                    catch {
+                        // Continue on error
+                    }
+                }
+            }
+            // Fallback: Search in cached activity definitions
+            for (const definitions of this.activitiesByCategory.values()) {
+                const found = definitions.find(def => def.name === name);
+                if (found) {
+                    this.activitiesByName.set(name, found);
+                    return found;
+                }
+            }
+            return undefined;
+        }
+        finally {
+            this.pendingActivityRequests.delete(name);
+        }
     }
     /**
-     * Register an activity type.
+     * Breadth-first search through category hierarchy
      */
-    register(type, factory, descriptor) {
-        this.registry.set(type, factory);
-        this.descriptors.set(type, descriptor);
+    async searchCategoryInHierarchy(categoryId) {
+        const searchQueue = [undefined];
+        const searched = new Set();
+        while (searchQueue.length > 0) {
+            const parentId = searchQueue.shift();
+            if (searched.has(parentId))
+                continue;
+            searched.add(parentId);
+            const categories = await this.getCategories(parentId);
+            const found = categories.find(cat => cat.id === categoryId);
+            if (found) {
+                return found;
+            }
+            // ✅ Optimization: Only search children if childrenCount > 0
+            for (const category of categories) {
+                if (category.childrenCount > 0 && !searched.has(category.id)) {
+                    searchQueue.push(category.id);
+                }
+            }
+        }
+        return undefined;
     }
+    //#endregion
+    //#region ----   Cache Management   ----
     /**
-     * Create an activity instance.
+     * Check if category has children (uses cached count)
      */
-    create(type) {
-        const factory = this.registry.get(type);
-        if (!factory) {
-            throw new Error(`Unknown activity type: ${type}`);
-        }
-        return factory();
+    categoryHasChildren(categoryId) {
+        const category = this.categoriesById.get(categoryId);
+        return category ? category.childrenCount > 0 : false;
     }
     /**
-     * Get activity descriptor.
+     * Check if category has activities (uses cached count)
      */
-    getDescriptor(type) {
-        return this.descriptors.get(type);
+    categoryHasActivities(categoryId) {
+        const category = this.categoriesById.get(categoryId);
+        return category ? (category.itemsCount ?? 0) > 0 : false;
     }
     /**
-     * Get all registered types.
+     * Clear all caches
      */
-    getTypes() {
-        return Array.from(this.registry.keys());
+    clearAllCache() {
+        this.categoriesById.clear();
+        this.categoriesByParentId.clear();
+        this.activitiesByCategory.clear();
+        this.activitiesByName.clear();
+        this.categoryOwnership.clear();
+        this.pendingCategoriesRequests.clear();
+        this.pendingActivitiesRequests.clear();
+        this.pendingActivityRequests.clear();
     }
     /**
-     * Get all descriptors.
+     * Clear categories cache only
      */
-    getAllDescriptors() {
-        return Array.from(this.descriptors.values());
+    clearCategoriesCache() {
+        this.categoriesById.clear();
+        this.categoriesByParentId.clear();
+        this.categoryOwnership.clear();
+        this.pendingCategoriesRequests.clear();
     }
     /**
-     * Get descriptors by category.
+     * Clear activities cache only
      */
-    getDescriptorsByCategory(category) {
-        return this.getAllDescriptors().filter(d => d.category === category);
-    }
+    clearActivitiesCache() {
+        this.activitiesByCategory.clear();
+        this.activitiesByName.clear();
+        this.pendingActivitiesRequests.clear();
+        this.pendingActivityRequests.clear();
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPActivityDefinitionService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPActivityDefinitionService, providedIn: 'root' }); }
 }
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPActivityDefinitionService, decorators: [{
+            type: Injectable,
+            args: [{
+                    providedIn: 'root',
+                }]
+        }] });
 
 /**
- * Injection token for activity providers.
+ * Injection token for workflow engine.
+ * Default implementation is AXPWorkflowLocalEngine.
  */
-const AXP_ACTIVITY_PROVIDER = new InjectionToken('AXP_ACTIVITY_PROVIDER');
+const AXP_WORKFLOW_ENGINE = new InjectionToken('AXP_WORKFLOW_ENGINE');
+
+//#endregion
 /**
- * Activity Provider Service.
- * Collects all activity providers and manages activity registration.
+ * Workflow Expression Scope Service
+ *
+ * Shared service for building expression evaluation scope from workflow data.
+ * Used by both Local Engine and Mock Runtime to manage workflow data (inputs, variables, outputs).
+ *
+ * Responsibilities:
+ * - Build expression evaluation scope from workflow state
+ * - Provide context.eval() function for accessing workflow data
+ * - Manage workflow data structure (inputs, variables, outputs)
+ *
+ * This service does NOT:
+ * - Execute activities
+ * - Evaluate expressions (delegates to AXPExpressionEvaluatorService)
+ * - Manage workflow state (handled by runtime)
+ *
+ * @example
+ * ```typescript
+ * const scopeService = inject(WorkflowExpressionScopeService);
+ *
+ * // Build scope from workflow state
+ * const scope = scopeService.buildScope({
+ *   inputs: state.input || {},
+ *   variables: state.variables || {},
+ *   outputs: activityOutputs
+ * });
+ *
+ * // Or build from state directly
+ * const scope = scopeService.buildScopeFromState(state, activityOutputs);
+ * ```
  */
-class AXPActivityProviderService {
-    constructor() {
-        this.activityDescriptors = new Map();
-        this.categories = [];
-        this.providers = [];
-        this.categoryProviders = [];
-        this.initialized = false;
-        this.commandService = inject(AXPCommandService);
-        this.commandRegistry = inject(AXPCommandRegistry);
-    }
+class WorkflowExpressionScopeService {
+    //#region ----   Private Helpers (dot-notation input normalization) ----
     /**
-     * Register an activity provider.
+     * Collect dot-notation key-value pairs from nested objects so that e.g.
+     * { metadata: { "metadata.questionnaire.id": "x" } } becomes { "metadata.questionnaire.id": "x" } at root.
+     * Top-level non-dot keys are kept as-is.
      */
-    registerProvider(provider) {
-        this.providers.push(provider);
-        if (this.initialized) {
-            this.initializeProvider(provider);
+    flattenDotKeysFromTree(obj) {
+        if (obj === null || typeof obj !== 'object')
+            return obj;
+        const result = {};
+        for (const [key, value] of Object.entries(obj)) {
+            if (key.includes('.')) {
+                result[key] = value;
+            }
+            else if (value !== null && typeof value === 'object' && !Array.isArray(value)) {
+                for (const [k, v] of Object.entries(value)) {
+                    if (k.includes('.')) {
+                        result[k] = v;
+                    }
+                    else {
+                        result[key + '.' + k] = v;
+                    }
+                }
+            }
+            else {
+                result[key] = value;
+            }
         }
+        return result;
     }
     /**
-     * Register a category provider.
+     * Expand flat keys with dots into nested objects.
+     * e.g. { "metadata.questionnaire.id": "x" } -> { metadata: { questionnaire: { id: "x" } } }.
      */
-    registerCategoryProvider(provider) {
-        this.categoryProviders.push(provider);
-        if (this.initialized) {
-            this.initializeCategoryProvider(provider);
+    expandDotKeys(obj) {
+        if (obj === null || typeof obj !== 'object')
+            return obj;
+        const result = {};
+        const dotKeys = [];
+        const simpleKeys = [];
+        for (const [key, value] of Object.entries(obj)) {
+            if (key.includes('.')) {
+                dotKeys.push([key, value]);
+            }
+            else {
+                simpleKeys.push([key, value]);
+            }
         }
-    }
-    /**
-     * Initialize all providers.
-     */
-    async initialize() {
-        if (this.initialized)
-            return;
-        // Initialize category providers first
-        for (const provider of this.categoryProviders) {
-            await this.initializeCategoryProvider(provider);
+        for (const [key, value] of dotKeys) {
+            const parts = key.split('.');
+            let current = result;
+            for (let i = 0; i < parts.length - 1; i++) {
+                const part = parts[i];
+                if (!(part in current) || typeof current[part] !== 'object' || current[part] === null) {
+                    current[part] = {};
+                }
+                current = current[part];
+            }
+            current[parts[parts.length - 1]] = value;
         }
-        // Initialize activity providers
-        for (const provider of this.providers) {
-            await this.initializeProvider(provider);
+        for (const [key, value] of simpleKeys) {
+            result[key] = value;
         }
-        this.initialized = true;
+        return result;
     }
     /**
-     * Get activity descriptor by key.
+     * Normalize workflow input so that flat dot-notation keys (e.g. from form schema
+     * "metadata.questionnaire.id") become nested for expression access (inputs.metadata.questionnaire.id).
      */
-    getDescriptor(key) {
-        return this.activityDescriptors.get(key);
-    }
-    /**
-     * Get all activity descriptors.
-     */
-    getAllDescriptors() {
-        return Array.from(this.activityDescriptors.values());
-    }
-    /**
-     * Get descriptors by category.
-     */
-    getDescriptorsByCategory(category) {
-        return this.getAllDescriptors().filter(d => d.category === category);
+    normalizeInputs(input) {
+        if (!input || typeof input !== 'object')
+            return {};
+        const flattened = this.flattenDotKeysFromTree(input);
+        return this.expandDotKeys(flattened);
     }
+    //#endregion
+    //#region ----   Public Methods   ----
     /**
-     * Get all categories.
+     * Build expression evaluation scope for workflow activities.
+     *
+     * Provides workflow-specific data (inputs, variables, outputs) and context.eval() function.
+     * Other data (session, current user, etc.) are provided by expression evaluator scope providers.
+     *
+     * Scope includes:
+     * - inputs: Workflow input values (accessible as inputs.propertyName)
+     * - variables: Workflow state variables (accessible as variables.propertyName or vars.propertyName)
+     * - outputs: Previous activity outputs (accessible as outputs.activityId)
+     * - context.eval(path): Function to access nested properties from workflow data
+     *
+     * Expressions can use:
+     * - {{inputs.userName}} - Direct access to workflow input
+     * - {{variables.someVar}} or {{vars.someVar}} - Direct access to workflow variable
+     * - {{outputs.activityId.property}} - Direct access to previous activity output
+     * - {{context.eval("inputs.userName")}} - Access via context.eval (supports nested paths)
+     * - {{context.eval("variables.someVar")}} - Access variables via context.eval
+     * - {{context.eval("outputs.activityId.property")}} - Access outputs via context.eval
+     * - {{session.currentUser().name}} - Access current user via expression evaluator scope providers
+     *
+     * The context.eval() function provides a unified way to access all workflow data,
+     * similar to how entity-detail-list uses context.eval() to access parent data.
+     *
+     * @param context - Workflow expression context containing inputs, variables, and outputs
+     * @returns Expression evaluator scope with workflow data and context.eval() function
      */
-    getCategories() {
-        return [...this.categories].sort((a, b) => (a.order || 999) - (b.order || 999));
+    buildScope(context) {
+        // Normalize inputs so flat dot-notation keys (e.g. metadata.questionnaire.id from forms) become nested for expressions
+        const inputs = this.normalizeInputs(context.inputs || {});
+        // Build merged workflow data object for context.eval()
+        // This allows expressions like: context.eval("inputs.userName") or context.eval("variables.count")
+        const workflowData = {
+            inputs,
+            variables: context.variables || {},
+            vars: context.variables || {}, // Alias for convenience
+            outputs: context.outputs || {},
+        };
+        // Build scope object with workflow-specific data and context.eval()
+        // Note: AXPExpressionEvaluatorScope type expects { [namespace]: { [name]: Function } }
+        // but evaluate() method actually accepts flat objects with values too
+        // We'll use 'any' to allow both values and functions
+        const scope = {
+            // Direct access to workflow data
+            inputs: workflowData.inputs,
+            variables: workflowData.variables,
+            vars: workflowData.vars,
+            outputs: workflowData.outputs,
+            // Context object with eval function (similar to entity-detail-list pattern)
+            context: {
+                eval: (path) => {
+                    // Use lodash get to access nested properties
+                    // Supports paths like: "inputs.userName", "variables.count", "outputs.activityId.property"
+                    return get(workflowData, path);
+                },
+            },
+        };
+        return scope;
     }
     /**
-     * Create an activity instance by key using AXPCommandService.
+     * Build expression evaluation scope from workflow instance state.
+     *
+     * Convenience method that extracts data from AXPWorkflowInstanceState.
+     *
+     * @param state - Workflow instance state
+     * @param activityOutputs - Map of activity outputs (activityId -> output)
+     * @returns Expression evaluator scope with workflow data and context.eval() function
      */
-    async createActivity(key) {
-        try {
-            // Check if command exists
-            if (!this.commandService.exists(key)) {
-                return null;
+    buildScopeFromState(state, activityOutputs) {
+        // Convert activity outputs to record format
+        const outputs = {};
+        if (activityOutputs) {
+            if (activityOutputs instanceof Map) {
+                activityOutputs.forEach((output, activityId) => {
+                    outputs[activityId] = output;
+                });
             }
-            // Get command loader from registry
-            const loader = this.commandRegistry.getLoader(key);
-            if (!loader) {
-                return null;
+            else {
+                Object.assign(outputs, activityOutputs);
             }
-            // Create command instance
-            const command = await loader();
-            return command;
         }
-        catch (error) {
-            return null;
+        // Convenience alias for the last activity output (if available).
+        // This allows expressions like: {{outputs.last.someField}}
+        if (outputs['last'] === undefined && state.lastActivityOutput !== undefined) {
+            outputs['last'] = state.lastActivityOutput;
         }
+        return this.buildScope({
+            inputs: this.normalizeInputs((state.input || {})),
+            variables: state.variables || {},
+            outputs: outputs,
+        });
     }
-    // ============================================
-    // PRIVATE METHODS
-    // ============================================
-    async initializeProvider(provider) {
-        const context = {
-            registerActivity: (config) => {
-                this.activityDescriptors.set(config.key, config.descriptor);
-            }
-        };
-        await provider.provide(context);
-    }
-    async initializeCategoryProvider(provider) {
-        const context = {
-            registerCategories: (categories) => {
-                this.categories.push(...categories);
-            }
-        };
-        await provider.provide(context);
-    }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.12", ngImport: i0, type: AXPActivityProviderService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
-    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.3.12", ngImport: i0, type: AXPActivityProviderService, providedIn: 'root' }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: WorkflowExpressionScopeService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: WorkflowExpressionScopeService, providedIn: 'root' }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.12", ngImport: i0, type: AXPActivityProviderService, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: WorkflowExpressionScopeService, decorators: [{
             type: Injectable,
             args: [{
                     providedIn: 'root'
                 }]
         }] });
 
+//#region ----   Constants   ----
 /**
- * Injection token for activity category providers.
+ * Activity types handled internally by the workflow engine (e.g. mock backend).
+ * When such an activity is not registered as Command on the client, we skip execution
+ * without warning — the engine will run it when executing the workflow.
  */
-const AXP_ACTIVITY_CATEGORY_PROVIDER = new InjectionToken('AXP_ACTIVITY_CATEGORY_PROVIDER');
-class AXPActivityCategoryProviderService {
-    constructor(parent, providers = []) {
-        this.parent = parent;
-        this.providers = providers;
-        this.categories = new Map();
-        this.isInitialized = false;
-        if (!parent) {
-            this.initialize();
-        }
-    }
-    async initialize() {
-        if (this.isInitialized) {
-            return;
-        }
-        for (const provider of this.providers) {
-            await provider.provide({
-                registerCategories: (categories) => {
-                    categories.forEach(cat => this.categories.set(cat.name, cat));
-                }
-            });
-        }
-        this.isInitialized = true;
-    }
-    getAllCategories() {
-        return Array.from(this.categories.values()).sort((a, b) => (a.order || 0) - (b.order || 0));
-    }
-    getCategory(name) {
-        return this.categories.get(name);
-    }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.12", ngImport: i0, type: AXPActivityCategoryProviderService, deps: [{ token: AXPActivityCategoryProviderService, optional: true, skipSelf: true }, { token: AXP_ACTIVITY_CATEGORY_PROVIDER, optional: true }], target: i0.ɵɵFactoryTarget.Injectable }); }
-    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.3.12", ngImport: i0, type: AXPActivityCategoryProviderService, providedIn: 'root' }); }
-}
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.12", ngImport: i0, type: AXPActivityCategoryProviderService, decorators: [{
-            type: Injectable,
-            args: [{ providedIn: 'root' }]
-        }], ctorParameters: () => [{ type: AXPActivityCategoryProviderService, decorators: [{
-                    type: Optional
-                }, {
-                    type: SkipSelf
-                }] }, { type: undefined, decorators: [{
-                    type: Optional
-                }, {
-                    type: Inject,
-                    args: [AXP_ACTIVITY_CATEGORY_PROVIDER]
-                }] }] });
-
+const ENGINE_BUILTIN_ACTIVITY_TYPES = new Set([
+    'workflow-activity:set-variable',
+    'workflow-activity:http-request',
+]);
+//#endregion
 /**
- * Abstract service for workflow execution operations.
- *
- * This service handles communication with backend for workflow execution.
+ * Activity Executor Service
  *
- * Implementation should be provided in connectivity layer:
- * - Mock implementation: @acorex/connectivity/mock
- * - API implementation: @acorex/connectivity/api
+ * Service for executing workflow activities via CommandBus.
+ * Automatically evaluates expressions in activity inputs before execution.
  *
  * @example
  * ```typescript
- * // In connectivity/mock
- * @Injectable()
- * export class AXCWorkflowExecutionService implements AXPWorkflowExecutionService {
- *   async startExecution(request: AXPStartWorkflowExecutionRequest): Promise<AXPStartWorkflowExecutionResponse> {
- *     // Mock implementation
- *   }
- * }
+ * const executor = inject(ActivityExecutor);
  *
- * // In connectivity/api
- * @Injectable()
- * export class AXCWorkflowExecutionService implements AXPWorkflowExecutionService {
- *   constructor(private http: HttpClient) {}
- *
- *   async startExecution(request: AXPStartWorkflowExecutionRequest): Promise<AXPStartWorkflowExecutionResponse> {
- *     return firstValueFrom(
- *       this.http.post<AXPStartWorkflowExecutionResponse>(
- *         `${this.config.baseUrl}/api/workflows/${request.workflowId}/start`,
- *         { input: request.input }
- *       )
- *     );
- *   }
- * }
+ * // Execute activity with task and workflow state (expressions will be evaluated)
+ * const result = await executor.execute(task, workflowState, activityOutputs);
  * ```
  */
-class AXPWorkflowExecutionService {
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.12", ngImport: i0, type: AXPWorkflowExecutionService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
-    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.3.12", ngImport: i0, type: AXPWorkflowExecutionService }); }
-}
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.12", ngImport: i0, type: AXPWorkflowExecutionService, decorators: [{
-            type: Injectable
-        }] });
-
-//#endregion
-/**
- * Production Workflow Coordinator.
- *
- * Separates frontend/backend execution:
- * - Frontend activities: Execute with AXPCommand in browser
- * - Backend activities: Execute via API calls to backend
- * - State caching: Caches workflow state in client for performance
- *
- */
-class WorkflowCoordinator {
+class ActivityExecutor {
     constructor() {
         //#region ----   Services & Dependencies   ----
-        this.workflowExecutionService = inject(AXPWorkflowExecutionService);
         this.commandService = inject(AXPCommandService);
-        //#endregion
-        //#region ----   State Cache (Client-side for Performance)   ----
-        /**
-         * Cache workflow states in memory for quick access.
-         * Key: executionId
-         * Value: AXPWorkflowExecutionState
-         */
-        this.stateCache = new Map();
+        this.expressionEvaluator = inject(AXPExpressionEvaluatorService);
+        this.expressionScopeService = inject(WorkflowExpressionScopeService);
     }
     //#endregion
     //#region ----   Public Methods   ----
     /**
-     * Start workflow execution in backend.
-     *
-     * Backend decides what to do: returns pendingTask or indicates completion.
-     * Frontend only calls API - no business logic here.
-     *
-     * @param workflowId - Workflow ID
-     * @param input - Initial input data
-     * @returns Execution result with pendingTask (if any)
-     *
-     * @example
-     * ```typescript
-     * const result = await coordinator.startWorkflow('my-workflow', { userId: '123' });
-     *
-     * if (result.pendingTask) {
-     *   // Execute task if frontend, or wait for backend to complete
-     *   if (result.pendingTask.executionMode === 'frontend') {
-     *     await coordinator.executeTask(result.pendingTask);
-     *     await coordinator.completeTask(result.executionId, result.pendingTask, outcome, output);
-     *   }
-     * }
-     * ```
-     */
-    async startWorkflow(workflowId, input = {}) {
-        try {
-            const execution = await this.startWorkflowExecution(workflowId, input);
-            const result = {
-                success: true,
-                output: execution.state.output,
-                nextTask: execution.pendingTask || null,
-                executionId: execution.executionId,
-                state: execution.state
-            };
-            return result;
-        }
-        catch (error) {
-            console.error('[WorkflowCoordinator] ❌ Error in startWorkflow', error);
-            return {
-                success: false,
-                error: error.message || 'Failed to start workflow',
-                nextTask: null
-            };
-        }
-    }
-    /**
-     * Execute a frontend task using AXPCommand.
+     * Execute a workflow activity with expression evaluation.
      *
-     * Only executes if task.executionMode is 'frontend' or 'both'.
-     * Backend tasks are handled automatically by backend.
+     * Evaluates expressions in activity inputs using workflow state,
+     * then executes the activity via CommandBus.
      *
-     * @param task - Task to execute
+     * @param task - Workflow task containing activity information
+     * @param workflowState - Current workflow instance state (for expression evaluation)
+     * @param activityOutputs - Map of previous activity outputs (for expression evaluation)
      * @returns Execution result with output and outcome
      */
-    async executeTask(task) {
-        // Only execute frontend tasks
-        if (task.executionMode !== 'frontend' && task.executionMode !== 'both') {
-            throw new Error(`Task '${task.activityId}' is not a frontend task. Backend handles it automatically.`);
-        }
-        return await this.executeFrontendActivity(task);
-    }
-    /**
-     * Complete a task and get next task from backend.
-     *
-     * Sends task result to backend API.
-     * Backend decides: next task, fail, or complete workflow.
-     *
-     * @param executionId - Execution ID
-     * @param task - Completed task
-     * @param outcome - Task outcome (e.g., 'Done', 'Confirmed', 'Cancelled')
-     * @param output - Task output/result
-     * @returns Next task from backend (if any)
-     */
-    async completeTask(executionId, task, outcome, output) {
+    async execute(task, workflowState, activityOutputs) {
         try {
-            // Send result to backend - backend decides next step
-            const response = await this.workflowExecutionService.resumeExecution({
-                executionId,
-                stepId: task.activityId,
-                taskToken: task.taskToken,
-                outcome,
-                userInput: output
-            });
-            // Update cache
-            if (response.state) {
-                this.stateCache.set(executionId, response.state);
-            }
-            return {
-                success: true,
-                output: response.output,
-                nextTask: response.nextTask || null,
-                executionId,
-                state: response.state
-            };
-        }
-        catch (error) {
-            return {
-                success: false,
-                error: error.message || 'Failed to complete task',
-                nextTask: null
-            };
-        }
-    }
-    /**
-     * Execute workflow by ID (backward compatibility).
-     *
-     * @deprecated Use startWorkflow + executeTask + completeTask pattern instead.
-     * This method is kept for backward compatibility but will be removed.
-     */
-    async executeWorkflowById(workflowId, input = {}) {
-        // Just start workflow - caller should handle task execution
-        return await this.startWorkflow(workflowId, input);
-    }
-    /**
-     * Resume a suspended workflow (e.g., after user interaction).
-     *
-     * Backend determines nextStep based on outcome and outcomeConnections.
-     * Client only provides executionId, stepId, outcome, and optional userInput.
-     *
-     * @param executionId - Workflow execution ID
-     * @param stepId - Step ID that was waiting for user input
-     * @param outcome - User action outcome (e.g., 'Confirmed', 'Cancelled', 'Submitted')
-     * @param userInput - Optional user input data
-     */
-    async resumeWorkflow(executionId, stepId, outcome, userInput, taskToken) {
-        try {
-            // Ensure taskToken is provided for secure resumption
-            if (!taskToken) {
-                throw new Error('Missing taskToken for resumeWorkflow');
-            }
-            // Backend handles everything: checks outcomeConnections and determines nextStep
-            const response = await this.workflowExecutionService.resumeExecution({
-                executionId,
-                stepId,
-                taskToken,
-                outcome,
-                userInput
-            });
-            // Update cache with state from backend
-            if (response.state) {
-                this.stateCache.set(executionId, response.state);
-            }
-            return {
-                success: true,
-                output: response.output,
-                nextTask: response.nextTask || null, // Backend determines this from outcomeConnections
-                executionId,
-                state: response.state
-            };
-        }
-        catch (error) {
-            return {
-                success: false,
-                error: error.message || 'Failed to resume workflow',
-                nextTask: null
-            };
-        }
-    }
-    /**
-     * Get workflow execution state (from cache or backend).
-     */
-    async getWorkflowState(executionId) {
-        // Check cache first
-        const cached = this.stateCache.get(executionId);
-        if (cached) {
-            // Cache is valid for 5 minutes
-            const cacheAge = Date.now() - cached.lastUpdated.getTime();
-            if (cacheAge < 5 * 60 * 1000) {
-                return cached;
+            const activityName = task.activityType;
+            // Evaluate inputs if workflow state is provided
+            let evaluatedInputs = task.input || {};
+            if (workflowState) {
+                // Prefer explicit outputs, fallback to outputs stored in state
+                const outputsForScope = activityOutputs ??
+                    workflowState.activityOutputs ??
+                    undefined;
+                // Build expression scope from workflow state
+                const scope = this.expressionScopeService.buildScopeFromState(workflowState, outputsForScope);
+                // Evaluate all inputs recursively (handles nested objects and arrays)
+                evaluatedInputs = await this.expressionEvaluator.evaluate(task.input || {}, scope);
             }
-        }
-        // Fetch from backend
-        try {
-            const state = await this.workflowExecutionService.getExecutionState({
-                executionId
-            });
-            // Update cache
-            this.stateCache.set(executionId, state);
-            return state;
-        }
-        catch {
-            return null;
-        }
-    }
-    //#endregion
-    //#region ----   Private Methods   ----
-    /**
-     * Execute a frontend activity using CommandBus.
-     *
-     * Frontend activities are executed in the browser using AXPCommandService.
-     * Activities can also be executed in both frontend and backend (hybrid mode).
-     *
-     * @param task - Frontend task to execute
-     * @returns Execution result with output and outcome
-     */
-    async executeFrontendActivity(task) {
-        try {
             // Check if command exists
-            const commandExists = this.commandService.exists(task.activityType);
+            const commandExists = this.commandService.exists(activityName);
             if (!commandExists) {
-                console.warn(`[WorkflowCoordinator] ⚠️ Frontend activity '${task.activityType}' is not registered. Skipping execution.`);
+                if (!ENGINE_BUILTIN_ACTIVITY_TYPES.has(activityName)) {
+                    console.warn(`[ActivityExecutor] ⚠️ Activity '${activityName}' is not registered as Command. ` +
+                        `Skipping execution.`);
+                }
                 return {
                     output: null,
                     outcome: 'Done'
                 };
             }
-            // Execute activity via CommandBus
-            // Activities registered as AXPCommand return {output, outcomes}
-            // 🎯 Flatten properties if nested (workflow-studio format)
-            let commandInput = task.input || task.config || {};
+            // Flatten properties if nested (workflow-studio format)
+            let commandInput = evaluatedInputs;
             if (commandInput['properties'] && typeof commandInput['properties'] === 'object') {
                 // Flatten: {properties: {text: "..."}} -> {text: "..."}
                 commandInput = { ...commandInput['properties'] };
             }
-            const result = await this.commandService.execute(task.activityType, commandInput);
+            // Execute activity via CommandBus
+            // Activities (AXPActivity) return {output, outcome}; legacy may return {output, outcomes}
+            const result = await this.commandService.execute(activityName, commandInput);
             if (!result) {
                 return {
                     output: null,
@@ -1126,1285 +1179,1209 @@ class WorkflowCoordinator {
                 };
             }
             const commandResult = result.data;
-            const outcomes = commandResult?.outcomes ?? {};
+            // Prefer unified outcome in result.metadata; fall back to legacy data.outcome/outcomes.
+            const metadataOutcome = result?.metadata?.['outcome'];
             let outcome = 'Done';
-            if (Object.keys(outcomes).length > 0) {
-                outcome = outcomes['Done'] ? 'Done' : Object.keys(outcomes)[0] || 'Done';
+            if (typeof metadataOutcome === 'string' && metadataOutcome.length > 0) {
+                outcome = metadataOutcome;
             }
+            else if (typeof commandResult?.outcome === 'string' && commandResult.outcome.length > 0) {
+                outcome = commandResult.outcome;
+            }
+            else {
+                const outcomes = (commandResult?.outcomes ?? {});
+                if (outcomes && typeof outcomes === 'object' && Object.keys(outcomes).length > 0) {
+                    outcome = outcomes['Done'] ? 'Done' : Object.keys(outcomes)[0] || 'Done';
+                }
+            }
+            // Prefer output wrapper when present; otherwise treat data itself as output.
+            const output = commandResult && typeof commandResult === 'object' && 'output' in commandResult
+                ? commandResult.output
+                : commandResult;
             return {
-                output: commandResult?.output ?? null,
+                output: output ?? null,
                 outcome,
             };
         }
         catch (error) {
-            console.error(`[WorkflowCoordinator] ❌ Error executing frontend activity '${task.activityType}':`, error);
+            console.error(`[ActivityExecutor] ❌ Error evaluating expressions or executing activity:`, error);
             return {
                 output: { error: error.message || 'Unknown error' },
                 outcome: 'Failed'
             };
         }
     }
-    /**
-     * Start workflow execution in backend.
-     * Backend returns executionId, initial state, and first task to execute.
-     */
-    async startWorkflowExecution(workflowId, input) {
-        const response = await this.workflowExecutionService.startExecution({
-            workflowId,
-            input
-        });
-        // Cache state
-        this.stateCache.set(response.executionId, response.state);
-        return {
-            executionId: response.executionId,
-            state: response.state,
-            pendingTask: response.pendingTask
-        };
-    }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.12", ngImport: i0, type: WorkflowCoordinator, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
-    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.3.12", ngImport: i0, type: WorkflowCoordinator, providedIn: 'root' }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: ActivityExecutor, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: ActivityExecutor, providedIn: 'root' }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.12", ngImport: i0, type: WorkflowCoordinator, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: ActivityExecutor, decorators: [{
             type: Injectable,
             args: [{
                     providedIn: 'root'
                 }]
         }] });
 
+//#endregion
 /**
- * Types and interfaces for Workflow Execution Service.
- */
-
-// Production Workflow Coordinator (Frontend/Backend Separation)
-
-/**
- * WriteLine Activity - Simple console logging activity.
+ * Workflow Manager - Facade for workflow lifecycle orchestration.
  *
- * Usage:
- * ```typescript
- * const activity = new WriteLine();
- * await activity.execute({ text: 'Hello World' });
- * ```
- */
-class WriteLine extends Activity {
-    constructor() {
-        super('WriteLine');
-    }
-    async execute(input) {
-        const text = input.text || '';
-        if (text !== undefined && text !== null) {
-            console.log(`[WriteLine] ${text}`);
-        }
-        return this.createResult(undefined, 'Done');
-    }
-}
-
-var writeLine_activity = /*#__PURE__*/Object.freeze({
-    __proto__: null,
-    WriteLine: WriteLine
-});
-
-/**
- * Sequence Activity - Executes activities in sequential order.
+ * This service is the ONLY interface the frontend uses to interact with workflows.
+ * It follows Clean Architecture principles and does NOT contain execution or business logic.
  *
- * Usage:
- * ```typescript
- * const sequence = new Sequence();
- * sequence.activities = [activity1, activity2, activity3];
- * await sequence.execute({});
- * ```
+ * Responsibilities:
+ * - Orchestrate workflow lifecycle (start, execute, complete, resume)
+ * - Delegate execution to ActivityExecutor
+ * - Cache workflow state in memory
+ * - Expose a stable API for UI
+ *
+ * Rules:
+ * - No HTTP calls (delegates to AXPWorkflowEngine)
+ * - No CommandBus / Command execution (delegates to ActivityExecutor)
+ * - No workflow branching logic (backend decides)
+ * - No business validation (backend validates)
+ * - No backend assumptions (uses abstract runtime service)
  */
-class Sequence extends Activity {
+class AXPWorkflowManager {
     constructor() {
-        super('Sequence');
+        //#region ----   Services & Dependencies   ----
+        this.workflowEngine = inject(AXP_WORKFLOW_ENGINE);
+        this.activityExecutor = inject(ActivityExecutor);
+        //#endregion
+        //#region ----   State Cache   ----
         /**
-         * Activities to execute in sequence.
+         * Cache workflow states in memory for quick access.
+         * Key: instanceId
+         * Value: AXPWorkflowInstanceState
          */
-        this.activities = [];
+        this.stateCache = new Map();
+        /**
+         * Cache TTL in milliseconds (5 minutes).
+         */
+        this.CACHE_TTL = 5 * 60 * 1000;
     }
-    async execute(input) {
-        // Execute all activities in sequence
-        for (const activity of this.activities) {
-            const result = await activity.execute(input);
-            if (!result.success) {
+    //#endregion
+    //#region ----   Public Methods   ----
+    /**
+     * Execute frontend activities interactively until reaching workflow-activity:human-task or completion.
+     *
+     * Interactive = show form/popup immediately (user sees and acts). Only workflow-activity:human-task
+     * is not interactive (goes to task board). Other frontend activities (show-layout-popup, show-toast, etc.)
+     * even with taskType human-task in definition are executed here.
+     *
+     * @param instanceId - Workflow instance ID
+     * @param task - Current task to execute
+     * @param state - Current workflow state
+     * @param lastActivityOutput - Last activity output (for expression evaluation)
+     * @returns Final result with nextTask (if workflow-activity:human-task) or completion status
+     */
+    async executeInteractiveFlow(instanceId, task, state, activityOutputs) {
+        let currentTask = task;
+        let currentState = state;
+        let currentActivityOutputs = {
+            ...(currentState.activityOutputs || {}),
+            ...(activityOutputs || {}),
+        };
+        const maxIterations = 100; // Prevent infinite loops
+        let iterationCount = 0;
+        while (currentTask && iterationCount < maxIterations) {
+            iterationCount++;
+            // Interactive = frontend executionMode and NOT workflow-activity:human-task (that one goes to task board)
+            const isInteractive = (currentTask.executionMode === 'frontend' || currentTask.executionMode === 'both') &&
+                currentTask.activityType !== 'workflow-activity:human-task';
+            if (isInteractive) {
+                // Execute frontend activity
+                const execResult = await this.activityExecutor.execute(currentTask, currentState, currentActivityOutputs);
+                // Track outputs locally (backend should also persist and return them)
+                currentActivityOutputs = {
+                    ...currentActivityOutputs,
+                    [currentTask.activityId]: execResult.output,
+                };
+                // Send result to backend
+                const completeResponse = await this.workflowEngine.frontActivtyComplete({
+                    instanceId,
+                    activityNode: currentTask.activityId,
+                    output: execResult.output || {},
+                    outcome: execResult.outcome,
+                });
+                // Update state cache
+                if (completeResponse.state) {
+                    const normalizedState = { ...completeResponse.state };
+                    if (normalizedState.lastUpdated && !(normalizedState.lastUpdated instanceof Date)) {
+                        normalizedState.lastUpdated = new Date(normalizedState.lastUpdated);
+                    }
+                    currentState = normalizedState;
+                    // Prefer outputs returned by backend; fallback to local cache
+                    currentActivityOutputs = {
+                        ...currentActivityOutputs,
+                        ...(normalizedState.activityOutputs || {}),
+                    };
+                    this.stateCache.set(instanceId, normalizedState);
+                }
+                // Backend decides: if no nextTask, workflow is completed
+                if (!completeResponse.nextTask) {
+                    return {
+                        nextTask: null,
+                        state: currentState,
+                        output: completeResponse.output,
+                    };
+                }
+                // Backend decides: if nextTask is workflow-activity:human-task or not frontend, return it (task board or done)
+                const nextInteractive = (completeResponse.nextTask.executionMode === 'frontend' || completeResponse.nextTask.executionMode === 'both') &&
+                    completeResponse.nextTask.activityType !== 'workflow-activity:human-task';
+                if (!nextInteractive) {
+                    return {
+                        nextTask: completeResponse.nextTask,
+                        state: currentState,
+                    };
+                }
+                // Continue with next interactive frontend task
+                currentTask = completeResponse.nextTask;
+            }
+            else {
+                // Not interactive (e.g. workflow-activity:human-task) - return as-is for task board
                 return {
-                    success: false,
-                    message: result.message,
-                    data: {
-                        output: undefined,
-                        outcomes: {
-                            Failed: true,
-                        },
-                    },
+                    nextTask: currentTask,
+                    state: currentState,
                 };
             }
         }
-        return this.createResult(undefined, 'Done');
+        // Max iterations reached
+        if (iterationCount >= maxIterations) {
+            console.warn(`[AXPWorkflowManager] ⚠️ Maximum iterations (${maxIterations}) reached`);
+        }
+        return {
+            nextTask: currentTask,
+            state: currentState,
+        };
     }
-}
-
-var sequence_activity = /*#__PURE__*/Object.freeze({
-    __proto__: null,
-    Sequence: Sequence
-});
-
-/**
- * Show Confirm Dialog Activity - Displays confirmation dialog to user.
- *
- * Has two outcomes:
- * - 'Confirmed': User clicked confirm/yes
- * - 'Cancelled': User clicked cancel/no
- *
- * Usage:
- * ```typescript
- * const dialog = new ShowConfirmDialog();
- * await dialog.execute({
- *   title: 'Confirm Delete',
- *   message: 'Are you sure?',
- *   color: 'danger'
- * });
- * ```
- */
-class ShowConfirmDialog extends Activity {
-    //#endregion
-    constructor() {
-        super('ShowConfirmDialog');
-        //#region ----   Services & Dependencies   ----
-        this.dialogService = inject(AXDialogService);
-        this.translationService = inject(AXTranslationService);
-    }
-    async execute(input) {
-        const { title = '', message = '', color = 'primary', defaultAction = 'cancel', align = 'horizontal', backdrop = false } = input;
-        // Translate title and message only if they start with '@' (translation key)
-        // Otherwise use the text as-is
-        const translatedTitle = title
-            ? (title.startsWith('@')
-                ? await this.translationService.translateAsync(title) || title
-                : title)
-            : '';
-        const translatedMessage = message
-            ? (message.startsWith('@')
-                ? await this.translationService.translateAsync(message) || message
-                : message)
-            : '';
+    /**
+     * Start a new workflow instance.
+     *
+     * Creates a new workflow instance in backend and returns instance ID.
+     * Backend decides what to do: returns pendingTask or indicates completion.
+     *
+     * @param workflowId - Workflow ID to start
+     * @param input - Initial input data (optional)
+     * @returns Start result with instanceId, state, and nextTask
+     *
+     * @example
+     * ```typescript
+     * const result = await workflowManager.start('my-workflow', { userId: '123' });
+     *
+     * if (result.success && result.nextTask) {
+     *   // Execute task if frontend
+     *   if (result.nextTask.executionMode === 'frontend') {
+     *     const execResult = await workflowManager.execute(result.nextTask);
+     *     await workflowManager.complete(result.instanceId!, result.nextTask, execResult.outcome, execResult.output);
+     *   }
+     * }
+     * ```
+     */
+    async start(workflowId, input = {}) {
         try {
-            const confirmResult = await this.dialogService.confirm(translatedTitle, translatedMessage, color, align, backdrop, defaultAction);
-            const result = confirmResult.result;
-            const action = result ? 'confirm' : 'cancel';
-            return this.createResult({
-                result,
-                action
-            }, result ? 'Confirmed' : 'Cancelled');
-        }
-        catch (err) {
-            console.error('[ShowConfirmDialog] Error showing dialog:', err);
+            const response = await this.workflowEngine.start({
+                workflowId,
+                input,
+            });
+            // Cache state (normalize Date)
+            let startNormalizedState = { ...response.state };
+            if (startNormalizedState.lastUpdated && !(startNormalizedState.lastUpdated instanceof Date)) {
+                startNormalizedState.lastUpdated = new Date(startNormalizedState.lastUpdated);
+            }
+            this.stateCache.set(response.instanceId, startNormalizedState);
+            // 🎯 Interactive flow: Execute frontend activities that are NOT workflow-activity:human-task (those go to task board)
+            let finalNextTask = response.pendingTask || null;
+            let finalOutput = startNormalizedState.output;
+            const pendingTask = response.pendingTask;
+            if (pendingTask &&
+                (pendingTask.executionMode === 'frontend' || pendingTask.executionMode === 'both') &&
+                pendingTask.activityType !== 'workflow-activity:human-task') {
+                const interactiveResult = await this.executeInteractiveFlow(response.instanceId, pendingTask, startNormalizedState, response.activityOutputs || response.state.activityOutputs);
+                finalNextTask = interactiveResult.nextTask;
+                startNormalizedState = interactiveResult.state;
+                if (interactiveResult.output !== undefined) {
+                    finalOutput = interactiveResult.output;
+                }
+                // Update cache with final state
+                this.stateCache.set(response.instanceId, startNormalizedState);
+            }
+            // If backend returned null or non-executable task, return it as-is
+            // Backend already decided workflow status (suspended, completed, etc.)
             return {
-                success: false,
-                message: {
-                    text: err instanceof Error ? err.message : 'Failed to show confirm dialog',
-                },
-                data: {
-                    output: {
-                        result: false,
-                        action: 'error',
-                    },
-                    outcomes: {
-                        Cancelled: true,
-                    },
-                },
+                success: true,
+                instanceId: response.instanceId,
+                state: startNormalizedState,
+                nextTask: finalNextTask,
+                output: finalOutput,
             };
         }
-    }
-}
-
-var showConfirmDialog_activity = /*#__PURE__*/Object.freeze({
-    __proto__: null,
-    ShowConfirmDialog: ShowConfirmDialog
-});
-
-/**
- * Show Alert Dialog Activity - Displays alert dialog to user.
- *
- * Has one outcome:
- * - 'Done': User clicked OK
- *
- * Usage:
- * ```typescript
- * const dialog = new ShowAlertDialog();
- * await dialog.execute({
- *   title: 'Alert',
- *   message: 'This is an alert',
- *   color: 'info'
- * });
- * ```
- */
-class ShowAlertDialog extends Activity {
-    //#endregion
-    constructor() {
-        super('ShowAlertDialog');
-        //#region ----   Services & Dependencies   ----
-        this.dialogService = inject(AXDialogService);
-        this.translationService = inject(AXTranslationService);
-    }
-    async execute(input) {
-        const { title = '', message = '', color = 'primary' } = input;
-        // Translate title and message only if they start with '@' (translation key)
-        // Otherwise use the text as-is
-        const translatedTitle = title
-            ? (title.startsWith('@')
-                ? await this.translationService.translateAsync(title) || title
-                : title)
-            : '';
-        const translatedMessage = message
-            ? (message.startsWith('@')
-                ? await this.translationService.translateAsync(message) || message
-                : message)
-            : '';
-        try {
-            await this.dialogService.alert(translatedTitle, translatedMessage, color);
-            return this.createResult({
-                result: true,
-                action: 'ok'
-            }, 'Done');
-        }
-        catch (err) {
-            console.error('[ShowAlertDialog] Error showing dialog:', err);
+        catch (error) {
+            console.error('[AXPWorkflowManager] ❌ Error starting workflow:', error);
             return {
                 success: false,
-                message: {
-                    text: err instanceof Error ? err.message : 'Failed to show alert dialog',
-                },
-                data: {
-                    output: {
-                        result: false,
-                        action: 'error',
-                    },
-                    outcomes: {
-                        Failed: true,
-                    },
-                },
+                error: error.message || 'Failed to start workflow',
             };
         }
     }
-}
-
-var showAlertDialog_activity = /*#__PURE__*/Object.freeze({
-    __proto__: null,
-    ShowAlertDialog: ShowAlertDialog
-});
-
-/**
- * Show Dialog Layout Builder Activity - Displays dialog using Layout Builder.
- *
- * This activity allows you to create custom dialogs using the Layout Builder API.
- * It accepts JSON-serializable content (AXPWidgetNode) and actions configuration.
- *
- * The content can be created using Layout Builder and then converted to JSON:
- * ```typescript
- * const builder = layoutBuilderService.create();
- * builder.flex(flex => {
- *   flex.setDirection('column')
- *     .formField('First Name', field => {
- *       field.path('firstName');
- *       field.textBox({ placeholder: 'Enter first name' });
- *     });
- * });
- * const contentNode = builder.build();
- * ```
- *
- * Usage in Workflow:
- * ```typescript
- * const dialog = new ShowDialogLayoutBuilder();
- * await dialog.execute({
- *   title: 'User Information',
- *   size: 'md',
- *   context: { firstName: '', lastName: '' },
- *   content: {
- *     type: 'flex-layout',
- *     mode: 'edit',
- *     options: {
- *       flexDirection: 'column',
- *       gap: '16px'
- *     },
- *     children: [
- *       {
- *         type: 'form-field',
- *         mode: 'edit',
- *         options: {
- *           label: 'First Name',
- *           showLabel: true
- *         },
- *         children: [{
- *           type: 'text-editor',
- *           path: 'firstName',
- *           options: {
- *             placeholder: 'Enter first name'
- *           }
- *         }]
- *       }
- *     ]
- *   },
- *   actions: {
- *     cancel: '@general:actions.cancel.title',
- *     submit: '@general:actions.submit.title',
- *     custom: [{
- *       title: 'Save Draft',
- *       icon: 'fa-save',
- *       color: 'secondary',
- *       command: { name: 'save-draft' }
- *     }]
- *   }
- * });
- * ```
- *
- * Usage in JSON Workflow Definition:
- * ```json
- * {
- *   "type": "ShowDialogLayoutBuilder",
- *   "properties": {
- *     "title": "User Information",
- *     "size": "md",
- *     "context": { "firstName": "", "lastName": "" },
- *     "content": {
- *       "type": "flex-layout",
- *       "mode": "edit",
- *       "options": {
- *         "flexDirection": "column",
- *         "gap": "16px"
- *       },
- *       "children": [
- *         {
- *           "type": "form-field",
- *           "mode": "edit",
- *           "options": {
- *             "label": "First Name",
- *             "showLabel": true
- *           },
- *           "children": [{
- *             "type": "text-editor",
- *             "path": "firstName",
- *             "options": {
- *               "placeholder": "Enter first name"
- *             }
- *           }]
- *         }
- *       ]
- *     },
- *     "actions": {
- *       "cancel": "@general:actions.cancel.title",
- *       "submit": "@general:actions.submit.title"
- *     }
- *   }
- * }
- * ```
- */
-class ShowDialogLayoutBuilder extends Activity {
-    //#endregion
-    constructor() {
-        super('ShowDialogLayoutBuilder');
-        //#region ----   Services & Dependencies   ----
-        this.layoutBuilder = inject(AXPLayoutBuilderService);
-    }
-    async execute(input) {
-        const { title = '', size = 'md', context = {}, closeButton = false, message, content, actions } = input;
+    /**
+     * Resume a suspended workflow (e.g., after user interaction).
+     *
+     * Backend determines nextStep based on outcome and outcomeConnections.
+     * Client only provides instanceId, stepId, outcome, and optional userInput.
+     *
+     * @param instanceId - Workflow instance ID
+     * @param stepId - Step ID that was waiting for user input
+     * @param outcome - User action outcome (e.g., 'Confirmed', 'Cancelled', 'Submitted')
+     * @param userInput - Optional user input data
+     * @param taskToken - Secure task token (required for secure resumption)
+     * @returns Resume result with next task (if any)
+     */
+    async resume(instanceId, stepId, outcome, userInput, taskToken) {
         try {
-            // Create dialog using layout builder
-            const dialogRef = await this.layoutBuilder
-                .create()
-                .dialog(dialog => {
-                // Set basic dialog options
-                dialog
-                    .setTitle(title)
-                    .setSize(size)
-                    .setCloseButton(closeButton)
-                    .setContext(context);
-                // Set message if provided
-                if (message) {
-                    dialog.setMessage(message);
-                }
-                // Set content if provided
-                if (content) {
-                    // If content is already a flex-layout, use it directly
-                    // Otherwise, wrap it in a flex container with column direction
-                    if (content.type === 'flex-layout') {
-                        // Set content layout directly (accessing internal state of DialogContainerBuilder)
-                        dialog.contentLayout = content;
-                    }
-                    else {
-                        // Wrap content in a flex container
-                        const wrappedContent = {
-                            type: 'flex-layout',
-                            mode: 'edit',
-                            options: {
-                                flexDirection: 'column',
-                                gap: '10px',
-                            },
-                            children: [content],
-                        };
-                        dialog.contentLayout = wrappedContent;
-                    }
-                }
-                // Set actions if provided
-                if (actions) {
-                    dialog.setActions(actionBuilder => {
-                        if (actions.cancel) {
-                            actionBuilder.cancel(actions.cancel);
-                        }
-                        if (actions.submit) {
-                            actionBuilder.submit(actions.submit);
-                        }
-                        if (actions.custom) {
-                            actions.custom.forEach(action => {
-                                actionBuilder.custom(action);
-                            });
-                        }
-                    });
+            // Ensure taskToken is provided for secure resumption
+            if (!taskToken) {
+                throw new Error('Missing taskToken for resume operation');
+            }
+            // Backend handles everything: checks outcomeConnections and determines nextStep
+            const response = await this.workflowEngine.resume({
+                instanceId,
+                stepId,
+                taskToken,
+                outcome,
+                userInput,
+            });
+            // Update cache with state from backend
+            let normalizedState = response.state ? { ...response.state } : undefined;
+            if (normalizedState && normalizedState.lastUpdated && !(normalizedState.lastUpdated instanceof Date)) {
+                normalizedState.lastUpdated = new Date(normalizedState.lastUpdated);
+            }
+            if (normalizedState) {
+                this.stateCache.set(instanceId, normalizedState);
+            }
+            // 🎯 Interactive flow: Execute frontend activities that are NOT workflow-activity:human-task (those go to task board)
+            let finalNextTask = response.nextTask || null;
+            let finalOutput = response.output;
+            const nextTask = response.nextTask;
+            if (nextTask &&
+                (nextTask.executionMode === 'frontend' || nextTask.executionMode === 'both') &&
+                nextTask.activityType !== 'workflow-activity:human-task') {
+                const interactiveResult = await this.executeInteractiveFlow(instanceId, nextTask, normalizedState, normalizedState?.activityOutputs);
+                finalNextTask = interactiveResult.nextTask;
+                normalizedState = interactiveResult.state;
+                if (interactiveResult.output !== undefined) {
+                    finalOutput = interactiveResult.output;
                 }
-            })
-                .show();
-            // Get user action and context
-            const action = dialogRef.action() || 'cancel';
-            const dialogContext = dialogRef.context();
-            // Determine outcomes
-            const cancelled = action === 'cancel';
-            const confirmed = action === 'submit' || (!cancelled && action !== 'error');
-            // Close dialog
-            dialogRef.close();
-            // Return result with appropriate outcome
-            const outcome = cancelled ? 'Cancelled' : confirmed ? 'Confirmed' : 'Done';
-            return this.createResult({
-                context: dialogContext,
-                action,
-                cancelled,
-                confirmed
-            }, outcome);
-        }
-        catch (err) {
-            console.error('[ShowDialogLayoutBuilder] Error showing dialog:', err);
+                // Update cache with final state
+                this.stateCache.set(instanceId, normalizedState);
+            }
+            // If backend returned null or non-executable task, return it as-is
+            // Backend already decided workflow status (suspended, completed, etc.)
+            return {
+                success: true,
+                instanceId,
+                state: normalizedState || response.state,
+                nextTask: finalNextTask,
+                output: finalOutput,
+            };
+        }
+        catch (error) {
+            console.error('[AXPWorkflowManager] ❌ Error resuming workflow:', error);
             return {
                 success: false,
-                message: {
-                    text: err instanceof Error ? err.message : 'Failed to show dialog',
-                },
-                data: {
-                    output: {
-                        context: {},
-                        action: 'error',
-                        cancelled: true,
-                        confirmed: false,
-                    },
-                    outcomes: {
-                        Error: true,
-                    },
-                },
+                instanceId,
+                error: error.message || 'Failed to resume workflow',
             };
         }
     }
-}
-
-/**
- * Show Toast Activity - Displays toast notification to user.
- *
- * Usage:
- * ```typescript
- * const toast = new ShowToast();
- * await toast.execute({
- *   color: 'success',
- *   title: 'Success',
- *   message: 'Operation completed successfully!'
- * });
- * ```
- */
-class ShowToast extends Activity {
-    constructor() {
-        super('ShowToast');
-        this.toastService = inject(AXToastService);
-        this.translationService = inject(AXTranslationService);
-    }
-    async execute(input) {
-        const { color = 'primary', title = '', message = '', duration = 3000 } = input;
-        // Translate title and message only if they start with '@' (translation key)
-        // Otherwise use the text as-is
-        const translatedTitle = title
-            ? (title.startsWith('@')
-                ? await this.translationService.translateAsync(title) || title
-                : title)
-            : '';
-        const translatedMessage = message
-            ? (message.startsWith('@')
-                ? await this.translationService.translateAsync(message) || message
-                : message)
-            : '';
+    /**
+     * Get workflow instance state.
+     *
+     * Retrieves state from cache (if valid) or from backend.
+     *
+     * @param instanceId - Workflow instance ID
+     * @returns Workflow instance state or null if not found
+     */
+    async getState(instanceId) {
+        // Check cache first
+        const cached = this.stateCache.get(instanceId);
+        if (cached) {
+            // Normalize lastUpdated to Date (for cache safety)
+            const normalizedCached = { ...cached };
+            if (normalizedCached.lastUpdated && !(normalizedCached.lastUpdated instanceof Date)) {
+                normalizedCached.lastUpdated = new Date(normalizedCached.lastUpdated);
+            }
+            // Validate cache age
+            const cacheAge = Date.now() - normalizedCached.lastUpdated.getTime();
+            if (cacheAge < this.CACHE_TTL) {
+                return normalizedCached;
+            }
+        }
+        // Fetch from backend
         try {
-            await this.toastService.show({
-                color: color,
-                title: translatedTitle,
-                content: translatedMessage,
-                closeButton: true,
-                timeOut: duration,
-                timeOutProgress: true,
+            const state = await this.workflowEngine.getState({
+                instanceId,
             });
-            return this.createResult(undefined, 'Done');
+            // Normalize lastUpdated to Date (for cache safety)
+            const normalizedState = { ...state };
+            if (normalizedState.lastUpdated && !(normalizedState.lastUpdated instanceof Date)) {
+                normalizedState.lastUpdated = new Date(normalizedState.lastUpdated);
+            }
+            // Update cache
+            this.stateCache.set(instanceId, normalizedState);
+            return normalizedState;
         }
-        catch (err) {
-            console.error('[ShowToast] Error showing toast:', err);
-            return {
-                success: false,
-                message: {
-                    text: err instanceof Error ? err.message : 'Failed to show toast',
-                },
-                data: {
-                    output: undefined,
-                    outcomes: {
-                        Failed: true,
-                    },
-                },
-            };
+        catch (error) {
+            console.error('[AXPWorkflowManager] ❌ Error getting workflow state:', error);
+            return null;
         }
     }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPWorkflowManager, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPWorkflowManager, providedIn: 'root' }); }
 }
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPWorkflowManager, decorators: [{
+            type: Injectable,
+            args: [{
+                    providedIn: 'root',
+                }]
+        }] });
 
-var showToast_activity = /*#__PURE__*/Object.freeze({
-    __proto__: null,
-    ShowToast: ShowToast
+const AXP_WORKFLOW_PROVIDER = new InjectionToken('AXP_WORKFLOW_PROVIDER', {
+    factory: () => [],
+});
+const AXP_WORKFLOW_CATEGORY_PROVIDER = new InjectionToken('AXP_WORKFLOW_CATEGORY_PROVIDER', {
+    factory: () => [],
 });
 
+//#endregion
 /**
- * Navigate Activity - Navigates to different pages/routes.
+ * Local engine implementation that manages workflow progression and state.
  *
- * Usage:
- * ```typescript
- * const navigate = new Navigate();
- * await navigate.execute({
- *   mode: 'route',
- *   route: '/users',
- *   params: { id: '123' }
- * });
- * ```
+ * This engine:
+ * - Returns frontend/both activities as pendingTask (does NOT execute them)
+ * - Skips backend activities (does not error, continues execution)
+ * - Maintains workflow state in memory
+ * - Does not require backend API calls
+ *
+ * Execution of frontend tasks is handled by AXPWorkflowManager via ActivityExecutor.
+ * This engine only manages workflow progression and state storage.
+ *
+ * This is the DEFAULT engine provider. Applications can override it with
+ * an API-based engine implementation.
  */
-class Navigate extends Activity {
+class AXPWorkflowLocalEngine {
     constructor() {
-        super('Navigate');
-        this.router = inject(Router);
+        //#region ----   Services & Dependencies   ----
+        this.activityDefinitionService = inject(AXPActivityDefinitionService);
+        this.workflowProviders = inject(AXP_WORKFLOW_PROVIDER, { optional: true }) || [];
+        //#endregion
+        //#region ----   Instance Storage   ----
+        /**
+         * In-memory storage for workflow instances.
+         * Key: instanceId
+         * Value: LocalWorkflowState
+         */
+        this.instances = new Map();
+        /**
+         * Task token storage for secure resume operations.
+         * Key: taskToken
+         * Value: { instanceId, activityId }
+         */
+        this.taskTokens = new Map();
     }
-    async execute(input) {
-        const { mode = 'route', route = '', params = {}, queryParams = {}, entity = '', entityId = '', url = '' } = input;
-        try {
-            switch (mode) {
-                case 'route':
-                    await this.router.navigate([route], { queryParams });
-                    break;
-                case 'entity-details':
-                    const detailsRoute = `/entities/${entity}/details/${entityId}`;
-                    await this.router.navigate([detailsRoute], { queryParams });
-                    break;
-                case 'entity-list':
-                    const listRoute = `/entities/${entity}`;
-                    await this.router.navigate([listRoute], { queryParams });
-                    break;
-                case 'external':
-                    if (url) {
-                        window.open(url, '_blank');
-                    }
-                    break;
-                default:
-                    console.error(`[Navigate] Unknown navigation mode: ${mode}`);
-                    return {
-                        success: false,
-                        message: {
-                            text: `Unknown navigation mode: ${mode}`,
-                        },
-                        data: {
-                            output: undefined,
-                            outcomes: {
-                                Failed: true,
-                            },
-                        },
-                    };
-            }
-            return this.createResult(undefined, 'Done');
-        }
-        catch (err) {
-            console.error('[Navigate] Error navigating:', err);
-            return {
-                success: false,
-                message: {
-                    text: err instanceof Error ? err.message : 'Failed to navigate',
-                },
-                data: {
-                    output: undefined,
-                    outcomes: {
-                        Failed: true,
-                    },
-                },
+    //#endregion
+    //#region ----   Public Methods (AXPWorkflowEngine)   ----
+    /**
+     * Start a new workflow instance.
+     *
+     * Creates an in-memory workflow instance and progresses it.
+     * Frontend/both activities are returned as pendingTask for external execution.
+     * Backend activities are skipped.
+     */
+    async start(request) {
+        console.log(`[WorkflowLocalEngine] 🚀 Starting workflow: ${request.workflowId}`, request);
+        // Generate instance ID
+        const instanceId = AXPDataGenerator.uuid();
+        const now = new Date();
+        // Load workflow definition
+        console.log(`[WorkflowLocalEngine] 📥 Loading workflow definition: ${request.workflowId}`);
+        const definition = await this.getDefinition(request.workflowId);
+        if (!definition) {
+            console.error(`[WorkflowLocalEngine] ❌ Workflow definition not found: ${request.workflowId}`);
+            throw new Error(`Workflow definition not found: ${request.workflowId}`);
+        }
+        console.log(`[WorkflowLocalEngine] ✅ Definition loaded:`, {
+            name: definition.name,
+            activitiesCount: definition.graph?.activities?.length || 0,
+            connectionsCount: definition.graph?.connections?.length || 0,
+        });
+        // Initialize workflow state
+        const state = {
+            instanceId,
+            workflowId: request.workflowId,
+            status: 'running',
+            variables: {},
+            activityOutputs: {},
+            lastActivityOutput: undefined,
+            input: request.input || {},
+            output: undefined,
+            lastUpdated: now,
+        };
+        // Create local state
+        const localState = {
+            instanceId,
+            workflowId: request.workflowId,
+            definition,
+            state,
+            completedActivities: new Set(),
+            activityResults: new Map(),
+        };
+        // Store instance
+        this.instances.set(instanceId, localState);
+        // Execute workflow steps
+        console.log(`[WorkflowLocalEngine] ⚙️ Executing workflow steps...`);
+        const pendingTask = await this.executeWorkflowSteps(localState);
+        // Update state
+        localState.state.lastUpdated = new Date();
+        console.log(`[WorkflowLocalEngine] ✅ Workflow started:`, {
+            instanceId,
+            status: localState.state.status,
+            hasPendingTask: !!pendingTask,
+            pendingTaskType: pendingTask?.activityType,
+        });
+        return {
+            instanceId,
+            state: localState.state,
+            pendingTask: pendingTask || null,
+            activityOutputs: localState.state.activityOutputs,
+            lastActivityOutput: localState.state.lastActivityOutput,
+        };
+    }
+    /**
+     * Resume a suspended workflow instance.
+     *
+     * Validates task token, applies externally executed result,
+     * and continues progressing workflow steps.
+     */
+    async resume(request) {
+        // Validate task token
+        const tokenInfo = this.taskTokens.get(request.taskToken);
+        if (!tokenInfo || tokenInfo.instanceId !== request.instanceId || tokenInfo.activityId !== request.stepId) {
+            throw new Error('Invalid task token');
+        }
+        // Get instance
+        const localState = this.instances.get(request.instanceId);
+        if (!localState) {
+            throw new Error(`Workflow instance not found: ${request.instanceId}`);
+        }
+        // Store activity result (from external execution)
+        const outcome = request.outcome ?? 'Done';
+        localState.activityResults.set(request.stepId, {
+            output: request.userInput || {},
+            outcome,
+        });
+        localState.completedActivities.add(request.stepId);
+        // Store activity output for expression evaluation
+        localState.state.activityOutputs = {
+            ...(localState.state.activityOutputs || {}),
+            [request.stepId]: request.userInput || {},
+        };
+        localState.state.lastActivityOutput = request.userInput || {};
+        // Merge output/userInput into state variables
+        if (request.userInput) {
+            localState.state.variables = {
+                ...localState.state.variables,
+                ...(request.userInput || {}),
             };
         }
+        // Mark activity as completed and continue progression
+        // Continue progressing workflow steps (skipping backend activities)
+        const nextTask = await this.executeWorkflowSteps(localState);
+        // Update state
+        localState.state.lastUpdated = new Date();
+        // Determine final status
+        if (!nextTask && localState.state.status === 'running') {
+            localState.state.status = 'completed';
+            localState.state.output = localState.state.variables;
+        }
+        return {
+            output: request.userInput || {},
+            outcomes: { [outcome]: true },
+            state: localState.state,
+            nextTask: nextTask || null,
+        };
     }
-}
-
-var navigate_activity = /*#__PURE__*/Object.freeze({
-    __proto__: null,
-    Navigate: Navigate
-});
-
-/**
- * Set Variable Activity - Sets a variable value in workflow context.
- *
- * Usage:
- * ```typescript
- * const setVar = new SetVariable();
- * await setVar.execute({
- *   variableName: 'userId',
- *   value: '12345'
- * });
- * ```
- */
-class SetVariable extends Activity {
-    constructor() {
-        super('workflow-activity:set-variable', 'Set Variable');
+    /**
+     * Get current workflow instance state.
+     */
+    async getState(request) {
+        const localState = this.instances.get(request.instanceId);
+        if (!localState) {
+            throw new Error(`Workflow instance not found: ${request.instanceId}`);
+        }
+        // Normalize lastUpdated to Date (for cache safety)
+        const state = { ...localState.state };
+        if (state.lastUpdated && !(state.lastUpdated instanceof Date)) {
+            state.lastUpdated = new Date(state.lastUpdated);
+        }
+        return state;
     }
-    async execute(input) {
-        const { variableName, value } = input;
-        try {
-            // In a real implementation, this would set the variable in workflow context
-            // For now, we'll just log it
-            console.log(`[SetVariable] Setting ${variableName} = ${JSON.stringify(value)}`);
-            return this.createResult(undefined, 'Done');
+    //#endregion
+    //#region ----   Private Methods   ----
+    /**
+     * Get workflow definition from available providers.
+     */
+    async getDefinition(workflowId) {
+        // Try all providers in order
+        const resolvedProviders = await Promise.allSettled(this.workflowProviders);
+        for (const p of resolvedProviders) {
+            if (p.status === 'fulfilled' && p.value) {
+                const provider = p.value;
+                // Check if provider has getByName method
+                if (typeof provider.getByName === 'function') {
+                    try {
+                        const definition = await provider.getByName(workflowId);
+                        if (definition) {
+                            return definition;
+                        }
+                    }
+                    catch {
+                        // Continue on error - try other providers
+                    }
+                }
+            }
         }
-        catch (err) {
-            console.error('[SetVariable] Error setting variable:', err);
-            return {
-                success: false,
-                message: {
-                    text: err instanceof Error ? err.message : 'Failed to set variable',
-                },
-                data: {
-                    output: undefined,
-                    outcomes: {
-                        Failed: true,
-                    },
-                },
-            };
+        return null;
+    }
+    /**
+     * Progress workflow steps starting from the current position.
+     *
+     * For frontend/both activities: returns task immediately (suspends workflow).
+     * For backend activities: skips and continues.
+     *
+     * Returns the next pending task (if frontend activity found) or null (if completed).
+     */
+    async executeWorkflowSteps(localState) {
+        const graph = localState.definition.graph;
+        const activities = graph.activities || [];
+        const connections = graph.connections || [];
+        // Build activity map
+        const activityMap = new Map();
+        activities.forEach(activity => {
+            activityMap.set(activity.id, activity);
+        });
+        // Build connection graph
+        const outgoingConnections = new Map();
+        const incomingConnections = new Map();
+        connections.forEach(conn => {
+            const sourceId = conn.source.activtyName;
+            const targetId = conn.target.activtyName;
+            if (!outgoingConnections.has(sourceId)) {
+                outgoingConnections.set(sourceId, []);
+            }
+            outgoingConnections.get(sourceId).push(conn);
+            if (!incomingConnections.has(targetId)) {
+                incomingConnections.set(targetId, []);
+            }
+            incomingConnections.get(targetId).push(conn);
+        });
+        // Find starting activity (use startActivityId or no incoming connections, or first activity)
+        let currentActivityId = localState.currentActivityId;
+        if (!currentActivityId) {
+            // Use startActivityId if available
+            if (graph.startActivityId) {
+                currentActivityId = graph.startActivityId;
+            }
+            else {
+                // Find root activity (no incoming connections)
+                for (const activity of activities) {
+                    if (!incomingConnections.has(activity.id)) {
+                        currentActivityId = activity.id;
+                        break;
+                    }
+                }
+                // If no root found, use first activity
+                if (!currentActivityId && activities.length > 0) {
+                    currentActivityId = activities[0].id;
+                }
+            }
         }
+        // Execute workflow steps
+        while (currentActivityId) {
+            const activity = activityMap.get(currentActivityId);
+            if (!activity) {
+                break;
+            }
+            // Skip if already completed
+            if (localState.completedActivities.has(currentActivityId)) {
+                // Move to next activity
+                const nextId = this.getNextActivityId(currentActivityId, outgoingConnections, localState.activityResults);
+                currentActivityId = nextId ?? undefined;
+                continue;
+            }
+            // Get activity definition to retrieve executionMode and title
+            console.log(`[WorkflowLocalEngine] 🔍 Getting activity definition for: ${activity.name}`);
+            const activityDefinition = await this.activityDefinitionService.getActivityByName(activity.name);
+            console.log(`[WorkflowLocalEngine] 📋 Activity definition:`, {
+                name: activityDefinition?.name,
+                type: activityDefinition?.type,
+                executionMode: activityDefinition?.executionMode,
+                title: activityDefinition?.title,
+                found: !!activityDefinition,
+            });
+            const executionMode = activityDefinition?.executionMode || 'frontend';
+            const activityTitle = activityDefinition?.title;
+            // Handle backend activities: skip
+            if (executionMode === 'backend') {
+                console.log(`[WorkflowLocalEngine] ⏭️ Skipping backend activity: ${activity.name} (${activity.id})`);
+                localState.completedActivities.add(currentActivityId);
+                localState.activityResults.set(currentActivityId, {
+                    output: null,
+                    outcome: 'Done',
+                });
+                // Move to next activity
+                const nextId = this.getNextActivityId(currentActivityId, outgoingConnections, localState.activityResults);
+                currentActivityId = nextId ?? undefined;
+                continue;
+            }
+            // Handle frontend/both activities: return as pendingTask (do NOT execute)
+            if (executionMode === 'frontend' || executionMode === 'both') {
+                // Create task for external execution
+                // Note: Expression evaluation will be done by ActivityExecutor
+                const task = {
+                    taskToken: AXPDataGenerator.uuid(),
+                    activityId: activity.id,
+                    activityType: activity.name,
+                    activityName: activityTitle || undefined,
+                    executionMode: executionMode,
+                    input: activity.inputs || {}, // Pass raw inputs - executor will evaluate
+                };
+                // Store task token for secure resume
+                this.taskTokens.set(task.taskToken, {
+                    instanceId: localState.instanceId,
+                    activityId: activity.id,
+                });
+                // Update state to indicate suspension
+                localState.currentActivityId = currentActivityId;
+                localState.state.status = 'suspended';
+                localState.state.currentStepId = currentActivityId;
+                // Return task immediately - AXPWorkflowManager will execute it
+                return task;
+            }
+            // Move to next activity
+            const nextId = this.getNextActivityId(currentActivityId, outgoingConnections, localState.activityResults);
+            currentActivityId = nextId ?? undefined;
+        }
+        // Workflow completed
+        localState.state.status = 'completed';
+        localState.state.output = localState.state.variables;
+        localState.currentActivityId = undefined;
+        return null;
     }
-}
-
-var setVariable_activity = /*#__PURE__*/Object.freeze({
-    __proto__: null,
-    SetVariable: SetVariable
-});
-
-/**
- * Dispatch Event Activity - Dispatches an event to the system.
- *
- * Usage:
- * ```typescript
- * const dispatch = new DispatchEvent();
- * await dispatch.execute({
- *   eventName: 'user-created',
- *   eventData: { userId: '123', name: 'John' }
- * });
- * ```
- */
-class DispatchEvent extends Activity {
-    constructor() {
-        super('DispatchEvent');
+    /**
+     * Get next activity ID based on connections and outcomes.
+     */
+    getNextActivityId(currentActivityId, outgoingConnections, activityResults) {
+        const connections = outgoingConnections.get(currentActivityId) || [];
+        if (connections.length === 0) {
+            return null; // No outgoing connections - workflow ends
+        }
+        // Get current activity result
+        const result = activityResults.get(currentActivityId);
+        const outcome = result?.outcome || 'Done';
+        // Find connection matching outcome
+        // Outcome matching is typically done via port name (e.g., "Done", "Failed")
+        for (const conn of connections) {
+            const sourcePort = conn.source.port || 'Done';
+            if (sourcePort === outcome) {
+                return conn.target.activtyName;
+            }
+        }
+        // If no matching outcome, use first connection (default path)
+        if (connections.length > 0) {
+            return connections[0].target.activtyName;
+        }
+        return null;
     }
-    async execute(input) {
-        const { eventName, eventData } = input;
-        try {
-            // In a real implementation, this would dispatch the event through an event bus
-            // For now, we'll just log it
-            console.log(`[DispatchEvent] Dispatching event: ${eventName}`, eventData);
-            return this.createResult(undefined, 'Done');
+    async frontActivtyComplete(request) {
+        const localState = this.instances.get(request.instanceId);
+        if (!localState) {
+            throw new Error(`Workflow instance not found: ${request.instanceId}`);
         }
-        catch (err) {
-            console.error('[DispatchEvent] Error dispatching event:', err);
-            return {
-                success: false,
-                message: {
-                    text: err instanceof Error ? err.message : 'Failed to dispatch event',
-                },
-                data: {
-                    output: undefined,
-                    outcomes: {
-                        Failed: true,
-                    },
-                },
-            };
+        // Store activity result
+        const outcome = request.outcome ?? 'Done';
+        localState.activityResults.set(request.activityNode, {
+            output: request.output || {},
+            outcome,
+        });
+        localState.completedActivities.add(request.activityNode);
+        // Store outputs for expression evaluation
+        localState.state.activityOutputs = {
+            ...(localState.state.activityOutputs || {}),
+            [request.activityNode]: request.output || {},
+        };
+        localState.state.lastActivityOutput = request.output || {};
+        // Merge output into workflow variables
+        localState.state.variables = {
+            ...localState.state.variables,
+            ...(request.output || {}),
+        };
+        // Continue workflow progression
+        const nextTask = await this.executeWorkflowSteps(localState);
+        // Update state timestamp
+        localState.state.lastUpdated = new Date();
+        // Determine final status
+        if (!nextTask && localState.state.status === 'running') {
+            localState.state.status = 'completed';
+            localState.state.output = localState.state.variables;
         }
+        return {
+            output: request.output || {},
+            outcomes: { [outcome]: true },
+            nextTask: nextTask || null,
+            state: localState.state,
+        };
     }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPWorkflowLocalEngine, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPWorkflowLocalEngine }); }
 }
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPWorkflowLocalEngine, decorators: [{
+            type: Injectable
+        }] });
 
-var dispatchEvent_activity = /*#__PURE__*/Object.freeze({
-    __proto__: null,
-    DispatchEvent: DispatchEvent
-});
+// Workflow Runtime Services
 
+//#region ----   Imports   ----
+//#endregion
 /**
- * If Activity - Conditional execution based on a condition.
+ * Optimized Workflow Definition Service
  *
- * Usage:
- * ```typescript
- * const ifActivity = new If();
- * ifActivity.condition = '{{user.isAdmin}}';
- * ifActivity.thenActivities = [activity1, activity2];
- * ifActivity.elseActivities = [activity3];
- * ```
+ * Manages workflow definitions (metadata) for UI and tooling.
+ * Similar to AXPActivityDefinitionService - only handles metadata, not execution.
+ *
+ * Performance optimizations:
+ * 1. Uses childrenCount to determine if category has children (no query needed)
+ * 2. Uses itemsCount to determine if category has workflows (no query needed)
+ * 3. Aggressive caching prevents duplicate API calls
+ * 4. Single pending request per resource prevents race conditions
+ * 5. Lazy loading - only loads data when needed
  */
-class If extends Activity {
+class AXPWorkflowDefinitionService {
     constructor() {
-        super('If');
+        //#region ----   Providers & Caches   ----
+        this.categoryProviders = inject(AXP_WORKFLOW_CATEGORY_PROVIDER, { optional: true }) || [];
+        this.workflowProviders = inject(AXP_WORKFLOW_PROVIDER, { optional: true }) || [];
+        //#endregion
+        //#region ----   Cache Storage   ----
+        /** Cache for categories by id - O(1) lookup */
+        this.categoriesById = new Map();
+        /** Cache for categories by parentId - O(1) lookup */
+        this.categoriesByParentId = new Map();
+        /** Cache for workflow definitions by categoryId - O(1) lookup */
+        this.workflowsByCategory = new Map();
+        /** Cache for individual workflow definitions by name - O(1) lookup */
+        this.workflowsByName = new Map();
+        /** Track which provider index owns each category (by category ID) */
+        this.categoryOwnership = new Map(); // Maps categoryId → provider index
+        /** Pending API requests to prevent duplicate calls */
+        this.pendingCategoriesRequests = new Map();
+        this.pendingWorkflowsRequests = new Map();
+        this.pendingWorkflowRequests = new Map();
     }
-    async execute(input) {
-        const { condition, thenActivities = [], elseActivities = [] } = input;
-        try {
-            // Evaluate condition (simplified - in real implementation, use expression evaluator)
-            const conditionResult = this.evaluateCondition(condition);
-            let result;
-            let activities;
-            if (conditionResult) {
-                activities = thenActivities;
-                result = { branch: 'then' };
+    //#endregion
+    //#region ----   Public API: Categories   ----
+    /**
+     * Get categories by parentId with aggressive caching
+     *
+     * Optimization: Returns cached result immediately if available,
+     * preventing unnecessary API calls during navigation
+     *
+     * @param parentId - Parent category ID (undefined = root categories)
+     * @returns Array of categories with count metadata (childrenCount, itemsCount)
+     */
+    async getCategories(parentId) {
+        // ✅ Fast path: Return cached result
+        if (this.categoriesByParentId.has(parentId)) {
+            return this.categoriesByParentId.get(parentId);
+        }
+        // ✅ Prevent duplicate requests: Return pending promise
+        if (this.pendingCategoriesRequests.has(parentId)) {
+            return this.pendingCategoriesRequests.get(parentId);
+        }
+        // ✅ Create single request and cache it
+        const requestPromise = this.loadCategoriesFromProviders(parentId);
+        this.pendingCategoriesRequests.set(parentId, requestPromise);
+        return requestPromise;
+    }
+    /**
+     * Get single category by ID with O(1) lookup
+     *
+     * Optimization: Uses Map for instant retrieval, falls back to
+     * searching cache, then providers if not found
+     */
+    async getCategoryById(categoryId) {
+        // ✅ Fast path: O(1) lookup in cache
+        if (this.categoriesById.has(categoryId)) {
+            return this.categoriesById.get(categoryId);
+        }
+        // ✅ Search in cached parent-child lists
+        for (const categories of this.categoriesByParentId.values()) {
+            const found = categories.find(cat => cat.id === categoryId);
+            if (found) {
+                this.categoriesById.set(categoryId, found);
+                return found;
             }
-            else {
-                activities = elseActivities;
-                result = { branch: 'else' };
+        }
+        // ✅ Load root categories if not loaded
+        if (!this.categoriesByParentId.has(undefined)) {
+            await this.getCategories();
+            if (this.categoriesById.has(categoryId)) {
+                return this.categoriesById.get(categoryId);
             }
-            // Execute activities in the chosen branch
-            for (const activity of activities) {
-                const activityResult = await activity.execute(input);
-                if (!activityResult.success) {
-                    return {
-                        success: false,
-                        message: activityResult.message,
-                        data: {
-                            output: { branch: conditionResult ? 'then' : 'else', failedActivity: activity },
-                            outcomes: {
-                                Failed: true,
-                            },
-                        },
-                    };
-                }
+        }
+        // ✅ Breadth-first search through hierarchy
+        return this.searchCategoryInHierarchy(categoryId);
+    }
+    /**
+     * Get category path from root to specified category
+     *
+     * Optimization: Builds path using cached categories only
+     */
+    async getCategoriesPathById(categoryId) {
+        const path = [];
+        let currentCategoryId = categoryId;
+        while (currentCategoryId) {
+            const category = await this.getCategoryById(currentCategoryId);
+            if (!category) {
+                throw new Error(`Category '${currentCategoryId}' not found`);
             }
-            return this.createResult(result, conditionResult ? 'Then' : 'Else');
+            path.unshift(category);
+            currentCategoryId = category.parentId;
         }
-        catch (err) {
-            console.error('[If] Error evaluating condition:', err);
-            return {
-                success: false,
-                message: {
-                    text: err instanceof Error ? err.message : 'Failed to evaluate condition',
-                },
-                data: {
-                    output: { branch: 'error' },
-                    outcomes: {
-                        Failed: true,
-                    },
-                },
-            };
+        return path;
+    }
+    //#endregion
+    //#region ----   Public API: Workflow Definitions   ----
+    /**
+     * Get workflow definitions for a category with smart caching
+     *
+     * Optimization: Checks itemsCount before querying
+     * - If itemsCount = 0, returns empty array (no API call)
+     * - If itemsCount > 0, loads and caches workflow definitions
+     * - Returns cached result on subsequent calls
+     *
+     * @param categoryId - Category ID to get workflow definitions from
+     * @returns Array of workflow definitions
+     */
+    async getWorkflowsByCategoryId(categoryId) {
+        // ✅ Fast path: Return cached result
+        if (this.workflowsByCategory.has(categoryId)) {
+            return this.workflowsByCategory.get(categoryId);
+        }
+        // ✅ Smart optimization: Check itemsCount before querying
+        const category = await this.getCategoryById(categoryId);
+        if (category && category.itemsCount !== undefined && category.itemsCount === 0) {
+            // Category has no workflows - cache empty array and skip API call
+            const emptyArray = [];
+            this.workflowsByCategory.set(categoryId, emptyArray);
+            return emptyArray;
+        }
+        // ✅ Prevent duplicate requests
+        if (this.pendingWorkflowsRequests.has(categoryId)) {
+            return this.pendingWorkflowsRequests.get(categoryId);
+        }
+        // ✅ Load from providers
+        const requestPromise = this.loadWorkflowsFromProviders(categoryId);
+        this.pendingWorkflowsRequests.set(categoryId, requestPromise);
+        return requestPromise;
+    }
+    /**
+     * Get single workflow definition by name with O(1) lookup
+     *
+     * Optimization: Uses Map for instant retrieval
+     *
+     * @param name - Workflow name (unique identifier)
+     * @returns Workflow definition or undefined if not found
+     */
+    async getWorkflowByName(name) {
+        // ✅ Fast path: O(1) lookup in cache
+        if (this.workflowsByName.has(name)) {
+            return this.workflowsByName.get(name);
+        }
+        // ✅ Prevent duplicate requests
+        if (this.pendingWorkflowRequests.has(name)) {
+            return this.pendingWorkflowRequests.get(name);
         }
+        // ✅ Load from providers
+        const requestPromise = this.loadWorkflowFromProviders(name);
+        this.pendingWorkflowRequests.set(name, requestPromise);
+        return requestPromise;
     }
-    evaluateCondition(condition) {
-        if (typeof condition === 'boolean') {
-            return condition;
+    /**
+     * Get category ID containing a specific workflow definition
+     *
+     * Optimization: Searches cache first, loads on-demand if needed
+     */
+    async getCategoryIdByWorkflowName(workflowName) {
+        // ✅ Search in cached workflow definitions
+        for (const [categoryId, definitions] of this.workflowsByCategory.entries()) {
+            if (definitions.some(def => def.name === workflowName)) {
+                return categoryId;
+            }
         }
-        if (typeof condition === 'string') {
-            // Simple evaluation - in real implementation, use proper expression evaluator
-            return condition === 'true' || condition === '1' || condition === 'yes';
+        // ✅ Try loading the workflow definition to find its category
+        // Note: AXPWorkflowDefinition doesn't have category field
+        // Category is managed separately through category providers
+        // This method searches through cached categories
+        const definition = await this.getWorkflowByName(workflowName);
+        if (definition) {
+            // Search through all categories to find which one contains this workflow
+            const categories = await this.getCategories();
+            for (const category of categories) {
+                const workflows = await this.getWorkflowsByCategoryId(category.id);
+                if (workflows.some(w => w.name === workflowName)) {
+                    return category.id;
+                }
+            }
         }
-        return false;
+        return undefined;
     }
-}
-
-var if_activity = /*#__PURE__*/Object.freeze({
-    __proto__: null,
-    If: If
-});
-
-/**
- * While Activity - Loop execution while condition is true.
- *
- * Usage:
- * ```typescript
- * const whileActivity = new While();
- * whileActivity.condition = '{{counter < 10}}';
- * whileActivity.activities = [incrementActivity, logActivity];
- * ```
- */
-class While extends Activity {
-    constructor() {
-        super('While');
+    /**
+     * Get category path for a workflow
+     */
+    async getCategoriesPathByWorkflowName(workflowName) {
+        const categoryId = await this.getCategoryIdByWorkflowName(workflowName);
+        if (!categoryId) {
+            throw new Error(`Workflow '${workflowName}' not found in any category`);
+        }
+        return this.getCategoriesPathById(categoryId);
     }
-    async execute(input) {
-        const { condition, activities = [], maxIterations = 1000 } = input;
+    //#endregion
+    //#region ----   Private: Data Loading   ----
+    /**
+     * Load categories from providers and cache results
+     *
+     * Optimization: Tracks provider ownership to avoid unnecessary API calls
+     * - For root (parentId = undefined): Query ALL providers
+     * - For children: Only query the provider that owns the parent
+     */
+    async loadCategoriesFromProviders(parentId) {
         try {
-            let iteration = 0;
-            let conditionResult = this.evaluateCondition(condition);
-            while (conditionResult && iteration < maxIterations) {
-                // Execute activities in the loop
-                for (const activity of activities) {
-                    const activityResult = await activity.execute(input);
-                    if (!activityResult.success) {
-                        return {
-                            success: false,
-                            message: activityResult.message,
-                            data: {
-                                output: {
-                                    iterations: iteration,
-                                    completed: false,
-                                },
-                                outcomes: {
-                                    Failed: true,
-                                },
-                            },
-                        };
+            const resolvedProviders = await Promise.allSettled(this.categoryProviders);
+            const categories = [];
+            // Determine which provider(s) to query
+            const providerIndicesToQuery = parentId
+                ? this.getProviderIndexForCategory(parentId)
+                : null; // Root: query all providers
+            for (let i = 0; i < resolvedProviders.length; i++) {
+                const p = resolvedProviders[i];
+                // Skip if we have a specific provider index and this isn't it
+                if (providerIndicesToQuery !== null && !providerIndicesToQuery.includes(i)) {
+                    continue;
+                }
+                if (p.status === 'fulfilled' && p.value && typeof p.value.getList === 'function') {
+                    try {
+                        const cats = await p.value.getList(parentId);
+                        if (Array.isArray(cats) && cats.length > 0) {
+                            categories.push(...cats);
+                            // ✅ Track ownership: This provider INDEX owns these categories
+                            cats.forEach(cat => this.categoryOwnership.set(cat.id, i));
+                        }
+                    }
+                    catch {
+                        // Continue on error - try other providers
                     }
                 }
-                iteration++;
-                conditionResult = this.evaluateCondition(condition);
             }
-            const result = {
-                iterations: iteration,
-                completed: iteration < maxIterations
-            };
-            return this.createResult(result, 'Done');
+            // ✅ Cache results for fast subsequent access
+            this.categoriesByParentId.set(parentId, categories);
+            categories.forEach(cat => this.categoriesById.set(cat.id, cat));
+            return categories;
         }
-        catch (err) {
-            console.error('[While] Error in loop execution:', err);
-            return {
-                success: false,
-                message: {
-                    text: err instanceof Error ? err.message : 'Failed during loop execution',
-                },
-                data: {
-                    output: { iterations: 0, completed: false },
-                    outcomes: {
-                        Failed: true,
-                    },
-                },
-            };
+        finally {
+            this.pendingCategoriesRequests.delete(parentId);
         }
     }
-    evaluateCondition(condition) {
-        if (typeof condition === 'boolean') {
-            return condition;
-        }
-        if (typeof condition === 'string') {
-            // Simple evaluation - in real implementation, use proper expression evaluator
-            return condition === 'true' || condition === '1' || condition === 'yes';
+    /**
+     * Get the provider index that owns a specific category
+     *
+     * @returns Array with provider index, or null if ownership unknown (query all)
+     */
+    getProviderIndexForCategory(categoryId) {
+        const ownerIndex = this.categoryOwnership.get(categoryId);
+        if (ownerIndex !== undefined) {
+            return [ownerIndex];
         }
-        return false;
-    }
-}
-
-var while_activity = /*#__PURE__*/Object.freeze({
-    __proto__: null,
-    While: While
-});
-
-/**
- * ForEach Activity - Iterates over a collection of items.
- *
- * Usage:
- * ```typescript
- * const forEach = new ForEach();
- * await forEach.execute({
- *   items: ['item1', 'item2', 'item3'],
- *   activities: [processItemActivity]
- * });
- * ```
- */
-class ForEach extends Activity {
-    constructor() {
-        super('ForEach');
+        // Ownership unknown - will query all providers (fallback)
+        return null;
     }
-    async execute(input) {
-        const { items = [], activities = [], itemVariableName = 'currentItem', indexVariableName = 'currentIndex' } = input;
+    /**
+     * Load workflow definitions from providers and cache results
+     *
+     * Optimization: Only queries the provider that owns the category
+     * Uses provider INDEX to match category provider with workflow provider
+     */
+    async loadWorkflowsFromProviders(categoryId) {
         try {
-            const results = [];
-            for (let index = 0; index < items.length; index++) {
-                const currentItem = items[index];
-                // Create context with current item and index
-                const itemContext = {
-                    ...input,
-                    [itemVariableName]: currentItem,
-                    [indexVariableName]: index
-                };
-                // Execute activities for current item
-                for (const activity of activities) {
-                    const activityResult = await activity.execute(itemContext);
-                    if (!activityResult.success) {
-                        return {
-                            success: false,
-                            message: activityResult.message,
-                            data: {
-                                output: {
-                                    totalItems: items.length,
-                                    processedItems: results.length,
-                                    results,
-                                },
-                                outcomes: {
-                                    Failed: true,
-                                },
-                            },
-                        };
+            const resolvedProviders = await Promise.allSettled(this.workflowProviders);
+            const definitions = [];
+            // ✅ Smart routing: Get provider INDEX that owns this category
+            const ownerIndex = this.categoryOwnership.get(categoryId);
+            const providerIndicesToQuery = ownerIndex !== undefined ? [ownerIndex] : null;
+            for (let i = 0; i < resolvedProviders.length; i++) {
+                const p = resolvedProviders[i];
+                // Skip if we have a specific provider index and this isn't it
+                if (providerIndicesToQuery !== null && !providerIndicesToQuery.includes(i)) {
+                    continue;
+                }
+                if (p.status === 'fulfilled' && p.value && typeof p.value.getList === 'function') {
+                    try {
+                        const defs = await p.value.getList(categoryId);
+                        if (Array.isArray(defs)) {
+                            definitions.push(...defs);
+                        }
+                    }
+                    catch {
+                        // Continue on error - try other providers
                     }
                 }
-                results.push({
-                    item: currentItem,
-                    index,
-                    processed: true
-                });
             }
-            const result = {
-                totalItems: items.length,
-                processedItems: results.length,
-                results
-            };
-            return this.createResult(result, 'Done');
+            // ✅ Cache results for fast subsequent access
+            this.workflowsByCategory.set(categoryId, definitions);
+            definitions.forEach(def => {
+                if (def.name) {
+                    this.workflowsByName.set(def.name, def);
+                }
+            });
+            return definitions;
         }
-        catch (err) {
-            console.error('[ForEach] Error in iteration:', err);
-            return {
-                success: false,
-                message: {
-                    text: err instanceof Error ? err.message : 'Failed during iteration',
-                },
-                data: {
-                    output: { totalItems: 0, processedItems: 0, results: [] },
-                    outcomes: {
-                        Failed: true,
-                    },
-                },
-            };
+        finally {
+            this.pendingWorkflowsRequests.delete(categoryId);
         }
     }
-}
-
-var forEach_activity = /*#__PURE__*/Object.freeze({
-    __proto__: null,
-    ForEach: ForEach
-});
-
-/**
- * Execute Command Activity - Executes a command through Command Bus.
- *
- * Usage:
- * ```typescript
- * const executeCmd = new ExecuteCommand();
- * await executeCmd.execute({
- *   commandKey: 'UserManagement.CreateUser',
- *   input: { name: 'John', email: 'john@example.com' }
- * });
- * ```
- */
-class ExecuteCommand extends Activity {
-    constructor() {
-        super('workflow-activity:execute-command', 'Execute Command');
-        this.commandService = inject(AXPCommandService);
-    }
-    async execute(input) {
-        const { commandKey, input: commandInput = {} } = input;
+    /**
+     * Load single workflow definition from providers and cache result
+     */
+    async loadWorkflowFromProviders(name) {
         try {
-            // Check if command exists
-            if (!this.commandService.exists(commandKey)) {
-                console.warn(`[ExecuteCommand] Command '${commandKey}' is not registered. Simulating execution.`);
-                // Simulate command execution for unregistered commands
-                const result = {
-                    commandKey,
-                    success: true,
-                    output: commandInput,
-                    executedAt: new Date().toISOString(),
-                    simulated: true
-                };
-                return this.createResult(result, 'Done');
-            }
-            // Execute command through Command Bus
-            const result = await this.commandService.execute(commandKey, commandInput);
-            if (!result) {
-                return {
-                    success: false,
-                    message: {
-                        text: `Command '${commandKey}' returned no result`,
-                    },
-                    data: {
-                        output: {
-                            commandKey,
-                            success: false,
-                            executedAt: new Date().toISOString(),
-                        },
-                        outcomes: {
-                            Failed: true,
-                        },
-                    },
-                };
+            const resolvedProviders = await Promise.allSettled(this.workflowProviders);
+            // Try providers first
+            for (const p of resolvedProviders) {
+                if (p.status === 'fulfilled' && p.value && typeof p.value.getByName === 'function') {
+                    try {
+                        const definition = await p.value.getByName(name);
+                        if (definition) {
+                            this.workflowsByName.set(name, definition);
+                            return definition;
+                        }
+                    }
+                    catch {
+                        // Continue on error
+                    }
+                }
             }
-            if (!result.success) {
-                return {
-                    success: false,
-                    message: result.message,
-                    data: {
-                        output: {
-                            commandKey,
-                            success: false,
-                            executedAt: new Date().toISOString(),
-                            error: result.message?.text,
-                        },
-                        outcomes: {
-                            Failed: true,
-                        },
-                    },
-                };
+            // Fallback: Search in cached workflow definitions
+            for (const definitions of this.workflowsByCategory.values()) {
+                const found = definitions.find(def => def.name === name);
+                if (found) {
+                    this.workflowsByName.set(name, found);
+                    return found;
+                }
             }
-            return this.createResult({
-                commandKey,
-                success: true,
-                output: result.data,
-                executedAt: new Date().toISOString(),
-            }, 'Done');
+            return undefined;
         }
-        catch (err) {
-            console.error('[ExecuteCommand] Error executing command:', err);
-            return {
-                success: false,
-                message: {
-                    text: err instanceof Error ? err.message : 'Unknown error',
-                },
-                data: {
-                    output: {
-                        commandKey,
-                        success: false,
-                        error: err instanceof Error ? err.message : 'Unknown error',
-                    },
-                    outcomes: {
-                        Failed: true,
-                    },
-                },
-            };
+        finally {
+            this.pendingWorkflowRequests.delete(name);
         }
     }
-}
-
-var executeCommand_activity = /*#__PURE__*/Object.freeze({
-    __proto__: null,
-    ExecuteCommand: ExecuteCommand
-});
-
-/**
- * Execute Query Activity - Executes a query through Query Bus.
- *
- * Usage:
- * ```typescript
- * const executeQuery = new ExecuteQuery();
- * await executeQuery.execute({
- *   queryKey: 'UserManagement.GetUsers',
- *   input: { page: 1, pageSize: 10 }
- * });
- * ```
- */
-class ExecuteQuery extends Activity {
-    constructor() {
-        super('workflow-activity:execute-query', 'Execute Query');
-        this.queryService = inject(AXPQueryService);
-    }
-    async execute(input) {
-        const { queryKey, input: queryInput = {} } = input;
-        try {
-            // Check if query exists
-            if (!this.queryService.exists(queryKey)) {
-                console.warn(`[ExecuteQuery] Query '${queryKey}' is not registered. Simulating execution.`);
-                // Simulate query execution for unregistered queries
-                const result = {
-                    queryKey,
-                    success: true,
-                    data: [],
-                    totalCount: 0,
-                    executedAt: new Date().toISOString(),
-                    simulated: true
-                };
-                return this.createResult(result, 'Done');
+    /**
+     * Breadth-first search through category hierarchy
+     */
+    async searchCategoryInHierarchy(categoryId) {
+        const searchQueue = [undefined];
+        const searched = new Set();
+        while (searchQueue.length > 0) {
+            const parentId = searchQueue.shift();
+            if (searched.has(parentId))
+                continue;
+            searched.add(parentId);
+            const categories = await this.getCategories(parentId);
+            const found = categories.find(cat => cat.id === categoryId);
+            if (found) {
+                return found;
+            }
+            // ✅ Optimization: Only search children if childrenCount > 0
+            for (const category of categories) {
+                if (category.childrenCount > 0 && !searched.has(category.id)) {
+                    searchQueue.push(category.id);
+                }
             }
-            // Execute query through Query Bus
-            const result = await this.queryService.fetch(queryKey, queryInput);
-            return this.createResult({
-                queryKey,
-                success: true,
-                data: result,
-                totalCount: Array.isArray(result) ? result.length : (result?.totalCount || 0),
-                executedAt: new Date().toISOString()
-            }, 'Done');
-        }
-        catch (err) {
-            console.error('[ExecuteQuery] Error executing query:', err);
-            return {
-                success: false,
-                message: {
-                    text: err instanceof Error ? err.message : 'Unknown error',
-                },
-                data: {
-                    output: {
-                        queryKey,
-                        success: false,
-                        error: err instanceof Error ? err.message : 'Unknown error',
-                    },
-                    outcomes: {
-                        Failed: true,
-                    },
-                },
-            };
         }
+        return undefined;
     }
-}
-
-var executeQuery_activity = /*#__PURE__*/Object.freeze({
-    __proto__: null,
-    ExecuteQuery: ExecuteQuery
-});
-
-/**
- * Start Activity - Marks the start point of a workflow.
- *
- * This is a visual marker activity that doesn't perform any actual work.
- * It's used in workflow designers to clearly indicate where a workflow begins.
- *
- * Usage:
- * ```typescript
- * const start = new StartActivity();
- * await start.execute({});
- * ```
- */
-class StartActivity extends Activity {
-    constructor() {
-        super('StartActivity');
+    //#endregion
+    //#region ----   Cache Management   ----
+    /**
+     * Check if category has children (uses cached count)
+     */
+    categoryHasChildren(categoryId) {
+        const category = this.categoriesById.get(categoryId);
+        return category ? category.childrenCount > 0 : false;
     }
-    async execute(input) {
-        // This activity is a visual marker only
-        // It immediately completes and allows workflow to proceed
-        console.log('[StartActivity] Workflow started');
-        return this.createResult(undefined, 'Done');
+    /**
+     * Check if category has workflows (uses cached count)
+     */
+    categoryHasWorkflows(categoryId) {
+        const category = this.categoriesById.get(categoryId);
+        return category ? (category.itemsCount ?? 0) > 0 : false;
     }
-}
-
-var startActivity_activity = /*#__PURE__*/Object.freeze({
-    __proto__: null,
-    StartActivity: StartActivity
-});
-
-/**
- * End Activity - Marks the end point of a workflow.
- *
- * This is a visual marker activity that terminates the workflow execution.
- * When this activity is reached, the workflow completes successfully.
- *
- * Usage:
- * ```typescript
- * const end = new EndActivity();
- * await end.execute({});
- * ```
- */
-class EndActivity extends Activity {
-    constructor() {
-        super('EndActivity');
+    /**
+     * Clear all caches
+     */
+    clearAllCache() {
+        this.categoriesById.clear();
+        this.categoriesByParentId.clear();
+        this.workflowsByCategory.clear();
+        this.workflowsByName.clear();
+        this.categoryOwnership.clear();
+        this.pendingCategoriesRequests.clear();
+        this.pendingWorkflowsRequests.clear();
+        this.pendingWorkflowRequests.clear();
     }
-    async execute(input) {
-        // This activity marks the end of workflow execution
-        console.log('[EndActivity] Workflow completed');
-        return this.createResult(undefined, 'Done');
+    /**
+     * Clear categories cache only
+     */
+    clearCategoriesCache() {
+        this.categoriesById.clear();
+        this.categoriesByParentId.clear();
+        this.categoryOwnership.clear();
+        this.pendingCategoriesRequests.clear();
     }
+    /**
+     * Clear workflows cache only
+     */
+    clearWorkflowsCache() {
+        this.workflowsByCategory.clear();
+        this.workflowsByName.clear();
+        this.pendingWorkflowsRequests.clear();
+        this.pendingWorkflowRequests.clear();
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPWorkflowDefinitionService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPWorkflowDefinitionService, providedIn: 'root' }); }
 }
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPWorkflowDefinitionService, decorators: [{
+            type: Injectable,
+            args: [{
+                    providedIn: 'root',
+                }]
+        }] });
 
-var endActivity_activity = /*#__PURE__*/Object.freeze({
-    __proto__: null,
-    EndActivity: EndActivity
-});
-
-/**
- * Command setups for all built-in workflow activities.
- * Registers activities as AXPCommand instances.
- */
-const provideWorkflowActivityCommands = () => provideCommandSetups([
-    // Workflow Markers
-    {
-        key: 'workflow-activity:start',
-        command: () => Promise.resolve().then(function () { return startActivity_activity; }).then(m => m.StartActivity),
-    },
-    {
-        key: 'workflow-activity:end',
-        command: () => Promise.resolve().then(function () { return endActivity_activity; }).then(m => m.EndActivity),
-    },
-    // Console Activities
-    {
-        key: 'workflow-activity:write-line',
-        command: () => Promise.resolve().then(function () { return writeLine_activity; }).then(m => m.WriteLine),
-    },
-    // Control Flow Activities
-    {
-        key: 'workflow-activity:sequence',
-        command: () => Promise.resolve().then(function () { return sequence_activity; }).then(m => m.Sequence),
-    },
-    {
-        key: 'workflow-activity:if',
-        command: () => Promise.resolve().then(function () { return if_activity; }).then(m => m.If),
-    },
-    {
-        key: 'workflow-activity:while',
-        command: () => Promise.resolve().then(function () { return while_activity; }).then(m => m.While),
-    },
-    {
-        key: 'workflow-activity:for-each',
-        command: () => Promise.resolve().then(function () { return forEach_activity; }).then(m => m.ForEach),
-    },
-    // Dialog Activities
-    {
-        key: 'workflow-activity:show-confirm-dialog',
-        command: () => Promise.resolve().then(function () { return showConfirmDialog_activity; }).then(m => m.ShowConfirmDialog),
-    },
-    {
-        key: 'workflow-activity:show-alert-dialog',
-        command: () => Promise.resolve().then(function () { return showAlertDialog_activity; }).then(m => m.ShowAlertDialog),
-    },
-    // Notification Activities
-    {
-        key: 'workflow-activity:show-toast',
-        command: () => Promise.resolve().then(function () { return showToast_activity; }).then(m => m.ShowToast),
-    },
-    // Event Activities
-    {
-        key: 'workflow-activity:dispatch-event',
-        command: () => Promise.resolve().then(function () { return dispatchEvent_activity; }).then(m => m.DispatchEvent),
-    },
-    // Variable Activities
-    {
-        key: 'workflow-activity:set-variable',
-        command: () => Promise.resolve().then(function () { return setVariable_activity; }).then(m => m.SetVariable),
-    },
-    // Command & Query Activities
-    {
-        key: 'workflow-activity:execute-command',
-        command: () => Promise.resolve().then(function () { return executeCommand_activity; }).then(m => m.ExecuteCommand),
-    },
-    {
-        key: 'workflow-activity:execute-query',
-        command: () => Promise.resolve().then(function () { return executeQuery_activity; }).then(m => m.ExecuteQuery),
-    },
-    // Navigation Activities
-    {
-        key: 'workflow-activity:navigate',
-        command: () => Promise.resolve().then(function () { return navigate_activity; }).then(m => m.Navigate),
-    },
-]);
-
-// Built-in Activities
-
-// Workflow Definition Types (Storage/Database)
+// Workflow Instance Types (Storage/Database)
 
 class AXPWorkflowModule {
     static forRoot(config) {
         return {
             ngModule: AXPWorkflowModule,
             providers: [
-                provideWorkflowActivityCommands(),
                 {
                     provide: 'AXPWorkflowModuleFactory',
                     useFactory: (registry) => () => {
@@ -2479,26 +2456,34 @@ class AXPWorkflowModule {
      * @ignore
      */
     constructor(instances) {
-        // Inject AXP_COMMAND_SETUP to trigger command registration factory
-        this._commandSetup = inject(AXP_COMMAND_SETUP, { optional: true });
         instances?.forEach((f) => {
             f();
         });
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.12", ngImport: i0, type: AXPWorkflowModule, deps: [{ token: 'AXPWorkflowModuleFactory', optional: true }], target: i0.ɵɵFactoryTarget.NgModule }); }
-    static { this.ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "14.0.0", version: "20.3.12", ngImport: i0, type: AXPWorkflowModule }); }
-    static { this.ɵinj = i0.ɵɵngDeclareInjector({ minVersion: "12.0.0", version: "20.3.12", ngImport: i0, type: AXPWorkflowModule, providers: [
-            provideWorkflowActivityCommands(),
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPWorkflowModule, deps: [{ token: 'AXPWorkflowModuleFactory', optional: true }], target: i0.ɵɵFactoryTarget.NgModule }); }
+    static { this.ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "14.0.0", version: "21.2.9", ngImport: i0, type: AXPWorkflowModule }); }
+    static { this.ɵinj = i0.ɵɵngDeclareInjector({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPWorkflowModule, providers: [
+            AXPWorkflowLocalEngine,
+            {
+                provide: AXP_WORKFLOW_ENGINE,
+                useExisting: AXPWorkflowLocalEngine,
+            },
+            AXPWorkflowManager,
         ] }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.12", ngImport: i0, type: AXPWorkflowModule, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPWorkflowModule, decorators: [{
             type: NgModule,
             args: [{
                     imports: [],
                     exports: [],
                     declarations: [],
                     providers: [
-                        provideWorkflowActivityCommands(),
+                        AXPWorkflowLocalEngine,
+                        {
+                            provide: AXP_WORKFLOW_ENGINE,
+                            useExisting: AXPWorkflowLocalEngine,
+                        },
+                        AXPWorkflowManager,
                     ],
                 }]
         }], ctorParameters: () => [{ type: undefined, decorators: [{
@@ -2512,5 +2497,5 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.12", ngImpo
  * Generated bundle index. Do not edit.
  */
 
-export { AXPActivityCategoryProviderService, AXPActivityProviderService, AXPWorkflowAction, AXPWorkflowContext, AXPWorkflowDefinitionRegistryService, AXPWorkflowDefinitionResolver, AXPWorkflowError, AXPWorkflowEventService, AXPWorkflowExecutionService, AXPWorkflowFunction, AXPWorkflowModule, AXPWorkflowRegistryService, AXPWorkflowService, AXP_ACTIVITY_CATEGORY_PROVIDER, AXP_ACTIVITY_PROVIDER, AXP_WORKFLOW_DEFINITION_LOADER, Activity, ActivityRegistry, DispatchEvent, EndActivity, ExecuteCommand, ExecuteQuery, ForEach, If, Navigate, Sequence, SetVariable, ShowAlertDialog, ShowConfirmDialog, ShowDialogLayoutBuilder, ShowToast, StartActivity, While, WorkflowCoordinator, WriteLine, createWorkFlowEvent, ofType, provideWorkflowActivityCommands };
+export { AXPActivityDefinitionService, AXPWorkflowAction, AXPWorkflowContext, AXPWorkflowDefinitionService, AXPWorkflowError, AXPWorkflowEventService, AXPWorkflowFunction, AXPWorkflowLocalEngine, AXPWorkflowManager, AXPWorkflowModule, AXPWorkflowRegistryService, AXPWorkflowService, AXP_ACTIVITY_CATEGORY_PROVIDER, AXP_ACTIVITY_PROVIDER, AXP_WORKFLOW_CATEGORY_PROVIDER, AXP_WORKFLOW_ENGINE, AXP_WORKFLOW_PROVIDER, ActivityExecutor, WorkflowExpressionScopeService, createWorkFlowEvent, ofType };
 //# sourceMappingURL=acorex-platform-workflow.mjs.map