mcard-js 2.1.41 → 2.1.43

package/dist/ptr/CLMIntrospection.js

@@ -1,329 +0,0 @@
-/**
- * CLM Introspection - Recursive CLM Hierarchy Analysis
- *
- * This module provides introspection capabilities for CLM (Cubical Logic Model)
- * hierarchies, enabling formal inspection of recursive CLM composition.
- *
- * ## Recursive CLM Composition
- *
- * CLMs can compose recursively, creating hierarchies of specifications:
- *
- * ```
- * Root CLM (Chapter)
- * ├── Sub-CLM A (referenced PCard)
- * │   ├── Leaf CLM X
- * │   └── Leaf CLM Y
- * └── Sub-CLM B (referenced PCard)
- *     └── Leaf CLM Z
- * ```
- *
- * This module enables:
- * - Traversal of CLM dependency graphs
- * - Detection of circular dependencies
- * - Extraction of CLM metadata at any level
- * - Composition path tracing
- *
- * ## SMC Structure Preservation
- *
- * The introspection respects the Symmetric Monoidal Category structure:
- * - Composition paths preserve associativity
- * - Parallel compositions are correctly identified
- * - Identity CLMs are recognized
- *
- * @see CLM_MCard_REPL_Implementation.md §8: Recursive CLM Composition
- * @see PTR_MCard_CLM_Recent_Developments_Jan2026.md §4.2: Recursive Structure
- */
-import { parse } from 'yaml';
-/**
- * Type classification for CLM nodes
- */
-export var CLMType;
-(function (CLMType) {
-    CLMType["CHAPTER"] = "chapter";
-    CLMType["PCARD"] = "pcard";
-    CLMType["COMPOSED"] = "composed";
-    CLMType["PARALLEL"] = "parallel";
-    CLMType["REFERENCE"] = "reference";
-    CLMType["UNKNOWN"] = "unknown";
-})(CLMType || (CLMType = {}));
-/**
- * Type of composition between CLMs
- */
-export var CompositionType;
-(function (CompositionType) {
-    CompositionType["SEQUENTIAL"] = "sequential";
-    CompositionType["PARALLEL"] = "parallel";
-    CompositionType["NONE"] = "none"; // Leaf node
-})(CompositionType || (CompositionType = {}));
-/**
- * Recursive CLM Hierarchy Introspector
- *
- * Analyzes CLM composition graphs, extracting structure and metadata
- * from arbitrarily nested CLM hierarchies.
- *
- * ## Usage
- *
- * ```typescript
- * const introspector = new CLMIntrospector(collection);
- * const result = await introspector.introspect("root_pcard_hash");
- *
- * // Access hierarchy
- * console.log(result.root.chapter);
- * for (const child of result.root.children) {
- *     console.log(`  - ${child.hash}: ${child.clmType}`);
- * }
- *
- * // Check for cycles
- * if (result.cycles.length > 0) {
- *     console.log(`Circular dependencies detected: ${result.cycles}`);
- * }
- * ```
- */
-export class CLMIntrospector {
-    collection;
-    maxDepth;
-    visited = new Set();
-    nodes = new Map();
-    cycles = [];
-    constructor(collection, maxDepth = 100) {
-        this.collection = collection;
-        this.maxDepth = maxDepth;
-    }
-    /**
-     * Introspect a CLM hierarchy starting from the given root
-     */
-    async introspect(pcardHash) {
-        this.visited = new Set();
-        this.nodes = new Map();
-        this.cycles = [];
-        let root = await this.buildTree(pcardHash, 0, []);
-        if (!root) {
-            root = {
-                hash: pcardHash,
-                clmType: CLMType.UNKNOWN,
-                compositionType: CompositionType.NONE,
-                children: [],
-                depth: 0,
-                runtime: 'unknown'
-            };
-        }
-        // Calculate statistics
-        const maxDepth = Math.max(...Array.from(this.nodes.values()).map(n => n.depth), 0);
-        const runtimes = this.countRuntimes();
-        const { seq, par, leaf } = this.countCompositions();
-        return {
-            root,
-            nodes: this.nodes,
-            maxDepth,
-            nodeCount: this.nodes.size,
-            cycles: this.cycles,
-            runtimes,
-            sequentialCount: seq,
-            parallelCount: par,
-            leafCount: leaf
-        };
-    }
-    /**
-     * Recursively build the CLM tree from a PCard hash
-     */
-    async buildTree(pcardHash, depth, path, parentHash) {
-        // Check for cycles
-        if (path.includes(pcardHash)) {
-            const cycleStart = path.indexOf(pcardHash);
-            const cycle = [...path.slice(cycleStart), pcardHash];
-            this.cycles.push(cycle);
-            console.warn(`Circular dependency detected: ${cycle.join(' -> ')}`);
-            return null;
-        }
-        // Check max depth
-        if (depth > this.maxDepth) {
-            console.warn(`Max depth ${this.maxDepth} exceeded at ${pcardHash}`);
-            return null;
-        }
-        // Check if already processed
-        if (this.nodes.has(pcardHash)) {
-            return this.nodes.get(pcardHash);
-        }
-        // Get PCard content
-        const clmData = await this.getCLMData(pcardHash);
-        if (!clmData) {
-            return null;
-        }
-        // Create node
-        const node = this.createNode(pcardHash, clmData, depth, parentHash);
-        this.nodes.set(pcardHash, node);
-        // Process children based on composition type
-        const newPath = [...path, pcardHash];
-        if (node.compositionType === CompositionType.SEQUENTIAL) {
-            // Sequential composition: process steps
-            const steps = clmData?.clm?.abstract?.steps || [];
-            for (const stepHash of steps) {
-                const child = await this.buildTree(stepHash, depth + 1, newPath, pcardHash);
-                if (child) {
-                    node.children.push(child);
-                }
-            }
-        }
-        else if (node.compositionType === CompositionType.PARALLEL) {
-            // Parallel composition: process components
-            const left = clmData?.clm?.abstract?.left;
-            const right = clmData?.clm?.abstract?.right;
-            if (left) {
-                const child = await this.buildTree(left, depth + 1, newPath, pcardHash);
-                if (child) {
-                    node.children.push(child);
-                }
-            }
-            if (right) {
-                const child = await this.buildTree(right, depth + 1, newPath, pcardHash);
-                if (child) {
-                    node.children.push(child);
-                }
-            }
-        }
-        return node;
-    }
-    /**
-     * Get CLM data from a PCard hash
-     */
-    async getCLMData(pcardHash) {
-        if (!this.collection) {
-            return null;
-        }
-        try {
-            const pcard = await this.collection.get(pcardHash);
-            if (!pcard) {
-                return null;
-            }
-            const content = typeof pcard.content === 'string'
-                ? pcard.content
-                : new TextDecoder().decode(pcard.content);
-            return parse(content);
-        }
-        catch (e) {
-            console.error(`Failed to get CLM data for ${pcardHash}: ${e}`);
-            return null;
-        }
-    }
-    /**
-     * Create a CLMNode from parsed CLM data
-     */
-    createNode(pcardHash, clmData, depth, parentHash) {
-        // Determine CLM type
-        const clmType = this.classifyCLM(clmData);
-        // Extract CLM dimensions
-        const clmSection = clmData.clm || {};
-        const abstract = clmSection.abstract || clmData.abstract;
-        const concrete = clmSection.concrete || clmData.concrete;
-        const balanced = clmSection.balanced || clmData.balanced;
-        // Extract chapter
-        const chapter = clmData.chapter;
-        // Determine composition type
-        let compositionType = CompositionType.NONE;
-        const abstractType = abstract?.type || '';
-        if (abstractType === 'sequential_composition') {
-            compositionType = CompositionType.SEQUENTIAL;
-        }
-        else if (abstractType === 'tensor_product') {
-            compositionType = CompositionType.PARALLEL;
-        }
-        // Extract runtime
-        const runtime = concrete?.runtime ||
-            clmSection.concrete?.runtime ||
-            'unknown';
-        return {
-            hash: pcardHash,
-            clmType,
-            abstract,
-            concrete,
-            balanced,
-            chapter,
-            compositionType,
-            children: [],
-            parentHash,
-            depth,
-            runtime
-        };
-    }
-    /**
-     * Classify the CLM by its structure
-     */
-    classifyCLM(clmData) {
-        if (clmData.chapter) {
-            return CLMType.CHAPTER;
-        }
-        const abstract = clmData.clm?.abstract || clmData.abstract || {};
-        const abstractType = typeof abstract === 'object' ? abstract.type || '' : '';
-        if (abstractType === 'sequential_composition') {
-            return CLMType.COMPOSED;
-        }
-        else if (abstractType === 'tensor_product') {
-            return CLMType.PARALLEL;
-        }
-        else if (clmData.clm || clmData.abstract) {
-            return CLMType.PCARD;
-        }
-        return CLMType.UNKNOWN;
-    }
-    /**
-     * Count nodes by runtime
-     */
-    countRuntimes() {
-        const runtimes = new Map();
-        for (const node of this.nodes.values()) {
-            const rt = node.runtime;
-            runtimes.set(rt, (runtimes.get(rt) || 0) + 1);
-        }
-        return runtimes;
-    }
-    /**
-     * Count sequential, parallel, and leaf compositions
-     */
-    countCompositions() {
-        let seq = 0;
-        let par = 0;
-        let leaf = 0;
-        for (const node of this.nodes.values()) {
-            if (node.compositionType === CompositionType.SEQUENTIAL) {
-                seq++;
-            }
-            else if (node.compositionType === CompositionType.PARALLEL) {
-                par++;
-            }
-            else {
-                leaf++;
-            }
-        }
-        return { seq, par, leaf };
-    }
-    /**
-     * Generate a tree visualization of the CLM hierarchy
-     */
-    toTreeString(result) {
-        const lines = [];
-        this.treeToString(result.root, lines, '', true);
-        return lines.join('\n');
-    }
-    /**
-     * Recursive helper for tree visualization
-     */
-    treeToString(node, lines, prefix, isLast) {
-        const connector = isLast ? '└── ' : '├── ';
-        // Build node label
-        const labelParts = [node.hash.substring(0, 8)];
-        if (node.chapter?.title) {
-            labelParts.push(`(${node.chapter.title})`);
-        }
-        labelParts.push(`[${node.clmType}]`);
-        if (node.runtime !== 'unknown') {
-            labelParts.push(`@${node.runtime}`);
-        }
-        lines.push(prefix + connector + labelParts.join(' '));
-        // Process children
-        const newPrefix = prefix + (isLast ? '    ' : '│   ');
-        node.children.forEach((child, i) => {
-            this.treeToString(child, lines, newPrefix, i === node.children.length - 1);
-        });
-    }
-}
-//# sourceMappingURL=CLMIntrospection.js.map

package/dist/ptr/CLMIntrospection.js.map

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

package/dist/ptr/FaroSidecar.d.ts

@@ -1,56 +0,0 @@
-import { Faro } from '@grafana/faro-web-sdk';
-/**
- * Configuration for the Faro Observability Sidecar
- */
-export interface FaroSidecarConfig {
-    url: string;
-    apiKey?: string;
-    appName: string;
-    appVersion: string;
-    enableTracing?: boolean;
-    namespace?: string;
-    additionalInstrumentations?: any[];
-}
-/**
- * FaroSidecar - Integrates Grafana Faro for Frontend Observability
- *
- * Acts as an observability sidecar for the PTR, capturing:
- * - Logs
- * - Errors
- * - Web Vitals
- * - Traces (OpenTelemetry)
- * - User Sessions
- */
-export declare class FaroSidecar {
-    private static instance;
-    private faro;
-    private constructor();
-    /**
-     * Get the singleton instance of FaroSidecar
-     */
-    static getInstance(): FaroSidecar;
-    /**
-     * Initialize the Faro SDK
-     *
-     * @param config Configuration options
-     * @returns The initialized Faro instance or null if not in a browser environment
-     */
-    initialize(config: FaroSidecarConfig): Faro | null;
-    /**
-     * Get the underlying Faro instance
-     */
-    getFaro(): Faro | null;
-    /**
-     * Manually push an error to Faro
-     */
-    pushError(error: Error, context?: Record<string, any>): void;
-    /**
-     * Manually push a log message to Faro
-     */
-    pushLog(message: string, context?: Record<string, any>): void;
-    /**
-     * Push a custom event
-     */
-    pushEvent(name: string, attributes?: Record<string, string>): void;
-}
-//# sourceMappingURL=FaroSidecar.d.ts.map

package/dist/ptr/FaroSidecar.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"FaroSidecar.d.ts","sourceRoot":"","sources":["../../src/ptr/FaroSidecar.ts"],"names":[],"mappings":"AACA,OAAO,EAGH,IAAI,EACP,MAAM,uBAAuB,CAAC;AAG/B;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0BAA0B,CAAC,EAAE,GAAG,EAAE,CAAC;CACtC;AAED;;;;;;;;;GASG;AACH,qBAAa,WAAW;IACpB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA4B;IACnD,OAAO,CAAC,IAAI,CAAqB;IAEjC,OAAO;IAEP;;OAEG;WACW,WAAW,IAAI,WAAW;IAOxC;;;;;OAKG;IACI,UAAU,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,GAAG,IAAI;IAuDzD;;OAEG;IACI,OAAO,IAAI,IAAI,GAAG,IAAI;IAI7B;;OAEG;IACI,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAMnE;;OAEG;IACI,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAMpE;;OAEG;IACI,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;CAK5E"}

package/dist/ptr/FaroSidecar.js

@@ -1,102 +0,0 @@
-import { initializeFaro, getWebInstrumentations } from '@grafana/faro-web-sdk';
-import { TracingInstrumentation } from '@grafana/faro-web-tracing';
-/**
- * FaroSidecar - Integrates Grafana Faro for Frontend Observability
- *
- * Acts as an observability sidecar for the PTR, capturing:
- * - Logs
- * - Errors
- * - Web Vitals
- * - Traces (OpenTelemetry)
- * - User Sessions
- */
-export class FaroSidecar {
-    static instance = null;
-    faro = null;
-    constructor() { }
-    /**
-     * Get the singleton instance of FaroSidecar
-     */
-    static getInstance() {
-        if (!FaroSidecar.instance) {
-            FaroSidecar.instance = new FaroSidecar();
-        }
-        return FaroSidecar.instance;
-    }
-    /**
-     * Initialize the Faro SDK
-     *
-     * @param config Configuration options
-     * @returns The initialized Faro instance or null if not in a browser environment
-     */
-    initialize(config) {
-        // Ensure we are in a browser environment
-        if (typeof window === 'undefined') {
-            console.warn('[FaroSidecar] Not initializing Grafana Faro: Non-browser environment detected.');
-            return null;
-        }
-        if (this.faro) {
-            console.warn('[FaroSidecar] Grafana Faro is already initialized.');
-            return this.faro;
-        }
-        const { url, apiKey, appName, appVersion, enableTracing = true, namespace = 'ptr_runtime', additionalInstrumentations = [] } = config;
-        const instrumentations = [
-            ...getWebInstrumentations(),
-            ...additionalInstrumentations
-        ];
-        if (enableTracing) {
-            instrumentations.push(new TracingInstrumentation());
-        }
-        const faroOptions = {
-            url,
-            apiKey,
-            app: {
-                name: appName,
-                version: appVersion,
-                namespace
-            },
-            instrumentations,
-        };
-        try {
-            this.faro = initializeFaro(faroOptions);
-            console.log(`[FaroSidecar] Grafana Faro initialized for ${appName}@${appVersion}`);
-            // Auto-push a session start log
-            this.faro.api.pushLog([`PTR Observability Sidecar started for ${appName}`]);
-        }
-        catch (error) {
-            console.error('[FaroSidecar] Failed to initialize Grafana Faro:', error);
-        }
-        return this.faro;
-    }
-    /**
-     * Get the underlying Faro instance
-     */
-    getFaro() {
-        return this.faro;
-    }
-    /**
-     * Manually push an error to Faro
-     */
-    pushError(error, context) {
-        if (this.faro) {
-            this.faro.api.pushError(error, { context });
-        }
-    }
-    /**
-     * Manually push a log message to Faro
-     */
-    pushLog(message, context) {
-        if (this.faro) {
-            this.faro.api.pushLog([message], { context });
-        }
-    }
-    /**
-     * Push a custom event
-     */
-    pushEvent(name, attributes) {
-        if (this.faro) {
-            this.faro.api.pushEvent(name, attributes);
-        }
-    }
-}
-//# sourceMappingURL=FaroSidecar.js.map

package/dist/ptr/FaroSidecar.js.map

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

package/dist/ptr/LensProtocol.d.ts

@@ -1,84 +0,0 @@
-/**
- * LensProtocol - JSON-RPC 2.0 communication for PTR
- *
- * Provides standardized message format for PCard execution
- */
-export interface JsonRpcRequest {
-    jsonrpc: '2.0';
-    id: string | number;
-    method: string;
-    params?: unknown;
-}
-export interface JsonRpcResponse {
-    jsonrpc: '2.0';
-    id: string | number;
-    result?: unknown;
-    error?: {
-        code: number;
-        message: string;
-        data?: unknown;
-    };
-}
-export interface ExecuteParams {
-    pcard_hash: string;
-    target_hash: string;
-    context?: Record<string, unknown>;
-}
-export interface VerifyParams {
-    pcard_hash: string;
-    target_hash: string;
-    context?: Record<string, unknown>;
-}
-export interface RevealParams {
-    card_hash: string;
-    aspect: string;
-}
-/**
- * LensProtocol - Create and parse JSON-RPC messages
- */
-export declare class LensProtocol {
-    private static idCounter;
-    /**
-     * Create an execute request
-     */
-    static createExecuteRequest(pcard_hash: string, target_hash: string, context?: Record<string, unknown>): JsonRpcRequest;
-    /**
-     * Create a verify request
-     */
-    static createVerifyRequest(pcard_hash: string, target_hash: string, context?: Record<string, unknown>): JsonRpcRequest;
-    /**
-     * Create a reveal request
-     */
-    static createRevealRequest(card_hash: string, aspect: string): JsonRpcRequest;
-    /**
-     * Create a system status request
-     */
-    static createStatusRequest(): JsonRpcRequest;
-    /**
-     * Create a system health request
-     */
-    static createHealthRequest(): JsonRpcRequest;
-    /**
-     * Create a success response
-     */
-    static createSuccessResponse(id: string | number, result: unknown): JsonRpcResponse;
-    /**
-     * Create an error response
-     */
-    static createErrorResponse(id: string | number, code: number, message: string, data?: unknown): JsonRpcResponse;
-    /**
-     * Parse a JSON-RPC response
-     */
-    static parseResponse<T>(response: JsonRpcResponse): T;
-}
-export declare const ErrorCodes: {
-    readonly PARSE_ERROR: -32700;
-    readonly INVALID_REQUEST: -32600;
-    readonly METHOD_NOT_FOUND: -32601;
-    readonly INVALID_PARAMS: -32602;
-    readonly INTERNAL_ERROR: -32603;
-    readonly EXECUTION_ERROR: -32000;
-    readonly VERIFICATION_FAILED: -32001;
-    readonly TIMEOUT: -32002;
-};
-//# sourceMappingURL=LensProtocol.d.ts.map

package/dist/ptr/LensProtocol.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"LensProtocol.d.ts","sourceRoot":"","sources":["../../src/ptr/LensProtocol.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,cAAc;IAC3B,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC5B,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE;QACJ,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,OAAO,CAAC;KAClB,CAAC;CACL;AAED,MAAM,WAAW,aAAa;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,YAAY;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,YAAY;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,qBAAa,YAAY;IACrB,OAAO,CAAC,MAAM,CAAC,SAAS,CAAK;IAE7B;;OAEG;IACH,MAAM,CAAC,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,cAAc;IASvH;;OAEG;IACH,MAAM,CAAC,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,cAAc;IAStH;;OAEG;IACH,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,cAAc;IAS7E;;OAEG;IACH,MAAM,CAAC,mBAAmB,IAAI,cAAc;IAQ5C;;OAEG;IACH,MAAM,CAAC,mBAAmB,IAAI,cAAc;IAQ5C;;OAEG;IACH,MAAM,CAAC,qBAAqB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,eAAe;IAInF;;OAEG;IACH,MAAM,CAAC,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,eAAe;IAI/G;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,CAAC,EAAE,QAAQ,EAAE,eAAe,GAAG,CAAC;CAMxD;AAGD,eAAO,MAAM,UAAU;;;;;;;;;CAUb,CAAC"}