agentstudio 0.1.18 → 0.1.21

package/services/a2a/agentCardService.js

@@ -0,0 +1,228 @@
+"use strict";
+/**
+ * Agent Card Service
+ *
+ * Generates Agent Cards from AgentConfig for A2A protocol discovery.
+ * Agent Cards are auto-generated and should never be manually maintained.
+ *
+ * Pure function approach: generateAgentCard(agentConfig, projectContext) -> AgentCard
+ *
+ * Phase 4: US2 - Agent Card Auto-Generation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateAgentCard = generateAgentCard;
+/**
+ * Generate Agent Card from agent configuration (pure function)
+ *
+ * This is a pure function with no side effects - it takes agent config and project context
+ * and returns a complete Agent Card compliant with A2A protocol v1.0.
+ *
+ * @param agentConfig - Agent configuration with tools and metadata
+ * @param projectContext - Project-specific context (ID, name, working directory, A2A ID, baseUrl)
+ * @returns Complete Agent Card ready for A2A protocol exposure
+ */
+function generateAgentCard(agentConfig, projectContext) {
+    // Extract skills from agent's tools
+    const skills = extractSkillsFromTools(agentConfig.allowedTools);
+    // Determine agent category
+    const agentCategory = agentConfig.source === 'plugin' ? 'subagent' : 'builtin';
+    // Build Agent Card
+    const agentCard = {
+        // A2A Protocol required fields
+        name: agentConfig.name,
+        description: agentConfig.description,
+        version: agentConfig.version,
+        url: `${projectContext.baseUrl}/a2a/${projectContext.a2aAgentId}`,
+        // Agent capabilities (skills extracted from tools)
+        skills,
+        // Authentication requirements (API key only for now)
+        securitySchemes: [
+            {
+                type: 'apiKey',
+                in: 'header',
+                name: 'Authorization',
+                scheme: 'bearer',
+            },
+        ],
+        // AgentStudio-specific context
+        context: {
+            a2aAgentId: projectContext.a2aAgentId,
+            projectId: projectContext.projectId,
+            projectName: projectContext.projectName,
+            workingDirectory: projectContext.workingDirectory,
+            agentType: agentConfig.id,
+            agentCategory,
+        },
+    };
+    return agentCard;
+}
+/**
+ * Extract skills from agent's enabled MCP tools
+ *
+ * Converts AgentTool[] to Skill[] by mapping tool names to skill definitions.
+ * Only includes enabled tools.
+ *
+ * @param tools - Array of agent tools with enable/disable state
+ * @returns Array of skills for Agent Card
+ */
+function extractSkillsFromTools(tools) {
+    const skills = [];
+    // Filter to enabled tools only
+    const enabledTools = tools.filter((tool) => tool.enabled);
+    for (const tool of enabledTools) {
+        const skill = toolToSkill(tool);
+        if (skill) {
+            skills.push(skill);
+        }
+    }
+    return skills;
+}
+/**
+ * Convert a single AgentTool to a Skill definition
+ *
+ * Maps common tool names to their skill schemas. For unknown tools,
+ * generates a generic skill with minimal schema.
+ *
+ * @param tool - Agent tool configuration
+ * @returns Skill definition or null if tool should be excluded
+ */
+function toolToSkill(tool) {
+    // Map common tools to skill definitions
+    const toolSchemas = {
+        // File operations
+        read_file: {
+            description: 'Read content from a file',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    path: { type: 'string', description: 'File path to read' },
+                },
+                required: ['path'],
+            },
+            outputSchema: {
+                type: 'object',
+                properties: {
+                    content: { type: 'string', description: 'File content' },
+                },
+            },
+        },
+        write_file: {
+            description: 'Write content to a file',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    path: { type: 'string', description: 'File path to write' },
+                    content: { type: 'string', description: 'Content to write' },
+                },
+                required: ['path', 'content'],
+            },
+            outputSchema: {
+                type: 'object',
+                properties: {
+                    success: { type: 'boolean' },
+                },
+            },
+        },
+        edit_file: {
+            description: 'Edit file content with search and replace',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    path: { type: 'string', description: 'File path to edit' },
+                    old_string: { type: 'string', description: 'Text to replace' },
+                    new_string: { type: 'string', description: 'Replacement text' },
+                },
+                required: ['path', 'old_string', 'new_string'],
+            },
+            outputSchema: {
+                type: 'object',
+                properties: {
+                    success: { type: 'boolean' },
+                },
+            },
+        },
+        // Command execution
+        execute_command: {
+            description: 'Execute shell command',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    command: { type: 'string', description: 'Shell command to execute' },
+                },
+                required: ['command'],
+            },
+            outputSchema: {
+                type: 'object',
+                properties: {
+                    stdout: { type: 'string' },
+                    stderr: { type: 'string' },
+                    exitCode: { type: 'number' },
+                },
+            },
+        },
+        // Search
+        grep: {
+            description: 'Search for patterns in files',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    pattern: { type: 'string', description: 'Search pattern' },
+                    path: { type: 'string', description: 'Directory to search' },
+                },
+                required: ['pattern'],
+            },
+            outputSchema: {
+                type: 'object',
+                properties: {
+                    matches: {
+                        type: 'array',
+                        items: { type: 'string' },
+                    },
+                },
+            },
+        },
+        glob: {
+            description: 'Find files matching glob pattern',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    pattern: { type: 'string', description: 'Glob pattern' },
+                },
+                required: ['pattern'],
+            },
+            outputSchema: {
+                type: 'object',
+                properties: {
+                    files: {
+                        type: 'array',
+                        items: { type: 'string' },
+                    },
+                },
+            },
+        },
+    };
+    // Check if we have a predefined schema for this tool
+    const schema = toolSchemas[tool.name];
+    if (schema) {
+        return {
+            name: tool.name,
+            ...schema,
+        };
+    }
+    // For unknown tools, generate generic schema
+    return {
+        name: tool.name,
+        description: `Execute ${tool.name} tool`,
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+        outputSchema: {
+            type: 'object',
+            properties: {
+                result: { type: 'string' },
+            },
+        },
+    };
+}
+//# sourceMappingURL=agentCardService.js.map

package/services/a2a/agentCardService.js.map

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

package/services/a2a/agentMappingService.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Agent Mapping Service
+ *
+ * Maps A2A agent IDs (UUID v4) to internal project/agent identifiers.
+ * Provides bidirectional resolution and lazy generation of A2A IDs.
+ *
+ * Storage: ~/.claude-agent/a2a-agent-mappings.json (global registry)
+ * Format: { version: "1.0.0", mappings: { [a2aAgentId]: AgentMapping } }
+ */
+import type { AgentMapping } from '../../types/a2a.js';
+/**
+ * Get or create A2A agent ID for a project/agent combination
+ * Lazily generates UUID v4 on first request
+ *
+ * @param projectId - Internal project identifier
+ * @param agentType - Internal agent type identifier
+ * @param workingDirectory - Absolute path to project working directory
+ * @returns A2A agent ID (UUID v4)
+ */
+export declare function getOrCreateA2AId(projectId: string, agentType: string, workingDirectory: string): Promise<string>;
+/**
+ * Resolve A2A agent ID to internal project/agent mapping
+ *
+ * @param a2aAgentId - A2A agent ID (UUID v4)
+ * @returns AgentMapping or null if not found
+ */
+export declare function resolveA2AId(a2aAgentId: string): Promise<AgentMapping | null>;
+/**
+ * List all agent mappings
+ *
+ * @returns Array of all agent mappings
+ */
+export declare function listAgentMappings(): Promise<AgentMapping[]>;
+/**
+ * Delete agent mapping (used when project or agent is deleted)
+ *
+ * @param a2aAgentId - A2A agent ID to delete
+ * @returns true if deleted, false if not found
+ */
+export declare function deleteAgentMapping(a2aAgentId: string): Promise<boolean>;
+/**
+ * Get A2A agent ID for a project/agent combination without creating
+ *
+ * @param projectId - Internal project identifier
+ * @param agentType - Internal agent type identifier
+ * @returns A2A agent ID or null if not found
+ */
+export declare function getA2AId(projectId: string, agentType: string): Promise<string | null>;
+/**
+ * Invalidate in-memory cache (useful for testing)
+ */
+export declare function invalidateCache(): void;
+//# sourceMappingURL=agentMappingService.d.ts.map

package/services/a2a/agentMappingService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentMappingService.d.ts","sourceRoot":"","sources":["../../../src/services/a2a/agentMappingService.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,KAAK,EAAE,YAAY,EAAwB,MAAM,oBAAoB,CAAC;AAqE7E;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,MAAM,CAAC,CA8BjB;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAanF;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,CAGjE;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAU7E;AAED;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAU3F;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAEtC"}

package/services/a2a/agentMappingService.js

@@ -0,0 +1,185 @@
+"use strict";
+/**
+ * Agent Mapping Service
+ *
+ * Maps A2A agent IDs (UUID v4) to internal project/agent identifiers.
+ * Provides bidirectional resolution and lazy generation of A2A IDs.
+ *
+ * Storage: ~/.claude-agent/a2a-agent-mappings.json (global registry)
+ * Format: { version: "1.0.0", mappings: { [a2aAgentId]: AgentMapping } }
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getOrCreateA2AId = getOrCreateA2AId;
+exports.resolveA2AId = resolveA2AId;
+exports.listAgentMappings = listAgentMappings;
+exports.deleteAgentMapping = deleteAgentMapping;
+exports.getA2AId = getA2AId;
+exports.invalidateCache = invalidateCache;
+const promises_1 = __importDefault(require("fs/promises"));
+const path_1 = __importDefault(require("path"));
+const uuid_1 = require("uuid");
+const proper_lockfile_1 = __importDefault(require("proper-lockfile"));
+const paths_js_1 = require("../../config/paths.js");
+const MAPPINGS_FILE = paths_js_1.A2A_AGENT_MAPPINGS_FILE;
+const LOCK_OPTIONS = {
+    retries: { retries: 5, minTimeout: 100, maxTimeout: 500 },
+};
+// In-memory cache for fast lookups
+let cachedRegistry = null;
+/**
+ * Load agent mapping registry from disk
+ * Uses in-memory cache if available and not explicitly bypassed
+ */
+async function loadRegistry(bypassCache = false) {
+    if (cachedRegistry && !bypassCache) {
+        return cachedRegistry;
+    }
+    try {
+        const data = await promises_1.default.readFile(MAPPINGS_FILE, 'utf-8');
+        const registry = JSON.parse(data);
+        cachedRegistry = registry;
+        return registry;
+    }
+    catch (error) {
+        // If file doesn't exist, return empty registry
+        if (error.code === 'ENOENT') {
+            const emptyRegistry = {
+                version: '1.0.0',
+                mappings: {},
+            };
+            cachedRegistry = emptyRegistry;
+            return emptyRegistry;
+        }
+        throw error;
+    }
+}
+/**
+ * Save agent mapping registry to disk with file locking
+ * Invalidates in-memory cache
+ */
+async function saveRegistry(registry) {
+    // Ensure directory exists
+    const dir = path_1.default.dirname(MAPPINGS_FILE);
+    await promises_1.default.mkdir(dir, { recursive: true });
+    // Check if file exists, if not create it first (for lockfile to work)
+    let fileExists = true;
+    try {
+        await promises_1.default.access(MAPPINGS_FILE);
+    }
+    catch {
+        fileExists = false;
+        // Create empty file first so lockfile can work
+        await promises_1.default.writeFile(MAPPINGS_FILE, JSON.stringify({ version: '1.0.0', mappings: {} }, null, 2), 'utf-8');
+    }
+    // Acquire lock for atomic write
+    const release = await proper_lockfile_1.default.lock(MAPPINGS_FILE, LOCK_OPTIONS);
+    try {
+        await promises_1.default.writeFile(MAPPINGS_FILE, JSON.stringify(registry, null, 2), 'utf-8');
+        cachedRegistry = registry;
+    }
+    finally {
+        await release();
+    }
+}
+/**
+ * Get or create A2A agent ID for a project/agent combination
+ * Lazily generates UUID v4 on first request
+ *
+ * @param projectId - Internal project identifier
+ * @param agentType - Internal agent type identifier
+ * @param workingDirectory - Absolute path to project working directory
+ * @returns A2A agent ID (UUID v4)
+ */
+async function getOrCreateA2AId(projectId, agentType, workingDirectory) {
+    const registry = await loadRegistry();
+    // Check if mapping already exists
+    for (const [a2aAgentId, mapping] of Object.entries(registry.mappings)) {
+        if (mapping.projectId === projectId && mapping.agentType === agentType) {
+            // Update last accessed timestamp
+            mapping.lastAccessedAt = new Date().toISOString();
+            await saveRegistry(registry);
+            return a2aAgentId;
+        }
+    }
+    // Create new mapping
+    const a2aAgentId = (0, uuid_1.v4)();
+    const now = new Date().toISOString();
+    const newMapping = {
+        a2aAgentId,
+        projectId,
+        agentType,
+        workingDirectory,
+        createdAt: now,
+        lastAccessedAt: now,
+    };
+    registry.mappings[a2aAgentId] = newMapping;
+    await saveRegistry(registry);
+    return a2aAgentId;
+}
+/**
+ * Resolve A2A agent ID to internal project/agent mapping
+ *
+ * @param a2aAgentId - A2A agent ID (UUID v4)
+ * @returns AgentMapping or null if not found
+ */
+async function resolveA2AId(a2aAgentId) {
+    const registry = await loadRegistry();
+    const mapping = registry.mappings[a2aAgentId];
+    if (!mapping) {
+        return null;
+    }
+    // Update last accessed timestamp
+    mapping.lastAccessedAt = new Date().toISOString();
+    await saveRegistry(registry);
+    return mapping;
+}
+/**
+ * List all agent mappings
+ *
+ * @returns Array of all agent mappings
+ */
+async function listAgentMappings() {
+    const registry = await loadRegistry();
+    return Object.values(registry.mappings);
+}
+/**
+ * Delete agent mapping (used when project or agent is deleted)
+ *
+ * @param a2aAgentId - A2A agent ID to delete
+ * @returns true if deleted, false if not found
+ */
+async function deleteAgentMapping(a2aAgentId) {
+    const registry = await loadRegistry(true); // Bypass cache
+    if (!registry.mappings[a2aAgentId]) {
+        return false;
+    }
+    delete registry.mappings[a2aAgentId];
+    await saveRegistry(registry);
+    return true;
+}
+/**
+ * Get A2A agent ID for a project/agent combination without creating
+ *
+ * @param projectId - Internal project identifier
+ * @param agentType - Internal agent type identifier
+ * @returns A2A agent ID or null if not found
+ */
+async function getA2AId(projectId, agentType) {
+    const registry = await loadRegistry();
+    for (const [a2aAgentId, mapping] of Object.entries(registry.mappings)) {
+        if (mapping.projectId === projectId && mapping.agentType === agentType) {
+            return a2aAgentId;
+        }
+    }
+    return null;
+}
+/**
+ * Invalidate in-memory cache (useful for testing)
+ */
+function invalidateCache() {
+    cachedRegistry = null;
+}
+//# sourceMappingURL=agentMappingService.js.map

package/services/a2a/agentMappingService.js.map

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

package/services/a2a/apiKeyService.d.ts

@@ -0,0 +1,101 @@
+/**
+ * API Key Service
+ *
+ * Manages inbound API keys for authenticating external callers to AgentStudio agents.
+ * Keys are stored hashed with bcryptjs (pure JavaScript, salt rounds 10) for security.
+ * Original keys are also encrypted with AES-256-GCM for display purposes.
+ *
+ * Storage: {projectPath}/.a2a/api-keys.json
+ * Format: { version: "1.0.0", keys: [A2AApiKey[]] }
+ *
+ * Key Format: agt_proj_{projectId}_{32-hex-chars}
+ */
+import type { A2AApiKey } from '../../types/a2a.js';
+/**
+ * Generate a new API key for a project
+ *
+ * @param projectId - Internal project identifier (can be a path)
+ * @param description - Human-readable description of the key
+ * @returns Object containing the generated key (plaintext, shown once) and key metadata
+ */
+export declare function generateApiKey(projectId: string, description: string): Promise<{
+    key: string;
+    keyData: A2AApiKey;
+}>;
+/**
+ * Hash an API key using bcrypt
+ * This is a pure function used internally and for testing
+ *
+ * @param key - Plaintext API key
+ * @returns Bcrypt hash
+ */
+export declare function hashApiKey(key: string): Promise<string>;
+/**
+ * Validate an API key against project's stored hashes
+ *
+ * @param projectId - Internal project identifier
+ * @param key - Plaintext API key to validate
+ * @returns Object with validation result and key ID if valid
+ */
+export declare function validateApiKey(projectId: string, key: string): Promise<{
+    valid: boolean;
+    keyId?: string;
+    keyData?: A2AApiKey;
+}>;
+/**
+ * Revoke an API key (soft delete - kept for audit trail)
+ *
+ * @param projectId - Internal project identifier
+ * @param keyId - Key ID to revoke
+ * @returns true if key was revoked, false if not found
+ */
+export declare function revokeApiKey(projectId: string, keyId: string): Promise<boolean>;
+/**
+ * List all API keys for a project (excluding revoked keys by default)
+ *
+ * @param projectId - Internal project identifier
+ * @param includeRevoked - Whether to include revoked keys
+ * @returns Array of API key metadata (hashes only, never plaintext)
+ */
+export declare function listApiKeys(projectId: string, includeRevoked?: boolean): Promise<A2AApiKey[]>;
+/**
+ * Rotate an API key (generate new key and revoke old one)
+ *
+ * @param projectId - Internal project identifier
+ * @param oldKeyId - ID of key to rotate
+ * @param description - Description for new key
+ * @param gracePeriodMs - Grace period in milliseconds before revoking old key (default 5 minutes)
+ * @returns New key data
+ */
+export declare function rotateApiKey(projectId: string, oldKeyId: string, description: string, gracePeriodMs?: number): Promise<{
+    key: string;
+    keyData: A2AApiKey;
+    oldKeyId: string;
+}>;
+/**
+ * Get API key metadata by ID
+ *
+ * @param projectId - Internal project identifier
+ * @param keyId - Key ID
+ * @returns API key metadata or null if not found
+ */
+export declare function getApiKey(projectId: string, keyId: string): Promise<A2AApiKey | null>;
+/**
+ * Get decrypted API key by ID
+ *
+ * @param projectId - Internal project identifier
+ * @param keyId - Key ID
+ * @returns Decrypted plaintext key or null if not found
+ */
+export declare function getDecryptedApiKey(projectId: string, keyId: string): Promise<string | null>;
+/**
+ * List all API keys with decrypted values
+ *
+ * @param projectId - Internal project identifier
+ * @param includeRevoked - Whether to include revoked keys
+ * @returns Array of API keys with decrypted key values
+ */
+export declare function listApiKeysWithDecryption(projectId: string, includeRevoked?: boolean): Promise<Array<A2AApiKey & {
+    decryptedKey?: string;
+}>>;
+//# sourceMappingURL=apiKeyService.d.ts.map

package/services/a2a/apiKeyService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiKeyService.d.ts","sourceRoot":"","sources":["../../../src/services/a2a/apiKeyService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAQH,OAAO,KAAK,EAAE,SAAS,EAAqB,MAAM,oBAAoB,CAAC;AAgIvE;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,SAAS,CAAA;CAAE,CAAC,CAkC9C;AAED;;;;;;GAMG;AACH,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAE7D;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,SAAS,CAAA;CAAE,CAAC,CA2BlE;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAcrF;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,cAAc,UAAQ,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAQjG;AAED;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAChC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,aAAa,SAAgB,GAC5B,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,SAAS,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAiBhE;AAED;;;;;;GAMG;AACH,wBAAsB,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAG3F;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAMjG;AAED;;;;;;GAMG;AACH,wBAAsB,yBAAyB,CAC7C,SAAS,EAAE,MAAM,EACjB,cAAc,UAAQ,GACrB,OAAO,CAAC,KAAK,CAAC,SAAS,GAAG;IAAE,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAOvD"}