@acorex/platform 20.8.9 → 20.8.11

package/fesm2022/acorex-platform-workflow.mjs

@@ -3,6 +3,7 @@ import { Injectable, inject, InjectionToken, Optional, Inject, NgModule } from '
 import { Subject, filter } from 'rxjs';
 import { cloneDeep, get, set } from 'lodash-es';
 import { setSmart, AXPExpressionEvaluatorService, AXPDataGenerator } from '@acorex/platform/core';
+import { AXTranslationService } from '@acorex/core/translation';
 import { AXPCommandService } from '@acorex/platform/runtime';
 
 class AXPWorkflowError extends Error {
@@ -23,10 +24,10 @@ class AXPWorkflowEventService {
     get events$() {
         return this.eventSubject.asObservable();
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.19", ngImport: i0, type: AXPWorkflowEventService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
-    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.3.19", 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.19", 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',
@@ -116,10 +117,10 @@ class AXPWorkflowRegistryService {
             });
         }
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.19", ngImport: i0, type: AXPWorkflowRegistryService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
-    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.3.19", 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.19", 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',
@@ -158,17 +159,17 @@ class AXPWorkflowAction {
     dispatch(event) {
         this.eventService.dispatch(event);
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.19", ngImport: i0, type: AXPWorkflowAction, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
-    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.3.19", 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.19", 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.19", ngImport: i0, type: AXPWorkflowFunction, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
-    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.3.19", 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.19", 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) {
@@ -184,10 +185,10 @@ class AXPWorkflowDecideAction extends AXPWorkflowAction {
     async execute(context) {
         // its a fake action
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.19", ngImport: i0, type: AXPWorkflowDecideAction, deps: null, target: i0.ɵɵFactoryTarget.Injectable }); }
-    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.3.19", 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.19", 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',
@@ -373,10 +374,10 @@ class AXPWorkflowService {
         }
         return this.injector.get(functionType);
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.19", 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.19", 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.19", 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',
@@ -401,10 +402,10 @@ class AXPStartWorkflowAction extends AXPWorkflowAction {
             throw e;
         }
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.19", ngImport: i0, type: AXPStartWorkflowAction, deps: null, target: i0.ɵɵFactoryTarget.Injectable }); }
-    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.3.19", 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.19", 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',
@@ -417,6 +418,12 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.19", ngImpo
 // 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: () => [],
 });
@@ -592,6 +599,19 @@ class AXPActivityDefinitionService {
         this.pendingActivityRequests.set(name, requestPromise);
         return requestPromise;
     }
+    /**
+     * Get all activity definitions (flat list) by loading root categories and their activities.
+     * Used by activity selector UIs (e.g. automation command configurator).
+     */
+    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;
+    }
     /**
      * Get category ID containing a specific activity definition
      *
@@ -609,7 +629,7 @@ class AXPActivityDefinitionService {
         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);
+            const found = categories.find((cat) => cat.id === definition.category);
             if (found) {
                 return found.id;
             }
@@ -836,10 +856,10 @@ class AXPActivityDefinitionService {
         this.pendingActivitiesRequests.clear();
         this.pendingActivityRequests.clear();
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.19", ngImport: i0, type: AXPActivityDefinitionService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
-    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.3.19", ngImport: i0, type: AXPActivityDefinitionService, providedIn: 'root' }); }
+    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: "20.3.19", ngImport: i0, type: AXPActivityDefinitionService, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPActivityDefinitionService, decorators: [{
             type: Injectable,
             args: [{
                     providedIn: 'root',
@@ -852,6 +872,62 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.19", ngImpo
  */
 const AXP_WORKFLOW_ENGINE = new InjectionToken('AXP_WORKFLOW_ENGINE');
 
+//#region ----   Error Codes   ----
+/**
+ * Stable workflow engine error codes for UI branching (toasts, take-over flow, etc.).
+ */
+const AXP_WORKFLOW_ERROR_CODES = {
+    TASK_NOT_ASSIGNEE: 'WORKFLOW_TASK_NOT_ASSIGNEE',
+    CLAIM_REQUIRED: 'WORKFLOW_CLAIM_REQUIRED',
+    REASSIGN_NOT_ALLOWED: 'WORKFLOW_REASSIGN_NOT_ALLOWED',
+};
+//#endregion
+//#region ----   Engine Error   ----
+/**
+ * Business-rule failure from {@link AXPWorkflowEngine} (expected, user-facing).
+ */
+class AXPWorkflowEngineError extends Error {
+    constructor(message, code, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = 'AXPWorkflowEngineError';
+    }
+}
+/**
+ * Resolves a stable error code from an unknown thrown value.
+ */
+function getWorkflowEngineErrorCode(error) {
+    if (error instanceof AXPWorkflowEngineError) {
+        return error.code;
+    }
+    return undefined;
+}
+/**
+ * Resolves a user-facing message and optional code from an unknown thrown value.
+ */
+function getWorkflowEngineErrorInfo(error) {
+    if (error instanceof AXPWorkflowEngineError) {
+        return { message: error.message, code: error.code };
+    }
+    if (error instanceof Error) {
+        return { message: error.message };
+    }
+    return { message: 'An unexpected workflow error occurred' };
+}
+//#endregion
+
+/**
+ * Activity types that use the task board (suspend until user acts via inbox), not inline interactive execution.
+ */
+const AXP_WORKFLOW_TASK_BOARD_ACTIVITY_TYPES = [
+    'workflow-activity:human-task',
+    'workflow-activity:cartable',
+];
+function axpIsWorkflowTaskBoardActivityType(activityType) {
+    return !!activityType && AXP_WORKFLOW_TASK_BOARD_ACTIVITY_TYPES.includes(activityType);
+}
+
 //#endregion
 /**
  * Workflow Expression Scope Service
@@ -885,6 +961,82 @@ const AXP_WORKFLOW_ENGINE = new InjectionToken('AXP_WORKFLOW_ENGINE');
  * ```
  */
 class WorkflowExpressionScopeService {
+    //#region ----   Private Helpers (dot-notation input normalization) ----
+    /**
+     * 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.
+     */
+    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;
+    }
+    /**
+     * Expand flat keys with dots into nested objects.
+     * e.g. { "metadata.questionnaire.id": "x" } -> { metadata: { questionnaire: { id: "x" } } }.
+     */
+    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]);
+            }
+        }
+        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;
+        }
+        for (const [key, value] of simpleKeys) {
+            result[key] = value;
+        }
+        return result;
+    }
+    /**
+     * 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).
+     */
+    normalizeInputs(input) {
+        if (!input || typeof input !== 'object')
+            return {};
+        const flattened = this.flattenDotKeysFromTree(input);
+        return this.expandDotKeys(flattened);
+    }
+    //#endregion
     //#region ----   Public Methods   ----
     /**
      * Build expression evaluation scope for workflow activities.
@@ -914,10 +1066,12 @@ class WorkflowExpressionScopeService {
      * @returns Expression evaluator scope with workflow data and context.eval() function
      */
     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: context.inputs || {},
+            inputs,
             variables: context.variables || {},
             vars: context.variables || {}, // Alias for convenience
             outputs: context.outputs || {},
@@ -971,21 +1125,32 @@ class WorkflowExpressionScopeService {
             outputs['last'] = state.lastActivityOutput;
         }
         return this.buildScope({
-            inputs: state.input || {},
+            inputs: this.normalizeInputs((state.input || {})),
             variables: state.variables || {},
             outputs: outputs,
         });
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.19", ngImport: i0, type: WorkflowExpressionScopeService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
-    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.3.19", ngImport: i0, type: WorkflowExpressionScopeService, 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.19", ngImport: i0, type: WorkflowExpressionScopeService, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: WorkflowExpressionScopeService, decorators: [{
             type: Injectable,
             args: [{
                     providedIn: 'root'
                 }]
         }] });
 
+//#region ----   Constants   ----
+/**
+ * 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 ENGINE_BUILTIN_ACTIVITY_TYPES = new Set([
+    'workflow-activity:set-variable',
+    'workflow-activity:http-request',
+    'workflow-activity:resolve-employee-user-id',
+]);
 //#endregion
 /**
  * Activity Executor Service
@@ -1007,6 +1172,7 @@ class ActivityExecutor {
         this.commandService = inject(AXPCommandService);
         this.expressionEvaluator = inject(AXPExpressionEvaluatorService);
         this.expressionScopeService = inject(WorkflowExpressionScopeService);
+        this.translateService = inject(AXTranslationService);
     }
     //#endregion
     //#region ----   Public Methods   ----
@@ -1039,21 +1205,23 @@ class ActivityExecutor {
             // Check if command exists
             const commandExists = this.commandService.exists(activityName);
             if (!commandExists) {
-                console.warn(`[ActivityExecutor] ⚠️ Activity '${activityName}' is not registered as Command. ` +
-                    `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'
                 };
             }
-            // Flatten properties if nested (workflow-studio format)
+            // Flatten properties if nested (designer-style nested payload)
             let commandInput = evaluatedInputs;
             if (commandInput['properties'] && typeof commandInput['properties'] === 'object') {
                 // Flatten: {properties: {text: "..."}} -> {text: "..."}
                 commandInput = { ...commandInput['properties'] };
             }
             // Execute activity via CommandBus
-            // Activities registered as AXPCommand return {output, outcomes}
+            // Activities (AXPActivity) return {output, outcome}; legacy may return {output, outcomes}
             const result = await this.commandService.execute(activityName, commandInput);
             if (!result) {
                 return {
@@ -1064,21 +1232,33 @@ class ActivityExecutor {
             if (!result.success) {
                 return {
                     output: {
-                        error: result.message?.text,
+                        error: await this.resolveCommandMessageTextForError(result.message?.text),
                     },
                     outcome: 'Failed',
                 };
             }
             const commandResult = result.data;
-            const outcomes = commandResult?.outcomes ?? {};
-            // Determine outcome from command results
-            // Default to 'Done' if no outcomes specified
+            // 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,
             };
         }
@@ -1090,10 +1270,22 @@ class ActivityExecutor {
             };
         }
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.19", ngImport: i0, type: ActivityExecutor, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
-    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.3.19", ngImport: i0, type: ActivityExecutor, providedIn: 'root' }); }
+    /**
+     * Resolves command failure message text for workflow output: `@` keys via translate, MLS maps via resolve.
+     */
+    async resolveCommandMessageTextForError(value) {
+        if (value == null) {
+            return '';
+        }
+        if (typeof value === 'string') {
+            return value.startsWith('@') ? await this.translateService.translateAsync(value) : value;
+        }
+        return this.translateService.resolve(value);
+    }
+    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.19", ngImport: i0, type: ActivityExecutor, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: ActivityExecutor, decorators: [{
             type: Injectable,
             args: [{
                     providedIn: 'root'
@@ -1141,23 +1333,19 @@ class AXPWorkflowManager {
     //#endregion
     //#region ----   Public Methods   ----
     /**
-     * Execute frontend activities interactively until reaching human-task or completion.
+     * Execute frontend activities interactively until reaching workflow-activity:human-task or completion.
      *
-     * This method handles the interactive flow between frontend and backend:
-     * 1. Executes frontend activity (ui-activity)
-     * 2. Sends result to backend via frontActivtyComplete
-     * 3. If backend returns nextTask (frontend activity), repeats the process
-     * 4. Continues until workflow completes or reaches human-task
+     * 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 human-task) or completion status
+     * @returns Final result with nextTask (if workflow-activity:human-task) or completion status
      */
     async executeInteractiveFlow(instanceId, task, state, activityOutputs) {
-        // Backend decides what to execute - frontend only executes ui-activity with frontend/both executionMode
-        // If backend returns a task that's not executable here, return it as-is
         let currentTask = task;
         let currentState = state;
         let currentActivityOutputs = {
@@ -1168,10 +1356,10 @@ class AXPWorkflowManager {
         let iterationCount = 0;
         while (currentTask && iterationCount < maxIterations) {
             iterationCount++;
-            // Only execute if task is ui-activity with frontend/both executionMode
-            // Backend decides if workflow should continue or suspend
-            if (currentTask.taskType === 'ui-activity' &&
-                (currentTask.executionMode === 'frontend' || currentTask.executionMode === 'both')) {
+            // Interactive = frontend executionMode and NOT task-board activities (human-task, cartable)
+            const isInteractive = (currentTask.executionMode === 'frontend' || currentTask.executionMode === 'both') &&
+                !axpIsWorkflowTaskBoardActivityType(currentTask.activityType);
+            if (isInteractive) {
                 // Execute frontend activity
                 const execResult = await this.activityExecutor.execute(currentTask, currentState, currentActivityOutputs);
                 // Track outputs locally (backend should also persist and return them)
@@ -1208,20 +1396,20 @@ class AXPWorkflowManager {
                         output: completeResponse.output,
                     };
                 }
-                // Backend decides: if nextTask is not executable here (human-task or other), return it
-                // Backend already set status to 'suspended' if needed
-                if (completeResponse.nextTask.taskType !== 'ui-activity' ||
-                    (completeResponse.nextTask.executionMode !== 'frontend' && completeResponse.nextTask.executionMode !== 'both')) {
+                // Backend decides: if nextTask is task-board activity or not frontend, return it (task board or done)
+                const nextInteractive = (completeResponse.nextTask.executionMode === 'frontend' || completeResponse.nextTask.executionMode === 'both') &&
+                    !axpIsWorkflowTaskBoardActivityType(completeResponse.nextTask.activityType);
+                if (!nextInteractive) {
                     return {
                         nextTask: completeResponse.nextTask,
                         state: currentState,
                     };
                 }
-                // Continue with next executable frontend task
+                // Continue with next interactive frontend task
                 currentTask = completeResponse.nextTask;
             }
             else {
-                // Not a frontend ui-activity - return as-is
+                // Not interactive (e.g. human-task / cartable) - return as-is for task board
                 return {
                     nextTask: currentTask,
                     state: currentState,
@@ -1272,15 +1460,14 @@ class AXPWorkflowManager {
                 startNormalizedState.lastUpdated = new Date(startNormalizedState.lastUpdated);
             }
             this.stateCache.set(response.instanceId, startNormalizedState);
-            // 🎯 Interactive flow: Execute frontend activities automatically
-            // Backend decides what to execute - if pendingTask is executable (ui-activity with frontend/both), execute it
+            // 🎯 Interactive flow: Execute frontend activities that are NOT task-board types (those go to task board)
             let finalNextTask = response.pendingTask || null;
             let finalOutput = startNormalizedState.output;
-            // If backend returned a task that's executable here (ui-activity with frontend/both), execute it
-            if (response.pendingTask &&
-                response.pendingTask.taskType === 'ui-activity' &&
-                (response.pendingTask.executionMode === 'frontend' || response.pendingTask.executionMode === 'both')) {
-                const interactiveResult = await this.executeInteractiveFlow(response.instanceId, response.pendingTask, startNormalizedState, response.activityOutputs || response.state.activityOutputs);
+            const pendingTask = response.pendingTask;
+            if (pendingTask &&
+                (pendingTask.executionMode === 'frontend' || pendingTask.executionMode === 'both') &&
+                !axpIsWorkflowTaskBoardActivityType(pendingTask.activityType)) {
+                const interactiveResult = await this.executeInteractiveFlow(response.instanceId, pendingTask, startNormalizedState, response.activityOutputs || response.state.activityOutputs);
                 finalNextTask = interactiveResult.nextTask;
                 startNormalizedState = interactiveResult.state;
                 if (interactiveResult.output !== undefined) {
@@ -1342,15 +1529,14 @@ class AXPWorkflowManager {
             if (normalizedState) {
                 this.stateCache.set(instanceId, normalizedState);
             }
-            // 🎯 Interactive flow: Execute frontend activities automatically
-            // Backend decides what to execute - if nextTask is executable (ui-activity with frontend/both), execute it
+            // 🎯 Interactive flow: Execute frontend activities that are NOT task-board types (those go to task board)
             let finalNextTask = response.nextTask || null;
             let finalOutput = response.output;
-            // If backend returned a task that's executable here (ui-activity with frontend/both), execute it
-            if (response.nextTask &&
-                response.nextTask.taskType === 'ui-activity' &&
-                (response.nextTask.executionMode === 'frontend' || response.nextTask.executionMode === 'both')) {
-                const interactiveResult = await this.executeInteractiveFlow(instanceId, response.nextTask, normalizedState, normalizedState?.activityOutputs);
+            const nextTask = response.nextTask;
+            if (nextTask &&
+                (nextTask.executionMode === 'frontend' || nextTask.executionMode === 'both') &&
+                !axpIsWorkflowTaskBoardActivityType(nextTask.activityType)) {
+                const interactiveResult = await this.executeInteractiveFlow(instanceId, nextTask, normalizedState, normalizedState?.activityOutputs);
                 finalNextTask = interactiveResult.nextTask;
                 normalizedState = interactiveResult.state;
                 if (interactiveResult.output !== undefined) {
@@ -1370,11 +1556,12 @@ class AXPWorkflowManager {
             };
         }
         catch (error) {
-            console.error('[AXPWorkflowManager] ❌ Error resuming workflow:', error);
+            const { message, code } = getWorkflowEngineErrorInfo(error);
             return {
                 success: false,
                 instanceId,
-                error: error.message || 'Failed to resume workflow',
+                error: message,
+                errorCode: code,
             };
         }
     }
@@ -1420,10 +1607,74 @@ class AXPWorkflowManager {
             return null;
         }
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.19", ngImport: i0, type: AXPWorkflowManager, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
-    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.3.19", ngImport: i0, type: AXPWorkflowManager, providedIn: 'root' }); }
+    /**
+     * Claim a pooled workflow task (assign current user on the bookmark without advancing the workflow).
+     * Supported only when the injected workflow engine implements {@link AXPWorkflowEngine.claimTask}.
+     */
+    async claimTask(instanceId, bookmarkId, stepId) {
+        const claim = this.workflowEngine.claimTask?.bind(this.workflowEngine);
+        if (!claim) {
+            return {
+                success: false,
+                instanceId,
+                error: 'Claim task is not supported by this workflow engine',
+            };
+        }
+        try {
+            const result = await claim({ instanceId, bookmarkId, stepId });
+            return {
+                success: result.success,
+                instanceId,
+                error: result.error,
+                errorCode: result.errorCode,
+            };
+        }
+        catch (error) {
+            const { message, code } = getWorkflowEngineErrorInfo(error);
+            return {
+                success: false,
+                instanceId,
+                error: message,
+                errorCode: code,
+            };
+        }
+    }
+    /**
+     * Reassign a human-task bookmark to the current user without advancing the workflow.
+     * Supported only when the injected workflow engine implements {@link AXPWorkflowEngine.reassignTaskToSelf}.
+     */
+    async reassignTaskToSelf(instanceId, bookmarkId, stepId) {
+        const reassign = this.workflowEngine.reassignTaskToSelf?.bind(this.workflowEngine);
+        if (!reassign) {
+            return {
+                success: false,
+                instanceId,
+                error: 'Reassign task is not supported by this workflow engine',
+            };
+        }
+        try {
+            const result = await reassign({ instanceId, bookmarkId, stepId });
+            return {
+                success: result.success,
+                instanceId,
+                error: result.error,
+                errorCode: result.errorCode,
+            };
+        }
+        catch (error) {
+            const { message, code } = getWorkflowEngineErrorInfo(error);
+            return {
+                success: false,
+                instanceId,
+                error: message,
+                errorCode: code,
+            };
+        }
+    }
+    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: "20.3.19", ngImport: i0, type: AXPWorkflowManager, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPWorkflowManager, decorators: [{
             type: Injectable,
             args: [{
                     providedIn: 'root',
@@ -1458,6 +1709,7 @@ class AXPWorkflowLocalEngine {
         //#region ----   Services & Dependencies   ----
         this.activityDefinitionService = inject(AXPActivityDefinitionService);
         this.workflowProviders = inject(AXP_WORKFLOW_PROVIDER, { optional: true }) || [];
+        this.multiLanguageResolver = inject(AXTranslationService);
         //#endregion
         //#region ----   Instance Storage   ----
         /**
@@ -1559,9 +1811,10 @@ class AXPWorkflowLocalEngine {
             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: request.outcome,
+            outcome,
         });
         localState.completedActivities.add(request.stepId);
         // Store activity output for expression evaluation
@@ -1577,6 +1830,11 @@ class AXPWorkflowLocalEngine {
                 ...(request.userInput || {}),
             };
         }
+        localState.state.variables = {
+            ...localState.state.variables,
+            [`${request.stepId}_outcome`]: outcome,
+            [`${request.stepId}_activityOutput`]: request.userInput || {},
+        };
         // Mark activity as completed and continue progression
         // Continue progressing workflow steps (skipping backend activities)
         const nextTask = await this.executeWorkflowSteps(localState);
@@ -1589,7 +1847,7 @@ class AXPWorkflowLocalEngine {
         }
         return {
             output: request.userInput || {},
-            outcomes: { [request.outcome]: true },
+            outcomes: { [outcome]: true },
             state: localState.state,
             nextTask: nextTask || null,
         };
@@ -1650,13 +1908,13 @@ class AXPWorkflowLocalEngine {
         const connections = graph.connections || [];
         // Build activity map
         const activityMap = new Map();
-        activities.forEach(activity => {
+        activities.forEach((activity) => {
             activityMap.set(activity.id, activity);
         });
         // Build connection graph
         const outgoingConnections = new Map();
         const incomingConnections = new Map();
-        connections.forEach(conn => {
+        connections.forEach((conn) => {
             const sourceId = conn.source.activtyName;
             const targetId = conn.target.activtyName;
             if (!outgoingConnections.has(sourceId)) {
@@ -1713,7 +1971,7 @@ class AXPWorkflowLocalEngine {
                 found: !!activityDefinition,
             });
             const executionMode = activityDefinition?.executionMode || 'frontend';
-            const activityTitle = activityDefinition?.title;
+            const activityTitle = this.multiLanguageResolver.resolve(activityDefinition?.title) || activityDefinition?.name;
             // Handle backend activities: skip
             if (executionMode === 'backend') {
                 console.log(`[WorkflowLocalEngine] ⏭️ Skipping backend activity: ${activity.name} (${activity.id})`);
@@ -1792,9 +2050,10 @@ class AXPWorkflowLocalEngine {
             throw new Error(`Workflow instance not found: ${request.instanceId}`);
         }
         // Store activity result
+        const outcome = request.outcome ?? 'Done';
         localState.activityResults.set(request.activityNode, {
             output: request.output || {},
-            outcome: request.outcome,
+            outcome,
         });
         localState.completedActivities.add(request.activityNode);
         // Store outputs for expression evaluation
@@ -1819,15 +2078,15 @@ class AXPWorkflowLocalEngine {
         }
         return {
             output: request.output || {},
-            outcomes: { [request.outcome]: true },
+            outcomes: { [outcome]: true },
             nextTask: nextTask || null,
             state: localState.state,
         };
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.19", ngImport: i0, type: AXPWorkflowLocalEngine, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
-    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.3.19", ngImport: i0, type: AXPWorkflowLocalEngine }); }
+    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: "20.3.19", ngImport: i0, type: AXPWorkflowLocalEngine, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPWorkflowLocalEngine, decorators: [{
             type: Injectable
         }] });
 
@@ -2248,10 +2507,10 @@ class AXPWorkflowDefinitionService {
         this.pendingWorkflowsRequests.clear();
         this.pendingWorkflowRequests.clear();
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.19", ngImport: i0, type: AXPWorkflowDefinitionService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
-    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.3.19", ngImport: i0, type: AXPWorkflowDefinitionService, providedIn: 'root' }); }
+    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: "20.3.19", ngImport: i0, type: AXPWorkflowDefinitionService, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPWorkflowDefinitionService, decorators: [{
             type: Injectable,
             args: [{
                     providedIn: 'root',
@@ -2343,9 +2602,9 @@ class AXPWorkflowModule {
             f();
         });
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.19", 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.19", ngImport: i0, type: AXPWorkflowModule }); }
-    static { this.ɵinj = i0.ɵɵngDeclareInjector({ minVersion: "12.0.0", version: "20.3.19", ngImport: i0, type: AXPWorkflowModule, providers: [
+    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,
@@ -2354,7 +2613,7 @@ class AXPWorkflowModule {
             AXPWorkflowManager,
         ] }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.19", ngImport: i0, type: AXPWorkflowModule, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPWorkflowModule, decorators: [{
             type: NgModule,
             args: [{
                     imports: [],
@@ -2380,5 +2639,5 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.19", ngImpo
  * Generated bundle index. Do not edit.
  */
 
-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 };
+export { AXPActivityDefinitionService, AXPWorkflowAction, AXPWorkflowContext, AXPWorkflowDefinitionService, AXPWorkflowEngineError, AXPWorkflowError, AXPWorkflowEventService, AXPWorkflowFunction, AXPWorkflowLocalEngine, AXPWorkflowManager, AXPWorkflowModule, AXPWorkflowRegistryService, AXPWorkflowService, AXP_ACTIVITY_CATEGORY_PROVIDER, AXP_ACTIVITY_PROVIDER, AXP_WORKFLOW_CATEGORY_PROVIDER, AXP_WORKFLOW_ENGINE, AXP_WORKFLOW_ERROR_CODES, AXP_WORKFLOW_PROVIDER, AXP_WORKFLOW_TASK_BOARD_ACTIVITY_TYPES, ActivityExecutor, WorkflowExpressionScopeService, axpIsWorkflowTaskBoardActivityType, createWorkFlowEvent, getWorkflowEngineErrorCode, getWorkflowEngineErrorInfo, ofType };
 //# sourceMappingURL=acorex-platform-workflow.mjs.map