@animalabs/agent-framework 0.1.0

package/dist/src/mcpl/errors.js

@@ -0,0 +1,93 @@
+/**
+ * MCPL error codes and helpers.
+ *
+ * Error codes from Spec Appendix A. Used when rejecting inbound messages
+ * from MCPL servers that violate permission or state constraints.
+ */
+// ============================================================================
+// Error Codes (Spec Appendix A)
+// ============================================================================
+/** Message used a disabled feature set. */
+export const FEATURE_SET_NOT_ENABLED = -32001;
+/** Message used an undeclared feature set. */
+export const UNKNOWN_FEATURE_SET = -32003;
+/** Rollback targeted a pruned or unknown checkpoint. */
+export const CHECKPOINT_NOT_FOUND = -32005;
+/** Lacking scope to publish or observe channel. */
+export const CHANNEL_NOT_PERMITTED = -32017;
+/** Channel ID doesn't exist or not registered. */
+export const UNKNOWN_CHANNEL = -32023;
+/** Server could not open/connect the requested channel. */
+export const CHANNEL_OPEN_FAILED = -32024;
+// ============================================================================
+// Error Factories
+// ============================================================================
+/**
+ * Create a "feature set not enabled" error.
+ * Returned when a server sends a message tagged with a feature set
+ * that the host has disabled.
+ */
+export function featureSetNotEnabled(featureSet, canEnable = true) {
+    return {
+        code: FEATURE_SET_NOT_ENABLED,
+        message: 'Feature set not enabled',
+        data: { featureSet, canEnable },
+    };
+}
+/**
+ * Create an "unknown feature set" error.
+ * Returned when a server sends a message tagged with a feature set
+ * that was never declared in capabilities.
+ */
+export function unknownFeatureSet(featureSet) {
+    return {
+        code: UNKNOWN_FEATURE_SET,
+        message: 'Unknown feature set',
+        data: { featureSet },
+    };
+}
+/**
+ * Create a "checkpoint not found" error.
+ * Returned when a rollback targets a pruned or unknown checkpoint.
+ */
+export function checkpointNotFound(checkpoint) {
+    return {
+        code: CHECKPOINT_NOT_FOUND,
+        message: 'Checkpoint not found',
+        data: { checkpoint },
+    };
+}
+/**
+ * Create a "channel not permitted" error.
+ * Returned when a server lacks scope to publish or observe a channel.
+ */
+export function channelNotPermitted(channelId) {
+    return {
+        code: CHANNEL_NOT_PERMITTED,
+        message: 'Channel not permitted',
+        data: { channelId },
+    };
+}
+/**
+ * Create an "unknown channel" error.
+ * Returned when a channel ID doesn't exist or isn't registered.
+ */
+export function unknownChannel(channelId) {
+    return {
+        code: UNKNOWN_CHANNEL,
+        message: 'Unknown channel',
+        data: { channelId },
+    };
+}
+/**
+ * Create a "channel open failed" error.
+ * Returned when a server could not open/connect the requested channel.
+ */
+export function channelOpenFailed(channelId, reason) {
+    return {
+        code: CHANNEL_OPEN_FAILED,
+        message: 'Channel open failed',
+        data: { channelId, reason },
+    };
+}
+//# sourceMappingURL=errors.js.map

package/dist/src/mcpl/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/mcpl/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,+EAA+E;AAC/E,gCAAgC;AAChC,+EAA+E;AAE/E,2CAA2C;AAC3C,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,KAAK,CAAC;AAE9C,8CAA8C;AAC9C,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,KAAK,CAAC;AAE1C,wDAAwD;AACxD,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,KAAK,CAAC;AAE3C,mDAAmD;AACnD,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,KAAK,CAAC;AAE5C,kDAAkD;AAClD,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAAK,CAAC;AAEtC,2DAA2D;AAC3D,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,KAAK,CAAC;AAE1C,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAE/E;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAClC,UAAkB,EAClB,YAAqB,IAAI;IAEzB,OAAO;QACL,IAAI,EAAE,uBAAuB;QAC7B,OAAO,EAAE,yBAAyB;QAClC,IAAI,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE;KAChC,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,UAAkB;IAClD,OAAO;QACL,IAAI,EAAE,mBAAmB;QACzB,OAAO,EAAE,qBAAqB;QAC9B,IAAI,EAAE,EAAE,UAAU,EAAE;KACrB,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAAkB;IACnD,OAAO;QACL,IAAI,EAAE,oBAAoB;QAC1B,OAAO,EAAE,sBAAsB;QAC/B,IAAI,EAAE,EAAE,UAAU,EAAE;KACrB,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,SAAiB;IACnD,OAAO;QACL,IAAI,EAAE,qBAAqB;QAC3B,OAAO,EAAE,uBAAuB;QAChC,IAAI,EAAE,EAAE,SAAS,EAAE;KACpB,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,SAAiB;IAC9C,OAAO;QACL,IAAI,EAAE,eAAe;QACrB,OAAO,EAAE,iBAAiB;QAC1B,IAAI,EAAE,EAAE,SAAS,EAAE;KACpB,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,SAAiB,EACjB,MAAe;IAEf,OAAO;QACL,IAAI,EAAE,mBAAmB;QACzB,OAAO,EAAE,qBAAqB;QAC9B,IAAI,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE;KAC5B,CAAC;AACJ,CAAC"}

package/dist/src/mcpl/feature-set-manager.d.ts

@@ -0,0 +1,91 @@
+/**
+ * FeatureSetManager — Permission gate for MCPL feature sets.
+ *
+ * Manages per-server feature set state: which feature sets each server declares,
+ * which are enabled/disabled, and validates inbound messages against that state.
+ *
+ * Spec references: Section 6 (Feature Sets), Appendix A (Error Codes).
+ */
+import type { McplCapabilities, FeatureSetDeclaration, FeatureSetsUpdateParams, FeatureSetsChangedParams } from './types.js';
+/**
+ * Error thrown when a feature set validation fails.
+ * Carries the JSON-RPC error code and the offending feature set name.
+ */
+export declare class McplFeatureSetError extends Error {
+    readonly code: number;
+    readonly featureSet: string;
+    constructor(code: number, featureSet: string, message: string);
+}
+/**
+ * Manages feature set state across all MCPL servers.
+ *
+ * This is the permission gate that all MCPL interactions pass through.
+ * Every inbound server message tagged with a `featureSet` must be validated
+ * through this manager before processing.
+ */
+export declare class FeatureSetManager {
+    /** Per-server state, keyed by server ID. */
+    private servers;
+    /**
+     * Initialize a server's feature set state from its capabilities and host config.
+     *
+     * Called after a server connects and advertises its capabilities.
+     * Returns the `FeatureSetsUpdateParams` that should be sent to the server
+     * via `featureSets/update`.
+     *
+     * Initialization logic:
+     * 1. Store all declared feature sets from capabilities.
+     * 2. If `config.enabledFeatureSets` is provided, enable matching sets (supports wildcards).
+     * 3. If `config.disabledFeatureSets` is provided, disable matching sets (supports wildcards).
+     * 4. Feature sets not mentioned in either list default to disabled.
+     */
+    initializeServer(serverId: string, capabilities: McplCapabilities, config?: {
+        enabledFeatureSets?: string[];
+        disabledFeatureSets?: string[];
+    }): FeatureSetsUpdateParams;
+    /**
+     * Remove all tracking state for a server.
+     * Called when a server disconnects.
+     */
+    removeServer(serverId: string): void;
+    /**
+     * Check whether a feature set is enabled for a server.
+     * Returns false if the server is unknown or the feature set is not enabled.
+     */
+    isEnabled(serverId: string, featureSet: string): boolean;
+    /**
+     * Validate that an inbound message's feature set is declared and enabled.
+     *
+     * @throws McplFeatureSetError with code -32003 if the feature set is unknown
+     * @throws McplFeatureSetError with code -32001 if the feature set is not enabled
+     */
+    validateInbound(serverId: string, featureSet: string): void;
+    /**
+     * Enable feature sets for a server (supports wildcard patterns).
+     * Only declared feature sets can be enabled.
+     */
+    enable(serverId: string, featureSets: string[]): void;
+    /**
+     * Disable feature sets for a server (supports wildcard patterns).
+     * Only declared feature sets can be disabled.
+     */
+    disable(serverId: string, featureSets: string[]): void;
+    /**
+     * Handle a `featureSets/changed` notification from a server.
+     *
+     * - Adds new feature sets from `params.added` (default to disabled).
+     * - Removes feature sets listed in `params.removed`.
+     */
+    handleFeatureSetsChanged(serverId: string, params: FeatureSetsChangedParams): void;
+    /**
+     * Get all declared feature sets for a server.
+     * Returns null if the server is unknown.
+     */
+    getDeclaredFeatureSets(serverId: string): Record<string, FeatureSetDeclaration> | null;
+    /**
+     * Get the names of all enabled feature sets for a server.
+     * Returns an empty array if the server is unknown.
+     */
+    getEnabledFeatureSets(serverId: string): string[];
+}
+//# sourceMappingURL=feature-set-manager.d.ts.map

package/dist/src/mcpl/feature-set-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-set-manager.d.ts","sourceRoot":"","sources":["../../../src/mcpl/feature-set-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAChB,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACzB,MAAM,YAAY,CAAC;AAWpB;;;GAGG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;aAE1B,IAAI,EAAE,MAAM;aACZ,UAAU,EAAE,MAAM;gBADlB,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClC,OAAO,EAAE,MAAM;CAKlB;AAgFD;;;;;;GAMG;AACH,qBAAa,iBAAiB;IAC5B,4CAA4C;IAC5C,OAAO,CAAC,OAAO,CAAkC;IAEjD;;;;;;;;;;;;OAYG;IACH,gBAAgB,CACd,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,gBAAgB,EAC9B,MAAM,CAAC,EAAE;QAAE,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GACzE,uBAAuB;IA2C1B;;;OAGG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAIpC;;;OAGG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO;IAQxD;;;;;OAKG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IA4B3D;;;OAGG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,IAAI;IAYrD;;;OAGG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,IAAI;IAYtD;;;;;OAKG;IACH,wBAAwB,CACtB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,wBAAwB,GAC/B,IAAI;IAuBP;;;OAGG;IACH,sBAAsB,CACpB,QAAQ,EAAE,MAAM,GACf,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,GAAG,IAAI;IAQ/C;;;OAGG;IACH,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE;CAOlD"}

package/dist/src/mcpl/feature-set-manager.js

@@ -0,0 +1,250 @@
+/**
+ * FeatureSetManager — Permission gate for MCPL feature sets.
+ *
+ * Manages per-server feature set state: which feature sets each server declares,
+ * which are enabled/disabled, and validates inbound messages against that state.
+ *
+ * Spec references: Section 6 (Feature Sets), Appendix A (Error Codes).
+ */
+import { FEATURE_SET_NOT_ENABLED, UNKNOWN_FEATURE_SET, } from './errors.js';
+// ============================================================================
+// Error Class
+// ============================================================================
+/**
+ * Error thrown when a feature set validation fails.
+ * Carries the JSON-RPC error code and the offending feature set name.
+ */
+export class McplFeatureSetError extends Error {
+    code;
+    featureSet;
+    constructor(code, featureSet, message) {
+        super(message);
+        this.code = code;
+        this.featureSet = featureSet;
+        this.name = 'McplFeatureSetError';
+    }
+}
+// ============================================================================
+// Wildcard Matching
+// ============================================================================
+/**
+ * Check whether a wildcard pattern matches a feature set name.
+ *
+ * Rules:
+ *   - Split both pattern and name on `.`
+ *   - `*` in a pattern segment matches exactly one segment (any value)
+ *   - Literal segments must match exactly
+ *   - Pattern and name must have the same number of segments
+ *     (unless the last pattern segment is `*`, which matches one segment)
+ *
+ * Examples:
+ *   `memory.*` matches `memory.retrieval` but not `memory.a.b`
+ *   `memory.retrieval` matches only `memory.retrieval`
+ */
+function wildcardMatch(pattern, name) {
+    const patternParts = pattern.split('.');
+    const nameParts = name.split('.');
+    if (patternParts.length !== nameParts.length) {
+        return false;
+    }
+    for (let i = 0; i < patternParts.length; i++) {
+        const p = patternParts[i];
+        if (p === '*') {
+            // Wildcard segment matches any single segment
+            continue;
+        }
+        if (p !== nameParts[i]) {
+            return false;
+        }
+    }
+    return true;
+}
+/**
+ * Find all declared feature set names that match any of the given patterns.
+ * Patterns may contain wildcards (e.g., `memory.*`).
+ */
+function resolvePatterns(patterns, declared) {
+    const matched = new Set();
+    const declaredNames = Object.keys(declared);
+    for (const pattern of patterns) {
+        for (const name of declaredNames) {
+            if (wildcardMatch(pattern, name)) {
+                matched.add(name);
+            }
+        }
+    }
+    return [...matched];
+}
+// ============================================================================
+// FeatureSetManager
+// ============================================================================
+/**
+ * Manages feature set state across all MCPL servers.
+ *
+ * This is the permission gate that all MCPL interactions pass through.
+ * Every inbound server message tagged with a `featureSet` must be validated
+ * through this manager before processing.
+ */
+export class FeatureSetManager {
+    /** Per-server state, keyed by server ID. */
+    servers = new Map();
+    /**
+     * Initialize a server's feature set state from its capabilities and host config.
+     *
+     * Called after a server connects and advertises its capabilities.
+     * Returns the `FeatureSetsUpdateParams` that should be sent to the server
+     * via `featureSets/update`.
+     *
+     * Initialization logic:
+     * 1. Store all declared feature sets from capabilities.
+     * 2. If `config.enabledFeatureSets` is provided, enable matching sets (supports wildcards).
+     * 3. If `config.disabledFeatureSets` is provided, disable matching sets (supports wildcards).
+     * 4. Feature sets not mentioned in either list default to disabled.
+     */
+    initializeServer(serverId, capabilities, config) {
+        const declared = capabilities.featureSets ?? {};
+        const state = {
+            declared: { ...declared },
+            enabled: new Set(),
+        };
+        // Resolve which feature sets to enable
+        const enablePatterns = config?.enabledFeatureSets ?? [];
+        const disablePatterns = config?.disabledFeatureSets ?? [];
+        const toEnable = resolvePatterns(enablePatterns, declared);
+        const toDisable = resolvePatterns(disablePatterns, declared);
+        // Enable matching sets
+        for (const name of toEnable) {
+            state.enabled.add(name);
+        }
+        // Disable explicitly overrides enable (disable wins on conflict)
+        for (const name of toDisable) {
+            state.enabled.delete(name);
+        }
+        this.servers.set(serverId, state);
+        // Build the update params to send to the server
+        const enabled = [...state.enabled];
+        const allDeclared = Object.keys(declared);
+        const disabled = allDeclared.filter((n) => !state.enabled.has(n));
+        const params = {};
+        if (enabled.length > 0) {
+            params.enabled = enabled;
+        }
+        if (disabled.length > 0) {
+            params.disabled = disabled;
+        }
+        return params;
+    }
+    /**
+     * Remove all tracking state for a server.
+     * Called when a server disconnects.
+     */
+    removeServer(serverId) {
+        this.servers.delete(serverId);
+    }
+    /**
+     * Check whether a feature set is enabled for a server.
+     * Returns false if the server is unknown or the feature set is not enabled.
+     */
+    isEnabled(serverId, featureSet) {
+        const state = this.servers.get(serverId);
+        if (!state) {
+            return false;
+        }
+        return state.enabled.has(featureSet);
+    }
+    /**
+     * Validate that an inbound message's feature set is declared and enabled.
+     *
+     * @throws McplFeatureSetError with code -32003 if the feature set is unknown
+     * @throws McplFeatureSetError with code -32001 if the feature set is not enabled
+     */
+    validateInbound(serverId, featureSet) {
+        const state = this.servers.get(serverId);
+        if (!state) {
+            throw new McplFeatureSetError(UNKNOWN_FEATURE_SET, featureSet, `Unknown server: ${serverId}`);
+        }
+        if (!(featureSet in state.declared)) {
+            throw new McplFeatureSetError(UNKNOWN_FEATURE_SET, featureSet, `Unknown feature set: ${featureSet}`);
+        }
+        if (!state.enabled.has(featureSet)) {
+            throw new McplFeatureSetError(FEATURE_SET_NOT_ENABLED, featureSet, `Feature set not enabled: ${featureSet}`);
+        }
+    }
+    /**
+     * Enable feature sets for a server (supports wildcard patterns).
+     * Only declared feature sets can be enabled.
+     */
+    enable(serverId, featureSets) {
+        const state = this.servers.get(serverId);
+        if (!state) {
+            return;
+        }
+        const resolved = resolvePatterns(featureSets, state.declared);
+        for (const name of resolved) {
+            state.enabled.add(name);
+        }
+    }
+    /**
+     * Disable feature sets for a server (supports wildcard patterns).
+     * Only declared feature sets can be disabled.
+     */
+    disable(serverId, featureSets) {
+        const state = this.servers.get(serverId);
+        if (!state) {
+            return;
+        }
+        const resolved = resolvePatterns(featureSets, state.declared);
+        for (const name of resolved) {
+            state.enabled.delete(name);
+        }
+    }
+    /**
+     * Handle a `featureSets/changed` notification from a server.
+     *
+     * - Adds new feature sets from `params.added` (default to disabled).
+     * - Removes feature sets listed in `params.removed`.
+     */
+    handleFeatureSetsChanged(serverId, params) {
+        const state = this.servers.get(serverId);
+        if (!state) {
+            return;
+        }
+        // Add new feature sets (default to disabled)
+        if (params.added) {
+            for (const [name, declaration] of Object.entries(params.added)) {
+                state.declared[name] = declaration;
+                // New feature sets default to disabled — do not add to enabled set
+            }
+        }
+        // Remove feature sets
+        if (params.removed) {
+            for (const name of params.removed) {
+                delete state.declared[name];
+                state.enabled.delete(name);
+            }
+        }
+    }
+    /**
+     * Get all declared feature sets for a server.
+     * Returns null if the server is unknown.
+     */
+    getDeclaredFeatureSets(serverId) {
+        const state = this.servers.get(serverId);
+        if (!state) {
+            return null;
+        }
+        return { ...state.declared };
+    }
+    /**
+     * Get the names of all enabled feature sets for a server.
+     * Returns an empty array if the server is unknown.
+     */
+    getEnabledFeatureSets(serverId) {
+        const state = this.servers.get(serverId);
+        if (!state) {
+            return [];
+        }
+        return [...state.enabled];
+    }
+}
+//# sourceMappingURL=feature-set-manager.js.map

package/dist/src/mcpl/feature-set-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-set-manager.js","sourceRoot":"","sources":["../../../src/mcpl/feature-set-manager.ts"],"names":[],"mappings":"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"}

package/dist/src/mcpl/hook-orchestrator.d.ts

@@ -0,0 +1,51 @@
+/**
+ * HookOrchestrator — manages before/after inference fan-out to MCPL servers.
+ *
+ * This is the bridge between the MCPL protocol and the agent-framework inference
+ * pipeline. It collects ContextInjection[] from MCPL servers via beforeInference
+ * and feeds them into context-manager's compile(). After inference, it notifies
+ * servers of the result via afterInference.
+ *
+ * Design principles:
+ * - Fail-open: timeouts and errors never block inference
+ * - Parallel fan-out with per-server timeouts
+ * - Loop prevention: rejects inference/request while inside a hook
+ */
+import type { ContextInjection } from '@animalabs/context-manager';
+import type { BeforeInferenceParams, AfterInferenceParams, AfterInferenceResult } from './types.js';
+import type { McplServerRegistry } from './server-registry.js';
+import type { FeatureSetManager } from './feature-set-manager.js';
+export declare class HookOrchestrator {
+    private registry;
+    private featureSetManager;
+    private _isInHook;
+    constructor(registry: McplServerRegistry, featureSetManager: FeatureSetManager);
+    /**
+     * Whether a hook is currently executing.
+     * Used for loop prevention: inference/request from servers should be rejected
+     * while this is true (enforced by Step 6's InferenceRouter).
+     */
+    get isInHook(): boolean;
+    /**
+     * Fan out `context/beforeInference` to all capable MCPL servers in parallel.
+     *
+     * Returns aggregated ContextInjection[] ready for context-manager's compile().
+     * Fail-open: servers that time out or error are silently skipped.
+     */
+    beforeInference(params: BeforeInferenceParams): Promise<ContextInjection[]>;
+    /**
+     * Fan out `context/afterInference` to all capable MCPL servers.
+     *
+     * Non-blocking servers receive a notification (fire-and-forget).
+     * Blocking servers receive a request with a 10s timeout.
+     * Returns the first valid AfterInferenceResult from a blocking server, or null.
+     */
+    afterInference(params: AfterInferenceParams): Promise<AfterInferenceResult | null>;
+    private fanOutBeforeInference;
+    private fanOutAfterInference;
+    /**
+     * Check if a server's afterInference capability is blocking.
+     */
+    private isBlockingAfterInference;
+}
+//# sourceMappingURL=hook-orchestrator.d.ts.map

package/dist/src/mcpl/hook-orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-orchestrator.d.ts","sourceRoot":"","sources":["../../../src/mcpl/hook-orchestrator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,OAAO,KAAK,EAGV,qBAAqB,EAErB,oBAAoB,EACpB,oBAAoB,EACrB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE/D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AA0FlE,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,SAAS,CAAS;gBAEd,QAAQ,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,iBAAiB;IAK9E;;;;OAIG;IACH,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED;;;;;OAKG;IACG,eAAe,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAcjF;;;;;;OAMG;IACG,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;YAkB1E,qBAAqB;YA+CrB,oBAAoB;IAyClC;;OAEG;IACH,OAAO,CAAC,wBAAwB;CAQjC"}