@hexabot-ai/api 3.0.0-alpha.3 → 3.1.0-alpha.0

package/dist/workflow/utils/schema-instance.js

@@ -0,0 +1,148 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SchemaInstance = void 0;
+class SchemaInstance {
+    constructor(rootSchema, data) {
+        this.rootSchema = rootSchema;
+        this.data = data;
+    }
+    *fields(options = {}) {
+        const { includeAdditional = false, recursive = false } = options;
+        const schema = this.resolveSchema(this.rootSchema);
+        if (!this.isObjectSchema(schema))
+            return;
+        yield* this.iterateObject(schema, this.data, {
+            includeAdditional,
+            recursive,
+            basePath: '',
+        });
+    }
+    getValue(path) {
+        if (!path)
+            return this.data;
+        const parts = path.split('.');
+        let cur = this.data;
+        for (const p of parts) {
+            if (cur == null || typeof cur !== 'object')
+                return undefined;
+            cur = cur[p];
+        }
+        return cur;
+    }
+    *iterateObject(objSchema, objValue, ctx) {
+        const resolvedObjSchema = this.resolveSchema(objSchema);
+        const props = resolvedObjSchema.properties ?? {};
+        const requiredSet = new Set(resolvedObjSchema.required ?? []);
+        const schemaKeys = Object.keys(props);
+        const dataKeys = Object.keys(objValue ?? {});
+        const extraKeys = ctx.includeAdditional
+            ? dataKeys.filter((k) => !(k in props))
+            : [];
+        for (const name of [...schemaKeys, ...extraKeys]) {
+            const rawPropSchema = props[name] ?? {};
+            const propSchema = this.resolveSchema(rawPropSchema);
+            const path = ctx.basePath ? `${ctx.basePath}.${name}` : name;
+            const value = (objValue ?? {})[name];
+            const { title, description, mergedSchema } = this.pickAnnotations(propSchema);
+            const info = {
+                name,
+                path,
+                title: title ?? name,
+                description,
+                value,
+                required: requiredSet.has(name),
+                schema: mergedSchema,
+            };
+            yield info;
+            if (ctx.recursive) {
+                const childSchema = mergedSchema;
+                if (this.isObjectSchema(childSchema) &&
+                    value &&
+                    typeof value === 'object' &&
+                    !Array.isArray(value)) {
+                    yield* this.iterateObject(childSchema, value, {
+                        ...ctx,
+                        basePath: path,
+                    });
+                }
+            }
+        }
+    }
+    isObjectSchema(s) {
+        const t = s.type;
+        if (t === 'object')
+            return true;
+        if (Array.isArray(t) && t.includes('object'))
+            return true;
+        return !!s.properties;
+    }
+    resolveSchema(schema, seen = new Set()) {
+        const normalizedSchema = this.normalizeSchema(schema);
+        if (seen.has(normalizedSchema))
+            return normalizedSchema;
+        seen.add(normalizedSchema);
+        if (normalizedSchema.$ref) {
+            const resolved = this.resolveLocalRef(normalizedSchema.$ref);
+            if (resolved !== undefined) {
+                return this.shallowMerge(this.resolveSchema(resolved, seen), normalizedSchema);
+            }
+        }
+        if (Array.isArray(normalizedSchema.allOf) &&
+            normalizedSchema.allOf.length) {
+            const merged = normalizedSchema.allOf
+                .map((s) => this.resolveSchema(s, seen))
+                .reduce((acc, cur) => this.shallowMerge(acc, cur), {});
+            return this.shallowMerge(merged, normalizedSchema);
+        }
+        return normalizedSchema;
+    }
+    pickAnnotations(schema) {
+        const mergedSchema = this.resolveSchema(schema);
+        const baseSchema = this.normalizeSchema(schema);
+        const title = mergedSchema.title ?? baseSchema.title;
+        const description = mergedSchema.description ?? baseSchema.description;
+        return { title, description, mergedSchema };
+    }
+    shallowMerge(a, b) {
+        const out = { ...a, ...b };
+        if (a.properties || b.properties) {
+            out.properties = { ...(a.properties ?? {}), ...(b.properties ?? {}) };
+        }
+        if (a.required || b.required) {
+            out.required = Array.from(new Set([...(a.required ?? []), ...(b.required ?? [])]));
+        }
+        const aDefs = a.$defs ?? a.definitions;
+        const bDefs = b.$defs ?? b.definitions;
+        if (aDefs || bDefs) {
+            out.$defs = { ...(aDefs ?? {}), ...(bDefs ?? {}) };
+        }
+        return out;
+    }
+    resolveLocalRef(ref) {
+        if (!ref.startsWith('#/'))
+            return undefined;
+        const pointer = ref.slice(2).split('/').map(this.unescapeJsonPointer);
+        const root = this.rootSchema;
+        let cur = root;
+        for (const key of pointer) {
+            if (cur == null || typeof cur !== 'object')
+                return undefined;
+            cur = cur[key];
+        }
+        return cur;
+    }
+    unescapeJsonPointer(segment) {
+        return segment.replace(/~1/g, '/').replace(/~0/g, '~');
+    }
+    normalizeSchema(schema) {
+        if (schema === false) {
+            return { not: {} };
+        }
+        if (schema === true || schema == null) {
+            return {};
+        }
+        return schema;
+    }
+}
+exports.SchemaInstance = SchemaInstance;
+//# sourceMappingURL=schema-instance.js.map

package/dist/workflow/utils/schema-instance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-instance.js","sourceRoot":"","sources":["../../../src/workflow/utils/schema-instance.ts"],"names":[],"mappings":";;;AAwFA,MAAa,cAAc;IAGzB,YACkB,UAAsB,EACtB,IAAW;QADX,eAAU,GAAV,UAAU,CAAY;QACtB,SAAI,GAAJ,IAAI,CAAO;IAC1B,CAAC;IAMJ,CAAC,MAAM,CAAC,UAA0B,EAAE;QAClC,MAAM,EAAE,iBAAiB,GAAG,KAAK,EAAE,SAAS,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;QACjE,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACnD,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC;YAAE,OAAO;QAEzC,KAAK,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE;YAC3C,iBAAiB;YACjB,SAAS;YACT,QAAQ,EAAE,EAAE;SACb,CAAC,CAAC;IACL,CAAC;IAGD,QAAQ,CAAC,IAAY;QACnB,IAAI,CAAC,IAAI;YAAE,OAAO,IAAI,CAAC,IAAI,CAAC;QAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,GAAG,GAAQ,IAAI,CAAC,IAAI,CAAC;QACzB,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,IAAI,GAAG,IAAI,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ;gBAAE,OAAO,SAAS,CAAC;YAC7D,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;QACf,CAAC;QAED,OAAO,GAAG,CAAC;IACb,CAAC;IAMO,CAAC,aAAa,CACpB,SAAqB,EACrB,QAAiC,EACjC,GAAyE;QAEzE,MAAM,iBAAiB,GAAG,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;QACxD,MAAM,KAAK,GAAG,iBAAiB,CAAC,UAAU,IAAI,EAAE,CAAC;QACjD,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,iBAAiB,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;QAC9D,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACtC,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;QAC7C,MAAM,SAAS,GAAG,GAAG,CAAC,iBAAiB;YACrC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC;YACvC,CAAC,CAAC,EAAE,CAAC;QAEP,KAAK,MAAM,IAAI,IAAI,CAAC,GAAG,UAAU,EAAE,GAAG,SAAS,CAAC,EAAE,CAAC;YACjD,MAAM,aAAa,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACxC,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC;YACrD,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,QAAQ,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;YAC7D,MAAM,KAAK,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;YAErC,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,GACxC,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC;YACnC,MAAM,IAAI,GAAc;gBACtB,IAAI;gBACJ,IAAI;gBACJ,KAAK,EAAE,KAAK,IAAI,IAAI;gBACpB,WAAW;gBACX,KAAK;gBACL,QAAQ,EAAE,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC;gBAC/B,MAAM,EAAE,YAAY;aACrB,CAAC;YAEF,MAAM,IAAI,CAAC;YAEX,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;gBAClB,MAAM,WAAW,GAAG,YAAY,CAAC;gBACjC,IACE,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC;oBAChC,KAAK;oBACL,OAAO,KAAK,KAAK,QAAQ;oBACzB,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EACrB,CAAC;oBACD,KAAK,CAAC,CAAC,IAAI,CAAC,aAAa,CACvB,WAAW,EACX,KAAgC,EAChC;wBACE,GAAG,GAAG;wBACN,QAAQ,EAAE,IAAI;qBACf,CACF,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAEO,cAAc,CAAC,CAAa;QAClC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;QACjB,IAAI,CAAC,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QAChC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAAE,OAAO,IAAI,CAAC;QAG1D,OAAO,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;IACxB,CAAC;IAOO,aAAa,CACnB,MAA+C,EAC/C,OAAO,IAAI,GAAG,EAAc;QAE5B,MAAM,gBAAgB,GAAG,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;QACtD,IAAI,IAAI,CAAC,GAAG,CAAC,gBAAgB,CAAC;YAAE,OAAO,gBAAgB,CAAC;QACxD,IAAI,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;QAG3B,IAAI,gBAAgB,CAAC,IAAI,EAAE,CAAC;YAC1B,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;YAC7D,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAE3B,OAAO,IAAI,CAAC,YAAY,CACtB,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,EAClC,gBAAgB,CACjB,CAAC;YACJ,CAAC;QACH,CAAC;QAGD,IACE,KAAK,CAAC,OAAO,CAAC,gBAAgB,CAAC,KAAK,CAAC;YACrC,gBAAgB,CAAC,KAAK,CAAC,MAAM,EAC7B,CAAC;YACD,MAAM,MAAM,GAAG,gBAAgB,CAAC,KAAK;iBAClC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;iBACvC,MAAM,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,EAAgB,CAAC,CAAC;YAEvE,OAAO,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;QACrD,CAAC;QAED,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IAEO,eAAe,CAAC,MAA4B;QAKlD,MAAM,YAAY,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAEhD,MAAM,UAAU,GAAG,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;QAChD,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK,CAAC;QACrD,MAAM,WAAW,GAAG,YAAY,CAAC,WAAW,IAAI,UAAU,CAAC,WAAW,CAAC;QAEvE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,CAAC;IAC9C,CAAC;IAEO,YAAY,CAAC,CAAa,EAAE,CAAa;QAC/C,MAAM,GAAG,GAAe,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;QAGvC,IAAI,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC;YACjC,GAAG,CAAC,UAAU,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,UAAU,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,UAAU,IAAI,EAAE,CAAC,EAAE,CAAC;QACxE,CAAC;QAGD,IAAI,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;YAC7B,GAAG,CAAC,QAAQ,GAAG,KAAK,CAAC,IAAI,CACvB,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAC,CACxD,CAAC;QACJ,CAAC;QAGD,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,WAAW,CAAC;QACvC,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,WAAW,CAAC;QACvC,IAAI,KAAK,IAAI,KAAK,EAAE,CAAC;YACnB,GAAG,CAAC,KAAK,GAAG,EAAE,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC;QACrD,CAAC;QAED,OAAO,GAAG,CAAC;IACb,CAAC;IAEO,eAAe,CAAC,GAAW;QACjC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,OAAO,SAAS,CAAC;QAG5C,MAAM,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QAEtE,MAAM,IAAI,GAAQ,IAAI,CAAC,UAAU,CAAC;QAClC,IAAI,GAAG,GAAQ,IAAI,CAAC;QAEpB,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;YAC1B,IAAI,GAAG,IAAI,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ;gBAAE,OAAO,SAAS,CAAC;YAC7D,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;QACjB,CAAC;QAED,OAAO,GAAuC,CAAC;IACjD,CAAC;IAEO,mBAAmB,CAAC,OAAe;QAEzC,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACzD,CAAC;IAEO,eAAe,CACrB,MAA+C;QAE/C,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;YACrB,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC;QACrB,CAAC;QAED,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;YACtC,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AA3ND,wCA2NC"}

package/dist/workflow/utils/workflow-run-duration.d.ts

@@ -0,0 +1,9 @@
+import { WorkflowRunStatus } from '@hexabot-ai/agentic';
+export declare const resolveTimestampMs: (value?: Date | string | null) => number | null;
+export declare const resolveRunDurationMs: (run: {
+    createdAt?: Date | string | null;
+    finishedAt?: Date | string | null;
+    failedAt?: Date | string | null;
+    suspendedAt?: Date | string | null;
+    status?: WorkflowRunStatus | null;
+}) => number | null;

package/dist/workflow/utils/workflow-run-duration.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveRunDurationMs = exports.resolveTimestampMs = void 0;
+const resolveTimestampMs = (value) => {
+    if (!value) {
+        return null;
+    }
+    const date = value instanceof Date ? value : new Date(value);
+    const timestamp = date.getTime();
+    return Number.isNaN(timestamp) ? null : timestamp;
+};
+exports.resolveTimestampMs = resolveTimestampMs;
+const resolveRunDurationMs = (run) => {
+    const createdAtMs = (0, exports.resolveTimestampMs)(run.createdAt);
+    if (createdAtMs == null) {
+        return null;
+    }
+    const endAtMs = (0, exports.resolveTimestampMs)(run.finishedAt) ??
+        (0, exports.resolveTimestampMs)(run.failedAt) ??
+        (0, exports.resolveTimestampMs)(run.suspendedAt) ??
+        (run.status === 'running' ? Date.now() : null);
+    if (endAtMs == null) {
+        return null;
+    }
+    return Math.max(0, endAtMs - createdAtMs);
+};
+exports.resolveRunDurationMs = resolveRunDurationMs;
+//# sourceMappingURL=workflow-run-duration.js.map

package/dist/workflow/utils/workflow-run-duration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-run-duration.js","sourceRoot":"","sources":["../../../src/workflow/utils/workflow-run-duration.ts"],"names":[],"mappings":";;;AAQO,MAAM,kBAAkB,GAAG,CAChC,KAA4B,EACb,EAAE;IACjB,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,IAAI,GAAG,KAAK,YAAY,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7D,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;IAEjC,OAAO,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AACpD,CAAC,CAAC;AAXW,QAAA,kBAAkB,sBAW7B;AAEK,MAAM,oBAAoB,GAAG,CAAC,GAMpC,EAAiB,EAAE;IAClB,MAAM,WAAW,GAAG,IAAA,0BAAkB,EAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACtD,IAAI,WAAW,IAAI,IAAI,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,OAAO,GACX,IAAA,0BAAkB,EAAC,GAAG,CAAC,UAAU,CAAC;QAClC,IAAA,0BAAkB,EAAC,GAAG,CAAC,QAAQ,CAAC;QAChC,IAAA,0BAAkB,EAAC,GAAG,CAAC,WAAW,CAAC;QACnC,CAAC,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAEjD,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,WAAW,CAAC,CAAC;AAC5C,CAAC,CAAC;AAvBW,QAAA,oBAAoB,wBAuB/B"}

package/dist/workflow/workflow.module.d.ts

@@ -0,0 +1,2 @@
+export declare class WorkflowModule {
+}

package/dist/workflow/workflow.module.js

@@ -0,0 +1,121 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkflowModule = void 0;
+const common_1 = require("@nestjs/common");
+const schedule_1 = require("@nestjs/schedule");
+const typeorm_1 = require("@nestjs/typeorm");
+const chat_module_1 = require("../chat/chat.module");
+const thread_entity_1 = require("../chat/entities/thread.entity");
+const cms_1 = require("../cms");
+const user_1 = require("../user");
+const conversational_workflow_context_1 = require("./contexts/conversational-workflow.context");
+const manual_workflow_context_1 = require("./contexts/manual-workflow.context");
+const scheduled_workflow_context_1 = require("./contexts/scheduled-workflow.context");
+const workflow_context_factory_1 = require("./contexts/workflow-context-factory");
+const mcp_server_controller_1 = require("./controllers/mcp-server.controller");
+const memory_definition_controller_1 = require("./controllers/memory-definition.controller");
+const workflow_run_controller_1 = require("./controllers/workflow-run.controller");
+const workflow_version_controller_1 = require("./controllers/workflow-version.controller");
+const workflow_controller_1 = require("./controllers/workflow.controller");
+const mcp_server_entity_1 = require("./entities/mcp-server.entity");
+const memory_definition_entity_1 = require("./entities/memory-definition.entity");
+const memory_record_entity_1 = require("./entities/memory-record.entity");
+const workflow_run_entity_1 = require("./entities/workflow-run.entity");
+const workflow_version_entity_1 = require("./entities/workflow-version.entity");
+const workflow_entity_1 = require("./entities/workflow.entity");
+const mcp_server_repository_1 = require("./repositories/mcp-server.repository");
+const memory_definition_repository_1 = require("./repositories/memory-definition.repository");
+const memory_record_repository_1 = require("./repositories/memory-record.repository");
+const workflow_run_repository_1 = require("./repositories/workflow-run.repository");
+const workflow_version_repository_1 = require("./repositories/workflow-version.repository");
+const workflow_repository_1 = require("./repositories/workflow.repository");
+const memory_definition_seed_1 = require("./seeds/memory-definition.seed");
+const workflow_seed_1 = require("./seeds/workflow.seed");
+const agentic_service_1 = require("./services/agentic.service");
+const mcp_client_pool_service_1 = require("./services/mcp-client-pool.service");
+const mcp_server_service_1 = require("./services/mcp-server.service");
+const memory_definition_service_1 = require("./services/memory-definition.service");
+const memory_record_service_1 = require("./services/memory-record.service");
+const memory_service_1 = require("./services/memory.service");
+const workflow_run_service_1 = require("./services/workflow-run.service");
+const workflow_scheduler_service_1 = require("./services/workflow-scheduler.service");
+const workflow_version_service_1 = require("./services/workflow-version.service");
+const workflow_service_1 = require("./services/workflow.service");
+let WorkflowModule = class WorkflowModule {
+};
+exports.WorkflowModule = WorkflowModule;
+exports.WorkflowModule = WorkflowModule = __decorate([
+    (0, common_1.Module)({
+        imports: [
+            typeorm_1.TypeOrmModule.forFeature([
+                workflow_entity_1.WorkflowOrmEntity,
+                workflow_version_entity_1.WorkflowVersionOrmEntity,
+                workflow_run_entity_1.WorkflowRunOrmEntity,
+                memory_definition_entity_1.MemoryDefinitionOrmEntity,
+                memory_record_entity_1.MemoryRecordOrmEntity,
+                mcp_server_entity_1.McpServerOrmEntity,
+                thread_entity_1.ThreadOrmEntity,
+            ]),
+            (0, common_1.forwardRef)(() => cms_1.CmsModule),
+            (0, common_1.forwardRef)(() => chat_module_1.ChatModule),
+            user_1.UserModule,
+        ],
+        controllers: [
+            workflow_controller_1.WorkflowController,
+            workflow_version_controller_1.WorkflowVersionController,
+            workflow_run_controller_1.WorkflowRunController,
+            memory_definition_controller_1.MemoryDefinitionController,
+            mcp_server_controller_1.McpServerController,
+        ],
+        providers: [
+            workflow_repository_1.WorkflowRepository,
+            workflow_version_repository_1.WorkflowVersionRepository,
+            workflow_run_repository_1.WorkflowRunRepository,
+            memory_definition_repository_1.MemoryDefinitionRepository,
+            memory_record_repository_1.MemoryRecordRepository,
+            mcp_server_repository_1.McpServerRepository,
+            memory_definition_seed_1.MemoryDefinitionSeeder,
+            workflow_seed_1.WorkflowSeeder,
+            workflow_service_1.WorkflowService,
+            workflow_version_service_1.WorkflowVersionService,
+            workflow_run_service_1.WorkflowRunService,
+            memory_definition_service_1.MemoryDefinitionService,
+            memory_record_service_1.MemoryRecordService,
+            memory_service_1.MemoryService,
+            mcp_server_service_1.McpServerService,
+            mcp_client_pool_service_1.McpClientPoolService,
+            schedule_1.SchedulerRegistry,
+            workflow_scheduler_service_1.WorkflowSchedulerService,
+            conversational_workflow_context_1.ConversationalWorkflowContext,
+            manual_workflow_context_1.ManualWorkflowContext,
+            scheduled_workflow_context_1.ScheduledWorkflowContext,
+            workflow_context_factory_1.WorkflowContextFactory,
+            agentic_service_1.AgenticService,
+        ],
+        exports: [
+            workflow_repository_1.WorkflowRepository,
+            workflow_version_repository_1.WorkflowVersionRepository,
+            workflow_run_repository_1.WorkflowRunRepository,
+            memory_definition_repository_1.MemoryDefinitionRepository,
+            memory_record_repository_1.MemoryRecordRepository,
+            mcp_server_repository_1.McpServerRepository,
+            workflow_service_1.WorkflowService,
+            workflow_version_service_1.WorkflowVersionService,
+            workflow_run_service_1.WorkflowRunService,
+            memory_definition_service_1.MemoryDefinitionService,
+            memory_record_service_1.MemoryRecordService,
+            memory_service_1.MemoryService,
+            mcp_server_service_1.McpServerService,
+            mcp_client_pool_service_1.McpClientPoolService,
+            conversational_workflow_context_1.ConversationalWorkflowContext,
+            agentic_service_1.AgenticService,
+        ],
+    })
+], WorkflowModule);
+//# sourceMappingURL=workflow.module.js.map

package/dist/workflow/workflow.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.module.js","sourceRoot":"","sources":["../../src/workflow/workflow.module.ts"],"names":[],"mappings":";;;;;;;;;AAMA,2CAAoD;AACpD,+CAAqD;AACrD,6CAAgD;AAEhD,qDAAgD;AAChD,kEAAgE;AAChE,gCAAkC;AAClC,kCAAoC;AAEpC,gGAA2F;AAC3F,gFAA2E;AAC3E,sFAAiF;AACjF,kFAA6E;AAC7E,+EAA0E;AAC1E,6FAAwF;AACxF,mFAA8E;AAC9E,2FAAsF;AACtF,2EAAuE;AACvE,oEAAkE;AAClE,kFAAgF;AAChF,0EAAwE;AACxE,wEAAsE;AACtE,gFAA8E;AAC9E,gEAA+D;AAC/D,gFAA2E;AAC3E,8FAAyF;AACzF,sFAAiF;AACjF,oFAA+E;AAC/E,4FAAuF;AACvF,4EAAwE;AACxE,2EAAwE;AACxE,yDAAuD;AACvD,gEAA4D;AAC5D,gFAA0E;AAC1E,sEAAiE;AACjE,oFAA+E;AAC/E,4EAAuE;AACvE,8DAA0D;AAC1D,0EAAqE;AACrE,sFAAiF;AACjF,kFAA6E;AAC7E,kEAA8D;AAoEvD,IAAM,cAAc,GAApB,MAAM,cAAc;CAAG,CAAA;AAAjB,wCAAc;yBAAd,cAAc;IAlE1B,IAAA,eAAM,EAAC;QACN,OAAO,EAAE;YACP,uBAAa,CAAC,UAAU,CAAC;gBACvB,mCAAiB;gBACjB,kDAAwB;gBACxB,0CAAoB;gBACpB,oDAAyB;gBACzB,4CAAqB;gBACrB,sCAAkB;gBAClB,+BAAe;aAChB,CAAC;YACF,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,eAAS,CAAC;YAC3B,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,wBAAU,CAAC;YAC5B,iBAAU;SACX;QACD,WAAW,EAAE;YACX,wCAAkB;YAClB,uDAAyB;YACzB,+CAAqB;YACrB,yDAA0B;YAC1B,2CAAmB;SACpB;QACD,SAAS,EAAE;YACT,wCAAkB;YAClB,uDAAyB;YACzB,+CAAqB;YACrB,yDAA0B;YAC1B,iDAAsB;YACtB,2CAAmB;YACnB,+CAAsB;YACtB,8BAAc;YACd,kCAAe;YACf,iDAAsB;YACtB,yCAAkB;YAClB,mDAAuB;YACvB,2CAAmB;YACnB,8BAAa;YACb,qCAAgB;YAChB,8CAAoB;YACpB,4BAAiB;YACjB,qDAAwB;YACxB,+DAA6B;YAC7B,+CAAqB;YACrB,qDAAwB;YACxB,iDAAsB;YACtB,gCAAc;SACf;QACD,OAAO,EAAE;YACP,wCAAkB;YAClB,uDAAyB;YACzB,+CAAqB;YACrB,yDAA0B;YAC1B,iDAAsB;YACtB,2CAAmB;YACnB,kCAAe;YACf,iDAAsB;YACtB,yCAAkB;YAClB,mDAAuB;YACvB,2CAAmB;YACnB,8BAAa;YACb,qCAAgB;YAChB,8CAAoB;YACpB,+DAA6B;YAC7B,gCAAc;SACf;KACF,CAAC;GACW,cAAc,CAAG"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@hexabot-ai/api",
   "private": false,
-  "version": "3.0.0-alpha.3",
+  "version": "3.1.0-alpha.0",
   "description": "Hexabot is a solution for creating and managing chatbots across multiple channels, leveraging AI for advanced conversational capabilities. It provides a user-friendly interface for building, training, and deploying chatbots with integrated support for various messaging platforms.",
   "author": "Hexastack",
   "license": "FCL-1.0-ALv2",
@@ -18,8 +18,7 @@
     "dist",
     "src",
     "types",
-    "!src/**/*.spec.ts",
-    "!src/.hexabot"
+    "!src/**/*.spec.ts"
   ],
   "scripts": {
     "dev": "pnpm run start:dev",
@@ -37,7 +36,8 @@
     "start:repl": "pnpm run start -- --entryFile repl",
     "lint": "eslint \"{src,apps,libs,test}/**/*.ts\"",
     "lint:fix": "eslint \"{src,apps,libs,test}/**/*.ts\" --fix",
-    "test": "jest --runInBand --logHeapUsage --detectOpenHandles --forceExit",
+    "test": "jest --logHeapUsage --maxWorkers=50% --workerIdleMemoryLimit=1GB --testTimeout=10000",
+    "test:runInBand": "jest --runInBand --logHeapUsage --detectOpenHandles --forceExit",
     "test:half": "jest --logHeapUsage --maxWorkers=50% --testTimeout=10000",
     "test:full": "jest --logHeapUsage --maxWorkers=100% --testTimeout=10000",
     "test:watch": "jest --watch --detectOpenHandles",
@@ -45,7 +45,7 @@
     "test:debug": "node --inspect-brk -r tsconfig-paths/register -r ts-node/register node_modules/.bin/jest --runInBand",
     "test:e2e": "jest --config ./test/jest-e2e.json",
     "test:clear": "jest --clearCache",
-    "typecheck": "tsc --noEmit",
+    "typecheck": "tsc --noEmit -p tsconfig.typecheck.json",
     "reset": "pnpm install && pnpm run containers:restart",
     "reset:hard": "pnpm install --force && pnpm run containers:rebuild",
     "cli": "HEXABOT_CLI=1 ts-node --files --log-error --compiler-options '{\"diagnostics\": true}' src/cli.ts"
@@ -54,7 +54,14 @@
     "*.{js,ts}": "eslint --fix --config eslint.config-staged.cjs"
   },
   "dependencies": {
+    "@ai-sdk/gateway": "^3.0.9",
+    "@ai-sdk/mcp": "^1.0.25",
+    "@ai-sdk/openai": "^3.0.7",
+    "@ai-sdk/provider": "^3.0.2",
+    "@hexabot-ai/agentic": "workspace:*",
     "@keyv/redis": "^5.1.3",
+    "@llamaindex/openai": "0.4.22",
+    "@llamaindex/postgres": "0.0.65",
     "@nestjs-modules/mailer": "^2.0.2",
     "@nestjs/axios": "^4.0.1",
     "@nestjs/cache-manager": "^3.0.1",
@@ -66,6 +73,7 @@
     "@nestjs/passport": "^11.0.5",
     "@nestjs/platform-express": "^11.1.6",
     "@nestjs/platform-socket.io": "^11.1.6",
+    "@nestjs/schedule": "^4.0.0",
     "@nestjs/serve-static": "^5.0.4",
     "@nestjs/swagger": "^11.2.0",
     "@nestjs/typeorm": "^11.0.0",
@@ -73,6 +81,7 @@
     "@resvg/resvg-js": "^2.6.2",
     "@socket.io/redis-adapter": "^8.3.0",
     "@types/uuid": "^10.0.0",
+    "ai": "^6.0.17",
     "async-mutex": "^0.5.0",
     "axios": "^1.12.2",
     "bcryptjs": "^3.0.2",
@@ -82,21 +91,24 @@
     "connect-typeorm": "^2.0.0",
     "cookie-parser": "^1.4.7",
     "csrf-sync": "^4.2.1",
+    "dotenv": "^16.3.1",
     "express-session": "^1.18.2",
-    "handlebars": "^4.7.8",
+    "handlebars": "^4.7.9",
     "keyv": "^5.5.3",
+    "llamaindex": "0.12.1",
     "mime": "^1.6.0",
     "module-alias": "2.2.3",
     "nest-commander": "^3.20.1",
     "nestjs-dynamic-providers": "^0.3.7",
     "nestjs-i18n": "^10.5.1",
-    "nodemailer": "^7.0.9",
+    "p-limit": "^3.1.0",
     "papaparse": "^5.5.3",
     "passport": "^0.7.0",
     "passport-anonymous": "^1.0.1",
     "passport-jwt": "^4.0.1",
     "passport-local": "^1.0.0",
     "pg": "^8.13.1",
+    "pgvector": "0.2.0",
     "redis": "^5.8.3",
     "reflect-metadata": "^0.2.2",
     "rxjs": "^7.8.2",
@@ -105,8 +117,8 @@
     "sqlite3": "^5.1.7",
     "typeorm": "^0.3.27",
     "uuid": "^9.0.1",
-    "zod": "^3.24.1",
-    "dotenv": "^16.3.1"
+    "yaml": "^2.5.0",
+    "zod": "^4.3.6"
   },
   "devDependencies": {
     "@compodoc/compodoc": "^1.1.31",
@@ -119,12 +131,12 @@
     "@types/express": "^5.0.3",
     "@types/express-session": "^1.18.2",
     "@types/jest": "^30.0.0",
+    "@types/json-schema": "^7.0.15",
     "@types/lodash": "^4.17.20",
     "@types/module-alias": "^2.0.4",
     "@types/multer": "^2.0.0",
     "@types/node": "^20.3.1",
     "@types/node-fetch": "^2.6.13",
-    "@types/nodemailer": "^6.4.14",
     "@types/papaparse": "^5.3.16",
     "@types/passport-anonymous": "^1.0.5",
     "@types/passport-jwt": "^4.0.1",
@@ -186,7 +198,9 @@
     "coverageDirectory": "../coverage",
     "testEnvironment": "node",
     "moduleNameMapper": {
-      "@/(.*)": "<rootDir>/$1"
+      "@/(.*)": "<rootDir>/$1",
+      "^@hexabot-ai/agentic$": "<rootDir>/../../agentic/src",
+      "^@hexabot-ai/agentic/(.*)$": "<rootDir>/../../agentic/src/$1"
     }
   },
   "engines": {

package/src/actions/actions.module.ts

@@ -0,0 +1,25 @@
+/*
+ * Hexabot — Fair Core License (FCL-1.0-ALv2)
+ * Copyright (c) 2025 Hexastack.
+ * Full terms: see LICENSE.md.
+ */
+
+import { Global, Module } from '@nestjs/common';
+import { InjectDynamicProviders } from 'nestjs-dynamic-providers';
+
+import { ActionService } from './actions.service';
+
+@Global()
+@InjectDynamicProviders(
+  // Built-in core actions
+  'node_modules/@hexabot-ai/api/dist/extensions/actions/**/*.action.js',
+  // Community extensions installed via npm
+  'node_modules/hexabot-action-*/**/*.action.js',
+  // Custom & under dev actions
+  'dist/extensions/actions/**/*.action.js',
+)
+@Module({
+  providers: [ActionService],
+  exports: [ActionService],
+})
+export class ActionsModule {}

package/src/actions/actions.service.ts

@@ -0,0 +1,102 @@
+/*
+ * Hexabot — Fair Core License (FCL-1.0-ALv2)
+ * Copyright (c) 2025 Hexastack.
+ * Full terms: see LICENSE.md.
+ */
+
+import { BaseWorkflowContext } from '@hexabot-ai/agentic';
+import { Injectable, InternalServerErrorException } from '@nestjs/common';
+import { I18nContext } from 'nestjs-i18n';
+
+import { I18nService } from '@/i18n/services/i18n.service';
+import { LoggerService } from '@/logger/logger.service';
+import { toDraft07JsonSchema } from '@/utils/helpers/zod';
+import { WorkflowType } from '@/workflow/types';
+
+import { BaseAction } from './base-action';
+import { ActionName, ActionRegistry } from './types';
+
+@Injectable()
+export class ActionService {
+  private readonly registry: ActionRegistry<
+    BaseAction<any, any, BaseWorkflowContext, any>
+  > = new Map();
+
+  constructor(
+    private readonly logger: LoggerService,
+    private readonly i18nService: I18nService,
+  ) {}
+
+  register<C extends BaseWorkflowContext>(
+    action: BaseAction<any, any, C, any>,
+  ) {
+    const name = action.getName();
+    if (this.registry.has(name)) {
+      throw new InternalServerErrorException(
+        `Action with name ${name} already exist`,
+      );
+    }
+
+    this.registry.set(name, action);
+    this.logger.log(`Action "${name}" has been registered!`);
+  }
+
+  get(name: ActionName) {
+    const action = this.registry.get(name);
+    if (!action) {
+      throw new Error(`Unable to find action "${name}"`);
+    }
+
+    return action;
+  }
+
+  getAll() {
+    return Array.from(this.registry.values());
+  }
+
+  getAllSchemaDefinitions(workflowType?: WorkflowType) {
+    const actions = workflowType
+      ? this.getAll().filter((action) =>
+          action.workflowTypes.includes(workflowType),
+        )
+      : this.getAll();
+    const lang = I18nContext.current()?.lang;
+
+    return actions.map((action) => {
+      const name = action.getName();
+      const localizationOptions =
+        this.i18nService.getJsonSchemaLocalizationOptions(name, lang);
+
+      return {
+        name,
+        description: action.description,
+        icon: action.icon,
+        color: action.color,
+        group: action.group,
+        workflowTypes: action.workflowTypes,
+        supportedBindings: action.supportedBindings ?? [],
+        inputSchema: toDraft07JsonSchema(
+          action.inputSchema,
+          localizationOptions,
+        ),
+        outputSchema: toDraft07JsonSchema(
+          action.outputSchema,
+          localizationOptions,
+        ),
+        settingSchema: toDraft07JsonSchema(
+          action.settingSchema,
+          localizationOptions,
+        ),
+      };
+    });
+  }
+
+  getRegistry(): Record<
+    ActionName,
+    BaseAction<any, any, BaseWorkflowContext, any>
+  > {
+    return Object.fromEntries(
+      this.getAll().map((action) => [action.getName(), action]),
+    );
+  }
+}

package/src/actions/base-action.ts

@@ -0,0 +1,77 @@
+/*
+ * Hexabot — Fair Core License (FCL-1.0-ALv2)
+ * Copyright (c) 2025 Hexastack.
+ * Full terms: see LICENSE.md.
+ */
+
+import { AbstractAction, BaseWorkflowContext } from '@hexabot-ai/agentic';
+import { Injectable, OnModuleInit } from '@nestjs/common';
+import { z, type ZodType } from 'zod';
+
+import { RuntimeBindings } from '@/bindings/runtime-bindings';
+import { ConversationalWorkflowContext } from '@/workflow/contexts/conversational-workflow.context';
+import { WorkflowType } from '@/workflow/types';
+
+import { ActionService } from './actions.service';
+import {
+  ActionMetadata,
+  ActionName,
+  ALL_WORKFLOW_TYPES,
+  DEFAULT_ACTION_COLOR,
+  DEFAULT_ACTION_GROUP,
+  DEFAULT_ACTION_ICON,
+  ExecArgs,
+} from './types';
+
+const defaultSchema = z.object({}).strict();
+const resolveSchema = <T>(schema?: ZodType<T>): ZodType<T> =>
+  (schema ?? defaultSchema) as unknown as ZodType<T>;
+
+@Injectable()
+export abstract class BaseAction<
+    I = unknown,
+    O = unknown,
+    C extends BaseWorkflowContext = ConversationalWorkflowContext,
+    S = unknown,
+  >
+  extends AbstractAction<I, O, C, S, RuntimeBindings>
+  implements OnModuleInit
+{
+  public readonly icon: string;
+
+  public readonly color: string;
+
+  public readonly group: string;
+
+  public readonly workflowTypes: WorkflowType[];
+
+  protected constructor(
+    metadata: ActionMetadata<I, O, S>,
+    private readonly actionService: ActionService,
+  ) {
+    super({
+      ...metadata,
+      inputSchema: resolveSchema(metadata.inputSchema),
+      outputSchema: resolveSchema(metadata.outputSchema),
+      settingsSchema: resolveSchema(metadata.settingsSchema),
+    });
+    this.icon = metadata.icon ?? DEFAULT_ACTION_ICON;
+    this.color = metadata.color ?? DEFAULT_ACTION_COLOR;
+    this.group = metadata.group ?? DEFAULT_ACTION_GROUP;
+    this.workflowTypes = metadata.workflowTypes ?? ALL_WORKFLOW_TYPES;
+  }
+
+  getIcon(): string {
+    return this.icon as string;
+  }
+
+  getName(): ActionName {
+    return this.name as ActionName;
+  }
+
+  async onModuleInit() {
+    this.actionService.register(this);
+  }
+
+  abstract execute(args: ExecArgs<I, C, S>): Promise<O>;
+}