@halleyassist/rule-templater 0.0.17 → 0.0.19

package/src/RuleTemplate.production.js

@@ -28,7 +28,7 @@ const AllowedTypeMapping = {
     'number': ['number_atom', 'math_expr'],
     'boolean': ['boolean_atom', 'boolean_expr'],
     'time period': ['time_period_atom'],
-    'time period ago': ['time_period_atom'],
+    'time period ago': ['time_period_ago_atom'],
     'time value': ['time_value_atom', 'tod_atom'],
     'number time': ['number_atom'],
     'string array': ['string_array'],
@@ -49,12 +49,71 @@ for(const rule of TemplateGrammar){
     }
 }
 
-// Add template_value as an alternative to value_atom so templates can be parsed
-const valueAtomIdx = extendedGrammar.findIndex(r => r.name === 'value_atom');
-if (valueAtomIdx !== -1) {
-    extendedGrammar[valueAtomIdx] = Object.assign({}, extendedGrammar[valueAtomIdx]);
-    extendedGrammar[valueAtomIdx].bnf = extendedGrammar[valueAtomIdx].bnf.concat([['template_value']]);
-}
+const cloneRule = (ruleName) => {
+    const idx = extendedGrammar.findIndex(rule => rule.name === ruleName);
+    if (idx === -1) {
+        return null;
+    }
+
+    extendedGrammar[idx] = Object.assign({}, extendedGrammar[idx], {
+        bnf: extendedGrammar[idx].bnf.map(alt => Array.isArray(alt) ? alt.slice() : alt)
+    });
+
+    return extendedGrammar[idx];
+};
+
+const appendAlternative = (ruleName, alternative) => {
+    const rule = cloneRule(ruleName);
+    if (!rule) {
+        return;
+    }
+
+    const exists = rule.bnf.some(existing => JSON.stringify(existing) === JSON.stringify(alternative));
+    if (!exists) {
+        rule.bnf.push(alternative);
+    }
+};
+
+const replaceRule = (ruleName, bnf) => {
+    const idx = extendedGrammar.findIndex(rule => rule.name === ruleName);
+    if (idx === -1) {
+        extendedGrammar.push({name: ruleName, bnf});
+        return;
+    }
+
+    extendedGrammar[idx] = Object.assign({}, extendedGrammar[idx], {
+        bnf: bnf.map(alt => alt.slice())
+    });
+};
+
+appendAlternative('number_atom', ['template_value']);
+appendAlternative('number_time_atom', ['template_value', 'WS+', 'unit']);
+appendAlternative('number_time_atom', ['template_value']);
+appendAlternative('tod_atom', ['template_value']);
+appendAlternative('dow_atom', ['template_value']);
+appendAlternative('between_time_only_atom', ['template_value']);
+appendAlternative('between_tod_only_atom', ['template_value']);
+appendAlternative('string_atom', ['template_value']);
+appendAlternative('boolean_atom', ['template_value']);
+appendAlternative('time_value_atom', ['template_value']);
+appendAlternative('time_period_atom', ['template_value']);
+appendAlternative('time_period_ago_atom', ['template_value']);
+appendAlternative('object_atom', ['template_value']);
+appendAlternative('string_array', ['template_value']);
+appendAlternative('number_array', ['template_value']);
+appendAlternative('boolean_array', ['template_value']);
+appendAlternative('object_array', ['template_value']);
+
+replaceRule('argument', [
+    ['number_time_atom', 'WS*'],
+    ['statement', 'WS*']
+]);
+
+replaceRule('simple_result', [
+    ['fcall'],
+    ['number_time_atom'],
+    ['value']
+]);
 
 // Export the parser rules for potential external use
 const ParserRules = extendedGrammar;
@@ -185,11 +244,13 @@ class RuleTemplate {
         
         // Extract filters
         const filters = [];
+        const filterCalls = [];
         for (const child of templateExpr.children || []) {
             if (child.type === 'template_filter_call') {
-                const filterName = this._extractFilterName(child);
-                if (filterName) {
-                    filters.push(filterName);
+                const filterCall = this._extractFilterCall(child);
+                if (filterCall) {
+                    filters.push(filterCall.name);
+                    filterCalls.push(filterCall);
                 }
             }
         }
@@ -198,18 +259,84 @@ class RuleTemplate {
         const start = node.start;
         const end = node.end;
         
-        return { name, filters, start, end };
+        return { name, filters, filterCalls, start, end };
     }
 
     /**
-     * Extract filter name from template_filter_call node
+     * Extract filter call from template_filter_call node
      * @private
      */
-    _extractFilterName(node) {
+    _extractFilterCall(node) {
         const filterNameNode = node.children?.find(c => c.type === 'template_filter_name');
         if (!filterNameNode || !filterNameNode.text) return null;
-        
-        return filterNameNode.text.trim();
+
+        const argsNode = node.children?.find(c => c.type === 'template_filter_args');
+
+        return {
+            name: filterNameNode.text.trim(),
+            args: this._extractFilterArgs(argsNode)
+        };
+    }
+
+    _extractFilterArgs(node) {
+        if (!node || !Array.isArray(node.children)) {
+            return [];
+        }
+
+        return node.children
+            .filter(child => child.type === 'template_filter_arg')
+            .map(child => this._extractFilterArgValue(child));
+    }
+
+    _extractFilterArgValue(node) {
+        if (!node || !Array.isArray(node.children) || node.children.length === 0) {
+            return this._normalizeFilterArgText(node?.text?.trim() || '');
+        }
+
+        const child = node.children[0];
+        if (!child) {
+            return this._normalizeFilterArgText(node.text?.trim() || '');
+        }
+
+        if (child.type === 'value' && Array.isArray(child.children) && child.children.length > 0) {
+            return this._extractFilterArgValue(child);
+        }
+
+        if (child.type === 'string') {
+            try {
+                return JSON.parse(child.text);
+            } catch (error) {
+                return this._normalizeFilterArgText(child.text);
+            }
+        }
+
+        if (child.type === 'number') {
+            return Number(child.text);
+        }
+
+        if (child.type === 'true') {
+            return true;
+        }
+
+        if (child.type === 'false') {
+            return false;
+        }
+
+        if (child.type === 'null') {
+            return null;
+        }
+
+        return this._normalizeFilterArgText(child.text?.trim() || node.text?.trim() || '');
+    }
+
+    _normalizeFilterArgText(text) {
+        const normalizedText = String(text).trim();
+
+        if ((normalizedText.startsWith('"') && normalizedText.endsWith('"')) || (normalizedText.startsWith("'") && normalizedText.endsWith("'"))) {
+            return normalizedText.slice(1, -1);
+        }
+
+        return normalizedText;
     }
 
     /**
@@ -229,10 +356,31 @@ class RuleTemplate {
 
         const errors = [];
         const warnings = [];
-        const extractedVars = this.extractVariables();
+        const extractedVars = this._extractTemplateVariables();
+        const seenVariables = new Set();
+        const seenFilterErrors = new Set();
         
         for (const varInfo of extractedVars) {
             const varName = varInfo.name;
+
+            for (const filter of (varInfo.filterCalls || varInfo.filters || [])) {
+                const filterName = typeof filter === 'string' ? filter : filter?.name;
+                if (filterName && TemplateFilters[filterName]) {
+                    continue;
+                }
+
+                const errorMessage = `Unknown filter '${filterName || filter}' for variable '${varName}'`;
+                if (!seenFilterErrors.has(errorMessage)) {
+                    errors.push(errorMessage);
+                    seenFilterErrors.add(errorMessage);
+                }
+            }
+
+            if (seenVariables.has(varName)) {
+                continue;
+            }
+
+            seenVariables.add(varName);
             
             // Check if variable is provided
             if (!variables.hasOwnProperty(varName)) {
@@ -262,6 +410,23 @@ class RuleTemplate {
             }
         }
 
+        const canValidatePreparedRule = errors.length === 0
+            && Array.from(seenVariables).every(varName => {
+                const varData = variables[varName];
+                return varData
+                    && typeof varData === 'object'
+                    && Object.prototype.hasOwnProperty.call(varData, 'type')
+                    && Object.prototype.hasOwnProperty.call(varData, 'value');
+            });
+
+        if (canValidatePreparedRule) {
+            try {
+                RuleParser.toAst(this.prepare(variables));
+            } catch (error) {
+                errors.push(`Prepared rule is invalid: ${error.message}`);
+            }
+        }
+
         if (functionBlob && typeof functionBlob.validate === 'function') {
             for (const functionCall of this._extractFunctionCalls()) {
                 warnings.push(...functionBlob.validate(functionCall.name, functionCall.arguments));
@@ -305,6 +470,30 @@ class RuleTemplate {
         return functionCalls;
     }
 
+    _extractTemplateVariables() {
+        const variables = [];
+
+        const traverse = (node) => {
+            if (!node) return;
+
+            if (node.type === 'template_value') {
+                const variableInfo = this._extractVariableFromNode(node);
+                if (variableInfo) {
+                    variables.push(variableInfo);
+                }
+            }
+
+            if (node.children) {
+                for (const child of node.children) {
+                    traverse(child);
+                }
+            }
+        };
+
+        traverse(this.ast);
+        return variables;
+    }
+
     /**
      * Prepare the template by replacing variables with their values
      * Rebuilds from AST by iterating through children
@@ -407,12 +596,15 @@ class RuleTemplate {
         
         // Apply filters if present
         if (templateInfo.filters && templateInfo.filters.length > 0) {
-            for (const filterName of templateInfo.filters) {
-                if (!TemplateFilters[filterName]) {
-                    throw new Error(`Unknown filter '${filterName}'`);
+            for (const filter of (templateInfo.filterCalls || templateInfo.filters)) {
+                const filterName = typeof filter === 'string' ? filter : filter?.name;
+                const filterArgs = typeof filter === 'string' ? [] : (Array.isArray(filter?.args) ? filter.args : []);
+
+                if (!filterName || !TemplateFilters[filterName]) {
+                    throw new Error(`Unknown filter '${filterName || filter}'`);
                 }
-               
-                TemplateFilters[filterName](varData);
+
+                TemplateFilters[filterName](varData, ...filterArgs);
             }
         }
 
@@ -443,12 +635,12 @@ class RuleTemplate {
             return value ? 'true' : 'false';
         }
 
-        if (type === 'time period' || type === 'time period ago') {
-            let ret = `${value.from} TO ${value.to}`;
-            if(value.ago) {
-                ret += ` AGO ${value.ago[0]} ${value.ago[1]}`;
-            }
-            return ret;
+        if (type === 'time period') {
+            return `BETWEEN ${value.from} AND ${value.to}`;
+        }
+
+        if (type === 'time period ago') {
+            return `${value.ago[0]} ${value.ago[1]} AGO BETWEEN ${value.from} AND ${value.to}`;
         }
 
         if (type === 'object' || type === 'string array' || type === 'number array' || type === 'boolean array' || type === 'object array') {

package/src/RuleTemplater.production.js

@@ -13,6 +13,7 @@ const VariableTypes = [
     'boolean',
     'object',
     'time period',
+    'time period ago',
     'time value',
     'string array',
     'number array',
@@ -25,6 +26,7 @@ const AllowedTypeMapping = {
     'number': ['number_atom', 'math_expr'],
     'boolean': ['boolean_atom', 'boolean_expr'],
     'time period': ['time_period_atom'],
+    'time period ago': ['time_period_ago_atom'],
     'time value': ['time_value_atom', 'tod_atom'],
     'string array': ['string_array'],
     'number array': ['number_array'],
@@ -44,11 +46,71 @@ for(const rule of TemplateGrammar){
     }
 }
 
-// Add template_value as an alternative to value_atom so templates can be parsed
-const valueAtomIdx = extendedGrammar.findIndex(r => r.name === 'value_atom');
-if (valueAtomIdx !== -1) {
-    extendedGrammar[valueAtomIdx].bnf.push(['template_value']);
-}
+const cloneRule = (ruleName) => {
+    const idx = extendedGrammar.findIndex(rule => rule.name === ruleName);
+    if (idx === -1) {
+        return null;
+    }
+
+    extendedGrammar[idx] = Object.assign({}, extendedGrammar[idx], {
+        bnf: extendedGrammar[idx].bnf.map(alt => Array.isArray(alt) ? alt.slice() : alt)
+    });
+
+    return extendedGrammar[idx];
+};
+
+const appendAlternative = (ruleName, alternative) => {
+    const rule = cloneRule(ruleName);
+    if (!rule) {
+        return;
+    }
+
+    const exists = rule.bnf.some(existing => JSON.stringify(existing) === JSON.stringify(alternative));
+    if (!exists) {
+        rule.bnf.push(alternative);
+    }
+};
+
+const replaceRule = (ruleName, bnf) => {
+    const idx = extendedGrammar.findIndex(rule => rule.name === ruleName);
+    if (idx === -1) {
+        extendedGrammar.push({name: ruleName, bnf});
+        return;
+    }
+
+    extendedGrammar[idx] = Object.assign({}, extendedGrammar[idx], {
+        bnf: bnf.map(alt => alt.slice())
+    });
+};
+
+appendAlternative('number_atom', ['template_value']);
+appendAlternative('number_time_atom', ['template_value', 'WS+', 'unit']);
+appendAlternative('number_time_atom', ['template_value']);
+appendAlternative('tod_atom', ['template_value']);
+appendAlternative('dow_atom', ['template_value']);
+appendAlternative('between_time_only_atom', ['template_value']);
+appendAlternative('between_tod_only_atom', ['template_value']);
+appendAlternative('string_atom', ['template_value']);
+appendAlternative('boolean_atom', ['template_value']);
+appendAlternative('time_value_atom', ['template_value']);
+appendAlternative('time_period_atom', ['template_value']);
+appendAlternative('time_period_ago_atom', ['template_value']);
+appendAlternative('object_atom', ['template_value']);
+appendAlternative('string_array', ['template_value']);
+appendAlternative('number_array', ['template_value']);
+appendAlternative('boolean_array', ['template_value']);
+appendAlternative('object_array', ['template_value']);
+
+replaceRule('argument', [
+    ['number_time_atom', 'WS*'],
+    ['statement', 'WS*']
+]);
+
+replaceRule('simple_result', [
+    ['fcall'],
+    ['number_time_atom'],
+    ['value']
+]);
 
 // Export the parser rules for potential external use
 const ParserRules = extendedGrammar;
@@ -374,6 +436,10 @@ class RuleTemplate {
             return String(value);
         } else if (type === 'boolean') {
             return value ? 'true' : 'false';
+        } else if (type === 'time period') {
+            return `BETWEEN ${value.from} AND ${value.to}`;
+        } else if (type === 'time period ago') {
+            return `${value.ago[0]} ${value.ago[1]} AGO BETWEEN ${value.from} AND ${value.to}`;
         } else {
             // Default behavior - just insert the value as-is
             return String(value);

package/src/TemplateFilters.js

@@ -2,6 +2,31 @@
 Template filters are functions that transform variable values.
 They are applied in the template syntax as ${variable|filter} or ${variable|filter1|filter2}
 */
+const HUMANISE_TIME_UNITS = [
+    { name: 'year', seconds: 31536000, aliases: ['year', 'years', 'yr', 'yrs', 'y'] },
+    { name: 'month', seconds: 2592000, aliases: ['month', 'months', 'mo', 'mos'] },
+    { name: 'week', seconds: 604800, aliases: ['week', 'weeks', 'wk', 'wks', 'w'] },
+    { name: 'day', seconds: 86400, aliases: ['day', 'days', 'd'] },
+    { name: 'hour', seconds: 3600, aliases: ['hour', 'hours', 'hr', 'hrs', 'h'] },
+    { name: 'minute', seconds: 60, aliases: ['minute', 'minutes', 'min', 'mins'] },
+    { name: 'second', seconds: 1, aliases: ['second', 'seconds', 'sec', 'secs', 's'] }
+];
+
+const getHumaniseTimeUnit = minUnit => {
+    if (minUnit === null || minUnit === undefined || minUnit === '') {
+        return null;
+    }
+
+    const normalizedMinUnit = String(minUnit).trim().toLowerCase();
+    const unit = HUMANISE_TIME_UNITS.find(candidate => candidate.aliases.includes(normalizedMinUnit));
+
+    if (!unit) {
+        throw new Error(`Unknown humanise_time min_unit \"${minUnit}\"`);
+    }
+
+    return unit;
+};
+
 const TemplateFilters = {
     // Convert value to JSON string representation
     string: varData => {
@@ -125,6 +150,69 @@ const TemplateFilters = {
 
     },
 
+    humanise_list: (varData, joiner = 'and') => {
+        if (typeof varData.value === 'string') {
+            varData.type = 'string';
+            return;
+        }
+
+        if (!Array.isArray(varData.value)) {
+            varData.value = String(varData.value);
+            varData.type = 'string';
+            return;
+        }
+
+        const items = varData.value.map(item => String(item));
+
+        if (items.length === 0) {
+            varData.value = '';
+        } else if (items.length === 1) {
+            [varData.value] = items;
+        } else if (items.length === 2) {
+            varData.value = `${items[0]} ${joiner} ${items[1]}`;
+        } else {
+            varData.value = `${items.slice(0, -1).join(', ')} ${joiner} ${items[items.length - 1]}`;
+        }
+
+        varData.type = 'string';
+
+    },
+
+    humanise_time: (varData, minUnit = null) => {
+        const rawSeconds = Number(varData.value);
+
+        if (isNaN(rawSeconds)) {
+            throw new Error(`Value "${varData.value}" cannot be converted to seconds`);
+        }
+
+        const isNegative = rawSeconds < 0;
+        const absoluteSeconds = Math.abs(rawSeconds);
+        const minimumUnit = getHumaniseTimeUnit(minUnit);
+        const minimumUnitIndex = minimumUnit
+            ? HUMANISE_TIME_UNITS.findIndex(unit => unit.name === minimumUnit.name)
+            : HUMANISE_TIME_UNITS.length - 1;
+        const candidateUnits = HUMANISE_TIME_UNITS.slice(0, minimumUnitIndex + 1);
+        let selectedUnit = candidateUnits.find(unit => absoluteSeconds % unit.seconds === 0);
+        let quantity;
+
+        if (selectedUnit) {
+            quantity = absoluteSeconds / selectedUnit.seconds;
+        } else if (minimumUnit) {
+            selectedUnit = minimumUnit;
+            quantity = Math.floor(absoluteSeconds / selectedUnit.seconds);
+        } else {
+            selectedUnit = HUMANISE_TIME_UNITS[HUMANISE_TIME_UNITS.length - 1];
+            quantity = absoluteSeconds;
+        }
+
+        const signedQuantity = isNegative ? -quantity : quantity;
+        const label = Math.abs(signedQuantity) === 1 ? selectedUnit.name : `${selectedUnit.name}s`;
+
+        varData.value = `${signedQuantity} ${label}`;
+        varData.type = 'string';
+
+    },
+
     // Extract start time from time period/time period ago as time value
     time_start: varData => {
         if (varData.type === 'time period' || varData.type === 'time period ago') {

package/src/VariableTemplate.js

@@ -37,7 +37,7 @@ class VariableTemplate {
     extractVariable() {
         return {
             name: this.variable.name,
-            filters: this.variable.filters.slice()
+            filters: this.variable.filters.map(filter => filter.name)
         };
     }
 
@@ -62,12 +62,15 @@ class VariableTemplate {
 
         varData = VariableTemplate._cloneVarData(varData);
 
-        for (const filterName of this.variable.filters) {
-            if (!TemplateFilters[filterName]) {
-                throw new Error(`Unknown filter '${filterName}'`);
+        for (const filter of this.variable.filters) {
+            const filterName = typeof filter === 'string' ? filter : filter?.name;
+            const filterArgs = typeof filter === 'string' ? [] : (Array.isArray(filter?.args) ? filter.args : []);
+
+            if (!filterName || !TemplateFilters[filterName]) {
+                throw new Error(`Unknown filter '${filterName || filter}'`);
             }
 
-            TemplateFilters[filterName](varData);
+            TemplateFilters[filterName](varData, ...filterArgs);
         }
 
         return varData;
@@ -98,7 +101,11 @@ class VariableTemplate {
                 const filterNameNode = child.children?.find(c => c.type === 'template_filter_name');
                 const filterName = filterNameNode?.text?.trim();
                 if (filterName) {
-                    filters.push(filterName);
+                    const argsNode = child.children?.find(c => c.type === 'template_filter_args');
+                    filters.push({
+                        name: filterName,
+                        args: VariableTemplate._extractFilterArgs(argsNode)
+                    });
                 }
             }
         }
@@ -121,6 +128,67 @@ class VariableTemplate {
 
         return cloned;
     }
+
+    static _extractFilterArgs(node) {
+        if (!node || !Array.isArray(node.children)) {
+            return [];
+        }
+
+        return node.children
+            .filter(child => child.type === 'template_filter_arg')
+            .map(child => VariableTemplate._extractFilterArgValue(child));
+    }
+
+    static _extractFilterArgValue(node) {
+        if (!node || !Array.isArray(node.children) || node.children.length === 0) {
+            return VariableTemplate._normalizeFilterArgText(node?.text?.trim() || '');
+        }
+
+        const child = node.children[0];
+        if (!child) {
+            return VariableTemplate._normalizeFilterArgText(node.text?.trim() || '');
+        }
+
+        if (child.type === 'value' && Array.isArray(child.children) && child.children.length > 0) {
+            return VariableTemplate._extractFilterArgValue(child);
+        }
+
+        if (child.type === 'string') {
+            try {
+                return JSON.parse(child.text);
+            } catch (error) {
+                return VariableTemplate._normalizeFilterArgText(child.text);
+            }
+        }
+
+        if (child.type === 'number') {
+            return Number(child.text);
+        }
+
+        if (child.type === 'true') {
+            return true;
+        }
+
+        if (child.type === 'false') {
+            return false;
+        }
+
+        if (child.type === 'null') {
+            return null;
+        }
+
+        return VariableTemplate._normalizeFilterArgText(child.text?.trim() || node.text?.trim() || '');
+    }
+
+    static _normalizeFilterArgText(text) {
+        const normalizedText = String(text).trim();
+
+        if ((normalizedText.startsWith('"') && normalizedText.endsWith('"')) || (normalizedText.startsWith("'") && normalizedText.endsWith("'"))) {
+            return normalizedText.slice(1, -1);
+        }
+
+        return normalizedText;
+    }
 }
 
 module.exports = VariableTemplate;

package/src/VariableValidate.js

@@ -139,12 +139,15 @@ class VariableValidate {
             throw new Error('Variable data filters must be an array');
         }
 
-        for (const filterName of normalizedVarData.filters) {
-            if (!TemplateFilters[filterName]) {
-                throw new Error(`Unknown filter '${filterName}'`);
+        for (const filter of normalizedVarData.filters) {
+            const filterName = typeof filter === 'string' ? filter : filter?.name;
+            const filterArgs = typeof filter === 'string' ? [] : (Array.isArray(filter?.args) ? filter.args : []);
+
+            if (!filterName || !TemplateFilters[filterName]) {
+                throw new Error(`Unknown filter '${filterName || filter}'`);
             }
 
-            TemplateFilters[filterName](normalizedVarData);
+            TemplateFilters[filterName](normalizedVarData, ...filterArgs);
         }
 
         return normalizedVarData;
@@ -204,7 +207,7 @@ class VariableValidate {
             return null;
         }
 
-        return `${value.from.trim()} TO ${value.to.trim()}`;
+        return `BETWEEN ${value.from.trim()} AND ${value.to.trim()}`;
     }
 
     static _serializeTimePeriodAgo(value) {
@@ -221,7 +224,7 @@ class VariableValidate {
             return null;
         }
 
-        return `${value.from.trim()} TO ${value.to.trim()} AGO ${amount} ${unit.trim()}`;
+        return `${amount} ${unit.trim()} AGO BETWEEN ${value.from.trim()} AND ${value.to.trim()}`;
     }
 
     static _serializeNumberTime(value) {
@@ -338,7 +341,7 @@ VariableValidate.validators = Object.freeze({
     'time period': (value) => VariableValidate._validateWithRule(value, 'time_period_atom', {
         normalize: VariableValidate._serializeTimePeriod,
         emptyMessage: 'Time period variables must be objects with string from/to properties',
-        parseMessage: 'Time period variables must serialize to FROM TO TO syntax',
+        parseMessage: 'Time period variables must serialize to BETWEEN FROM AND TO syntax',
         semanticCheck: (rawValue) => {
             const fromError = VariableValidate._validateTimeOfDay(rawValue?.from);
             if (fromError) return `Invalid time period from value: ${fromError}`;
@@ -352,7 +355,7 @@ VariableValidate.validators = Object.freeze({
     'time period ago': (value) => VariableValidate._validateWithRule(value, 'time_period_ago_atom', {
         normalize: VariableValidate._serializeTimePeriodAgo,
         emptyMessage: 'Time period ago variables must be objects with from, to, and ago properties',
-        parseMessage: 'Time period ago variables must serialize to FROM TO TO AGO AMOUNT UNIT syntax',
+        parseMessage: 'Time period ago variables must serialize to AMOUNT UNIT AGO BETWEEN FROM AND TO syntax',
         semanticCheck: (rawValue) => {
             const fromError = VariableValidate._validateTimeOfDay(rawValue?.from);
             if (fromError) return `Invalid time period ago from value: ${fromError}`;