@llm-dev-ops/agentics-cli 1.4.26 → 1.4.29

package/dist/bundled-agents/data-vault-agents/dist/agents/dataset-anonymization/handler.js

@@ -0,0 +1,230 @@
+/**
+ * LLM-Data-Vault: Dataset Anonymization Edge Function Handler
+ *
+ * HTTP handler for the Dataset Anonymization Agent.
+ * Designed for deployment as a Google Cloud Edge Function.
+ *
+ * CRITICAL CONSTRAINTS:
+ * - Handler MUST NOT execute inference
+ * - Handler MUST NOT modify prompts (beyond anonymization)
+ * - Handler MUST NOT route requests
+ * - Handler MUST NOT trigger orchestration
+ * - Handler produces privacy-safe artifacts ONLY
+ *
+ * @module dataset-anonymization/handler
+ */
+import { v4 as uuidv4 } from 'uuid';
+import pino from 'pino';
+import { AnonymizationRequestSchema, } from '../../contracts/index.js';
+import { DatasetAnonymizationAgent } from './agent.js';
+/**
+ * Logger instance
+ */
+const logger = pino({
+    name: 'dataset-anonymization-handler',
+    level: process.env['LOG_LEVEL'] ?? 'info',
+});
+/**
+ * Singleton agent instance (reused across invocations)
+ */
+let agentInstance = null;
+/**
+ * Get or create agent instance
+ */
+function getAgent() {
+    if (!agentInstance) {
+        const config = {
+            agentId: process.env['AGENT_ID'] ?? 'dataset-anonymization-agent',
+            agentVersion: process.env['AGENT_VERSION'] ?? '1.0.0',
+            emitDecisionEvents: process.env['EMIT_DECISION_EVENTS'] !== 'false',
+            detector: {
+                confidenceThreshold: parseFloat(process.env['DETECTION_CONFIDENCE'] ?? '0.85'),
+                contextWindow: parseInt(process.env['CONTEXT_WINDOW'] ?? '50', 10),
+                enableValidation: process.env['ENABLE_VALIDATION'] !== 'false',
+            },
+        };
+        agentInstance = new DatasetAnonymizationAgent(config);
+        logger.info({ config }, 'Agent instance created');
+    }
+    return agentInstance;
+}
+/**
+ * HTTP handler for anonymization requests
+ *
+ * Expected request body: AnonymizationRequest
+ * Response: AnonymizationResponse
+ */
+export const anonymizeHandler = async (req, res) => {
+    const requestId = req.headers['x-request-id'] ?? uuidv4();
+    const startTime = performance.now();
+    // Set response headers
+    res.setHeader('Content-Type', 'application/json');
+    res.setHeader('X-Request-Id', requestId);
+    // Log request start
+    logger.info({
+        requestId,
+        method: req.method,
+        path: req.path,
+        contentLength: req.headers['content-length'],
+    }, 'Request received');
+    try {
+        // Validate HTTP method
+        if (req.method !== 'POST') {
+            res.status(405).json({
+                error: {
+                    code: 'METHOD_NOT_ALLOWED',
+                    message: 'Only POST method is allowed',
+                },
+            });
+            return;
+        }
+        // Parse and validate request body
+        const body = req.body;
+        if (!body || typeof body !== 'object') {
+            res.status(400).json({
+                error: {
+                    code: 'INVALID_REQUEST_BODY',
+                    message: 'Request body must be a valid JSON object',
+                },
+            });
+            return;
+        }
+        // Inject request ID if not provided
+        if (!body.request_id) {
+            body.request_id = requestId;
+        }
+        // Validate against schema
+        const validation = AnonymizationRequestSchema.safeParse(body);
+        if (!validation.success) {
+            const errors = validation.error.issues.map(issue => ({
+                path: issue.path.join('.'),
+                message: issue.message,
+            }));
+            logger.warn({ requestId, errors }, 'Request validation failed');
+            res.status(400).json({
+                error: {
+                    code: 'VALIDATION_ERROR',
+                    message: 'Request validation failed',
+                    details: { errors },
+                },
+            });
+            return;
+        }
+        const request = validation.data;
+        // Get agent and process request
+        const agent = getAgent();
+        const response = await agent.anonymize(request);
+        // Calculate processing time
+        const processingTimeMs = performance.now() - startTime;
+        // Log success
+        logger.info({
+            requestId,
+            processingTimeMs,
+            piiDetections: response.results.pii_detections,
+            fieldsAnonymized: response.results.fields_anonymized,
+            complianceSatisfied: response.compliance.frameworks_satisfied,
+        }, 'Request processed successfully');
+        // Add timing header
+        res.setHeader('X-Processing-Time-Ms', Math.round(processingTimeMs).toString());
+        // Send response
+        res.status(200).json(response);
+    }
+    catch (error) {
+        const processingTimeMs = performance.now() - startTime;
+        // Determine error type and status code
+        let statusCode = 500;
+        let errorCode = 'INTERNAL_ERROR';
+        let errorMessage = 'An unexpected error occurred';
+        if (error instanceof Error) {
+            errorMessage = error.message;
+            if (error.name === 'ZodError') {
+                statusCode = 400;
+                errorCode = 'VALIDATION_ERROR';
+            }
+            else if (error.message.includes('not found')) {
+                statusCode = 404;
+                errorCode = 'NOT_FOUND';
+            }
+            else if (error.message.includes('unauthorized') || error.message.includes('forbidden')) {
+                statusCode = 403;
+                errorCode = 'FORBIDDEN';
+            }
+        }
+        // Log error
+        logger.error({
+            requestId,
+            processingTimeMs,
+            error: error instanceof Error ? error.message : String(error),
+            stack: error instanceof Error ? error.stack : undefined,
+        }, 'Request processing failed');
+        // Send error response
+        res.status(statusCode).json({
+            error: {
+                code: errorCode,
+                message: errorMessage,
+                requestId,
+            },
+        });
+    }
+};
+/**
+ * Health check handler
+ */
+export const healthHandler = async (_req, res) => {
+    res.setHeader('Content-Type', 'application/json');
+    try {
+        // Verify agent can be created
+        getAgent();
+        res.status(200).json({
+            status: 'healthy',
+            service: 'dataset-anonymization-agent',
+            version: process.env['AGENT_VERSION'] ?? '1.0.0',
+            timestamp: new Date().toISOString(),
+        });
+    }
+    catch (error) {
+        res.status(503).json({
+            status: 'unhealthy',
+            service: 'dataset-anonymization-agent',
+            error: error instanceof Error ? error.message : 'Unknown error',
+            timestamp: new Date().toISOString(),
+        });
+    }
+};
+/**
+ * Main entry point for Edge Function
+ *
+ * Routes requests based on path:
+ * - POST /anonymize -> anonymizeHandler
+ * - GET /health -> healthHandler
+ */
+export const main = async (req, res) => {
+    const path = req.path ?? '/';
+    // CORS headers
+    res.setHeader('Access-Control-Allow-Origin', process.env['CORS_ORIGIN'] ?? '*');
+    res.setHeader('Access-Control-Allow-Methods', 'GET, POST, OPTIONS');
+    res.setHeader('Access-Control-Allow-Headers', 'Content-Type, Authorization, X-Request-Id');
+    // Handle preflight
+    if (req.method === 'OPTIONS') {
+        res.status(204).send('');
+        return;
+    }
+    // Route to appropriate handler
+    if (path === '/health' || path === '/healthz') {
+        await healthHandler(req, res);
+    }
+    else if (path === '/anonymize' || path === '/') {
+        await anonymizeHandler(req, res);
+    }
+    else {
+        res.status(404).json({
+            error: {
+                code: 'NOT_FOUND',
+                message: `Path '${path}' not found`,
+            },
+        });
+    }
+};
+// Export default for Cloud Functions
+export default main;
+//# sourceMappingURL=handler.js.map

package/dist/bundled-agents/data-vault-agents/dist/agents/dataset-anonymization/handler.js.map

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

package/dist/bundled-agents/data-vault-agents/dist/agents/dataset-anonymization/index.d.ts

@@ -0,0 +1,50 @@
+/**
+ * LLM-Data-Vault: Dataset Anonymization Agent
+ *
+ * Public API for the Dataset Anonymization Agent module.
+ *
+ * This agent detects PII in datasets and applies appropriate anonymization
+ * strategies to produce privacy-safe artifacts suitable for LLM training/inference.
+ *
+ * CRITICAL CONSTRAINTS:
+ * - Agent MUST NOT execute inference
+ * - Agent MUST NOT modify prompts (beyond anonymization)
+ * - Agent MUST NOT route requests
+ * - Agent MUST NOT trigger orchestration
+ * - Agent produces privacy-safe artifacts ONLY
+ *
+ * @module dataset-anonymization
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   DatasetAnonymizationAgent,
+ *   createAnonymizationAgent,
+ * } from './agents/dataset-anonymization';
+ *
+ * // Create agent
+ * const agent = createAnonymizationAgent({
+ *   agentId: 'my-anonymization-agent',
+ *   detector: { confidenceThreshold: 0.9 },
+ * });
+ *
+ * // Anonymize data
+ * const response = await agent.anonymize({
+ *   request_id: crypto.randomUUID(),
+ *   dataset_id: 'dataset-123',
+ *   content: 'Contact john.doe@example.com at 555-123-4567',
+ *   content_format: 'text',
+ *   tenant_id: 'tenant-1',
+ *   requester: { service: 'ml-pipeline' },
+ * });
+ *
+ * console.log(response.anonymized_content);
+ * // Output: "Contact [EMAIL_REDACTED] at [PHONE_REDACTED]"
+ * ```
+ */
+export { DatasetAnonymizationAgent, createAnonymizationAgent, type AgentConfig, } from './agent.js';
+export { PIIDetector, createPIIDetector, type DetectorConfig, type DetectionStats, } from './pii-detector.js';
+export { mask, redact, hash, hashSync, generalize, synthesize, applyStrategy, applyStrategySync, type StrategyResult, type MaskConfig, type HashConfig, type GeneralizeConfig, type SynthesizeConfig, type DispatchConfig, } from './anonymization-strategies.js';
+export { checkCompliance, checkGDPRCompliance, checkHIPAACompliance, checkCCPACompliance, getRecommendedStrategy, requiresMandatoryAnonymization, type ComplianceFramework, type ComplianceCheckResult, type ComplianceViolation, type FrameworkRequirements, } from './compliance-rules.js';
+export { main, anonymizeHandler, healthHandler, } from './handler.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/bundled-agents/data-vault-agents/dist/agents/dataset-anonymization/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agents/dataset-anonymization/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAGH,OAAO,EACL,yBAAyB,EACzB,wBAAwB,EACxB,KAAK,WAAW,GACjB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,KAAK,cAAc,EACnB,KAAK,cAAc,GACpB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,IAAI,EACJ,MAAM,EACN,IAAI,EACJ,QAAQ,EACR,UAAU,EACV,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,cAAc,GACpB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,sBAAsB,EACtB,8BAA8B,EAC9B,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,GAC3B,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,IAAI,EACJ,gBAAgB,EAChB,aAAa,GACd,MAAM,cAAc,CAAC"}

package/dist/bundled-agents/data-vault-agents/dist/agents/dataset-anonymization/index.js

@@ -0,0 +1,55 @@
+/**
+ * LLM-Data-Vault: Dataset Anonymization Agent
+ *
+ * Public API for the Dataset Anonymization Agent module.
+ *
+ * This agent detects PII in datasets and applies appropriate anonymization
+ * strategies to produce privacy-safe artifacts suitable for LLM training/inference.
+ *
+ * CRITICAL CONSTRAINTS:
+ * - Agent MUST NOT execute inference
+ * - Agent MUST NOT modify prompts (beyond anonymization)
+ * - Agent MUST NOT route requests
+ * - Agent MUST NOT trigger orchestration
+ * - Agent produces privacy-safe artifacts ONLY
+ *
+ * @module dataset-anonymization
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   DatasetAnonymizationAgent,
+ *   createAnonymizationAgent,
+ * } from './agents/dataset-anonymization';
+ *
+ * // Create agent
+ * const agent = createAnonymizationAgent({
+ *   agentId: 'my-anonymization-agent',
+ *   detector: { confidenceThreshold: 0.9 },
+ * });
+ *
+ * // Anonymize data
+ * const response = await agent.anonymize({
+ *   request_id: crypto.randomUUID(),
+ *   dataset_id: 'dataset-123',
+ *   content: 'Contact john.doe@example.com at 555-123-4567',
+ *   content_format: 'text',
+ *   tenant_id: 'tenant-1',
+ *   requester: { service: 'ml-pipeline' },
+ * });
+ *
+ * console.log(response.anonymized_content);
+ * // Output: "Contact [EMAIL_REDACTED] at [PHONE_REDACTED]"
+ * ```
+ */
+// Main agent
+export { DatasetAnonymizationAgent, createAnonymizationAgent, } from './agent.js';
+// PII Detection
+export { PIIDetector, createPIIDetector, } from './pii-detector.js';
+// Anonymization Strategies
+export { mask, redact, hash, hashSync, generalize, synthesize, applyStrategy, applyStrategySync, } from './anonymization-strategies.js';
+// Compliance Rules
+export { checkCompliance, checkGDPRCompliance, checkHIPAACompliance, checkCCPACompliance, getRecommendedStrategy, requiresMandatoryAnonymization, } from './compliance-rules.js';
+// HTTP Handler (for Edge Function deployment)
+export { main, anonymizeHandler, healthHandler, } from './handler.js';
+//# sourceMappingURL=index.js.map

package/dist/bundled-agents/data-vault-agents/dist/agents/dataset-anonymization/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/agents/dataset-anonymization/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAEH,aAAa;AACb,OAAO,EACL,yBAAyB,EACzB,wBAAwB,GAEzB,MAAM,YAAY,CAAC;AAEpB,gBAAgB;AAChB,OAAO,EACL,WAAW,EACX,iBAAiB,GAGlB,MAAM,mBAAmB,CAAC;AAE3B,2BAA2B;AAC3B,OAAO,EACL,IAAI,EACJ,MAAM,EACN,IAAI,EACJ,QAAQ,EACR,UAAU,EACV,UAAU,EACV,aAAa,EACb,iBAAiB,GAOlB,MAAM,+BAA+B,CAAC;AAEvC,mBAAmB;AACnB,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,sBAAsB,EACtB,8BAA8B,GAK/B,MAAM,uBAAuB,CAAC;AAE/B,8CAA8C;AAC9C,OAAO,EACL,IAAI,EACJ,gBAAgB,EAChB,aAAa,GACd,MAAM,cAAc,CAAC"}

package/dist/bundled-agents/data-vault-agents/dist/agents/dataset-anonymization/pii-detector.d.ts

@@ -0,0 +1,142 @@
+/**
+ * LLM-Data-Vault: PII Detection Module
+ *
+ * Provides comprehensive PII (Personally Identifiable Information) detection
+ * using regex patterns and contextual validation.
+ *
+ * CRITICAL CONSTRAINTS:
+ * - This module MUST NOT execute inference
+ * - This module MUST NOT modify prompts
+ * - This module MUST NOT route requests
+ * - This module produces detection artifacts ONLY
+ *
+ * @module dataset-anonymization/pii-detector
+ */
+import type { PIIMatch, PIIType } from '../../contracts/index.js';
+/**
+ * Pattern configuration for PII detection
+ */
+interface PIIPattern {
+    /** PII type this pattern detects */
+    type: PIIType;
+    /** Regular expression pattern */
+    regex: RegExp;
+    /** Base confidence score (0-1) */
+    baseConfidence: number;
+    /** Whether this pattern requires context validation */
+    requiresContextValidation: boolean;
+    /** Optional validator function */
+    validator?: (text: string) => boolean;
+    /** Context keywords that increase confidence */
+    contextKeywords?: string[];
+}
+/**
+ * Detection configuration options
+ */
+export interface DetectorConfig {
+    /** Minimum confidence threshold (0-1) */
+    confidenceThreshold?: number;
+    /** Context window size (characters around match) */
+    contextWindow?: number;
+    /** Enable validation functions */
+    enableValidation?: boolean;
+    /** Custom patterns to add */
+    customPatterns?: PIIPattern[];
+}
+/**
+ * Detection result statistics
+ */
+export interface DetectionStats {
+    totalCharactersProcessed: number;
+    totalDetections: number;
+    detectionsByType: Partial<Record<PIIType, number>>;
+    processingTimeMs: number;
+    averageConfidence: number;
+}
+/**
+ * PII Detector class
+ *
+ * Detects PII in text using regex patterns with optional contextual validation.
+ */
+export declare class PIIDetector {
+    private readonly patterns;
+    private readonly confidenceThreshold;
+    private readonly contextWindow;
+    private readonly enableValidation;
+    constructor(config?: DetectorConfig);
+    /**
+     * Detect PII in text
+     *
+     * @param text - Text to analyze
+     * @returns Array of PII matches above confidence threshold
+     */
+    detect(text: string): PIIMatch[];
+    /**
+     * Detect PII with statistics
+     *
+     * @param text - Text to analyze
+     * @returns Detection results with statistics
+     */
+    detectWithStats(text: string): {
+        matches: PIIMatch[];
+        stats: DetectionStats;
+    };
+    /**
+     * Detect with a single pattern
+     */
+    private detectWithPattern;
+    /**
+     * Extract context around a match
+     */
+    private extractContext;
+    /**
+     * Adjust confidence based on contextual keywords
+     */
+    private adjustConfidenceByContext;
+    /**
+     * Remove overlapping matches, keeping highest confidence
+     */
+    private removeOverlappingMatches;
+    /**
+     * Build default PII detection patterns
+     */
+    private buildDefaultPatterns;
+    /**
+     * Check if email is from a disposable domain
+     */
+    private isDisposableEmail;
+    /**
+     * Validate SSN format (exclude known invalid patterns)
+     */
+    private validateSSN;
+    /**
+     * Validate credit card number using Luhn algorithm
+     */
+    private validateLuhn;
+    /**
+     * Validate phone number length
+     */
+    private validatePhone;
+    /**
+     * Check if IP is private/reserved
+     */
+    private isPrivateIP;
+    /**
+     * Validate API key entropy (detect random strings)
+     */
+    private validateAPIKeyEntropy;
+    /**
+     * Calculate Shannon entropy of a string
+     */
+    private calculateEntropy;
+    /**
+     * Validate IBAN format (basic check)
+     */
+    private validateIBAN;
+}
+/**
+ * Create a PII detector with default configuration
+ */
+export declare function createPIIDetector(config?: DetectorConfig): PIIDetector;
+export {};
+//# sourceMappingURL=pii-detector.d.ts.map

package/dist/bundled-agents/data-vault-agents/dist/agents/dataset-anonymization/pii-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pii-detector.d.ts","sourceRoot":"","sources":["../../../src/agents/dataset-anonymization/pii-detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAElE;;GAEG;AACH,UAAU,UAAU;IAClB,oCAAoC;IACpC,IAAI,EAAE,OAAO,CAAC;IACd,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,uDAAuD;IACvD,yBAAyB,EAAE,OAAO,CAAC;IACnC,kCAAkC;IAClC,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IACtC,gDAAgD;IAChD,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAcD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,yCAAyC;IACzC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,oDAAoD;IACpD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kCAAkC;IAClC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,6BAA6B;IAC7B,cAAc,CAAC,EAAE,UAAU,EAAE,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,wBAAwB,EAAE,MAAM,CAAC;IACjC,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;IACnD,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;;;GAIG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAS;IAC7C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAU;gBAE/B,MAAM,GAAE,cAAmB;IAOvC;;;;;OAKG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,EAAE;IAgBhC;;;;;OAKG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;QAAC,KAAK,EAAE,cAAc,CAAA;KAAE;IAyB7E;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAkDzB;;OAEG;IACH,OAAO,CAAC,cAAc;IAWtB;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAsFjC;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAgChC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IA4I5B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAazB;;OAEG;IACH,OAAO,CAAC,WAAW;IAiBnB;;OAEG;IACH,OAAO,CAAC,YAAY;IAoBpB;;OAEG;IACH,OAAO,CAAC,aAAa;IAKrB;;OAEG;IACH,OAAO,CAAC,WAAW;IAwBnB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAK7B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAgBxB;;OAEG;IACH,OAAO,CAAC,YAAY;CAGrB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG,WAAW,CAEtE"}