agent-world 0.11.1 → 0.12.0

package/dist/core/storage/skill-storage.js

@@ -0,0 +1,474 @@
+/**
+ * Skill Storage Module - File I/O Operations for World-Level Agent Skills
+ *
+ * Purpose:
+ * File-based storage for world-scoped skills following the Anthropic Agent Skills Protocol.
+ * Each skill is a directory under `{world-dir}/skills/{skill-name}/` containing a `SKILL.md`
+ * file with YAML frontmatter metadata and markdown body instructions.
+ *
+ * Features:
+ * - SKILL.md parsing with YAML frontmatter extraction and validation
+ * - Skill CRUD operations (import, read, list, delete, export)
+ * - `.meta.json` write-time cache for fast metadata listing
+ * - Cache fallback to SKILL.md parsing when cache is missing or corrupt
+ * - Path traversal protection using resolve + startsWith guards
+ * - Duplicate skill rejection via `skillExists()` check before import
+ * - Content size and line-count validation with warnings
+ *
+ * Notes:
+ * - Follows `agent-storage.ts` pattern: standalone module with explicit `rootPath`
+ * - Uses `fs/promises` for all I/O, pure functions, no classes
+ * - Skills are NOT tool calls — they follow the Anthropic Agent Skills Protocol
+ *   as a content/instruction protocol (app reads SKILL.md, injects into user message)
+ * - Skill metadata limits: name max 64 chars (kebab-case), description max 256 chars
+ *
+ * Recent Changes:
+ * - 2026-02-09: Initial implementation for world-level skills system
+ */
+import { promises as fs } from 'fs';
+import * as path from 'path';
+import { DuplicateSkillError } from '../types.js';
+// ============================================================
+// Constants
+// ============================================================
+/** Maximum allowed length for skill name. */
+const MAX_NAME_LENGTH = 64;
+/** Maximum allowed length for skill description. */
+const MAX_DESCRIPTION_LENGTH = 256;
+/** Maximum SKILL.md file size in bytes before warning (50 KB). */
+const MAX_CONTENT_SIZE_WARN = 50 * 1024;
+/** Maximum SKILL.md line count before warning. */
+const MAX_LINE_COUNT_WARN = 500;
+/** Pattern for valid skill names (kebab-case). */
+const SKILL_NAME_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+/** Name of the metadata cache file. */
+const META_CACHE_FILENAME = '.meta.json';
+/** Name of the skill definition file. */
+const SKILL_FILENAME = 'SKILL.md';
+// ============================================================
+// Path Helpers
+// ============================================================
+/**
+ * Get the skills root directory for a world.
+ */
+export function getSkillsDir(rootPath, worldId) {
+    return path.join(rootPath, worldId, 'skills');
+}
+/**
+ * Get the directory path for a specific skill.
+ */
+export function getSkillDir(rootPath, worldId, skillName) {
+    return path.join(getSkillsDir(rootPath, worldId), skillName);
+}
+/**
+ * Get the SKILL.md file path for a specific skill.
+ */
+export function getSkillFilePath(rootPath, worldId, skillName) {
+    return path.join(getSkillDir(rootPath, worldId, skillName), SKILL_FILENAME);
+}
+/**
+ * Get the .meta.json cache file path for a world's skills.
+ */
+function getMetaCachePath(rootPath, worldId) {
+    return path.join(getSkillsDir(rootPath, worldId), META_CACHE_FILENAME);
+}
+// ============================================================
+// Directory Helpers
+// ============================================================
+/**
+ * Ensure the skills root directory exists.
+ */
+export async function ensureSkillsDirectory(rootPath, worldId) {
+    await fs.mkdir(getSkillsDir(rootPath, worldId), { recursive: true });
+}
+/**
+ * Ensure a specific skill directory exists.
+ */
+export async function ensureSkillDirectory(rootPath, worldId, skillName) {
+    await fs.mkdir(getSkillDir(rootPath, worldId, skillName), { recursive: true });
+}
+// ============================================================
+// Path Safety
+// ============================================================
+/**
+ * Validate that a resolved path stays within the expected base directory.
+ * Prevents path traversal attacks (e.g., `../../etc/passwd`).
+ */
+function assertSafePath(filePath, baseDir) {
+    const resolved = path.resolve(filePath);
+    const resolvedBase = path.resolve(baseDir);
+    const sep = path.sep || '/';
+    if (!resolved.startsWith(resolvedBase + sep) && resolved !== resolvedBase) {
+        throw new Error(`Path traversal detected: ${filePath} escapes ${baseDir}`);
+    }
+}
+// ============================================================
+// YAML Frontmatter Parsing
+// ============================================================
+/**
+ * Parse SKILL.md content into metadata (YAML frontmatter) and body content.
+ * Supports standard YAML frontmatter delimited by `---` lines.
+ *
+ * @param raw - Raw file content of SKILL.md
+ * @returns Parsed SkillData with metadata and content
+ * @throws Error if frontmatter is missing or malformed
+ */
+export function parseSkillFile(raw) {
+    const trimmed = raw.trimStart();
+    if (!trimmed.startsWith('---')) {
+        throw new Error('SKILL.md must start with YAML frontmatter (---)');
+    }
+    const endIndex = trimmed.indexOf('\n---', 3);
+    if (endIndex === -1) {
+        throw new Error('SKILL.md YAML frontmatter is not properly closed (missing closing ---)');
+    }
+    const yamlBlock = trimmed.substring(3, endIndex).trim();
+    const body = trimmed.substring(endIndex + 4).trim();
+    const metadata = parseSimpleYaml(yamlBlock);
+    return { metadata, content: body };
+}
+/**
+ * Minimal YAML parser for frontmatter fields.
+ * Handles simple key-value pairs and arrays (inline `[a, b]` syntax).
+ * Does NOT support nested objects, multi-line strings, or complex YAML.
+ */
+function parseSimpleYaml(yaml) {
+    const result = {};
+    const lines = yaml.split('\n');
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith('#'))
+            continue;
+        const colonIndex = trimmed.indexOf(':');
+        if (colonIndex === -1)
+            continue;
+        const key = trimmed.substring(0, colonIndex).trim();
+        let value = trimmed.substring(colonIndex + 1).trim();
+        // Handle inline arrays: [item1, item2]
+        if (value.startsWith('[') && value.endsWith(']')) {
+            value = value
+                .slice(1, -1)
+                .split(',')
+                .map((item) => item.trim().replace(/^["']|["']$/g, ''))
+                .filter((item) => item.length > 0);
+        }
+        else {
+            // Remove surrounding quotes
+            value = value.replace(/^["']|["']$/g, '');
+        }
+        result[key] = value;
+    }
+    if (!result.name || !result.description) {
+        throw new Error('SKILL.md frontmatter must contain required fields: name, description');
+    }
+    return result;
+}
+/**
+ * Extract just the metadata from a SKILL.md file (without body content).
+ */
+export function extractSkillMetadata(raw) {
+    return parseSkillFile(raw).metadata;
+}
+// ============================================================
+// Validation
+// ============================================================
+/**
+ * Validate skill metadata against protocol constraints.
+ */
+export function validateSkillMetadata(metadata) {
+    const errors = [];
+    const warnings = [];
+    // Name validation
+    if (!metadata.name) {
+        errors.push('Skill name is required');
+    }
+    else {
+        if (metadata.name.length > MAX_NAME_LENGTH) {
+            errors.push(`Skill name exceeds maximum length of ${MAX_NAME_LENGTH} characters`);
+        }
+        if (!SKILL_NAME_PATTERN.test(metadata.name)) {
+            errors.push('Skill name must be kebab-case (lowercase alphanumeric with hyphens)');
+        }
+    }
+    // Description validation
+    if (!metadata.description) {
+        errors.push('Skill description is required');
+    }
+    else if (metadata.description.length > MAX_DESCRIPTION_LENGTH) {
+        errors.push(`Skill description exceeds maximum length of ${MAX_DESCRIPTION_LENGTH} characters`);
+    }
+    // Optional field warnings
+    if (!metadata.version) {
+        warnings.push('No version specified');
+    }
+    return { valid: errors.length === 0, errors, warnings };
+}
+/**
+ * Validate skill content (SKILL.md body) for size and line count.
+ */
+export function validateSkillContent(content) {
+    const errors = [];
+    const warnings = [];
+    const byteSize = Buffer.byteLength(content, 'utf8');
+    if (byteSize > MAX_CONTENT_SIZE_WARN) {
+        warnings.push(`Skill content is ${Math.round(byteSize / 1024)} KB (recommended max: ${MAX_CONTENT_SIZE_WARN / 1024} KB)`);
+    }
+    const lineCount = content.split('\n').length;
+    if (lineCount > MAX_LINE_COUNT_WARN) {
+        warnings.push(`Skill content has ${lineCount} lines (recommended max: ${MAX_LINE_COUNT_WARN})`);
+    }
+    return { valid: errors.length === 0, errors, warnings };
+}
+// ============================================================
+// File CRUD Operations
+// ============================================================
+/**
+ * Check if a skill exists in a world.
+ */
+export async function skillExists(rootPath, worldId, skillName) {
+    try {
+        const filePath = getSkillFilePath(rootPath, worldId, skillName);
+        await fs.access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Save a SKILL.md file for a skill.
+ */
+export async function saveSkillFile(rootPath, worldId, skillName, content) {
+    await ensureSkillDirectory(rootPath, worldId, skillName);
+    const filePath = getSkillFilePath(rootPath, worldId, skillName);
+    assertSafePath(filePath, getSkillsDir(rootPath, worldId));
+    await fs.writeFile(filePath, content, 'utf8');
+}
+/**
+ * Load a SKILL.md file content for a skill.
+ */
+export async function loadSkillFile(rootPath, worldId, skillName) {
+    const filePath = getSkillFilePath(rootPath, worldId, skillName);
+    assertSafePath(filePath, getSkillsDir(rootPath, worldId));
+    return fs.readFile(filePath, 'utf8');
+}
+/**
+ * Delete a skill directory and all its contents.
+ */
+export async function deleteSkillFolder(rootPath, worldId, skillName) {
+    try {
+        const skillDir = getSkillDir(rootPath, worldId, skillName);
+        assertSafePath(skillDir, getSkillsDir(rootPath, worldId));
+        await fs.rm(skillDir, { recursive: true, force: true });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * List all skill folder names in a world's skills directory.
+ */
+export async function listSkillFolders(rootPath, worldId) {
+    try {
+        const skillsDir = getSkillsDir(rootPath, worldId);
+        const entries = await fs.readdir(skillsDir, { withFileTypes: true });
+        return entries
+            .filter(entry => entry.isDirectory())
+            .map(entry => entry.name);
+    }
+    catch {
+        return [];
+    }
+}
+// ============================================================
+// High-Level Operations
+// ============================================================
+/**
+ * Get a full WorldSkill object for a specific skill.
+ */
+export async function getWorldSkill(rootPath, worldId, skillName) {
+    try {
+        const raw = await loadSkillFile(rootPath, worldId, skillName);
+        const skillData = parseSkillFile(raw);
+        const dirPath = getSkillDir(rootPath, worldId, skillName);
+        const filePath = getSkillFilePath(rootPath, worldId, skillName);
+        return {
+            metadata: skillData.metadata,
+            content: skillData.content,
+            dirPath,
+            filePath,
+            contentSize: Buffer.byteLength(raw, 'utf8'),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Get just the metadata for a specific skill.
+ */
+export async function getWorldSkillMetadata(rootPath, worldId, skillName) {
+    try {
+        const raw = await loadSkillFile(rootPath, worldId, skillName);
+        return extractSkillMetadata(raw);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * List all WorldSkill objects in a world.
+ */
+export async function listWorldSkills(rootPath, worldId) {
+    const folders = await listSkillFolders(rootPath, worldId);
+    const skills = [];
+    for (const folder of folders) {
+        const skill = await getWorldSkill(rootPath, worldId, folder);
+        if (skill) {
+            skills.push(skill);
+        }
+    }
+    return skills;
+}
+/**
+ * List skill metadata for all skills in a world.
+ * Uses `.meta.json` cache for fast listing; falls back to SKILL.md parsing.
+ */
+export async function listWorldSkillsMetadata(rootPath, worldId) {
+    // Try cache first
+    const cached = await loadMetaCache(rootPath, worldId);
+    if (cached) {
+        return cached;
+    }
+    // Fallback: parse all SKILL.md files
+    const folders = await listSkillFolders(rootPath, worldId);
+    const metadataList = [];
+    for (const folder of folders) {
+        const metadata = await getWorldSkillMetadata(rootPath, worldId, folder);
+        if (metadata) {
+            metadataList.push(metadata);
+        }
+    }
+    // Write collected metadata to cache for next time (avoids re-reading all SKILL.md files)
+    if (metadataList.length > 0) {
+        try {
+            await ensureSkillsDirectory(rootPath, worldId);
+            const cachePath = getMetaCachePath(rootPath, worldId);
+            await fs.writeFile(cachePath, JSON.stringify(metadataList, null, 2), 'utf8');
+        }
+        catch {
+            // Cache write failure is non-critical
+        }
+    }
+    return metadataList;
+}
+/**
+ * Import a skill into a world from raw SKILL.md content.
+ * Validates metadata, rejects duplicates, and regenerates cache.
+ *
+ * @throws {DuplicateSkillError} if skill with same name already exists
+ * @throws {Error} if content is invalid
+ */
+export async function importWorldSkill(rootPath, worldId, skillContent) {
+    // Parse and validate
+    const skillData = parseSkillFile(skillContent);
+    const metaValidation = validateSkillMetadata(skillData.metadata);
+    if (!metaValidation.valid) {
+        throw new Error(`Invalid skill metadata: ${metaValidation.errors.join(', ')}`);
+    }
+    const skillName = skillData.metadata.name;
+    // Check for duplicates
+    if (await skillExists(rootPath, worldId, skillName)) {
+        throw new DuplicateSkillError(skillName);
+    }
+    // Save skill file
+    await saveSkillFile(rootPath, worldId, skillName, skillContent);
+    // Regenerate metadata cache
+    await regenerateMetaCache(rootPath, worldId);
+    // Return the full WorldSkill object
+    return (await getWorldSkill(rootPath, worldId, skillName));
+}
+/**
+ * Export a skill's SKILL.md content as a raw string.
+ */
+export async function exportWorldSkill(rootPath, worldId, skillName) {
+    try {
+        return await loadSkillFile(rootPath, worldId, skillName);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Delete a skill from a world and regenerate the metadata cache.
+ */
+export async function deleteWorldSkill(rootPath, worldId, skillName) {
+    const deleted = await deleteSkillFolder(rootPath, worldId, skillName);
+    if (deleted) {
+        await regenerateMetaCache(rootPath, worldId);
+    }
+    return deleted;
+}
+/**
+ * Get total size (in bytes) of all SKILL.md files in a world.
+ */
+export async function getWorldSkillsSize(rootPath, worldId) {
+    const folders = await listSkillFolders(rootPath, worldId);
+    let totalSize = 0;
+    for (const folder of folders) {
+        try {
+            const filePath = getSkillFilePath(rootPath, worldId, folder);
+            const stat = await fs.stat(filePath);
+            totalSize += stat.size;
+        }
+        catch {
+            // Skip unreadable files
+        }
+    }
+    return totalSize;
+}
+// ============================================================
+// `.meta.json` Cache
+// ============================================================
+/**
+ * Regenerate the `.meta.json` metadata cache from all SKILL.md files.
+ */
+export async function regenerateMetaCache(rootPath, worldId) {
+    await ensureSkillsDirectory(rootPath, worldId);
+    const folders = await listSkillFolders(rootPath, worldId);
+    const metadataList = [];
+    for (const folder of folders) {
+        try {
+            const raw = await loadSkillFile(rootPath, worldId, folder);
+            const metadata = extractSkillMetadata(raw);
+            metadataList.push(metadata);
+        }
+        catch {
+            // Skip malformed skill files
+        }
+    }
+    const cachePath = getMetaCachePath(rootPath, worldId);
+    await fs.writeFile(cachePath, JSON.stringify(metadataList, null, 2), 'utf8');
+}
+/**
+ * Load the `.meta.json` metadata cache.
+ * Returns null if cache is missing or corrupt.
+ */
+export async function loadMetaCache(rootPath, worldId) {
+    try {
+        const cachePath = getMetaCachePath(rootPath, worldId);
+        const raw = await fs.readFile(cachePath, 'utf8');
+        const parsed = JSON.parse(raw);
+        if (!Array.isArray(parsed)) {
+            return null;
+        }
+        // Basic validation: ensure each entry has name and description
+        const valid = parsed.every((item) => typeof item.name === 'string' && typeof item.description === 'string');
+        return valid ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=skill-storage.js.map

package/dist/core/storage/skill-storage.js.map

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

package/dist/core/storage/sqlite-schema.d.ts

@@ -0,0 +1,95 @@
+/**
+ * SQLite Database Schema for Agent World System
+ *
+ * Logger Category: storage.schema
+ * Purpose: Schema utilities and PRAGMA configuration
+ *
+ * Features:
+ * - PRAGMA configuration for performance and integrity
+ * - Schema version tracking (PRAGMA user_version)
+ * - Database statistics and integrity validation
+ * - Index and trigger creation utilities
+ *
+ * Schema Design:
+ * - worlds: Core world configuration and metadata
+ * - agents: Agent configuration with LLM settings
+ * - agent_memory: Current active conversation memory
+ * - memory_archives: Archive session metadata with rich information
+ * - archived_messages: Historical conversation content linked to archives
+ * - archive_statistics: Usage analytics and management data
+ * - world_chats: Chat session management
+ * - events: Event storage with sequences
+ * - event_sequences: Atomic sequence generation
+ *
+ * Implementation:
+ * - PRAGMA settings for performance and integrity
+ * - JSON column types for flexible configuration storage
+ * - Timestamp tracking for all operations
+ * - Cascading deletes for data consistency
+ * - Prepared statements for security and performance
+ * - 2025-11-02: Refactored to remove migration logic (now in migration-runner.ts)
+ * - 2025-11-02: Schema initialization deprecated - all databases use migration system (0000-0009)
+ * - 2025-11-02: Removed initializeSchema() - migration 0000 handles base schema creation
+ */
+import type { Database } from 'sqlite3';
+export interface SQLiteConfig {
+    database: string;
+    enableWAL?: boolean;
+    busyTimeout?: number;
+    cacheSize?: number;
+    enableForeignKeys?: boolean;
+}
+export interface ArchiveMetadata {
+    sessionName?: string;
+    archiveReason?: string;
+    messageCount: number;
+    startTime?: string;
+    endTime?: string;
+    participants: string[];
+    tags?: string[];
+}
+export interface ArchiveStatistics {
+    totalArchives: number;
+    totalMessages: number;
+    averageSessionLength: number;
+    mostActiveAgent: string;
+    archiveFrequency: {
+        [key: string]: number;
+    };
+}
+export interface SQLiteSchemaContext {
+    db: Database;
+    config: SQLiteConfig;
+    isInitialized: boolean;
+}
+export declare function createSQLiteSchemaContext(config: SQLiteConfig): Promise<SQLiteSchemaContext>;
+export declare function configurePragmas(ctx: {
+    db: Database;
+    config: SQLiteConfig;
+}): void;
+/**
+ * @deprecated All schema initialization is now handled by the migration system.
+ * This file only provides utility functions for PRAGMA configuration and database introspection.
+ * Schema creation (tables, indexes, triggers) is defined in migrations/*.sql files.
+ */
+export declare function getSchemaVersion(ctx: SQLiteSchemaContext): Promise<number>;
+export declare function setSchemaVersion(ctx: SQLiteSchemaContext, version: number): Promise<void>;
+/**
+ * Validate database integrity
+ * Checks for corruption and foreign key constraint violations
+ */
+export declare function validateIntegrity(ctx: SQLiteSchemaContext): Promise<{
+    isValid: boolean;
+    errors: string[];
+}>;
+export declare function getDatabaseStats(ctx: SQLiteSchemaContext): Promise<{
+    worldCount: number;
+    agentCount: number;
+    activeMemoryCount: number;
+    archiveCount: number;
+    archivedMessageCount: number;
+    databaseSize: number;
+}>;
+export declare function closeSchema(ctx: SQLiteSchemaContext): Promise<void>;
+export declare function getDatabase(ctx: SQLiteSchemaContext): Database;
+//# sourceMappingURL=sqlite-schema.d.ts.map

package/dist/core/storage/sqlite-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-schema.d.ts","sourceRoot":"","sources":["../../../core/storage/sqlite-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAUxC,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAGD,MAAM,WAAW,eAAe;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAGD,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;CAC7C;AAID,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,QAAQ,CAAC;IACb,MAAM,EAAE,YAAY,CAAC;IACrB,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,wBAAsB,yBAAyB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAqBlG;AAGD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE;IAAE,EAAE,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,YAAY,CAAA;CAAE,GAAG,IAAI,CAgBlF;AAED;;;;GAIG;AAEH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAQhF;AAED,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAG/F;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAkBjH;AAED,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC;IACxE,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC,CAyBD;AAED,wBAAsB,WAAW,CAAC,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAOzE;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,mBAAmB,GAAG,QAAQ,CAE9D"}