@sowonai/crewx-sdk 0.1.0-dev.4 → 0.1.0-dev.6

package/dist/services/props-validator.service.js

@@ -0,0 +1,332 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PropsValidator = void 0;
+const layout_types_1 = require("../types/layout.types");
+class PropsValidator {
+    constructor(options = {}) {
+        this.defaultMode = options.defaultMode ?? 'lenient';
+    }
+    validate(props, schema, mode = this.defaultMode) {
+        const errors = [];
+        const resolvedProps = this.validateObject(props ?? {}, schema, mode, ['props'], errors);
+        if (errors.length > 0 && mode === 'strict') {
+            throw new layout_types_1.PropsValidationError('Props validation failed in strict mode', errors);
+        }
+        return {
+            valid: errors.length === 0,
+            props: resolvedProps,
+            errors,
+        };
+    }
+    validateObject(provided, schema, mode, pathSegments, errors) {
+        const sanitized = {};
+        if (mode === 'strict') {
+            for (const key of Object.keys(provided)) {
+                if (!schema[key]) {
+                    errors.push({
+                        path: this.buildPath([...pathSegments, key]),
+                        message: `Unknown prop '${key}'`,
+                        value: provided[key],
+                    });
+                }
+            }
+        }
+        for (const [key, propSchema] of Object.entries(schema)) {
+            const fullPath = [...pathSegments, key];
+            const rawValue = provided[key];
+            const result = this.resolveProp(rawValue, propSchema, fullPath, mode, errors);
+            if (result.shouldAssign) {
+                sanitized[key] = result.value;
+            }
+        }
+        if (mode === 'lenient') {
+        }
+        else if (mode === 'strict') {
+        }
+        return sanitized;
+    }
+    resolveProp(value, schema, pathSegments, mode, errors) {
+        const path = this.buildPath(pathSegments);
+        if (this.isNil(value)) {
+            if (schema.isRequired) {
+                errors.push({
+                    path,
+                    message: `Required prop '${pathSegments[pathSegments.length - 1]}' is missing`,
+                });
+            }
+            if (schema.defaultValue !== undefined) {
+                return { shouldAssign: true, value: this.cloneValue(schema.defaultValue) };
+            }
+            if (schema.type === 'shape' && schema.shape) {
+                const nestedDefaults = this.applyDefaults(schema.shape);
+                if (Object.keys(nestedDefaults).length > 0) {
+                    return { shouldAssign: true, value: nestedDefaults };
+                }
+            }
+            return { shouldAssign: false };
+        }
+        const typeResult = this.validateType(value, schema, pathSegments, mode, errors);
+        if (!typeResult.valid) {
+            if (schema.type === 'shape' &&
+                typeResult.value &&
+                this.isPlainObject(typeResult.value)) {
+                return { shouldAssign: true, value: typeResult.value };
+            }
+            errors.push({ path, message: typeResult.error ?? 'Invalid value', value });
+            if (schema.defaultValue !== undefined) {
+                return { shouldAssign: true, value: this.cloneValue(schema.defaultValue) };
+            }
+            if (schema.type === 'shape' && schema.shape) {
+                const nestedDefaults = this.applyDefaults(schema.shape);
+                if (Object.keys(nestedDefaults).length > 0) {
+                    return { shouldAssign: true, value: nestedDefaults };
+                }
+            }
+            return { shouldAssign: false };
+        }
+        return { shouldAssign: true, value: typeResult.value };
+    }
+    validateType(value, schema, pathSegments, mode, errors) {
+        const { type } = schema;
+        switch (type) {
+            case 'string':
+                return this.validateString(value, schema);
+            case 'number':
+                return this.validateNumber(value, schema);
+            case 'bool':
+                return this.validateBoolean(value);
+            case 'array':
+                return this.validateArray(value, schema);
+            case 'arrayOf':
+                return this.validateArrayOf(value, schema, pathSegments, mode, errors);
+            case 'object':
+                return this.validatePlainObject(value);
+            case 'shape':
+                return this.validateShape(value, schema, pathSegments, mode, errors);
+            case 'oneOfType':
+                return this.validateOneOfType(value, schema);
+            case 'func':
+                return this.validateFunction(value);
+            case 'node':
+                return { valid: true, value };
+            default:
+                return { valid: true, value };
+        }
+    }
+    validateString(value, schema) {
+        if (typeof value !== 'string') {
+            return { valid: false, error: `Expected string, got ${this.describeType(value)}` };
+        }
+        if (schema.oneOf && !schema.oneOf.includes(value)) {
+            return {
+                valid: false,
+                error: `Expected one of: ${schema.oneOf.join(', ')}`,
+            };
+        }
+        if (schema.minLength !== undefined && value.length < schema.minLength) {
+            return {
+                valid: false,
+                error: `String length must be >= ${schema.minLength}`,
+            };
+        }
+        if (schema.maxLength !== undefined && value.length > schema.maxLength) {
+            return {
+                valid: false,
+                error: `String length must be <= ${schema.maxLength}`,
+            };
+        }
+        if (schema.pattern) {
+            const pattern = new RegExp(schema.pattern);
+            if (!pattern.test(value)) {
+                return {
+                    valid: false,
+                    error: `String does not match pattern ${schema.pattern}`,
+                };
+            }
+        }
+        return { valid: true, value };
+    }
+    validateNumber(value, schema) {
+        if (typeof value !== 'number' || Number.isNaN(value)) {
+            return { valid: false, error: `Expected number, got ${this.describeType(value)}` };
+        }
+        if (schema.min !== undefined && value < schema.min) {
+            return { valid: false, error: `Number must be >= ${schema.min}` };
+        }
+        if (schema.max !== undefined && value > schema.max) {
+            return { valid: false, error: `Number must be <= ${schema.max}` };
+        }
+        if (schema.oneOf && !schema.oneOf.includes(value)) {
+            return {
+                valid: false,
+                error: `Expected one of: ${schema.oneOf.join(', ')}`,
+            };
+        }
+        return { valid: true, value };
+    }
+    validateBoolean(value) {
+        if (typeof value !== 'boolean') {
+            return { valid: false, error: `Expected boolean, got ${this.describeType(value)}` };
+        }
+        return { valid: true, value };
+    }
+    validateArray(value, schema) {
+        if (!Array.isArray(value)) {
+            return { valid: false, error: `Expected array, got ${this.describeType(value)}` };
+        }
+        if (schema.minLength !== undefined && value.length < schema.minLength) {
+            return {
+                valid: false,
+                error: `Array length must be >= ${schema.minLength}`,
+            };
+        }
+        if (schema.maxLength !== undefined && value.length > schema.maxLength) {
+            return {
+                valid: false,
+                error: `Array length must be <= ${schema.maxLength}`,
+            };
+        }
+        return { valid: true, value: [...value] };
+    }
+    validateArrayOf(value, schema, pathSegments, mode, errors) {
+        const base = this.validateArray(value, schema);
+        if (!base.valid) {
+            return base;
+        }
+        const itemValues = [];
+        const itemType = schema.itemType;
+        const itemOneOf = schema.itemOneOf;
+        const beforeErrors = errors.length;
+        base.value.forEach((item, index) => {
+            const itemPath = [...pathSegments, String(index)];
+            if (itemType) {
+                const result = this.validateType(item, { type: itemType }, itemPath, mode, errors);
+                if (!result.valid) {
+                    errors.push({
+                        path: this.buildPath(itemPath),
+                        message: result.error ?? 'Invalid array item',
+                        value: item,
+                    });
+                }
+                else {
+                    itemValues.push(result.value);
+                }
+            }
+            else {
+                itemValues.push(item);
+            }
+            if (itemOneOf && !itemOneOf.includes(item)) {
+                errors.push({
+                    path: this.buildPath(itemPath),
+                    message: `Array item must be one of: ${itemOneOf.join(', ')}`,
+                    value: item,
+                });
+            }
+        });
+        return { valid: errors.length === beforeErrors, value: itemValues };
+    }
+    validatePlainObject(value) {
+        if (!this.isPlainObject(value)) {
+            return { valid: false, error: `Expected object, got ${this.describeType(value)}` };
+        }
+        return { valid: true, value: { ...value } };
+    }
+    validateFunction(value) {
+        if (typeof value !== 'function') {
+            return { valid: false, error: `Expected function, got ${this.describeType(value)}` };
+        }
+        return { valid: true, value };
+    }
+    validateShape(value, schema, pathSegments, mode, errors) {
+        if (!this.isPlainObject(value)) {
+            return { valid: false, error: `Expected object, got ${this.describeType(value)}` };
+        }
+        const beforeErrors = errors.length;
+        const nested = this.validateObject(value, schema.shape ?? {}, mode, pathSegments, errors);
+        return { valid: errors.length === beforeErrors, value: nested };
+    }
+    validateOneOfType(value, schema) {
+        const types = schema.types ?? [];
+        const matches = types.some(typeName => this.matchesType(value, typeName));
+        if (!matches) {
+            return {
+                valid: false,
+                error: `Value does not match any allowed type: ${types.join(', ')}`,
+            };
+        }
+        return { valid: true, value };
+    }
+    matchesType(value, typeName) {
+        switch (typeName) {
+            case 'string':
+                return typeof value === 'string';
+            case 'number':
+                return typeof value === 'number' && !Number.isNaN(value);
+            case 'bool':
+            case 'boolean':
+                return typeof value === 'boolean';
+            case 'array':
+                return Array.isArray(value);
+            case 'object':
+                return this.isPlainObject(value);
+            case 'func':
+            case 'function':
+                return typeof value === 'function';
+            case 'shape':
+                return this.isPlainObject(value);
+            case 'node':
+                return value === null || value === undefined || typeof value !== 'symbol';
+            default:
+                return true;
+        }
+    }
+    applyDefaults(schema) {
+        const defaults = {};
+        for (const [key, propSchema] of Object.entries(schema)) {
+            if (propSchema.defaultValue !== undefined) {
+                defaults[key] = this.cloneValue(propSchema.defaultValue);
+                continue;
+            }
+            if (propSchema.type === 'shape' && propSchema.shape) {
+                const nestedDefaults = this.applyDefaults(propSchema.shape);
+                if (Object.keys(nestedDefaults).length > 0) {
+                    defaults[key] = nestedDefaults;
+                }
+            }
+        }
+        return defaults;
+    }
+    cloneValue(value) {
+        if (Array.isArray(value)) {
+            return value.map(item => this.cloneValue(item));
+        }
+        if (this.isPlainObject(value)) {
+            const cloned = {};
+            for (const [key, nested] of Object.entries(value)) {
+                cloned[key] = this.cloneValue(nested);
+            }
+            return cloned;
+        }
+        return value;
+    }
+    isPlainObject(value) {
+        return typeof value === 'object' && value !== null && !Array.isArray(value);
+    }
+    isNil(value) {
+        return value === null || value === undefined;
+    }
+    buildPath(segments) {
+        return segments.join('.');
+    }
+    describeType(value) {
+        if (Array.isArray(value)) {
+            return 'array';
+        }
+        if (value === null) {
+            return 'null';
+        }
+        return typeof value;
+    }
+}
+exports.PropsValidator = PropsValidator;
+//# sourceMappingURL=props-validator.service.js.map

package/dist/services/props-validator.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"props-validator.service.js","sourceRoot":"","sources":["../../src/services/props-validator.service.ts"],"names":[],"mappings":";;;AAAA,wDAK+B;AAc/B,MAAa,cAAc;IAGzB,YAAY,UAAiC,EAAE;QAC7C,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,SAAS,CAAC;IACtD,CAAC;IAED,QAAQ,CACN,KAAsC,EACtC,MAAkC,EAClC,OAAuB,IAAI,CAAC,WAAW;QAEvC,MAAM,MAAM,GAAsB,EAAE,CAAC;QACrC,MAAM,aAAa,GAAG,IAAI,CAAC,cAAc,CACvC,KAAK,IAAI,EAAE,EACX,MAAM,EACN,IAAI,EACJ,CAAC,OAAO,CAAC,EACT,MAAM,CACP,CAAC;QAEF,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC3C,MAAM,IAAI,mCAAoB,CAAC,wCAAwC,EAAE,MAAM,CAAC,CAAC;QACnF,CAAC;QAED,OAAO;YACL,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;YAC1B,KAAK,EAAE,aAAa;YACpB,MAAM;SACP,CAAC;IACJ,CAAC;IAEO,cAAc,CACpB,QAA6B,EAC7B,MAAkC,EAClC,IAAoB,EACpB,YAAsB,EACtB,MAAyB;QAEzB,MAAM,SAAS,GAAwB,EAAE,CAAC;QAG1C,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtB,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACxC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;oBACjB,MAAM,CAAC,IAAI,CAAC;wBACV,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,YAAY,EAAE,GAAG,CAAC,CAAC;wBAC5C,OAAO,EAAE,iBAAiB,GAAG,GAAG;wBAChC,KAAK,EAAE,QAAQ,CAAC,GAAG,CAAC;qBACrB,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;QAED,KAAK,MAAM,CAAC,GAAG,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACvD,MAAM,QAAQ,GAAG,CAAC,GAAG,YAAY,EAAE,GAAG,CAAC,CAAC;YACxC,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;YAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;YAE9E,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;gBACxB,SAAS,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC;YAChC,CAAC;QACH,CAAC;QAED,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QAGzB,CAAC;aAAM,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QAE/B,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAEO,WAAW,CACjB,KAAU,EACV,MAAkB,EAClB,YAAsB,EACtB,IAAoB,EACpB,MAAyB;QAEzB,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QAE1C,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;YACtB,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;gBACtB,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI;oBACJ,OAAO,EAAE,kBAAkB,YAAY,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,cAAc;iBAC/E,CAAC,CAAC;YACL,CAAC;YAED,IAAI,MAAM,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;gBACtC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;YAC7E,CAAC;YAED,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;gBAC5C,MAAM,cAAc,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACxD,IAAI,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC3C,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC;gBACvD,CAAC;YACH,CAAC;YAED,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC;QACjC,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QAEhF,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;YACtB,IACE,MAAM,CAAC,IAAI,KAAK,OAAO;gBACvB,UAAU,CAAC,KAAK;gBAChB,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,KAAK,CAAC,EACpC,CAAC;gBAED,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,CAAC;YACzD,CAAC;YAED,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,CAAC,KAAK,IAAI,eAAe,EAAE,KAAK,EAAE,CAAC,CAAC;YAE3E,IAAI,MAAM,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;gBACtC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;YAC7E,CAAC;YAED,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;gBAC5C,MAAM,cAAc,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACxD,IAAI,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC3C,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC;gBACvD,CAAC;YACH,CAAC;YAED,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC;QACjC,CAAC;QAED,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,CAAC;IACzD,CAAC;IAEO,YAAY,CAClB,KAAU,EACV,MAAkB,EAClB,YAAsB,EACtB,IAAoB,EACpB,MAAyB;QAEzB,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC;QAExB,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,QAAQ;gBACX,OAAO,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YAC5C,KAAK,QAAQ;gBACX,OAAO,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YAC5C,KAAK,MAAM;gBACT,OAAO,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;YACrC,KAAK,OAAO;gBACV,OAAO,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YAC3C,KAAK,SAAS;gBACZ,OAAO,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;YACzE,KAAK,QAAQ;gBACX,OAAO,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC;YACzC,KAAK,OAAO;gBACV,OAAO,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;YACvE,KAAK,WAAW;gBACd,OAAO,IAAI,CAAC,iBAAiB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YAC/C,KAAK,MAAM;gBACT,OAAO,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;YACtC,KAAK,MAAM;gBACT,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;YAChC;gBACE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;QAClC,CAAC;IACH,CAAC;IAEO,cAAc,CAAC,KAAU,EAAE,MAAkB;QACnD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,wBAAwB,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;QACrF,CAAC;QAED,IAAI,MAAM,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAClD,OAAO;gBACL,KAAK,EAAE,KAAK;gBACZ,KAAK,EAAE,oBAAoB,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;aACrD,CAAC;QACJ,CAAC;QAED,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;YACtE,OAAO;gBACL,KAAK,EAAE,KAAK;gBACZ,KAAK,EAAE,4BAA4B,MAAM,CAAC,SAAS,EAAE;aACtD,CAAC;QACJ,CAAC;QAED,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;YACtE,OAAO;gBACL,KAAK,EAAE,KAAK;gBACZ,KAAK,EAAE,4BAA4B,MAAM,CAAC,SAAS,EAAE;aACtD,CAAC;QACJ,CAAC;QAED,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,MAAM,OAAO,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAC3C,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;gBACzB,OAAO;oBACL,KAAK,EAAE,KAAK;oBACZ,KAAK,EAAE,iCAAiC,MAAM,CAAC,OAAO,EAAE;iBACzD,CAAC;YACJ,CAAC;QACH,CAAC;QAED,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IAChC,CAAC;IAEO,cAAc,CAAC,KAAU,EAAE,MAAkB;QACnD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;YACrD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,wBAAwB,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;QACrF,CAAC;QAED,IAAI,MAAM,CAAC,GAAG,KAAK,SAAS,IAAI,KAAK,GAAG,MAAM,CAAC,GAAG,EAAE,CAAC;YACnD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,qBAAqB,MAAM,CAAC,GAAG,EAAE,EAAE,CAAC;QACpE,CAAC;QAED,IAAI,MAAM,CAAC,GAAG,KAAK,SAAS,IAAI,KAAK,GAAG,MAAM,CAAC,GAAG,EAAE,CAAC;YACnD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,qBAAqB,MAAM,CAAC,GAAG,EAAE,EAAE,CAAC;QACpE,CAAC;QAED,IAAI,MAAM,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAClD,OAAO;gBACL,KAAK,EAAE,KAAK;gBACZ,KAAK,EAAE,oBAAoB,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;aACrD,CAAC;QACJ,CAAC;QAED,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IAChC,CAAC;IAEO,eAAe,CAAC,KAAU;QAChC,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;YAC/B,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,yBAAyB,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;QACtF,CAAC;QAED,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IAChC,CAAC;IAEO,aAAa,CAAC,KAAU,EAAE,MAAkB;QAClD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,uBAAuB,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;QACpF,CAAC;QAED,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;YACtE,OAAO;gBACL,KAAK,EAAE,KAAK;gBACZ,KAAK,EAAE,2BAA2B,MAAM,CAAC,SAAS,EAAE;aACrD,CAAC;QACJ,CAAC;QAED,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;YACtE,OAAO;gBACL,KAAK,EAAE,KAAK;gBACZ,KAAK,EAAE,2BAA2B,MAAM,CAAC,SAAS,EAAE;aACrD,CAAC;QACJ,CAAC;QAED,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,GAAG,KAAK,CAAC,EAAE,CAAC;IAC5C,CAAC;IAEO,eAAe,CACrB,KAAU,EACV,MAAkB,EAClB,YAAsB,EACtB,IAAoB,EACpB,MAAyB;QAEzB,MAAM,IAAI,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAC/C,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAChB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,UAAU,GAAU,EAAE,CAAC;QAC7B,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;QACjC,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;QACnC,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC;QAEnC,IAAI,CAAC,KAAM,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;YAClC,MAAM,QAAQ,GAAG,CAAC,GAAG,YAAY,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAElD,IAAI,QAAQ,EAAE,CAAC;gBACb,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAgB,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;gBACjG,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;oBAClB,MAAM,CAAC,IAAI,CAAC;wBACV,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC;wBAC9B,OAAO,EAAE,MAAM,CAAC,KAAK,IAAI,oBAAoB;wBAC7C,KAAK,EAAE,IAAI;qBACZ,CAAC,CAAC;gBACL,CAAC;qBAAM,CAAC;oBACN,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBAChC,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACxB,CAAC;YAED,IAAI,SAAS,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC3C,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC;oBAC9B,OAAO,EAAE,8BAA8B,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;oBAC7D,KAAK,EAAE,IAAI;iBACZ,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;IACtE,CAAC;IAEO,mBAAmB,CAAC,KAAU;QACpC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;YAC/B,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,wBAAwB,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;QACrF,CAAC;QAED,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,GAAG,KAAK,EAAE,EAAE,CAAC;IAC9C,CAAC;IAEO,gBAAgB,CAAC,KAAU;QACjC,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;YAChC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,0BAA0B,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;QACvF,CAAC;QAED,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IAChC,CAAC;IAEO,aAAa,CACnB,KAAU,EACV,MAAkB,EAClB,YAAsB,EACtB,IAAoB,EACpB,MAAyB;QAEzB,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;YAC/B,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,wBAAwB,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;QACrF,CAAC;QAED,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC;QACnC,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc,CAChC,KAAK,EACL,MAAM,CAAC,KAAK,IAAI,EAAE,EAClB,IAAI,EACJ,YAAY,EACZ,MAAM,CACP,CAAC;QAEF,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAClE,CAAC;IAEO,iBAAiB,CAAC,KAAU,EAAE,MAAkB;QACtD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;QAEjC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC;QAE1E,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO;gBACL,KAAK,EAAE,KAAK;gBACZ,KAAK,EAAE,0CAA0C,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;aACpE,CAAC;QACJ,CAAC;QAED,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IAChC,CAAC;IAEO,WAAW,CAAC,KAAU,EAAE,QAAgB;QAC9C,QAAQ,QAAQ,EAAE,CAAC;YACjB,KAAK,QAAQ;gBACX,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;YACnC,KAAK,QAAQ;gBACX,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC3D,KAAK,MAAM,CAAC;YACZ,KAAK,SAAS;gBACZ,OAAO,OAAO,KAAK,KAAK,SAAS,CAAC;YACpC,KAAK,OAAO;gBACV,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAC9B,KAAK,QAAQ;gBACX,OAAO,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;YACnC,KAAK,MAAM,CAAC;YACZ,KAAK,UAAU;gBACb,OAAO,OAAO,KAAK,KAAK,UAAU,CAAC;YACrC,KAAK,OAAO;gBACV,OAAO,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;YACnC,KAAK,MAAM;gBACT,OAAO,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC;YAC5E;gBACE,OAAO,IAAI,CAAC;QAChB,CAAC;IACH,CAAC;IAEO,aAAa,CAAC,MAAkC;QACtD,MAAM,QAAQ,GAAwB,EAAE,CAAC;QAEzC,KAAK,MAAM,CAAC,GAAG,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACvD,IAAI,UAAU,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;gBAC1C,QAAQ,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;gBACzD,SAAS;YACX,CAAC;YAED,IAAI,UAAU,CAAC,IAAI,KAAK,OAAO,IAAI,UAAU,CAAC,KAAK,EAAE,CAAC;gBACpD,MAAM,cAAc,GAAG,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;gBAC5D,IAAI,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC3C,QAAQ,CAAC,GAAG,CAAC,GAAG,cAAc,CAAC;gBACjC,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAEO,UAAU,CAAI,KAAQ;QAC5B,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAiB,CAAC;QAClE,CAAC;QAED,IAAI,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9B,MAAM,MAAM,GAAwB,EAAE,CAAC;YACvC,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAA4B,CAAC,EAAE,CAAC;gBACzE,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;YACxC,CAAC;YACD,OAAO,MAAW,CAAC;QACrB,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,aAAa,CAAC,KAAU;QAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC9E,CAAC;IAEO,KAAK,CAAC,KAAU;QACtB,OAAO,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,CAAC;IAC/C,CAAC;IAEO,SAAS,CAAC,QAAkB;QAClC,OAAO,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;IAEO,YAAY,CAAC,KAAU;QAC7B,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACnB,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,OAAO,OAAO,KAAK,CAAC;IACtB,CAAC;CACF;AAhcD,wCAgcC"}

package/dist/types/agent.types.d.ts

@@ -110,8 +110,13 @@ export interface AgentInfo {
     inline?: {
         type: 'agent';
         provider: 'claude' | 'gemini' | 'copilot';
-        system_prompt: string;
+        system_prompt?: string;
+        prompt?: string;
         model?: string;
+        layout?: string | {
+            id: string;
+            props?: Record<string, any>;
+        };
     };
     remote?: RemoteAgentInfo;
 }

package/dist/types/layout.types.d.ts

@@ -0,0 +1,77 @@
+export interface PropSchema {
+    type: 'string' | 'number' | 'bool' | 'array' | 'arrayOf' | 'object' | 'shape' | 'oneOfType' | 'func' | 'node';
+    isRequired?: boolean;
+    defaultValue?: any;
+    oneOf?: any[];
+    min?: number;
+    max?: number;
+    minLength?: number;
+    maxLength?: number;
+    itemType?: string;
+    itemOneOf?: any[];
+    shape?: Record<string, PropSchema>;
+    types?: string[];
+    pattern?: string;
+    description?: string;
+}
+export interface LayoutDefinition {
+    id: string;
+    version: string;
+    description: string;
+    template: string;
+    propsSchema: Record<string, PropSchema>;
+    defaultProps: Record<string, any>;
+}
+export type InlineLayoutSpec = string | {
+    id: string;
+    props?: Record<string, any>;
+};
+export interface ValidationResult {
+    valid: boolean;
+    props: Record<string, any>;
+    errors: ValidationError[];
+}
+export interface ValidationError {
+    path: string;
+    message: string;
+    value?: any;
+}
+export interface LoaderOptions {
+    templatesPath: string;
+    validationMode?: 'strict' | 'lenient';
+    fallbackLayoutId?: string;
+}
+export interface RenderContext {
+    agent: {
+        id: string;
+        name: string;
+        inline: {
+            prompt: string;
+        };
+    };
+    documents: Record<string, {
+        content: string;
+        toc?: string;
+        summary?: string;
+    }>;
+    vars: Record<string, any>;
+    props: Record<string, any>;
+}
+export interface RawLayoutYaml {
+    id?: string;
+    version?: string;
+    description?: string;
+    propsSchema?: Record<string, any>;
+    template?: string;
+    layouts?: Record<string, string>;
+}
+export declare class LayoutLoadError extends Error {
+    readonly layoutId?: string | undefined;
+    readonly cause?: Error | undefined;
+    constructor(message: string, layoutId?: string | undefined, cause?: Error | undefined);
+}
+export declare class PropsValidationError extends Error {
+    readonly errors: ValidationError[];
+    readonly cause?: Error | undefined;
+    constructor(message: string, errors?: ValidationError[], cause?: Error | undefined);
+}

package/dist/types/layout.types.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PropsValidationError = exports.LayoutLoadError = void 0;
+class LayoutLoadError extends Error {
+    constructor(message, layoutId, cause) {
+        super(message);
+        this.layoutId = layoutId;
+        this.cause = cause;
+        this.name = 'LayoutLoadError';
+    }
+}
+exports.LayoutLoadError = LayoutLoadError;
+class PropsValidationError extends Error {
+    constructor(message, errors = [], cause) {
+        super(message);
+        this.errors = errors;
+        this.cause = cause;
+        this.name = 'PropsValidationError';
+    }
+}
+exports.PropsValidationError = PropsValidationError;
+//# sourceMappingURL=layout.types.js.map

package/dist/types/layout.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.types.js","sourceRoot":"","sources":["../../src/types/layout.types.ts"],"names":[],"mappings":";;;AAqHA,MAAa,eAAgB,SAAQ,KAAK;IACxC,YAAY,OAAe,EAAkB,QAAiB,EAAkB,KAAa;QAC3F,KAAK,CAAC,OAAO,CAAC,CAAC;QAD4B,aAAQ,GAAR,QAAQ,CAAS;QAAkB,UAAK,GAAL,KAAK,CAAQ;QAE3F,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AALD,0CAKC;AAKD,MAAa,oBAAqB,SAAQ,KAAK;IAC7C,YACE,OAAe,EACC,SAA4B,EAAE,EAC9B,KAAa;QAE7B,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,WAAM,GAAN,MAAM,CAAwB;QAC9B,UAAK,GAAL,KAAK,CAAQ;QAG7B,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AATD,oDASC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sowonai/crewx-sdk",
-  "version": "0.1.0-dev.4",
+  "version": "0.1.0-dev.6",
   "license": "Apache-2.0",
   "description": "SowonAI CrewX SDK",
   "type": "commonjs",