@mat3ra/wode 2026.5.29-0 → 2026.6.16-0

package/dist/js/Subworkflow.d.ts

@@ -44,9 +44,9 @@ declare class Subworkflow extends InMemoryEntity implements SubworkflowSchema {
     static get defaultConfig(): {
         _id: any;
         name: string;
-        application: import("@mat3ra/esse/dist/js/types").ApplicationSchema | undefined;
+        application: import("@mat3ra/esse/dist/js/types").ApplicationSchema;
         model: {
-            functional: string;
+            functional: "pbe";
             method: {
                 readonly type: "pseudopotential";
                 readonly subtype: "us";
@@ -461,7 +461,7 @@ declare class Subworkflow extends InMemoryEntity implements SubworkflowSchema {
                 contextProviderName: "vasp-neb";
             };
             extraData: {
-                materialHash: string;
+                materialHash?: string;
             };
             isEdited: boolean;
         } | {
@@ -483,7 +483,7 @@ declare class Subworkflow extends InMemoryEntity implements SubworkflowSchema {
                 preferGridMetric?: boolean;
             };
             extraData: {
-                materialHash: string;
+                materialHash?: string;
             };
             isEdited: boolean;
         } | {
@@ -496,7 +496,7 @@ declare class Subworkflow extends InMemoryEntity implements SubworkflowSchema {
                 steps: number;
             }[]];
             extraData: {
-                materialHash: string;
+                materialHash?: string;
             };
             isEdited: boolean;
         } | {
@@ -522,7 +522,7 @@ declare class Subworkflow extends InMemoryEntity implements SubworkflowSchema {
                 hubbardUValue?: number;
             }[];
             extraData: {
-                materialHash: string;
+                materialHash?: string;
             };
             isEdited: boolean;
         } | {
@@ -575,7 +575,7 @@ declare class Subworkflow extends InMemoryEntity implements SubworkflowSchema {
                 targetFermiEnergy?: number;
             };
             extraData: {
-                materialHash: string;
+                materialHash?: string;
             };
             isEdited: boolean;
         } | {
@@ -615,7 +615,7 @@ declare class Subworkflow extends InMemoryEntity implements SubworkflowSchema {
                 totalMagnetization: number;
             };
             extraData: {
-                materialHash: string;
+                materialHash?: string;
             };
             isEdited: boolean;
         } | {
@@ -650,7 +650,7 @@ declare class Subworkflow extends InMemoryEntity implements SubworkflowSchema {
                 };
             };
             extraData: {
-                materialHash: string;
+                materialHash?: string;
             };
             isEdited: boolean;
         })[];
@@ -697,6 +697,43 @@ declare class Subworkflow extends InMemoryEntity implements SubworkflowSchema {
         }[];
         operand: string;
         value: string | boolean | number;
+    } | {
+        _id?: string;
+        slug?: string;
+        systemName?: string;
+        schemaVersion?: string;
+        name: string;
+        isDefault?: boolean;
+        preProcessors: {
+            name: string;
+            [k: string]: unknown;
+        }[];
+        postProcessors: {
+            name: string;
+            [k: string]: unknown;
+        }[];
+        monitors: {
+            name: string;
+            [k: string]: unknown;
+        }[];
+        results: {
+            name: string;
+            [k: string]: unknown;
+        }[];
+        tags?: string[];
+        status?: "idle" | "active" | "warning" | "error" | "finished";
+        statusTrack?: {
+            trackedAt: number;
+            status: string;
+            repetition?: number;
+        }[];
+        isDraft?: boolean;
+        type: "error";
+        head?: boolean;
+        flowchartId: string;
+        next?: string;
+        enableRender?: boolean;
+        reason: string;
     } | undefined;
     findUnitKeyById(id: string): string;
     private findUnitWithTag;

package/dist/js/Subworkflow.js

@@ -35,11 +35,14 @@ class Subworkflow extends entity_1.InMemoryEntity {
     }
     static get defaultConfig() {
         const defaultName = "New Subworkflow";
+        const application = new standata_1.ApplicationRegistry().getDefaultApplication();
+        if (!application) {
+            throw new Error("No default application found");
+        }
         return {
             _id: utils_1.Utils.uuid.getUUID(),
             name: defaultName,
-            application: new standata_1.ApplicationRegistry().getDefaultApplication(),
-            // TODO: confirm if `functional` is required field. If not, update ESSE schema
+            application,
             // `Model.defaultConfig` from @mat3ra/mode may omit `functional`; ESSE subworkflow schema requires it once schemas are registered.
             model: { ...mode_1.Model.defaultConfig, functional: "pbe" },
             properties: [],

package/dist/js/Workflow.d.ts

@@ -4,7 +4,7 @@ import { type HasDescription } from "@mat3ra/code/dist/js/entity/mixins/HasDescr
 import { type HashedEntity } from "@mat3ra/code/dist/js/entity/mixins/HashedEntityMixin";
 import { Taggable } from "@mat3ra/code/dist/js/entity/mixins/TaggableMixin";
 import type { AnyObject } from "@mat3ra/esse/dist/js/esse/types";
-import type { ApplicationSchema, WorkflowSchema } from "@mat3ra/esse/dist/js/types";
+import type { ApplicationSchema } from "@mat3ra/esse/dist/js/types";
 import { ComputedEntityMixin } from "@mat3ra/ide/dist/js/compute";
 import type { Material } from "@mat3ra/made";
 import type { MetaPropertyHolder } from "@mat3ra/prode";
@@ -17,6 +17,7 @@ import { type WorkflowSchemaMixin } from "./generated/WorkflowSchemaMixin";
 import Subworkflow from "./Subworkflow";
 import { MapUnit } from "./units";
 import { type AnyWorkflowUnit } from "./units/factory";
+import type { WorkflowSchema } from "./workflows/types";
 interface Workflow extends Defaultable, NamedInMemoryEntity, WorkflowSchemaMixin, Taggable, HashedEntity, ComputedEntityMixin, HasDescription {
     compute: WorkflowSchema["compute"];
 }

package/dist/js/context/mixins/MaterialContextMixin.d.ts

@@ -7,7 +7,7 @@ export type MaterialContextMixin = {
     readonly isMaterialUpdated: boolean;
     material: OrderedMaterial;
     extraData?: {
-        materialHash: string;
+        materialHash?: string;
     };
     initMaterialContextMixin(externalContext: MaterialExternalContext): void;
     updateMaterialHash(): void;

package/dist/js/enums.d.ts

@@ -9,6 +9,7 @@ export declare const UNIT_TYPES: {
     readonly subworkflow: "subworkflow";
     readonly io: "io";
     readonly assertion: "assertion";
+    readonly error: "error";
 };
 export declare enum UnitType {
     convergence = "convergence",
@@ -20,7 +21,8 @@ export declare enum UnitType {
     condition = "condition",
     subworkflow = "subworkflow",
     io = "io",
-    assertion = "assertion"
+    assertion = "assertion",
+    error = "error"
 }
 export declare enum UnitTag {
     hasConvergenceParam = "hasConvergenceParam",

package/dist/js/enums.js

@@ -14,6 +14,7 @@ exports.UNIT_TYPES = {
     subworkflow: "subworkflow",
     io: "io",
     assertion: "assertion",
+    error: "error",
 };
 var UnitType;
 (function (UnitType) {
@@ -27,6 +28,7 @@ var UnitType;
     UnitType["subworkflow"] = "subworkflow";
     UnitType["io"] = "io";
     UnitType["assertion"] = "assertion";
+    UnitType["error"] = "error";
 })(UnitType || (exports.UnitType = UnitType = {}));
 var UnitTag;
 (function (UnitTag) {

package/dist/js/generated/ErrorUnitSchemaMixin.d.ts

@@ -0,0 +1,5 @@
+import type { InMemoryEntity } from "@mat3ra/code/dist/js/entity";
+import type { ErrorUnitMixinSchema } from "@mat3ra/esse/dist/js/types";
+export type ErrorUnitSchemaMixin = ErrorUnitMixinSchema;
+export type ErrorUnitInMemoryEntity = InMemoryEntity & ErrorUnitSchemaMixin;
+export declare function errorUnitSchemaMixin<T extends InMemoryEntity>(item: InMemoryEntity): asserts item is T & ErrorUnitSchemaMixin;

package/dist/js/generated/ErrorUnitSchemaMixin.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.errorUnitSchemaMixin = errorUnitSchemaMixin;
+function errorUnitSchemaMixin(item) {
+    // @ts-expect-error
+    const properties = {
+        get type() {
+            return this.prop("type");
+        },
+        set type(value) {
+            this.setProp("type", value);
+        },
+        get reason() {
+            return this.requiredProp("reason");
+        },
+        set reason(value) {
+            this.setProp("reason", value);
+        },
+    };
+    Object.defineProperties(item, Object.getOwnPropertyDescriptors(properties));
+}

package/dist/js/index.d.ts

@@ -2,7 +2,7 @@ import PointsPathFormDataProvider from "./context/providers/PointsPath/PointsPat
 import { globalSettings } from "./context/providers/settings";
 import { TAB_NAVIGATION_CONFIG, UNIT_NAME_INVALID_CHARS, WORKFLOW_STATUSES } from "./enums";
 import Subworkflow from "./Subworkflow";
-import { AssertionUnit, AssignmentUnit, BaseUnit, ConditionUnit, ExecutionUnit, IOUnit, MapUnit, ReduceUnit, SubworkflowUnit } from "./units";
+import { AssertionUnit, AssignmentUnit, BaseUnit, ConditionUnit, ErrorUnit, ExecutionUnit, IOUnit, MapUnit, ReduceUnit, SubworkflowUnit } from "./units";
 import { UnitFactory } from "./units/factory";
 import { defaultMapConfig } from "./units/MapUnit";
 import * as utils from "./utils";
@@ -10,4 +10,5 @@ import Workflow from "./Workflow";
 export type { OrderedMaterial } from "./context/mixins/MaterialContextMixin";
 export type { MaterialsSet } from "./context/mixins/MaterialsSetContextMixin";
 export type { AnySubworkflowUnit, DefaultSubworkflowUnitType } from "./units/factory";
-export { Subworkflow, Workflow, UnitFactory, TAB_NAVIGATION_CONFIG, UNIT_NAME_INVALID_CHARS, WORKFLOW_STATUSES, BaseUnit, ExecutionUnit, AssertionUnit, AssignmentUnit, ConditionUnit, IOUnit, MapUnit, ReduceUnit, SubworkflowUnit, defaultMapConfig, PointsPathFormDataProvider, globalSettings, utils, };
+export { repairWorkflow } from "./utils/repair";
+export { Subworkflow, Workflow, UnitFactory, TAB_NAVIGATION_CONFIG, UNIT_NAME_INVALID_CHARS, WORKFLOW_STATUSES, BaseUnit, ExecutionUnit, AssertionUnit, AssignmentUnit, ConditionUnit, ErrorUnit, IOUnit, MapUnit, ReduceUnit, SubworkflowUnit, defaultMapConfig, PointsPathFormDataProvider, globalSettings, utils, };

package/dist/js/index.js

@@ -36,7 +36,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.utils = exports.globalSettings = exports.PointsPathFormDataProvider = exports.defaultMapConfig = exports.SubworkflowUnit = exports.ReduceUnit = exports.MapUnit = exports.IOUnit = exports.ConditionUnit = exports.AssignmentUnit = exports.AssertionUnit = exports.ExecutionUnit = exports.BaseUnit = exports.WORKFLOW_STATUSES = exports.UNIT_NAME_INVALID_CHARS = exports.TAB_NAVIGATION_CONFIG = exports.UnitFactory = exports.Workflow = exports.Subworkflow = void 0;
+exports.utils = exports.globalSettings = exports.PointsPathFormDataProvider = exports.defaultMapConfig = exports.SubworkflowUnit = exports.ReduceUnit = exports.MapUnit = exports.IOUnit = exports.ErrorUnit = exports.ConditionUnit = exports.AssignmentUnit = exports.AssertionUnit = exports.ExecutionUnit = exports.BaseUnit = exports.WORKFLOW_STATUSES = exports.UNIT_NAME_INVALID_CHARS = exports.TAB_NAVIGATION_CONFIG = exports.UnitFactory = exports.Workflow = exports.Subworkflow = exports.repairWorkflow = void 0;
 const PointsPathFormDataProvider_1 = __importDefault(require("./context/providers/PointsPath/PointsPathFormDataProvider"));
 exports.PointsPathFormDataProvider = PointsPathFormDataProvider_1.default;
 const settings_1 = require("./context/providers/settings");
@@ -52,6 +52,7 @@ Object.defineProperty(exports, "AssertionUnit", { enumerable: true, get: functio
 Object.defineProperty(exports, "AssignmentUnit", { enumerable: true, get: function () { return units_1.AssignmentUnit; } });
 Object.defineProperty(exports, "BaseUnit", { enumerable: true, get: function () { return units_1.BaseUnit; } });
 Object.defineProperty(exports, "ConditionUnit", { enumerable: true, get: function () { return units_1.ConditionUnit; } });
+Object.defineProperty(exports, "ErrorUnit", { enumerable: true, get: function () { return units_1.ErrorUnit; } });
 Object.defineProperty(exports, "ExecutionUnit", { enumerable: true, get: function () { return units_1.ExecutionUnit; } });
 Object.defineProperty(exports, "IOUnit", { enumerable: true, get: function () { return units_1.IOUnit; } });
 Object.defineProperty(exports, "MapUnit", { enumerable: true, get: function () { return units_1.MapUnit; } });
@@ -65,3 +66,5 @@ const utils = __importStar(require("./utils"));
 exports.utils = utils;
 const Workflow_1 = __importDefault(require("./Workflow"));
 exports.Workflow = Workflow_1.default;
+var repair_1 = require("./utils/repair");
+Object.defineProperty(exports, "repairWorkflow", { enumerable: true, get: function () { return repair_1.repairWorkflow; } });

package/dist/js/repair/createErrorUnitData.d.ts

@@ -0,0 +1,3 @@
+import type { ErrorUnitSchema } from "@mat3ra/esse/dist/js/types";
+import type { AnySubworkflowUnitSchema } from "../units/factory";
+export declare function createErrorUnitData(unitData: AnySubworkflowUnitSchema | Record<string, unknown>, reason: string): ErrorUnitSchema;

package/dist/js/repair/createErrorUnitData.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createErrorUnitData = createErrorUnitData;
+const utils_1 = require("@mat3ra/utils");
+const enums_1 = require("../enums");
+function createErrorUnitData(unitData, reason) {
+    const original = structuredClone(unitData);
+    return {
+        results: [],
+        preProcessors: [],
+        postProcessors: [],
+        monitors: [],
+        name: typeof original.name === "string" ? original.name : enums_1.UnitType.error,
+        type: enums_1.UnitType.error,
+        status: enums_1.UnitStatus.error,
+        flowchartId: typeof original.flowchartId === "string" ? original.flowchartId : utils_1.Utils.uuid.getUUID(),
+        originalUnit: original,
+        reason,
+        ...(typeof original._id === "string" ? { _id: original._id } : {}),
+        ...(typeof original.next === "string" ? { next: original.next } : {}),
+        ...(original.head === true ? { head: true } : {}),
+        ...(Array.isArray(original.statusTrack) ? { statusTrack: original.statusTrack } : {}),
+        ...(Array.isArray(original.tags) ? { tags: original.tags } : {}),
+    };
+}

package/dist/js/repair/formatRepairReason.d.ts

@@ -0,0 +1 @@
+export declare function formatRepairReason(error: unknown): string;

package/dist/js/repair/formatRepairReason.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatRepairReason = formatRepairReason;
+function formatRepairReason(error) {
+    var _a;
+    if (error && typeof error === "object") {
+        const entityError = error;
+        if (((_a = entityError.details) === null || _a === void 0 ? void 0 : _a.error) !== undefined) {
+            return JSON.stringify(entityError.details.error);
+        }
+        if (typeof entityError.message === "string" && entityError.message.length > 0) {
+            return entityError.message;
+        }
+        if (typeof entityError.code === "string" && entityError.code.length > 0) {
+            return entityError.code;
+        }
+    }
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return String(error);
+}

package/dist/js/repair/types.d.ts

@@ -0,0 +1,16 @@
+import type { SubworkflowSchema, WorkflowSchema } from "@mat3ra/esse/dist/js/types";
+export type SubworkflowUnitRepairRecord = {
+    subworkflowId: string;
+    flowchartId: string;
+    reason: string;
+};
+export type SubworkflowRepairResult = {
+    document: SubworkflowSchema;
+    changed: boolean;
+    repairs: SubworkflowUnitRepairRecord[];
+};
+export type WorkflowRepairResult = {
+    document: WorkflowSchema;
+    changed: boolean;
+    repairs: SubworkflowUnitRepairRecord[];
+};

package/dist/js/repair/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/js/units/ErrorUnit.d.ts

@@ -0,0 +1,16 @@
+import type { Constructor } from "@mat3ra/code/dist/js/utils/types";
+import type { AnyObject } from "@mat3ra/esse/dist/js/esse/types";
+import type { ErrorUnitSchema } from "@mat3ra/esse/dist/js/types";
+import { type ErrorUnitSchemaMixin } from "../generated/ErrorUnitSchemaMixin";
+import BaseUnit from "./BaseUnit";
+type Schema = ErrorUnitSchema;
+type Base = typeof BaseUnit<Schema> & Constructor<ErrorUnitSchemaMixin>;
+export type ErrorUnitConfig = Partial<Schema>;
+declare const ErrorUnit_base: Base;
+declare class ErrorUnit extends ErrorUnit_base implements Schema {
+    toJSON: () => Schema & AnyObject;
+    _json: Schema & AnyObject;
+    static get jsonSchema(): import("json-schema").JSONSchema7 | undefined;
+    constructor(config: ErrorUnitConfig);
+}
+export default ErrorUnit;

package/dist/js/units/ErrorUnit.js

@@ -0,0 +1,31 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const JSONSchemasInterface_1 = __importDefault(require("@mat3ra/esse/dist/js/esse/JSONSchemasInterface"));
+const enums_1 = require("../enums");
+const ErrorUnitSchemaMixin_1 = require("../generated/ErrorUnitSchemaMixin");
+const BaseUnit_1 = __importDefault(require("./BaseUnit"));
+class ErrorUnit extends BaseUnit_1.default {
+    static get jsonSchema() {
+        return JSONSchemasInterface_1.default.getSchemaById("workflow/unit/error");
+    }
+    constructor(config) {
+        var _a;
+        const schema = {
+            name: enums_1.UnitType.error,
+            results: [],
+            preProcessors: [],
+            postProcessors: [],
+            monitors: [],
+            reason: "",
+            ...config,
+            type: enums_1.UnitType.error,
+            status: (_a = config.status) !== null && _a !== void 0 ? _a : enums_1.UnitStatus.error,
+        };
+        super(schema);
+    }
+}
+(0, ErrorUnitSchemaMixin_1.errorUnitSchemaMixin)(ErrorUnit.prototype);
+exports.default = ErrorUnit;

package/dist/js/units/factory.d.ts

@@ -1,21 +1,23 @@
-import type { AssertionUnitSchema, AssignmentUnitSchema, ConditionUnitSchema, DataIOUnitSchema, ExecutionUnitSchema, MapUnitSchema, ReduceUnitSchema, SubworkflowUnitSchema, WorkflowUnitSchema } from "@mat3ra/esse/dist/js/types";
+import type { ApplicationSchema, AssertionUnitSchema, AssignmentUnitSchema, ConditionUnitSchema, DataIOUnitSchema, ErrorUnitSchema, ExecutionUnitSchema, MapUnitSchema, ReduceUnitSchema, SubworkflowUnitSchema, WorkflowUnitSchema } from "@mat3ra/esse/dist/js/types";
 import AssertionUnit, { type AssertionUnitConfig } from "./AssertionUnit";
 import AssignmentUnit, { type AssignmentUnitConfig } from "./AssignmentUnit";
 import ConditionUnit, { type ConditionUnitConfig } from "./ConditionUnit";
+import ErrorUnit, { type ErrorUnitConfig } from "./ErrorUnit";
 import ExecutionUnit, { type ExecutionUnitConfig } from "./ExecutionUnit";
 import IOUnit, { type IOUnitConfig } from "./IOUnit";
 import MapUnit from "./MapUnit";
 import ReduceUnit from "./ReduceUnit";
 import SubworkflowUnit from "./SubworkflowUnit";
-export type AnyWorkflowUnit = MapUnit | SubworkflowUnit | ReduceUnit;
-export type AnyWorkflowUnitSchema = MapUnitSchema | SubworkflowUnitSchema | ReduceUnitSchema;
-export type AnySubworkflowUnit = ExecutionUnit | AssignmentUnit | ConditionUnit | IOUnit | AssertionUnit;
-export type AnySubworkflowUnitSchema = ExecutionUnitSchema | AssertionUnitSchema | AssignmentUnitSchema | ConditionUnitSchema | DataIOUnitSchema;
+export type AnyWorkflowUnit = MapUnit | SubworkflowUnit | ReduceUnit | ErrorUnit;
+export type AnyWorkflowUnitSchema = MapUnitSchema | SubworkflowUnitSchema | ReduceUnitSchema | ErrorUnitSchema;
+export type AnySubworkflowUnit = ExecutionUnit | AssignmentUnit | ConditionUnit | IOUnit | AssertionUnit | ErrorUnit;
+export type AnySubworkflowUnitSchema = ExecutionUnitSchema | AssertionUnitSchema | AssignmentUnitSchema | ConditionUnitSchema | DataIOUnitSchema | ErrorUnitSchema;
 type ExcutionConfig = ExecutionUnitConfig & Pick<ExecutionUnitSchema, "type">;
 type AssignmentConfig = AssignmentUnitConfig & Pick<AssignmentUnitSchema, "type">;
 type ConditionConfig = ConditionUnitConfig & Pick<ConditionUnitSchema, "type">;
 type IOConfig = IOUnitConfig & Pick<DataIOUnitSchema, "type">;
 type AssertionConfig = AssertionUnitConfig & Pick<AssertionUnitSchema, "type">;
+type ErrorConfig = ErrorUnitConfig & Pick<ErrorUnitSchema, "type">;
 /** Subworkflow unit kinds supported by {@link UnitFactory.createDefaultSubworkflowUnit}. */
 export type DefaultSubworkflowUnitType = "execution" | "assignment" | "condition" | "io" | "assertion";
 export declare class UnitFactory {
@@ -23,9 +25,12 @@ export declare class UnitFactory {
      * Create a new subworkflow unit with fresh `flowchartId` and constructor defaults.
      * For execution units, pass the subworkflow (or parent) `application` JSON.
      */
-    static createDefaultSubworkflowUnit(type: "execution", application: ExecutionUnitSchema["application"]): AnySubworkflowUnit;
-    static createDefaultSubworkflowUnit(type: "assignment" | "condition" | "io" | "assertion"): AnySubworkflowUnit;
+    static createDefaultSubworkflowUnit(type: "execution", application: ApplicationSchema): ExecutionUnit;
+    static createDefaultSubworkflowUnit(type: "assignment"): AssignmentUnit;
+    static createDefaultSubworkflowUnit(type: "condition"): ConditionUnit;
+    static createDefaultSubworkflowUnit(type: "io"): IOUnit;
+    static createDefaultSubworkflowUnit(type: "assertion"): AssertionUnit;
     static createInWorkflow(config: WorkflowUnitSchema): AnyWorkflowUnit;
-    static createInSubworkflow(config: ExcutionConfig | AssignmentConfig | ConditionConfig | IOConfig | AssertionConfig): AnySubworkflowUnit;
+    static createInSubworkflow(config: ExcutionConfig | AssignmentConfig | ConditionConfig | IOConfig | AssertionConfig | ErrorConfig): AnySubworkflowUnit;
 }
 export {};

package/dist/js/units/factory.js

@@ -8,6 +8,7 @@ const enums_1 = require("../enums");
 const AssertionUnit_1 = __importDefault(require("./AssertionUnit"));
 const AssignmentUnit_1 = __importDefault(require("./AssignmentUnit"));
 const ConditionUnit_1 = __importDefault(require("./ConditionUnit"));
+const ErrorUnit_1 = __importDefault(require("./ErrorUnit"));
 const ExecutionUnit_1 = __importDefault(require("./ExecutionUnit"));
 const IOUnit_1 = __importDefault(require("./IOUnit"));
 const MapUnit_1 = __importDefault(require("./MapUnit"));
@@ -47,6 +48,8 @@ class UnitFactory {
                 return new SubworkflowUnit_1.default(config);
             case enums_1.UnitType.reduce:
                 return new ReduceUnit_1.default(config);
+            case enums_1.UnitType.error:
+                return new ErrorUnit_1.default(config);
             default:
                 throw new Error(`Unknown unit type: ${config.type}`);
         }
@@ -63,6 +66,8 @@ class UnitFactory {
                 return new IOUnit_1.default(config);
             case enums_1.UnitType.assertion:
                 return new AssertionUnit_1.default(config);
+            case enums_1.UnitType.error:
+                return new ErrorUnit_1.default(config);
             default:
                 throw new Error(`Unknown unit type: ${config.type}`);
         }

package/dist/js/units/index.d.ts

@@ -2,6 +2,7 @@ import AssertionUnit from "./AssertionUnit";
 import AssignmentUnit from "./AssignmentUnit";
 import BaseUnit from "./BaseUnit";
 import ConditionUnit from "./ConditionUnit";
+import ErrorUnit from "./ErrorUnit";
 import ExecutionUnit from "./ExecutionUnit";
 import { UnitFactory } from "./factory";
 import IOUnit from "./IOUnit";
@@ -10,5 +11,5 @@ import ReduceUnit from "./ReduceUnit";
 import SubworkflowUnit from "./SubworkflowUnit";
 export type { ReduceUnitConfig } from "./ReduceUnit";
 export type { SubworkflowUnitConfig } from "./SubworkflowUnit";
-export { BaseUnit, AssertionUnit, AssignmentUnit, ConditionUnit, ExecutionUnit, IOUnit, MapUnit, ReduceUnit, SubworkflowUnit, UnitFactory, };
+export { BaseUnit, AssertionUnit, AssignmentUnit, ConditionUnit, ErrorUnit, ExecutionUnit, IOUnit, MapUnit, ReduceUnit, SubworkflowUnit, UnitFactory, };
 export type { DefaultSubworkflowUnitType } from "./factory";

package/dist/js/units/index.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.UnitFactory = exports.SubworkflowUnit = exports.ReduceUnit = exports.MapUnit = exports.IOUnit = exports.ExecutionUnit = exports.ConditionUnit = exports.AssignmentUnit = exports.AssertionUnit = exports.BaseUnit = void 0;
+exports.UnitFactory = exports.SubworkflowUnit = exports.ReduceUnit = exports.MapUnit = exports.IOUnit = exports.ExecutionUnit = exports.ErrorUnit = exports.ConditionUnit = exports.AssignmentUnit = exports.AssertionUnit = exports.BaseUnit = void 0;
 const AssertionUnit_1 = __importDefault(require("./AssertionUnit"));
 exports.AssertionUnit = AssertionUnit_1.default;
 const AssignmentUnit_1 = __importDefault(require("./AssignmentUnit"));
@@ -12,6 +12,8 @@ const BaseUnit_1 = __importDefault(require("./BaseUnit"));
 exports.BaseUnit = BaseUnit_1.default;
 const ConditionUnit_1 = __importDefault(require("./ConditionUnit"));
 exports.ConditionUnit = ConditionUnit_1.default;
+const ErrorUnit_1 = __importDefault(require("./ErrorUnit"));
+exports.ErrorUnit = ErrorUnit_1.default;
 const ExecutionUnit_1 = __importDefault(require("./ExecutionUnit"));
 exports.ExecutionUnit = ExecutionUnit_1.default;
 const factory_1 = require("./factory");

package/dist/js/utils/index.d.ts

@@ -1,3 +1,4 @@
 export * as units from "./units";
 export * as workflow from "./workflow";
 export * as baseUnits from "./baseUnits";
+export * as repair from "./repair";

package/dist/js/utils/index.js

@@ -33,7 +33,8 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.baseUnits = exports.workflow = exports.units = void 0;
+exports.repair = exports.baseUnits = exports.workflow = exports.units = void 0;
 exports.units = __importStar(require("./units"));
 exports.workflow = __importStar(require("./workflow"));
 exports.baseUnits = __importStar(require("./baseUnits"));
+exports.repair = __importStar(require("./repair"));

package/dist/js/utils/repair.d.ts

@@ -0,0 +1,2 @@
+import type { WorkflowSchema } from "../workflows/types";
+export declare function repairWorkflow<T extends WorkflowSchema>(workflowData: T): T;

package/dist/js/utils/repair.js

@@ -0,0 +1,140 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.repairWorkflow = repairWorkflow;
+const in_memory_1 = require("@mat3ra/code/dist/js/entity/in_memory");
+const utils_1 = require("@mat3ra/utils");
+const enums_1 = require("../enums");
+const Subworkflow_1 = __importDefault(require("../Subworkflow"));
+const ConditionUnit_1 = __importDefault(require("../units/ConditionUnit"));
+const ExecutionUnit_1 = __importDefault(require("../units/ExecutionUnit"));
+function toErrorUnitSchema(unitData, error) {
+    var _a, _b, _c, _d;
+    let reasonPayload;
+    if (error instanceof in_memory_1.EntityError && error.details) {
+        reasonPayload = {
+            error: error.details.error,
+            json: unitData,
+        };
+    }
+    else if (error instanceof Error) {
+        reasonPayload = {
+            error: { message: error.message, name: error.name },
+            json: unitData,
+        };
+    }
+    else {
+        reasonPayload = {
+            error,
+            json: unitData,
+        };
+    }
+    return {
+        results: [],
+        preProcessors: [],
+        postProcessors: [],
+        monitors: [],
+        name: (_a = unitData.name) !== null && _a !== void 0 ? _a : enums_1.UnitType.error,
+        type: enums_1.UnitType.error,
+        status: enums_1.UnitStatus.error,
+        flowchartId: (_b = unitData.flowchartId) !== null && _b !== void 0 ? _b : utils_1.Utils.uuid.getUUID(),
+        reason: JSON.stringify(reasonPayload),
+        next: (_c = unitData.next) !== null && _c !== void 0 ? _c : "",
+        head: (_d = unitData.head) !== null && _d !== void 0 ? _d : false,
+    };
+}
+function repairExecutionUnit(unitData) {
+    try {
+        return new ExecutionUnit_1.default(unitData).toJSON();
+    }
+    catch (error) {
+        return toErrorUnitSchema(unitData, error);
+    }
+}
+function repairConditionUnit(unitData) {
+    try {
+        return new ConditionUnit_1.default(unitData).toJSON();
+    }
+    catch (error) {
+        return toErrorUnitSchema(unitData, error);
+    }
+}
+function getSubworkflowValidationError(subworkflow) {
+    // Two checks, same order as the old isValid() path (construct + validate), but split so we
+    // keep AJV errors when hydration would fail first:
+    // 1. validateData — JSON Schema on raw persisted subworkflow (no Application/ModelFactory/units).
+    //    Surfaces structured AJV errors (e.g. missing model) before the constructor runs.
+    // 2. new Subworkflow().validate() — hydration (app, model, units) then schema on the instance.
+    //    Catches schema-valid JSON that still cannot be built (unknown model, bad units, etc.).
+    try {
+        Subworkflow_1.default.validateData({ ...subworkflow });
+        new Subworkflow_1.default(subworkflow).validate();
+        return null;
+    }
+    catch (error) {
+        if (error instanceof in_memory_1.EntityError || error instanceof Error) {
+            return error;
+        }
+        return new Error(String(error));
+    }
+}
+function repairSubworkflow(subworkflowData) {
+    const units = subworkflowData.units.map((unit) => {
+        if (unit.type === enums_1.UnitType.execution) {
+            return repairExecutionUnit(unit);
+        }
+        if (unit.type === enums_1.UnitType.condition) {
+            return repairConditionUnit(unit);
+        }
+        return unit;
+    });
+    return { ...subworkflowData, units };
+}
+function repairWorkflow(workflowData) {
+    const subworkflows = workflowData.subworkflows.map((subworkflow) => {
+        return repairSubworkflow(subworkflow);
+    });
+    const invalidSubworkflows = subworkflows
+        .map((subworkflow) => {
+        const error = getSubworkflowValidationError(subworkflow);
+        return error ? { subworkflow, error } : null;
+    })
+        .filter((entry) => entry !== null);
+    const units = workflowData.units.map((unit) => {
+        const invalidEntry = invalidSubworkflows.find(({ subworkflow }) => subworkflow._id === unit._id);
+        if (invalidEntry) {
+            const { subworkflow, error } = invalidEntry;
+            const errorUnit = toErrorUnitSchema(unit, error);
+            const reasonPayload = {
+                ...JSON.parse(errorUnit.reason),
+                json: { unit, subworkflow },
+            };
+            return {
+                ...errorUnit,
+                _id: unit._id,
+                name: unit.name || errorUnit.name,
+                flowchartId: unit.flowchartId,
+                reason: JSON.stringify(reasonPayload),
+                preProcessors: unit.preProcessors || [],
+                postProcessors: unit.postProcessors || [],
+                monitors: unit.monitors || [],
+                results: unit.results || [],
+            };
+        }
+        return unit;
+    });
+    const validSubworkflows = subworkflows.filter((subworkflow) => {
+        return !invalidSubworkflows.some(({ subworkflow: invalid }) => invalid._id === subworkflow._id);
+    });
+    const workflows = workflowData.workflows.map((nested) => {
+        return repairWorkflow(nested);
+    });
+    return {
+        ...workflowData,
+        subworkflows: validSubworkflows,
+        workflows,
+        units,
+    };
+}

package/dist/js/workflows/default.d.ts

@@ -1,3 +1,3 @@
-import type { WorkflowSchema } from "@mat3ra/esse/dist/js/types";
+import type { WorkflowSchema } from "./types";
 declare const defaultWorkflowConfig: WorkflowSchema;
 export default defaultWorkflowConfig;

package/dist/js/workflows/types.d.ts

@@ -0,0 +1,4 @@
+import type { WorkflowSchema as EsseWorkflowSchema } from "@mat3ra/esse/dist/js/types";
+export type WorkflowSchema = EsseWorkflowSchema & {
+    workflows: WorkflowSchema[];
+};

package/dist/js/workflows/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@mat3ra/wode",
-    "version": "2026.5.29-0",
+    "version": "2026.6.16-0",
     "description": "WOrkflow DEfinitions",
     "scripts": {
         "test": "mocha --recursive --bail --require ts-node/register 'tests/js/**/*.ts'",
@@ -42,7 +42,7 @@
         "@exabyte-io/eslint-config": "2025.5.13-0",
         "@mat3ra/ade": "2026.5.28-0",
         "@mat3ra/code": "2026.5.27-0",
-        "@mat3ra/esse": "2026.5.28-0",
+        "@mat3ra/esse": "2026.6.16-0",
         "@mat3ra/ide": "2026.5.28-0",
         "@mat3ra/made": "2026.5.28-0",
         "@mat3ra/mode": "2026.5.29-1",
@@ -50,6 +50,8 @@
         "@mat3ra/standata": "2026.5.28-0",
         "@mat3ra/tsconfig": "^2024.6.3-0",
         "@mat3ra/utils": "2025.9.20-0",
+        "@typescript-eslint/eslint-plugin": "^5.62.0",
+        "@typescript-eslint/parser": "^5.62.0",
         "@types/nunjucks": "^3.2.6",
         "chai": "^4.3.4",
         "eslint": "^7.32.0",
@@ -76,7 +78,7 @@
     "peerDependencies": {
         "@mat3ra/ade": "*",
         "@mat3ra/code": "*",
-        "@mat3ra/esse": "*",
+        "@mat3ra/esse": "file:../esse/mat3ra-esse-0.0.0.tgz",
         "@mat3ra/ide": "*",
         "@mat3ra/made": "*",
         "@mat3ra/mode": "*",

package/src/js/Subworkflow.ts

@@ -100,13 +100,18 @@ class Subworkflow extends InMemoryEntity implements SubworkflowSchema {
 
     static get defaultConfig() {
         const defaultName = "New Subworkflow";
+        const application = new ApplicationRegistry().getDefaultApplication();
+
+        if (!application) {
+            throw new Error("No default application found");
+        }
+
         return {
             _id: Utils.uuid.getUUID(),
             name: defaultName,
-            application: new ApplicationRegistry().getDefaultApplication(),
-            // TODO: confirm if `functional` is required field. If not, update ESSE schema
+            application,
             // `Model.defaultConfig` from @mat3ra/mode may omit `functional`; ESSE subworkflow schema requires it once schemas are registered.
-            model: { ...Model.defaultConfig, functional: "pbe" },
+            model: { ...Model.defaultConfig, functional: "pbe" as const },
             properties: [],
             units: [],
         };

package/src/js/Workflow.ts

@@ -15,11 +15,7 @@ import { namedEntityMixin } from "@mat3ra/code/dist/js/entity/mixins/NamedEntity
 import { Taggable, taggableMixin } from "@mat3ra/code/dist/js/entity/mixins/TaggableMixin";
 import JSONSchemasInterface from "@mat3ra/esse/dist/js/esse/JSONSchemasInterface";
 import type { AnyObject } from "@mat3ra/esse/dist/js/esse/types";
-import type {
-    ApplicationSchema,
-    SubworkflowSchema,
-    WorkflowSchema,
-} from "@mat3ra/esse/dist/js/types";
+import type { ApplicationSchema, SubworkflowSchema } from "@mat3ra/esse/dist/js/types";
 import { ComputedEntityMixin, computedEntityMixin } from "@mat3ra/ide/dist/js/compute";
 import type { Material } from "@mat3ra/made";
 import type { MetaPropertyHolder } from "@mat3ra/prode";
@@ -45,6 +41,7 @@ import {
     getUsedModels,
 } from "./utils/workflow";
 import defaultWorkflowConfig from "./workflows/default";
+import type { WorkflowSchema } from "./workflows/types";
 
 interface Workflow
     extends Defaultable,

package/src/js/context/mixins/MaterialContextMixin.ts

@@ -9,7 +9,7 @@ export type MaterialContextMixin = {
     readonly isMaterialCreatedDefault: boolean;
     readonly isMaterialUpdated: boolean;
     material: OrderedMaterial;
-    extraData?: { materialHash: string };
+    extraData?: { materialHash?: string };
     initMaterialContextMixin(externalContext: MaterialExternalContext): void;
     updateMaterialHash(): void;
 };

package/src/js/enums.ts

@@ -11,6 +11,7 @@ export const UNIT_TYPES = {
     subworkflow: "subworkflow",
     io: "io",
     assertion: "assertion",
+    error: "error",
 } as const;
 
 export enum UnitType {
@@ -24,6 +25,7 @@ export enum UnitType {
     subworkflow = "subworkflow",
     io = "io",
     assertion = "assertion",
+    error = "error",
 }
 
 export enum UnitTag {

package/src/js/generated/ErrorUnitSchemaMixin.ts

@@ -0,0 +1,28 @@
+import type { InMemoryEntity } from "@mat3ra/code/dist/js/entity";
+import type { ErrorUnitMixinSchema } from "@mat3ra/esse/dist/js/types";
+
+export type ErrorUnitSchemaMixin = ErrorUnitMixinSchema;
+
+export type ErrorUnitInMemoryEntity = InMemoryEntity & ErrorUnitSchemaMixin;
+
+export function errorUnitSchemaMixin<T extends InMemoryEntity>(
+    item: InMemoryEntity,
+): asserts item is T & ErrorUnitSchemaMixin {
+    // @ts-expect-error
+    const properties: InMemoryEntity & ErrorUnitSchemaMixin = {
+        get type() {
+            return this.prop<ErrorUnitMixinSchema["type"]>("type");
+        },
+        set type(value: ErrorUnitMixinSchema["type"]) {
+            this.setProp("type", value);
+        },
+        get reason() {
+            return this.requiredProp<ErrorUnitMixinSchema["reason"]>("reason");
+        },
+        set reason(value: ErrorUnitMixinSchema["reason"]) {
+            this.setProp("reason", value);
+        },
+    };
+
+    Object.defineProperties(item, Object.getOwnPropertyDescriptors(properties));
+}

package/src/js/index.ts

@@ -7,6 +7,7 @@ import {
     AssignmentUnit,
     BaseUnit,
     ConditionUnit,
+    ErrorUnit,
     ExecutionUnit,
     IOUnit,
     MapUnit,
@@ -21,6 +22,7 @@ import Workflow from "./Workflow";
 export type { OrderedMaterial } from "./context/mixins/MaterialContextMixin";
 export type { MaterialsSet } from "./context/mixins/MaterialsSetContextMixin";
 export type { AnySubworkflowUnit, DefaultSubworkflowUnitType } from "./units/factory";
+export { repairWorkflow } from "./utils/repair";
 export {
     Subworkflow,
     Workflow,
@@ -33,6 +35,7 @@ export {
     AssertionUnit,
     AssignmentUnit,
     ConditionUnit,
+    ErrorUnit,
     IOUnit,
     MapUnit,
     ReduceUnit,

package/src/js/units/ErrorUnit.ts

@@ -0,0 +1,42 @@
+import type { Constructor } from "@mat3ra/code/dist/js/utils/types";
+import JSONSchemasInterface from "@mat3ra/esse/dist/js/esse/JSONSchemasInterface";
+import type { AnyObject } from "@mat3ra/esse/dist/js/esse/types";
+import type { ErrorUnitSchema } from "@mat3ra/esse/dist/js/types";
+
+import { UnitStatus, UnitType } from "../enums";
+import { type ErrorUnitSchemaMixin, errorUnitSchemaMixin } from "../generated/ErrorUnitSchemaMixin";
+import BaseUnit from "./BaseUnit";
+
+type Schema = ErrorUnitSchema;
+type Base = typeof BaseUnit<Schema> & Constructor<ErrorUnitSchemaMixin>;
+
+export type ErrorUnitConfig = Partial<Schema>;
+
+class ErrorUnit extends (BaseUnit as Base) implements Schema {
+    declare toJSON: () => Schema & AnyObject;
+
+    declare _json: Schema & AnyObject;
+
+    static get jsonSchema() {
+        return JSONSchemasInterface.getSchemaById("workflow/unit/error");
+    }
+
+    constructor(config: ErrorUnitConfig) {
+        const schema = {
+            name: UnitType.error,
+            results: [],
+            preProcessors: [],
+            postProcessors: [],
+            monitors: [],
+            reason: "",
+            ...config,
+            type: UnitType.error as Schema["type"],
+            status: config.status ?? UnitStatus.error,
+        };
+        super(schema);
+    }
+}
+
+errorUnitSchemaMixin(ErrorUnit.prototype);
+
+export default ErrorUnit;

package/src/js/units/factory.ts

@@ -1,8 +1,10 @@
 import type {
+    ApplicationSchema,
     AssertionUnitSchema,
     AssignmentUnitSchema,
     ConditionUnitSchema,
     DataIOUnitSchema,
+    ErrorUnitSchema,
     ExecutionUnitSchema,
     MapUnitSchema,
     ReduceUnitSchema,
@@ -14,35 +16,43 @@ import { UnitType } from "../enums";
 import AssertionUnit, { type AssertionUnitConfig } from "./AssertionUnit";
 import AssignmentUnit, { type AssignmentUnitConfig } from "./AssignmentUnit";
 import ConditionUnit, { type ConditionUnitConfig } from "./ConditionUnit";
+import ErrorUnit, { type ErrorUnitConfig } from "./ErrorUnit";
 import ExecutionUnit, { type ExecutionUnitConfig } from "./ExecutionUnit";
 import IOUnit, { type IOUnitConfig } from "./IOUnit";
 import MapUnit from "./MapUnit";
 import ReduceUnit from "./ReduceUnit";
 import SubworkflowUnit from "./SubworkflowUnit";
 
-export type AnyWorkflowUnit = MapUnit | SubworkflowUnit | ReduceUnit;
+export type AnyWorkflowUnit = MapUnit | SubworkflowUnit | ReduceUnit | ErrorUnit;
 
-export type AnyWorkflowUnitSchema = MapUnitSchema | SubworkflowUnitSchema | ReduceUnitSchema;
+export type AnyWorkflowUnitSchema =
+    | MapUnitSchema
+    | SubworkflowUnitSchema
+    | ReduceUnitSchema
+    | ErrorUnitSchema;
 
 export type AnySubworkflowUnit =
     | ExecutionUnit
     | AssignmentUnit
     | ConditionUnit
     | IOUnit
-    | AssertionUnit;
+    | AssertionUnit
+    | ErrorUnit;
 
 export type AnySubworkflowUnitSchema =
     | ExecutionUnitSchema
     | AssertionUnitSchema
     | AssignmentUnitSchema
     | ConditionUnitSchema
-    | DataIOUnitSchema;
+    | DataIOUnitSchema
+    | ErrorUnitSchema;
 
 type ExcutionConfig = ExecutionUnitConfig & Pick<ExecutionUnitSchema, "type">;
 type AssignmentConfig = AssignmentUnitConfig & Pick<AssignmentUnitSchema, "type">;
 type ConditionConfig = ConditionUnitConfig & Pick<ConditionUnitSchema, "type">;
 type IOConfig = IOUnitConfig & Pick<DataIOUnitSchema, "type">;
 type AssertionConfig = AssertionUnitConfig & Pick<AssertionUnitSchema, "type">;
+type ErrorConfig = ErrorUnitConfig & Pick<ErrorUnitSchema, "type">;
 
 /** Subworkflow unit kinds supported by {@link UnitFactory.createDefaultSubworkflowUnit}. */
 export type DefaultSubworkflowUnitType =
@@ -59,16 +69,20 @@ export class UnitFactory {
      */
     static createDefaultSubworkflowUnit(
         type: "execution",
-        application: ExecutionUnitSchema["application"],
-    ): AnySubworkflowUnit;
+        application: ApplicationSchema,
+    ): ExecutionUnit;
 
-    static createDefaultSubworkflowUnit(
-        type: "assignment" | "condition" | "io" | "assertion",
-    ): AnySubworkflowUnit;
+    static createDefaultSubworkflowUnit(type: "assignment"): AssignmentUnit;
+
+    static createDefaultSubworkflowUnit(type: "condition"): ConditionUnit;
+
+    static createDefaultSubworkflowUnit(type: "io"): IOUnit;
+
+    static createDefaultSubworkflowUnit(type: "assertion"): AssertionUnit;
 
     static createDefaultSubworkflowUnit(
         type: DefaultSubworkflowUnitType,
-        application?: ExecutionUnitSchema["application"],
+        application?: ApplicationSchema,
     ): AnySubworkflowUnit {
         if (type === "execution") {
             if (application === undefined) {
@@ -105,13 +119,21 @@ export class UnitFactory {
                 return new SubworkflowUnit(config);
             case UnitType.reduce:
                 return new ReduceUnit(config);
+            case UnitType.error:
+                return new ErrorUnit(config);
             default:
                 throw new Error(`Unknown unit type: ${config.type}`);
         }
     }
 
     static createInSubworkflow(
-        config: ExcutionConfig | AssignmentConfig | ConditionConfig | IOConfig | AssertionConfig,
+        config:
+            | ExcutionConfig
+            | AssignmentConfig
+            | ConditionConfig
+            | IOConfig
+            | AssertionConfig
+            | ErrorConfig,
     ): AnySubworkflowUnit {
         switch (config.type) {
             case UnitType.execution:
@@ -124,6 +146,8 @@ export class UnitFactory {
                 return new IOUnit(config);
             case UnitType.assertion:
                 return new AssertionUnit(config);
+            case UnitType.error:
+                return new ErrorUnit(config);
             default:
                 throw new Error(`Unknown unit type: ${config.type}`);
         }

package/src/js/units/index.ts

@@ -2,6 +2,7 @@ import AssertionUnit from "./AssertionUnit";
 import AssignmentUnit from "./AssignmentUnit";
 import BaseUnit from "./BaseUnit";
 import ConditionUnit from "./ConditionUnit";
+import ErrorUnit from "./ErrorUnit";
 import ExecutionUnit from "./ExecutionUnit";
 import { UnitFactory } from "./factory";
 import IOUnit from "./IOUnit";
@@ -16,6 +17,7 @@ export {
     AssertionUnit,
     AssignmentUnit,
     ConditionUnit,
+    ErrorUnit,
     ExecutionUnit,
     IOUnit,
     MapUnit,

package/src/js/utils/index.ts

@@ -1,3 +1,4 @@
 export * as units from "./units";
 export * as workflow from "./workflow";
 export * as baseUnits from "./baseUnits";
+export * as repair from "./repair";

package/src/js/utils/repair.ts

@@ -0,0 +1,171 @@
+import { EntityError } from "@mat3ra/code/dist/js/entity/in_memory";
+import type {
+    ConditionUnitSchema,
+    ErrorUnitSchema,
+    ExecutionUnitSchema,
+    SubworkflowSchema,
+    WorkflowBaseUnitSchema,
+} from "@mat3ra/esse/dist/js/types";
+import { Utils } from "@mat3ra/utils";
+
+import { UnitStatus, UnitType } from "../enums";
+import Subworkflow from "../Subworkflow";
+import ConditionUnit from "../units/ConditionUnit";
+import ExecutionUnit from "../units/ExecutionUnit";
+import type { AnyWorkflowUnitSchema } from "../units/factory";
+import type { WorkflowSchema } from "../workflows/types";
+
+function toErrorUnitSchema(
+    unitData: Partial<WorkflowBaseUnitSchema>,
+    error: unknown,
+): ErrorUnitSchema {
+    let reasonPayload: { error: unknown; json: object };
+
+    if (error instanceof EntityError && error.details) {
+        reasonPayload = {
+            error: error.details.error,
+            json: unitData as object,
+        };
+    } else if (error instanceof Error) {
+        reasonPayload = {
+            error: { message: error.message, name: error.name },
+            json: unitData as object,
+        };
+    } else {
+        reasonPayload = {
+            error,
+            json: unitData as object,
+        };
+    }
+
+    return {
+        results: [],
+        preProcessors: [],
+        postProcessors: [],
+        monitors: [],
+        name: unitData.name ?? UnitType.error,
+        type: UnitType.error,
+        status: UnitStatus.error,
+        flowchartId: unitData.flowchartId ?? Utils.uuid.getUUID(),
+        reason: JSON.stringify(reasonPayload),
+        next: unitData.next ?? "",
+        head: unitData.head ?? false,
+    };
+}
+
+function repairExecutionUnit(
+    unitData: Partial<ExecutionUnitSchema>,
+): ExecutionUnitSchema | ErrorUnitSchema {
+    try {
+        return new ExecutionUnit(unitData as ExecutionUnitSchema).toJSON();
+    } catch (error: unknown) {
+        return toErrorUnitSchema(unitData as Partial<WorkflowBaseUnitSchema>, error);
+    }
+}
+
+function repairConditionUnit(
+    unitData: Partial<ConditionUnitSchema>,
+): ConditionUnitSchema | ErrorUnitSchema {
+    try {
+        return new ConditionUnit(unitData as ConditionUnitSchema).toJSON();
+    } catch (error: unknown) {
+        return toErrorUnitSchema(unitData as Partial<WorkflowBaseUnitSchema>, error);
+    }
+}
+
+function getSubworkflowValidationError(subworkflow: SubworkflowSchema): EntityError | Error | null {
+    // Two checks, same order as the old isValid() path (construct + validate), but split so we
+    // keep AJV errors when hydration would fail first:
+    // 1. validateData — JSON Schema on raw persisted subworkflow (no Application/ModelFactory/units).
+    //    Surfaces structured AJV errors (e.g. missing model) before the constructor runs.
+    // 2. new Subworkflow().validate() — hydration (app, model, units) then schema on the instance.
+    //    Catches schema-valid JSON that still cannot be built (unknown model, bad units, etc.).
+    try {
+        Subworkflow.validateData({ ...subworkflow });
+        new Subworkflow(subworkflow).validate();
+        return null;
+    } catch (error: unknown) {
+        if (error instanceof EntityError || error instanceof Error) {
+            return error;
+        }
+        return new Error(String(error));
+    }
+}
+
+function repairSubworkflow(subworkflowData: SubworkflowSchema): SubworkflowSchema {
+    const units = subworkflowData.units.map((unit) => {
+        if (unit.type === UnitType.execution) {
+            return repairExecutionUnit(unit);
+        }
+
+        if (unit.type === UnitType.condition) {
+            return repairConditionUnit(unit);
+        }
+
+        return unit;
+    });
+
+    return { ...subworkflowData, units };
+}
+
+export function repairWorkflow<T extends WorkflowSchema>(workflowData: T): T {
+    const subworkflows = workflowData.subworkflows.map((subworkflow) => {
+        return repairSubworkflow(subworkflow);
+    });
+
+    const invalidSubworkflows = subworkflows
+        .map((subworkflow) => {
+            const error = getSubworkflowValidationError(subworkflow);
+            return error ? { subworkflow, error } : null;
+        })
+        .filter(
+            (entry): entry is { subworkflow: SubworkflowSchema; error: EntityError | Error } =>
+                entry !== null,
+        );
+
+    const units = workflowData.units.map((unit): AnyWorkflowUnitSchema => {
+        const invalidEntry = invalidSubworkflows.find(
+            ({ subworkflow }) => subworkflow._id === unit._id,
+        );
+
+        if (invalidEntry) {
+            const { subworkflow, error } = invalidEntry;
+            const errorUnit = toErrorUnitSchema(unit, error);
+            const reasonPayload = {
+                ...JSON.parse(errorUnit.reason),
+                json: { unit, subworkflow },
+            };
+
+            return {
+                ...errorUnit,
+                _id: unit._id,
+                name: unit.name || errorUnit.name,
+                flowchartId: unit.flowchartId,
+                reason: JSON.stringify(reasonPayload),
+                preProcessors: unit.preProcessors || [],
+                postProcessors: unit.postProcessors || [],
+                monitors: unit.monitors || [],
+                results: unit.results || [],
+            };
+        }
+
+        return unit;
+    });
+
+    const validSubworkflows = subworkflows.filter((subworkflow) => {
+        return !invalidSubworkflows.some(
+            ({ subworkflow: invalid }) => invalid._id === subworkflow._id,
+        );
+    });
+
+    const workflows = workflowData.workflows.map((nested) => {
+        return repairWorkflow(nested as WorkflowSchema);
+    });
+
+    return {
+        ...workflowData,
+        subworkflows: validSubworkflows,
+        workflows,
+        units,
+    };
+}

package/src/js/workflows/default.ts

@@ -1,4 +1,4 @@
-import type { WorkflowSchema } from "@mat3ra/esse/dist/js/types";
+import type { WorkflowSchema } from "./types";
 
 const defaultWorkflowConfig: WorkflowSchema = {
     name: "New Workflow",

package/src/js/workflows/types.ts

@@ -0,0 +1,5 @@
+import type { WorkflowSchema as EsseWorkflowSchema } from "@mat3ra/esse/dist/js/types";
+
+export type WorkflowSchema = EsseWorkflowSchema & {
+    workflows: WorkflowSchema[];
+};