@dollhousemcp/mcp-server 1.4.2 → 1.4.4

package/dist/elements/ensembles/Ensemble.d.ts

@@ -0,0 +1,144 @@
+/**
+ * Ensemble Element - Orchestrates multiple elements working together
+ *
+ * Ensembles allow combining multiple elements (personas, skills, templates, agents, memories)
+ * into cohesive units with controlled activation, conflict resolution, and shared context.
+ *
+ * SECURITY MEASURES IMPLEMENTED:
+ * 1. Circular dependency detection with path tracking
+ * 2. Resource limits (max elements, nesting depth, activation time)
+ * 3. Input sanitization for all user-provided data
+ * 4. Activation timeout protection
+ * 5. Context size limits to prevent memory exhaustion
+ * 6. Audit logging for security events
+ * 7. Condition validation to prevent code injection
+ */
+import { BaseElement } from '../BaseElement.js';
+import { IElement, ElementValidationResult, ElementStatus } from '../../types/elements/index.js';
+import { EnsembleMetadata, EnsembleElement, ElementRole, EnsembleActivationResult, ContextConflict } from './types.js';
+export declare class Ensemble extends BaseElement implements IElement {
+    private elements;
+    private elementInstances;
+    private sharedContext;
+    private activationInProgress;
+    private lastActivationResult?;
+    constructor(metadata?: Partial<EnsembleMetadata>);
+    /**
+     * Add an element to the ensemble
+     */
+    addElement(elementId: string, elementType: string, role?: ElementRole, options?: {
+        priority?: number;
+        activationCondition?: string;
+        dependencies?: string[];
+    }): void;
+    /**
+     * Remove an element from the ensemble
+     */
+    removeElement(elementId: string): void;
+    /**
+     * Activate the ensemble and all its elements based on strategy
+     */
+    activate(): Promise<void>;
+    /**
+     * Deactivate the ensemble and all its elements
+     */
+    deactivate(): Promise<void>;
+    /**
+     * Validate the ensemble configuration
+     */
+    validate(): ElementValidationResult;
+    /**
+     * Check if adding an element would create a circular dependency
+     * MEDIUM FIX: Remove type safety bypass
+     * Previously: Used 'as any' which bypasses TypeScript checking
+     * Now: Creates proper EnsembleElement with all required fields
+     */
+    private wouldCreateCircularDependency;
+    /**
+     * Find circular dependency path
+     */
+    private findCircularDependency;
+    /**
+     * Detect all circular dependencies in the ensemble
+     */
+    private detectAllCircularDependencies;
+    /**
+     * Check if graph has any cycle
+     */
+    private hasCycle;
+    /**
+     * Check for cycle starting from a specific node
+     */
+    private hasCycleFrom;
+    /**
+     * Validate activation condition syntax
+     */
+    private isValidCondition;
+    /**
+     * Get activation order based on dependencies and strategy
+     */
+    private getActivationOrder;
+    /**
+     * Activate elements sequentially
+     */
+    private activateSequential;
+    /**
+     * Activate all elements simultaneously as one unified entity
+     */
+    private activateAll;
+    /**
+     * Activate elements by priority
+     */
+    private activatePriority;
+    /**
+     * Activate elements based on conditions
+     */
+    private activateConditional;
+    /**
+     * Activate a single element
+     * CRITICAL FIX: Implement actual element loading and activation
+     * Previously: Just simulated with timeout
+     * Now: Loads element from portfolio and activates it
+     */
+    private activateElement;
+    /**
+     * Evaluate a simple condition
+     * CRITICAL FIX: Implement actual condition evaluation
+     * Previously: Always returned true
+     * Now: Parses and evaluates simple conditions like "element.property == value"
+     *
+     * Supported operators: ==, !=, >, <, >=, <=
+     * Supported properties: active, status, priority
+     * Example: "element1.active == true" or "element2.priority > 50"
+     */
+    private evaluateCondition;
+    /**
+     * Get shared context value
+     */
+    getContextValue(key: string): any;
+    /**
+     * Set shared context value with conflict resolution
+     */
+    setContextValue(key: string, value: any, elementId: string): ContextConflict | null;
+    /**
+     * Get all elements in the ensemble
+     */
+    getElements(): Map<string, EnsembleElement>;
+    /**
+     * Get activation result
+     */
+    getLastActivationResult(): EnsembleActivationResult | undefined;
+    /**
+     * Get current element status
+     */
+    getStatus(): ElementStatus;
+    /**
+     * Serialize ensemble to string
+     */
+    serialize(): string;
+    /**
+     * Deserialize ensemble from string
+     */
+    deserialize(data: string): void;
+}
+//# sourceMappingURL=Ensemble.d.ts.map

package/dist/elements/ensembles/Ensemble.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Ensemble.d.ts","sourceRoot":"","sources":["../../../src/elements/ensembles/Ensemble.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,uBAAuB,EAAsC,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAOrI,OAAO,EACL,gBAAgB,EAChB,eAAe,EAGf,WAAW,EAEX,wBAAwB,EAExB,eAAe,EAEhB,MAAM,YAAY,CAAC;AAYpB,qBAAa,QAAS,SAAQ,WAAY,YAAW,QAAQ;IAC3D,OAAO,CAAC,QAAQ,CAA2C;IAC3D,OAAO,CAAC,gBAAgB,CAAoC;IAC5D,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,oBAAoB,CAAkB;IAC9C,OAAO,CAAC,oBAAoB,CAAC,CAA2B;gBAE5C,QAAQ,GAAE,OAAO,CAAC,gBAAgB,CAAM;IA8DpD;;OAEG;IACI,UAAU,CACf,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,IAAI,GAAE,WAA4C,EAClD,OAAO,GAAE;QACP,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAC7B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;KACpB,GACL,IAAI;IA0EP;;OAEG;IACI,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IA+B7C;;OAEG;IACmB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAiE/C;;OAEG;IACmB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA0BjD;;OAEG;IACa,QAAQ,IAAI,uBAAuB;IAqDnD;;;;;OAKG;IACH,OAAO,CAAC,6BAA6B;IAkBrC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAqC9B;;OAEG;IACH,OAAO,CAAC,6BAA6B;IAcrC;;OAEG;IACH,OAAO,CAAC,QAAQ;IAgChB;;OAEG;IACH,OAAO,CAAC,YAAY;IAyBpB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAMxB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA6B1B;;OAEG;YACW,kBAAkB;IAgChC;;OAEG;YACW,WAAW;IA4BzB;;OAEG;YACW,gBAAgB;IAe9B;;OAEG;YACW,mBAAmB;IAiCjC;;;;;OAKG;YACW,eAAe;IA+E7B;;;;;;;;;OASG;IACH,OAAO,CAAC,iBAAiB;IAoFzB;;OAEG;IACI,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG;IAIxC;;OAEG;IACI,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI;IA0E1F;;OAEG;IACI,WAAW,IAAI,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC;IAIlD;;OAEG;IACI,uBAAuB,IAAI,wBAAwB,GAAG,SAAS;IAItE;;OAEG;IACa,SAAS,IAAI,aAAa;IAI1C;;OAEG;IACa,SAAS,IAAI,MAAM;IAanC;;OAEG;IACa,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;CAqChD"}