@crewx/sdk 0.8.0-rc.58

package/dist/services/layout-loader.service.js

@@ -0,0 +1,271 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LayoutLoader = void 0;
+const fs_1 = require("fs");
+const path = __importStar(require("path"));
+const js_yaml_1 = require("js-yaml");
+const layout_types_1 = require("../types/layout.types");
+const DEFAULT_OPTIONS = {
+    templatesPath: path.join(__dirname, '../../../templates/agents'),
+    validationMode: 'lenient',
+    fallbackLayoutId: 'crewx/default',
+};
+class LayoutLoader {
+    constructor(options) {
+        this.layouts = new Map();
+        this.options = { ...DEFAULT_OPTIONS, ...options };
+        this.loadAllLayouts();
+    }
+    load(layoutId, propsOverride) {
+        let layout = this.layouts.get(layoutId);
+        if (!layout) {
+            const normalizedId = this.normalizeLayoutId(layoutId);
+            layout = this.layouts.get(normalizedId);
+        }
+        if (!layout) {
+            console.warn(`Layout not found: ${layoutId}, falling back to ${this.options.fallbackLayoutId}`);
+            layout = this.layouts.get(this.options.fallbackLayoutId);
+            if (!layout) {
+                throw new layout_types_1.LayoutLoadError(`Fallback layout not found: ${this.options.fallbackLayoutId}`, this.options.fallbackLayoutId);
+            }
+        }
+        if (propsOverride && Object.keys(propsOverride).length > 0) {
+            return {
+                ...layout,
+                defaultProps: { ...layout.defaultProps, ...propsOverride },
+            };
+        }
+        return layout;
+    }
+    getLayoutIds() {
+        return Array.from(this.layouts.keys());
+    }
+    hasLayout(layoutId) {
+        if (this.layouts.has(layoutId)) {
+            return true;
+        }
+        const normalizedId = this.normalizeLayoutId(layoutId);
+        return this.layouts.has(normalizedId);
+    }
+    reload() {
+        this.layouts.clear();
+        this.loadAllLayouts();
+    }
+    loadAllLayouts() {
+        const layoutsDir = this.options.templatesPath;
+        if (!(0, fs_1.existsSync)(layoutsDir)) {
+            throw new layout_types_1.LayoutLoadError(`Templates directory not found: ${layoutsDir}`, undefined, new Error(`Directory does not exist: ${layoutsDir}`));
+        }
+        try {
+            const files = (0, fs_1.readdirSync)(layoutsDir).filter(f => f.endsWith('.yaml') || f.endsWith('.yml'));
+            if (files.length === 0) {
+                console.warn(`No layout files found in ${layoutsDir}`);
+            }
+            for (const file of files) {
+                const layoutName = file.replace(/\.(yaml|yml)$/, '');
+                const layoutPath = path.join(layoutsDir, file);
+                try {
+                    const layout = this.loadLayoutFile(layoutPath, layoutName);
+                    const layoutId = `crewx/${layoutName}`;
+                    this.layouts.set(layoutId, layout);
+                    if (layoutId !== 'crewx/minimal') {
+                        console.log(`Loaded layout: ${layoutId} from ${file}`);
+                    }
+                }
+                catch (error) {
+                    console.error(`Failed to load layout file ${file}:`, error);
+                }
+            }
+            console.log(`Loaded ${this.layouts.size} layouts from ${layoutsDir}`);
+        }
+        catch (error) {
+            throw new layout_types_1.LayoutLoadError(`Failed to read layouts directory: ${layoutsDir}`, undefined, error instanceof Error ? error : new Error(String(error)));
+        }
+    }
+    loadLayoutFile(filePath, layoutName) {
+        try {
+            const content = (0, fs_1.readFileSync)(filePath, 'utf-8');
+            if (!content || content.trim().length === 0) {
+                console.warn(`Empty YAML file: ${filePath}, will use fallback`);
+                throw new layout_types_1.LayoutLoadError(`Empty YAML file: ${filePath}`, layoutName, new Error('File content is empty'));
+            }
+            const parsed = (0, js_yaml_1.load)(content);
+            if (!parsed || typeof parsed !== 'object') {
+                console.warn(`Invalid YAML content in ${filePath} (parsed as ${typeof parsed}), will use fallback`);
+                throw new layout_types_1.LayoutLoadError(`Invalid or empty YAML in ${filePath}`, layoutName, new Error('YAML parsing returned null/undefined or non-object'));
+            }
+            if (parsed.layouts && typeof parsed.layouts === 'object') {
+                const layoutTemplate = this.resolveLayoutTemplate(parsed.layouts, layoutName);
+                if (!layoutTemplate || (typeof layoutTemplate === 'string' && layoutTemplate.trim().length === 0)) {
+                    console.warn(`Empty or missing layout template in ${filePath} for ${layoutName}`);
+                    throw new layout_types_1.LayoutLoadError(`Layout template not found or empty in layouts map: ${layoutName}`, layoutName);
+                }
+                return {
+                    id: `crewx/${layoutName}`,
+                    version: parsed.version || '1.0.0',
+                    description: parsed.description || `CrewX ${layoutName} layout`,
+                    template: layoutTemplate,
+                    propsSchema: this.parsePropsSchema(parsed.propsSchema || {}),
+                    defaultProps: this.extractDefaultProps(parsed.propsSchema || {}),
+                };
+            }
+            else {
+                if (!parsed.template || (typeof parsed.template === 'string' && parsed.template.trim().length === 0)) {
+                    console.warn(`Empty or missing template field in ${filePath}`);
+                    throw new layout_types_1.LayoutLoadError(`Layout template is missing or empty in ${filePath}`, layoutName);
+                }
+                return {
+                    id: parsed.id || `crewx/${layoutName}`,
+                    version: parsed.version || '1.0.0',
+                    description: parsed.description || '',
+                    template: parsed.template,
+                    propsSchema: this.parsePropsSchema(parsed.propsSchema || {}),
+                    defaultProps: this.extractDefaultProps(parsed.propsSchema || {}),
+                };
+            }
+        }
+        catch (error) {
+            throw new layout_types_1.LayoutLoadError(`Failed to load layout file: ${filePath}`, layoutName, error instanceof Error ? error : new Error(String(error)));
+        }
+    }
+    parsePropsSchema(raw) {
+        const schema = {};
+        for (const [key, value] of Object.entries(raw)) {
+            if (typeof value === 'object' && value !== null) {
+                schema[key] = value;
+            }
+        }
+        return schema;
+    }
+    extractDefaultProps(propsSchema) {
+        const defaults = {};
+        for (const [key, schema] of Object.entries(propsSchema)) {
+            if (schema && typeof schema === 'object') {
+                if ('defaultValue' in schema) {
+                    defaults[key] = schema.defaultValue;
+                }
+                else if ('default' in schema) {
+                    defaults[key] = schema.default;
+                }
+            }
+        }
+        return defaults;
+    }
+    normalizeLayoutId(layoutId) {
+        if (!layoutId) {
+            return this.options.fallbackLayoutId;
+        }
+        if (layoutId.includes('/')) {
+            return layoutId;
+        }
+        return `crewx/${layoutId}`;
+    }
+    registerLayout(layoutId, layoutConfig) {
+        if (!layoutId || typeof layoutId !== 'string') {
+            throw new layout_types_1.LayoutLoadError('Layout ID must be a non-empty string', layoutId);
+        }
+        const config = typeof layoutConfig === 'string'
+            ? { template: layoutConfig }
+            : layoutConfig;
+        const template = typeof config.template === 'string' ? config.template : '';
+        if (!template || template.trim().length === 0) {
+            throw new layout_types_1.LayoutLoadError(`Custom layout template is empty for ${layoutId}`, layoutId);
+        }
+        const propsSchemaRaw = config.propsSchema || {};
+        const defaultPropsFromSchema = this.extractDefaultProps(propsSchemaRaw);
+        const explicitDefaults = config.defaultProps || {};
+        const layoutDefinition = {
+            id: layoutId,
+            version: config.version || '1.0.0',
+            description: config.description || `Custom layout ${layoutId}`,
+            template,
+            propsSchema: this.parsePropsSchema(propsSchemaRaw),
+            defaultProps: { ...defaultPropsFromSchema, ...explicitDefaults },
+        };
+        const existingLayout = this.layouts.get(layoutId);
+        const templatesEqual = existingLayout?.template === template &&
+            JSON.stringify(existingLayout?.defaultProps ?? {}) === JSON.stringify(layoutDefinition.defaultProps ?? {}) &&
+            JSON.stringify(existingLayout?.propsSchema ?? {}) === JSON.stringify(layoutDefinition.propsSchema ?? {});
+        this.layouts.set(layoutId, layoutDefinition);
+        if (!existingLayout) {
+            console.log(`Registered custom layout: ${layoutId}`);
+        }
+        else if (!templatesEqual) {
+            console.log(`Updated custom layout: ${layoutId}`);
+        }
+    }
+    registerLayouts(layoutsMap) {
+        for (const [id, config] of Object.entries(layoutsMap)) {
+            try {
+                this.registerLayout(id, config);
+            }
+            catch (error) {
+                console.warn(`Failed to register custom layout ${id}:`, error instanceof Error ? error.message : error);
+            }
+        }
+    }
+    resolveLayoutTemplate(layoutsMap, layoutName) {
+        const candidates = new Set();
+        if (layoutName) {
+            candidates.add(layoutName);
+            if (layoutName.includes('/')) {
+                const parts = layoutName.split('/');
+                const last = parts[parts.length - 1];
+                if (last) {
+                    candidates.add(last);
+                }
+            }
+            else {
+                candidates.add(`crewx/${layoutName}`);
+            }
+        }
+        candidates.add('default');
+        for (const key of candidates) {
+            const value = layoutsMap[key];
+            if (typeof value === 'string' && value.trim().length > 0) {
+                return value;
+            }
+        }
+        for (const value of Object.values(layoutsMap)) {
+            if (typeof value === 'string' && value.trim().length > 0) {
+                return value;
+            }
+        }
+        return undefined;
+    }
+}
+exports.LayoutLoader = LayoutLoader;
+//# sourceMappingURL=layout-loader.service.js.map

package/dist/services/layout-loader.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout-loader.service.js","sourceRoot":"","sources":["../../src/services/layout-loader.service.ts"],"names":[],"mappings":"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"}

package/dist/services/layout-renderer.service.d.ts

@@ -0,0 +1,34 @@
+import { PropsValidator } from './props-validator.service';
+import type { LayoutDefinition, RenderContext, PropSchema, ValidationResult } from '../types/layout.types';
+export { PropsValidationError } from '../types/layout.types';
+export type { LayoutDefinition, RenderContext, PropSchema, ValidationResult as PropsValidationResult, } from '../types/layout.types';
+export interface RenderOptions {
+    validationMode?: 'strict' | 'lenient';
+    skipValidation?: boolean;
+}
+export interface ExecHelperConfig {
+    timeout?: number;
+    allow?: string[];
+    deny?: string[];
+}
+export interface TemplateConfig {
+    exec?: ExecHelperConfig;
+    helpers?: Record<string, string>;
+}
+export declare class LayoutRenderer {
+    private readonly handlebars;
+    private readonly propsValidator;
+    constructor(propsValidator?: PropsValidator);
+    render(layout: LayoutDefinition, context: RenderContext, options?: RenderOptions): string;
+    validate(props: Record<string, any> | undefined, propsSchema: Record<string, PropSchema>, mode?: 'strict' | 'lenient'): ValidationResult;
+    resolveProps(layout: LayoutDefinition, props: Record<string, any> | undefined, mode?: 'strict' | 'lenient'): ValidationResult;
+    private prepareRenderContext;
+    private registerHelpers;
+    registerTemplateHelpers(config: TemplateConfig): void;
+    private executeValidation;
+    private mergeProps;
+    private deepMerge;
+    private cloneDeep;
+    private isPlainObject;
+    private sanitizeVars;
+}

package/dist/services/layout-renderer.service.js

@@ -0,0 +1,325 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LayoutRenderer = exports.PropsValidationError = void 0;
+const handlebars_1 = __importDefault(require("handlebars"));
+const child_process_1 = require("child_process");
+const fs_1 = require("fs");
+const path_1 = require("path");
+const props_validator_service_1 = require("./props-validator.service");
+const layout_types_1 = require("../types/layout.types");
+var layout_types_2 = require("../types/layout.types");
+Object.defineProperty(exports, "PropsValidationError", { enumerable: true, get: function () { return layout_types_2.PropsValidationError; } });
+const SENSITIVE_ENV_PATTERNS = [
+    /^ANTHROPIC_/i, /^OPENAI_/i, /^AWS_SECRET/i, /^SLACK_/i,
+    /^GITHUB_TOKEN$/i, /^CREWX_MCP_KEY$/i, /^DATABASE_/i,
+    /^AWS_ACCESS_KEY/i, /^AWS_SESSION_TOKEN$/i,
+    /^GH_TOKEN$/i, /^GH_APP_/i,
+    /^NPM_TOKEN$/i, /^NPM_AUTH/i,
+    /^GOOGLE_APPLICATION/i, /^GCLOUD_/i,
+    /^AZURE_/i, /^ARM_/i,
+    /^DOCKER_PASSWORD$/i, /^DOCKER_AUTH/i,
+    /^SSH_PRIVATE/i, /^SSH_AUTH_SOCK$/i,
+    /^CI_JOB_TOKEN$/i, /^ACTIONS_RUNTIME_TOKEN$/i,
+    /^VAULT_TOKEN$/i, /^SONAR_TOKEN$/i, /^CODECOV_TOKEN$/i,
+    /TOKEN$/i, /SECRET$/i, /PASSWORD$/i, /API_KEY$/i,
+];
+const SHELL_METACHAR = /[;|&`$(){}!><\n\r]/;
+const MAX_EXEC_DEPTH = 2;
+const DANGEROUS_PATTERNS = ['*', '**', '*:*', '* *', '**/*'];
+class LayoutRenderer {
+    constructor(propsValidator) {
+        this.handlebars = handlebars_1.default.create();
+        this.propsValidator = propsValidator ?? new props_validator_service_1.PropsValidator();
+        this.registerHelpers();
+    }
+    render(layout, context, options = {}) {
+        try {
+            const preparedContext = this.prepareRenderContext(layout, context, options);
+            const template = this.handlebars.compile(layout.template);
+            const result = template(preparedContext);
+            return result;
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                throw new Error(`Template rendering failed for layout '${layout.id}': ${error.message}`);
+            }
+            throw new Error(`Unknown error rendering layout '${layout.id}'`);
+        }
+    }
+    validate(props, propsSchema, mode = 'lenient') {
+        return this.executeValidation(props, propsSchema, mode);
+    }
+    resolveProps(layout, props, mode = 'lenient') {
+        const mergedProps = this.mergeProps(layout.defaultProps, props);
+        if (!layout.propsSchema || Object.keys(layout.propsSchema).length === 0) {
+            return {
+                valid: true,
+                props: mergedProps,
+                errors: [],
+            };
+        }
+        return this.executeValidation(mergedProps, layout.propsSchema, mode);
+    }
+    prepareRenderContext(layout, context, options) {
+        const { validationMode = 'lenient', skipValidation = false } = options;
+        const resolvedProps = skipValidation
+            ? this.mergeProps(layout.defaultProps, context.props)
+            : this.resolveProps(layout, context.props, validationMode).props;
+        return {
+            ...context,
+            vars: this.sanitizeVars(context.vars),
+            props: resolvedProps,
+        };
+    }
+    registerHelpers() {
+        if (handlebars_1.default.helpers.each) {
+            this.handlebars.registerHelper('each', handlebars_1.default.helpers.each);
+        }
+        if (handlebars_1.default.helpers.if) {
+            this.handlebars.registerHelper('if', handlebars_1.default.helpers.if);
+        }
+        if (handlebars_1.default.helpers.unless) {
+            this.handlebars.registerHelper('unless', handlebars_1.default.helpers.unless);
+        }
+        if (handlebars_1.default.helpers.with) {
+            this.handlebars.registerHelper('with', handlebars_1.default.helpers.with);
+        }
+        this.handlebars.registerHelper('eq', function (a, b) {
+            return a === b;
+        });
+        this.handlebars.registerHelper('ne', function (a, b) {
+            return a !== b;
+        });
+        this.handlebars.registerHelper('gt', function (a, b) {
+            return a > b;
+        });
+        this.handlebars.registerHelper('lt', function (a, b) {
+            return a < b;
+        });
+        this.handlebars.registerHelper('json', function (obj) {
+            return new handlebars_1.default.SafeString(JSON.stringify(obj));
+        });
+        this.handlebars.registerHelper('raw', function (options) {
+            return typeof options?.fn === 'function' ? options.fn(this) : '';
+        });
+        this.handlebars.registerHelper('escapeHandlebars', function (text) {
+            if (typeof text !== 'string') {
+                return '';
+            }
+            return text.replace(/\{\{/g, '&#123;&#123;').replace(/\}\}/g, '&#125;&#125;');
+        });
+        this.handlebars.registerHelper('formatFileSize', function (bytes) {
+            if (bytes === 0)
+                return '0 B';
+            const sizes = ['B', 'KB', 'MB', 'GB'];
+            const i = Math.floor(Math.log(bytes) / Math.log(1024));
+            return Math.round((bytes / Math.pow(1024, i)) * 100) / 100 + ' ' + sizes[i];
+        });
+        const handlebarsInstance = this.handlebars;
+        this.handlebars.registerHelper('formatConversation', function (messages, platform, options) {
+            const isBlockHelper = options && typeof options.fn === 'function';
+            if (!Array.isArray(messages) || messages.length === 0) {
+                return '';
+            }
+            const assistantAgentIds = Array.from(new Set(messages
+                .filter((msg) => msg?.isAssistant && msg?.metadata?.agent_id)
+                .map((msg) => msg.metadata.agent_id)));
+            const primaryAgentId = assistantAgentIds.length > 0 ? assistantAgentIds[0] : '';
+            if (isBlockHelper) {
+                return options.fn({
+                    messages,
+                    platform,
+                    messagesCount: messages.length,
+                    agentIds: assistantAgentIds,
+                    primaryAgentId,
+                });
+            }
+            const templatePath = (0, path_1.join)(process.cwd(), '.crewx', 'templates', 'conversation-history-default.hbs');
+            let templateContent;
+            try {
+                if ((0, fs_1.existsSync)(templatePath)) {
+                    templateContent = (0, fs_1.readFileSync)(templatePath, 'utf8');
+                }
+            }
+            catch {
+            }
+            if (!templateContent) {
+                templateContent = `{{#if messages}}
+{{#if primaryAgentId}}Primary agent: @{{primaryAgentId}}
+{{else}}Primary agent: (unknown)
+{{/if}}
+Previous conversation ({{messagesCount}} messages):
+{{#each messages}}
+{{#if isAssistant}}
+**Assistant{{#if metadata.agent_id}} (@{{metadata.agent_id}}){{/if}}**
+{{else}}
+**{{#if metadata.slack}}{{#with metadata.slack}}{{#if user_profile.display_name}}{{user_profile.display_name}}{{else if username}}{{username}}{{else if user_id}}User ({{user_id}}){{else}}User{{/if}}{{/with}}{{else}}User{{/if}}**
+{{/if}}: {{{escapeHandlebars text}}}
+{{#if files}}
+{{#each files}}
+📎 {{name}} ({{formatFileSize size}}) - Local: {{localPath}}
+{{/each}}
+{{/if}}
+{{/each}}{{/if}}`;
+            }
+            const template = handlebarsInstance.compile(templateContent, { noEscape: true });
+            return template({
+                messages,
+                platform,
+                messagesCount: messages.length,
+                agentIds: assistantAgentIds,
+                primaryAgentId,
+            });
+        });
+    }
+    registerTemplateHelpers(config) {
+        const execConfig = config.exec || {};
+        const hbs = this.handlebars;
+        const shellQuote = require('shell-quote');
+        const _minimatchMod = require('minimatch');
+        const minimatchFn = typeof _minimatchMod === 'function' ? _minimatchMod : _minimatchMod.minimatch;
+        const validatePattern = (pattern) => {
+            if (DANGEROUS_PATTERNS.includes(pattern.trim())) {
+                throw new Error(`exec config error: overly broad pattern "${pattern}" is not allowed`);
+            }
+            if (!/^[\w./@-]/.test(pattern)) {
+                throw new Error(`exec config error: pattern must start with a command name`);
+            }
+        };
+        for (const p of [...(execConfig.allow || []), ...(execConfig.deny || [])]) {
+            validatePattern(p);
+        }
+        const logAudit = (entry) => {
+            console.error(JSON.stringify({ span: 'template_exec', ...entry, timestamp: new Date().toISOString() }));
+        };
+        hbs.registerHelper('exec', function (command) {
+            if (typeof command !== 'string')
+                return '';
+            const startMs = Date.now();
+            const execDepth = parseInt(process.env.CREWX_EXEC_DEPTH || '0', 10);
+            if (isNaN(execDepth) || execDepth >= MAX_EXEC_DEPTH) {
+                logAudit({ command, status: 'denied', reason: 'invalid or max recursion depth' });
+                return '(exec blocked: max recursion depth reached)';
+            }
+            if (SHELL_METACHAR.test(command)) {
+                logAudit({ command, status: 'denied', reason: 'shell metacharacter detected' });
+                return `(exec blocked: shell metacharacter detected in "${command}")`;
+            }
+            const isCommandAllowed = (cmd) => {
+                const { allow = [], deny = [] } = execConfig;
+                if (deny.some(p => minimatchFn(cmd, p)))
+                    return false;
+                if (/^npx\s+@crewx\/[\w-]+/.test(cmd))
+                    return true;
+                return allow.some(p => minimatchFn(cmd, p));
+            };
+            if (!isCommandAllowed(command)) {
+                logAudit({ command, status: 'denied', reason: 'not in allow list' });
+                return `(exec blocked: ${command})`;
+            }
+            try {
+                const parsed = shellQuote.parse(command).map(String);
+                const [bin, ...args] = parsed;
+                if (!bin)
+                    return `(exec failed: ${command})`;
+                const env = { ...process.env };
+                for (const key of Object.keys(env)) {
+                    if (SENSITIVE_ENV_PATTERNS.some(p => p.test(key)))
+                        delete env[key];
+                }
+                const result = (0, child_process_1.execFileSync)(bin, args, {
+                    timeout: execConfig.timeout || 5000,
+                    maxBuffer: 64 * 1024,
+                    encoding: 'utf-8',
+                    env: { ...env, CREWX_EXEC_DEPTH: String(execDepth + 1) },
+                    stdio: ['pipe', 'pipe', 'pipe'],
+                });
+                const durationMs = Date.now() - startMs;
+                logAudit({ command, status: 'allowed', duration_ms: durationMs });
+                return new handlebars_1.default.SafeString(`<exec-output cmd="${command}">\n${result.trim()}\n</exec-output>`);
+            }
+            catch {
+                logAudit({ command, status: 'error', reason: 'execution failed' });
+                return `(exec failed: ${command})`;
+            }
+        });
+        if (config.helpers) {
+            for (const [name] of Object.entries(config.helpers)) {
+                console.warn(`Custom helper '${name}' rejected: user-defined JavaScript execution is disabled for security`);
+            }
+        }
+    }
+    executeValidation(props, propsSchema, mode) {
+        try {
+            return this.propsValidator.validate(props, propsSchema, mode);
+        }
+        catch (error) {
+            if (error instanceof layout_types_1.PropsValidationError && error.errors && error.errors.length > 0) {
+                const firstError = error.errors[0];
+                if (firstError) {
+                    throw new layout_types_1.PropsValidationError(firstError.message, error.errors);
+                }
+            }
+            throw error;
+        }
+    }
+    mergeProps(defaultProps, overrides) {
+        const base = this.cloneDeep(defaultProps ?? {});
+        if (!overrides) {
+            return base;
+        }
+        return this.deepMerge(base, overrides);
+    }
+    deepMerge(target, source) {
+        for (const [key, value] of Object.entries(source)) {
+            if (this.isPlainObject(value)) {
+                const existing = target[key];
+                target[key] = this.deepMerge(this.isPlainObject(existing) ? existing : {}, value);
+                continue;
+            }
+            if (Array.isArray(value)) {
+                target[key] = this.cloneDeep(value);
+                continue;
+            }
+            target[key] = value;
+        }
+        return target;
+    }
+    cloneDeep(value) {
+        if (Array.isArray(value)) {
+            return value.map(item => this.cloneDeep(item));
+        }
+        if (this.isPlainObject(value)) {
+            const cloned = {};
+            for (const [key, nested] of Object.entries(value)) {
+                cloned[key] = this.cloneDeep(nested);
+            }
+            return cloned;
+        }
+        return value;
+    }
+    isPlainObject(value) {
+        return typeof value === 'object' && value !== null && !Array.isArray(value);
+    }
+    sanitizeVars(vars) {
+        if (!vars) {
+            return {};
+        }
+        const sanitizedVars = { ...vars };
+        if (typeof vars.user_input === 'string') {
+            sanitizedVars.user_input_raw = vars.user_input;
+            const escapedHandlebars = vars.user_input
+                .replace(/\{\{\{/g, '&#123;&#123;&#123;')
+                .replace(/\}\}\}/g, '&#125;&#125;&#125;')
+                .replace(/\{\{/g, '&#123;&#123;')
+                .replace(/\}\}/g, '&#125;&#125;');
+            sanitizedVars.user_input = this.handlebars.escapeExpression(escapedHandlebars);
+        }
+        return sanitizedVars;
+    }
+}
+exports.LayoutRenderer = LayoutRenderer;
+//# sourceMappingURL=layout-renderer.service.js.map