@crewx/sdk 0.8.0-rc.72 → 0.8.0-rc.74

package/dist/{services/layout-loader.service.js → layout/loader.js}

@@ -1,4 +1,9 @@
 "use strict";
+/**
+ * LayoutLoader — loads layout templates from templates/agents/*.yaml files.
+ * Ported 1:1 from packages/sdk-bak/src/services/layout-loader.service.ts.
+ * Only import paths and DEFAULT_OPTIONS.templatesPath are changed.
+ */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     var desc = Object.getOwnPropertyDescriptor(m, k);
@@ -37,18 +42,30 @@ 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 types_1 = require("./types");
+/**
+ * Default loader options — points to SDK's bundled templates directory.
+ */
 const DEFAULT_OPTIONS = {
     templatesPath: path.join(__dirname, '../../../templates/agents'),
     validationMode: 'lenient',
     fallbackLayoutId: 'crewx/default',
 };
+/**
+ * Layout loader service.
+ * Loads and caches layout definitions from YAML files.
+ * Provides fallback mechanism and prop override support.
+ */
 class LayoutLoader {
+    layouts = new Map();
+    options;
     constructor(options) {
-        this.layouts = new Map();
         this.options = { ...DEFAULT_OPTIONS, ...options };
         this.loadAllLayouts();
     }
+    /**
+     * Load a layout by ID with optional props override.
+     */
     load(layoutId, propsOverride) {
         let layout = this.layouts.get(layoutId);
         if (!layout) {
@@ -59,7 +76,7 @@ class LayoutLoader {
             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);
+                throw new types_1.LayoutLoadError(`Fallback layout not found: ${this.options.fallbackLayoutId}`, this.options.fallbackLayoutId);
             }
         }
         if (propsOverride && Object.keys(propsOverride).length > 0) {
@@ -74,9 +91,8 @@ class LayoutLoader {
         return Array.from(this.layouts.keys());
     }
     hasLayout(layoutId) {
-        if (this.layouts.has(layoutId)) {
+        if (this.layouts.has(layoutId))
             return true;
-        }
         const normalizedId = this.normalizeLayoutId(layoutId);
         return this.layouts.has(normalizedId);
     }
@@ -84,10 +100,62 @@ class LayoutLoader {
         this.layouts.clear();
         this.loadAllLayouts();
     }
+    /**
+     * Register or override a layout at runtime.
+     */
+    registerLayout(layoutId, layoutConfig) {
+        if (!layoutId || typeof layoutId !== 'string') {
+            throw new 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 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 (process.env.CREWX_VERBOSE === '1') {
+            if (!existingLayout) {
+                console.error(`Registered custom layout: ${layoutId}`);
+            }
+            else if (!templatesEqual) {
+                console.error(`Updated custom layout: ${layoutId}`);
+            }
+        }
+    }
+    /**
+     * Register multiple layouts from a map.
+     */
+    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);
+            }
+        }
+    }
     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}`));
+            throw new 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'));
@@ -114,7 +182,7 @@ class LayoutLoader {
                 console.error(`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)));
+            throw new types_1.LayoutLoadError(`Failed to read layouts directory: ${layoutsDir}`, undefined, error instanceof Error ? error : new Error(String(error)));
         }
     }
     loadLayoutFile(filePath, layoutName) {
@@ -122,32 +190,36 @@ class LayoutLoader {
             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'));
+                throw new 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'));
+                throw new types_1.LayoutLoadError(`Invalid or empty YAML in ${filePath}`, layoutName, new Error('YAML parsing returned null/undefined or non-object'));
             }
+            // Format 2: layouts map (templates/agents/default.yaml format)
             if (parsed.layouts && typeof parsed.layouts === 'object') {
-                const layoutTemplate = this.resolveLayoutTemplate(parsed.layouts, layoutName);
-                if (!layoutTemplate || (typeof layoutTemplate === 'string' && layoutTemplate.trim().length === 0)) {
+                const entry = this.resolveLayoutEntry(parsed.layouts, layoutName);
+                if (!entry || entry.template.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);
+                    throw new types_1.LayoutLoadError(`Layout template not found or empty in layouts map: ${layoutName}`, layoutName);
                 }
+                // propsSchema may be inline in the layout entry object (e.g. default.yaml) or at the top level
+                const propsSchemaRaw = entry.propsSchema || parsed.propsSchema || {};
                 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 || {}),
+                    template: entry.template,
+                    propsSchema: this.parsePropsSchema(propsSchemaRaw),
+                    defaultProps: this.extractDefaultProps(propsSchemaRaw),
                 };
             }
             else {
+                // Format 1: direct layout definition
                 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);
+                    throw new types_1.LayoutLoadError(`Layout template is missing or empty in ${filePath}`, layoutName);
                 }
                 return {
                     id: parsed.id || `crewx/${layoutName}`,
@@ -160,7 +232,7 @@ class LayoutLoader {
             }
         }
         catch (error) {
-            throw new layout_types_1.LayoutLoadError(`Failed to load layout file: ${filePath}`, layoutName, error instanceof Error ? error : new Error(String(error)));
+            throw new types_1.LayoutLoadError(`Failed to load layout file: ${filePath}`, layoutName, error instanceof Error ? error : new Error(String(error)));
         }
     }
     parsePropsSchema(raw) {
@@ -187,70 +259,21 @@ class LayoutLoader {
         return defaults;
     }
     normalizeLayoutId(layoutId) {
-        if (!layoutId) {
+        if (!layoutId)
             return this.options.fallbackLayoutId;
-        }
-        if (layoutId.includes('/')) {
+        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 (process.env.CREWX_VERBOSE === '1') {
-            if (!existingLayout) {
-                console.error(`Registered custom layout: ${layoutId}`);
-            }
-            else if (!templatesEqual) {
-                console.error(`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) {
+    resolveLayoutEntry(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) {
+                if (last)
                     candidates.add(last);
-                }
             }
             else {
                 candidates.add(`crewx/${layoutName}`);
@@ -260,16 +283,23 @@ class LayoutLoader {
         for (const key of candidates) {
             const value = layoutsMap[key];
             if (typeof value === 'string' && value.trim().length > 0) {
-                return value;
+                return { template: value };
+            }
+            if (value && typeof value === 'object' && typeof value.template === 'string' && value.template.trim().length > 0) {
+                return { template: value.template, propsSchema: value.propsSchema };
             }
         }
         for (const value of Object.values(layoutsMap)) {
             if (typeof value === 'string' && value.trim().length > 0) {
-                return value;
+                return { template: value };
+            }
+            const v = value;
+            if (v && typeof v === 'object' && typeof v.template === 'string' && v.template.trim().length > 0) {
+                return { template: v.template, propsSchema: v.propsSchema };
             }
         }
         return undefined;
     }
 }
 exports.LayoutLoader = LayoutLoader;
-//# sourceMappingURL=layout-loader.service.js.map
+//# sourceMappingURL=loader.js.map

package/dist/{services/props-validator.service.d.ts → layout/props-validator.d.ts}

@@ -1,4 +1,9 @@
-import { PropSchema, ValidationResult } from '../types/layout.types';
+/**
+ * PropsValidator — React PropTypes style props validation.
+ * Ported 1:1 from packages/sdk-bak/src/services/props-validator.service.ts.
+ * Only the import path is changed.
+ */
+import { PropSchema, ValidationResult } from './types';
 export type ValidationMode = 'strict' | 'lenient';
 export interface PropsValidatorOptions {
     defaultMode?: ValidationMode;
@@ -27,3 +32,4 @@ export declare class PropsValidator {
     private buildPath;
     private describeType;
 }
+//# sourceMappingURL=props-validator.d.ts.map

package/dist/{services/props-validator.service.js → layout/props-validator.js}

@@ -1,8 +1,14 @@
 "use strict";
+/**
+ * PropsValidator — React PropTypes style props validation.
+ * Ported 1:1 from packages/sdk-bak/src/services/props-validator.service.ts.
+ * Only the import path is changed.
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PropsValidator = void 0;
-const layout_types_1 = require("../types/layout.types");
+const types_1 = require("./types");
 class PropsValidator {
+    defaultMode;
     constructor(options = {}) {
         this.defaultMode = options.defaultMode ?? 'lenient';
     }
@@ -10,7 +16,7 @@ class PropsValidator {
         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);
+            throw new types_1.PropsValidationError('Props validation failed in strict mode', errors);
         }
         return {
             valid: errors.length === 0,
@@ -39,10 +45,6 @@ class PropsValidator {
                 sanitized[key] = result.value;
             }
         }
-        if (mode === 'lenient') {
-        }
-        else if (mode === 'strict') {
-        }
         return sanitized;
     }
     resolveProp(value, schema, pathSegments, mode, errors) {
@@ -118,30 +120,18 @@ class PropsValidator {
             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(', ')}`,
-            };
+            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}`,
-            };
+            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}`,
-            };
+            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: false, error: `String does not match pattern ${schema.pattern}` };
             }
         }
         return { valid: true, value };
@@ -157,10 +147,7 @@ class PropsValidator {
             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: false, error: `Expected one of: ${schema.oneOf.join(', ')}` };
         }
         return { valid: true, value };
     }
@@ -175,24 +162,17 @@ class PropsValidator {
             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}`,
-            };
+            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: 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) {
+        if (!base.valid)
             return base;
-        }
         const itemValues = [];
         const itemType = schema.itemType;
         const itemOneOf = schema.itemOneOf;
@@ -258,26 +238,17 @@ class PropsValidator {
     }
     matchesType(value, typeName) {
         switch (typeName) {
-            case 'string':
-                return typeof value === 'string';
-            case 'number':
-                return typeof value === 'number' && !Number.isNaN(value);
+            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 '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;
+            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) {
@@ -319,14 +290,12 @@ class PropsValidator {
         return segments.join('.');
     }
     describeType(value) {
-        if (Array.isArray(value)) {
+        if (Array.isArray(value))
             return 'array';
-        }
-        if (value === null) {
+        if (value === null)
             return 'null';
-        }
         return typeof value;
     }
 }
 exports.PropsValidator = PropsValidator;
-//# sourceMappingURL=props-validator.service.js.map
+//# sourceMappingURL=props-validator.js.map

package/dist/{services/layout-renderer.service.d.ts → layout/renderer.d.ts}

@@ -1,30 +1,43 @@
-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';
+/**
+ * LayoutRenderer — Handlebars-based layout rendering.
+ * Ported from packages/sdk-bak/src/services/layout-renderer.service.ts.
+ * Excluded: registerTemplateHelpers (exec/shell-quote).
+ * Exec is handled separately by TemplateEngine in the facade layer.
+ * WI-CONV-002: formatConversation helper restored.
+ */
+import { PropsValidator } from './props-validator';
+import type { LayoutDefinition, RenderContext, PropSchema, ValidationResult } from './types';
+export { PropsValidationError } from './types';
+export type { LayoutDefinition, RenderContext, PropSchema, ValidationResult as PropsValidationResult, } from './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>;
-}
+/**
+ * LayoutRenderer — renders layout templates with Handlebars.
+ */
 export declare class LayoutRenderer {
     private readonly handlebars;
     private readonly propsValidator;
     constructor(propsValidator?: PropsValidator);
+    /**
+     * Render a layout template with the given context.
+     */
     render(layout: LayoutDefinition, context: RenderContext, options?: RenderOptions): string;
+    /**
+     * Validate props against schema.
+     */
     validate(props: Record<string, any> | undefined, propsSchema: Record<string, PropSchema>, mode?: 'strict' | 'lenient'): ValidationResult;
+    /**
+     * Merge default props and runtime props, then validate.
+     */
     resolveProps(layout: LayoutDefinition, props: Record<string, any> | undefined, mode?: 'strict' | 'lenient'): ValidationResult;
     private prepareRenderContext;
+    /**
+     * Register built-in Handlebars helpers (no exec).
+     * WI-CONV-002: formatConversation block helper registered for conversation history.
+     */
     private registerHelpers;
-    registerTemplateHelpers(config: TemplateConfig): void;
     private executeValidation;
     private mergeProps;
     private deepMerge;
@@ -32,3 +45,4 @@ export declare class LayoutRenderer {
     private isPlainObject;
     private sanitizeVars;
 }
+//# sourceMappingURL=renderer.d.ts.map