@elizaos/ui 2.0.0-alpha.25 → 2.0.0-alpha.334

package/packages/typescript/src/features/plugin-manager/services/pluginRegistryService.d.ts

@@ -0,0 +1,84 @@
+import type { PluginMetadata } from "../types.ts";
+export interface RegistryPlugin {
+    name: string;
+    gitRepo: string;
+    gitUrl: string;
+    description: string;
+    homepage: string | null;
+    topics: string[];
+    stars: number;
+    language: string;
+    npm: {
+        package: string;
+        v0Version: string | null;
+        v1Version: string | null;
+        v2Version: string | null;
+        v0CoreRange: string | null;
+        v1CoreRange: string | null;
+        v2CoreRange: string | null;
+    };
+    git: {
+        v0Branch: string | null;
+        v1Branch: string | null;
+        v2Branch: string | null;
+    };
+    supports: {
+        v0: boolean;
+        v1: boolean;
+        v2: boolean;
+    };
+    viewer?: {
+        url: string;
+        embedParams?: Record<string, string>;
+        postMessageAuth?: boolean;
+        sandbox?: string;
+    };
+    launchType?: "connect" | "local";
+    launchUrl?: string;
+    displayName?: string;
+    kind?: string;
+    category?: string;
+    capabilities?: string[];
+    icon?: string | null;
+}
+export interface PluginSearchResult {
+    name: string;
+    description: string;
+    score: number;
+    tags: string[];
+    version: string | null;
+    npmPackage: string;
+    repository: string;
+    stars: number;
+    supports: {
+        v0: boolean;
+        v1: boolean;
+        v2: boolean;
+    };
+}
+export interface CloneResult {
+    success: boolean;
+    error?: string;
+    pluginName?: string;
+    localPath?: string;
+    hasTests?: boolean;
+    dependencies?: Record<string, string>;
+}
+export declare function resetRegistryCache(): void;
+/**
+ * Load the plugin registry from the next@registry branch.
+ * Tries generated-registry.json first, falls back to index.json.
+ * Also scans local plugins/ directory for elizaos.plugin.json files.
+ * Local plugins override remote registry entries.
+ * Cached in-memory for 1 hour.
+ */
+export declare function loadRegistry(): Promise<Map<string, RegistryPlugin>>;
+export declare function getRegistryEntry(name: string): Promise<RegistryPlugin | null>;
+export declare function searchPluginsByContent(query: string, limit?: number): Promise<PluginSearchResult[]>;
+export declare function getPluginDetails(name: string): Promise<PluginMetadata | null>;
+export declare function getAllPlugins(): Promise<PluginMetadata[]>;
+export declare function listNonAppPlugins(): Promise<RegistryPlugin[]>;
+export declare function searchNonAppPlugins(query: string, limit?: number): Promise<PluginSearchResult[]>;
+export declare function refreshRegistry(): Promise<Map<string, RegistryPlugin>>;
+export declare function clonePlugin(pluginName: string): Promise<CloneResult>;
+//# sourceMappingURL=pluginRegistryService.d.ts.map

package/packages/typescript/src/features/plugin-manager/services/pluginRegistryService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pluginRegistryService.d.ts","sourceRoot":"","sources":["../../../../../../../../typescript/src/features/plugin-manager/services/pluginRegistryService.ts"],"names":[],"mappings":"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"}

package/packages/typescript/src/features/plugin-manager/services/pluginRegistryService.js

@@ -0,0 +1,401 @@
+import { exec } from "node:child_process";
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { promisify } from "node:util";
+import { logger } from "../../../logger.js";
+// ---------------------------------------------------------------------------
+// Registry URLs — next branch
+// ---------------------------------------------------------------------------
+const GENERATED_REGISTRY_URL = "https://raw.githubusercontent.com/elizaos-plugins/registry/next/generated-registry.json";
+const INDEX_REGISTRY_URL = "https://raw.githubusercontent.com/elizaos-plugins/registry/next/index.json";
+const CACHE_DURATION = 3_600_000; // 1 hour
+// ---------------------------------------------------------------------------
+// Local plugins directory (relative to cwd)
+// ---------------------------------------------------------------------------
+const LOCAL_PLUGINS_DIR = "plugins";
+const execAsync = promisify(exec);
+// ---------------------------------------------------------------------------
+// In-memory cache
+// ---------------------------------------------------------------------------
+let registryCache = null;
+export function resetRegistryCache() {
+    registryCache = null;
+}
+// ---------------------------------------------------------------------------
+// Fetching & parsing
+// ---------------------------------------------------------------------------
+function entryToPlugin(name, e) {
+    return {
+        name,
+        gitRepo: e.git.repo,
+        gitUrl: `https://github.com/${e.git.repo}.git`,
+        description: e.description || "",
+        homepage: e.homepage,
+        topics: e.topics || [],
+        stars: e.stargazers_count || 0,
+        language: e.language || "TypeScript",
+        npm: {
+            package: e.npm.repo,
+            v0Version: e.npm.v0,
+            v1Version: e.npm.v1,
+            v2Version: e.npm.v2,
+            v0CoreRange: e.npm.v0CoreRange,
+            v1CoreRange: e.npm.v1CoreRange,
+            v2CoreRange: e.npm.v2CoreRange,
+        },
+        git: {
+            v0Branch: e.git.v0?.branch ?? null,
+            v1Branch: e.git.v1?.branch ?? null,
+            v2Branch: e.git.v2?.branch ?? null,
+        },
+        supports: e.supports,
+        kind: e.kind,
+    };
+}
+function stubPlugin(name, gitRef) {
+    const repo = gitRef.replace(/^github:/, "");
+    return {
+        name,
+        gitRepo: repo,
+        gitUrl: `https://github.com/${repo}.git`,
+        description: "",
+        homepage: null,
+        topics: [],
+        stars: 0,
+        language: "TypeScript",
+        npm: {
+            package: name,
+            v0Version: null,
+            v1Version: null,
+            v2Version: null,
+            v0CoreRange: null,
+            v1CoreRange: null,
+            v2CoreRange: null,
+        },
+        git: { v0Branch: null, v1Branch: null, v2Branch: "next" },
+        supports: { v0: false, v1: false, v2: false },
+    };
+}
+function localPluginToRegistry(pluginJson, dirName) {
+    const name = pluginJson.id || `@elizaos/${dirName}`;
+    const displayName = pluginJson.app?.displayName || pluginJson.name || dirName;
+    const description = pluginJson.description || "";
+    const homepage = pluginJson.homepage || null;
+    const keywords = pluginJson.keywords || [];
+    const repo = pluginJson.repository
+        ?.replace("https://github.com/", "")
+        .replace(".git", "") || `elizaos/${dirName}`;
+    return {
+        name,
+        gitRepo: repo,
+        gitUrl: pluginJson.repository || `https://github.com/${repo}.git`,
+        description,
+        displayName,
+        homepage,
+        topics: keywords,
+        stars: 0,
+        language: "TypeScript",
+        npm: {
+            package: name,
+            v0Version: null,
+            v1Version: pluginJson.version || null,
+            v2Version: pluginJson.version || null,
+            v0CoreRange: null,
+            v1CoreRange: null,
+            v2CoreRange: null,
+        },
+        git: { v0Branch: null, v1Branch: null, v2Branch: "main" },
+        supports: { v0: false, v1: true, v2: true },
+        kind: pluginJson.kind,
+        launchType: pluginJson.app?.launchType,
+        launchUrl: pluginJson.app?.launchUrl,
+        viewer: pluginJson.viewer,
+        // App-specific metadata
+        category: pluginJson.app?.category,
+        capabilities: pluginJson.app?.capabilities || [],
+        icon: null,
+    };
+}
+async function scanLocalPlugins() {
+    const plugins = new Map();
+    const pluginsDir = path.resolve(process.cwd(), LOCAL_PLUGINS_DIR);
+    if (!fs.existsSync(pluginsDir)) {
+        return plugins;
+    }
+    try {
+        const entries = fs.readdirSync(pluginsDir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            const pluginJsonPath = path.join(pluginsDir, entry.name, "elizaos.plugin.json");
+            if (!fs.existsSync(pluginJsonPath))
+                continue;
+            try {
+                const content = fs.readFileSync(pluginJsonPath, "utf-8");
+                const pluginJson = JSON.parse(content);
+                const plugin = localPluginToRegistry(pluginJson, entry.name);
+                plugins.set(plugin.name, plugin);
+                logger.debug(`[registry] Found local plugin: ${plugin.name} (${entry.name})`);
+            }
+            catch (err) {
+                logger.warn(`[registry] Failed to parse ${pluginJsonPath}: ${errMsg(err)}`);
+            }
+        }
+        if (plugins.size > 0) {
+            logger.info(`[registry] Loaded ${plugins.size} local plugins from ${pluginsDir}`);
+        }
+    }
+    catch (err) {
+        logger.warn(`[registry] Failed to scan local plugins: ${errMsg(err)}`);
+    }
+    return plugins;
+}
+async function fetchGeneratedRegistry() {
+    const response = await fetch(GENERATED_REGISTRY_URL);
+    if (!response.ok) {
+        throw new Error(`generated-registry.json: ${response.status} ${response.statusText}`);
+    }
+    const data = (await response.json());
+    const plugins = new Map();
+    for (const [name, entry] of Object.entries(data.registry)) {
+        plugins.set(name, entryToPlugin(name, entry));
+    }
+    if (data.apps) {
+        for (const [name, entry] of Object.entries(data.apps)) {
+            plugins.set(name, entryToPlugin(name, { ...entry, kind: "app" }));
+        }
+    }
+    return plugins;
+}
+async function fetchIndexRegistry() {
+    const response = await fetch(INDEX_REGISTRY_URL);
+    if (!response.ok) {
+        throw new Error(`index.json: ${response.status} ${response.statusText}`);
+    }
+    const data = (await response.json());
+    const plugins = new Map();
+    for (const [name, gitRef] of Object.entries(data)) {
+        plugins.set(name, stubPlugin(name, gitRef));
+    }
+    return plugins;
+}
+/**
+ * Load the plugin registry from the next@registry branch.
+ * Tries generated-registry.json first, falls back to index.json.
+ * Also scans local plugins/ directory for elizaos.plugin.json files.
+ * Local plugins override remote registry entries.
+ * Cached in-memory for 1 hour.
+ */
+export async function loadRegistry() {
+    if (registryCache && Date.now() - registryCache.timestamp < CACHE_DURATION) {
+        return registryCache.plugins;
+    }
+    logger.info("[registry] Fetching from next@registry...");
+    let plugins = new Map();
+    try {
+        plugins = await fetchGeneratedRegistry();
+        logger.info(`[registry] Loaded ${plugins.size} plugins (generated-registry.json)`);
+    }
+    catch (err) {
+        logger.warn(`[registry] generated-registry.json unavailable: ${errMsg(err)}, falling back to index.json`);
+        try {
+            plugins = await fetchIndexRegistry();
+            logger.info(`[registry] Loaded ${plugins.size} plugins (index.json)`);
+        }
+        catch (err2) {
+            logger.warn(`[registry] index.json also unavailable: ${errMsg(err2)}, using local plugins only`);
+            // Continue with empty remote registry - local plugins will still be added
+        }
+    }
+    // Merge local plugins (they override remote registry entries)
+    const localPlugins = await scanLocalPlugins();
+    for (const [name, plugin] of localPlugins) {
+        plugins.set(name, plugin);
+    }
+    registryCache = { plugins, timestamp: Date.now() };
+    return plugins;
+}
+// ---------------------------------------------------------------------------
+// Lookup helpers
+// ---------------------------------------------------------------------------
+/** Resolve a plugin by name with fuzzy matching (exact -> @elizaos/ prefix -> bare name). */
+function resolvePlugin(registry, name) {
+    let p = registry.get(name);
+    if (p)
+        return p;
+    if (!name.startsWith("@")) {
+        p = registry.get(`@elizaos/${name}`);
+        if (p)
+            return p;
+    }
+    const bare = name.replace(/^@[^/]+\//, "");
+    for (const [key, value] of registry) {
+        if (key.endsWith(`/${bare}`) || key === bare)
+            return value;
+    }
+    return null;
+}
+export async function getRegistryEntry(name) {
+    return resolvePlugin(await loadRegistry(), name);
+}
+// ---------------------------------------------------------------------------
+// RegistryPlugin -> PluginMetadata conversion
+// ---------------------------------------------------------------------------
+function toMetadata(p) {
+    const author = p.gitRepo.split("/")[0] || "unknown";
+    return {
+        name: p.name,
+        description: p.description,
+        author,
+        repository: `https://github.com/${p.gitRepo}`,
+        versions: [p.npm.v0Version, p.npm.v1Version, p.npm.v2Version].filter((v) => v !== null),
+        latestVersion: p.npm.v2Version || p.npm.v1Version || p.npm.v0Version || "unknown",
+        runtimeVersion: p.supports.v2 ? "v2" : p.supports.v1 ? "v1" : "v0",
+        maintainer: author,
+        tags: p.topics,
+        categories: [],
+    };
+}
+// ---------------------------------------------------------------------------
+// Search
+// ---------------------------------------------------------------------------
+function computeSearchScore(plugin, query) {
+    const lq = query.toLowerCase();
+    const terms = lq.split(/\s+/).filter((t) => t.length > 1);
+    const ln = plugin.name.toLowerCase();
+    const ld = plugin.description.toLowerCase();
+    let score = 0;
+    if (ln === lq || ln === `@elizaos/${lq}`)
+        score += 100;
+    else if (ln.includes(lq))
+        score += 50;
+    if (ld.includes(lq))
+        score += 30;
+    for (const t of plugin.topics)
+        if (t.toLowerCase().includes(lq))
+            score += 25;
+    for (const term of terms) {
+        if (ln.includes(term))
+            score += 15;
+        if (ld.includes(term))
+            score += 10;
+        for (const t of plugin.topics)
+            if (t.toLowerCase().includes(term))
+                score += 8;
+    }
+    // Popularity bonus only when there's already a text match
+    if (score > 0) {
+        if (plugin.stars > 100)
+            score += 5;
+        if (plugin.stars > 500)
+            score += 5;
+        if (plugin.stars > 1000)
+            score += 5;
+    }
+    return score;
+}
+export async function searchPluginsByContent(query, limit = 10) {
+    const registry = await loadRegistry();
+    const scored = [];
+    for (const plugin of registry.values()) {
+        const score = computeSearchScore(plugin, query);
+        if (score > 0)
+            scored.push({ plugin, score });
+    }
+    scored.sort((a, b) => b.score - a.score || b.plugin.stars - a.plugin.stars);
+    const maxScore = scored[0]?.score || 1;
+    return scored.slice(0, limit).map(({ plugin, score }) => ({
+        name: plugin.name,
+        description: plugin.description,
+        score: score / maxScore,
+        tags: plugin.topics,
+        version: plugin.npm.v2Version || plugin.npm.v1Version || plugin.npm.v0Version,
+        npmPackage: plugin.npm.package,
+        repository: `https://github.com/${plugin.gitRepo}`,
+        stars: plugin.stars,
+        supports: plugin.supports,
+    }));
+}
+export async function getPluginDetails(name) {
+    const plugin = resolvePlugin(await loadRegistry(), name);
+    return plugin ? toMetadata(plugin) : null;
+}
+export async function getAllPlugins() {
+    const registry = await loadRegistry();
+    return Array.from(registry.values(), toMetadata);
+}
+// ---------------------------------------------------------------------------
+// Legacy support for non-app plugins
+// ---------------------------------------------------------------------------
+export async function listNonAppPlugins() {
+    const registry = await loadRegistry();
+    return Array.from(registry.values()).filter((p) => p.kind !== "app" && !p.displayName);
+}
+export async function searchNonAppPlugins(query, limit = 10) {
+    const registry = await loadRegistry();
+    const scored = [];
+    for (const plugin of registry.values()) {
+        if (plugin.kind === "app" || plugin.displayName)
+            continue;
+        const score = computeSearchScore(plugin, query);
+        if (score > 0)
+            scored.push({ plugin, score });
+    }
+    scored.sort((a, b) => b.score - a.score || b.plugin.stars - a.plugin.stars);
+    const maxScore = scored[0]?.score || 1;
+    return scored.slice(0, limit).map(({ plugin, score }) => ({
+        name: plugin.name,
+        description: plugin.description,
+        score: score / maxScore,
+        tags: plugin.topics,
+        version: plugin.npm.v2Version || plugin.npm.v1Version || plugin.npm.v0Version,
+        npmPackage: plugin.npm.package,
+        repository: `https://github.com/${plugin.gitRepo}`,
+        stars: plugin.stars,
+        supports: plugin.supports,
+    }));
+}
+export async function refreshRegistry() {
+    resetRegistryCache();
+    return loadRegistry();
+}
+// ---------------------------------------------------------------------------
+// Clone
+// ---------------------------------------------------------------------------
+export async function clonePlugin(pluginName) {
+    logger.info(`[registry] Cloning plugin: ${pluginName}`);
+    const plugin = resolvePlugin(await loadRegistry(), pluginName);
+    if (!plugin) {
+        return {
+            success: false,
+            error: `Plugin "${pluginName}" not found in registry`,
+        };
+    }
+    const cloneDir = path.join(process.cwd(), "cloned-plugins", plugin.name.replace(/^@[^/]+\//, ""));
+    await fs.promises.mkdir(cloneDir, { recursive: true });
+    const branch = plugin.git.v2Branch || plugin.git.v1Branch || "next";
+    await execAsync(`git clone --branch ${branch} --single-branch --depth 1 ${plugin.gitUrl} ${cloneDir}`);
+    let hasTests = false;
+    let dependencies = {};
+    try {
+        const pkg = JSON.parse(await fs.promises.readFile(path.join(cloneDir, "package.json"), "utf-8"));
+        hasTests = !!(pkg.scripts?.test || pkg.devDependencies?.vitest);
+        dependencies = pkg.dependencies || {};
+    }
+    catch {
+        logger.warn(`[registry] No package.json at repo root for ${plugin.name}`);
+    }
+    return {
+        success: true,
+        pluginName: plugin.name,
+        localPath: cloneDir,
+        hasTests,
+        dependencies,
+    };
+}
+// ---------------------------------------------------------------------------
+// Util
+// ---------------------------------------------------------------------------
+function errMsg(err) {
+    return err instanceof Error ? err.message : String(err);
+}

package/packages/typescript/src/features/plugin-manager/types.d.ts

@@ -0,0 +1,142 @@
+import type { EventPayload, EventPayloadMap } from "../../types/events.ts";
+import type { Plugin as ElizaPlugin } from "../../types/plugin.ts";
+import type { ServiceTypeName } from "../../types/service.ts";
+declare module "../../types/service.ts" {
+    interface ServiceTypeRegistry {
+        PLUGIN_MANAGER: "plugin_manager";
+        PLUGIN_CONFIGURATION: "plugin_configuration";
+        REGISTRY: "registry";
+        CORE_MANAGER: "core_manager";
+    }
+}
+export declare const PluginManagerServiceType: {
+    readonly PLUGIN_MANAGER: ServiceTypeName;
+    readonly PLUGIN_CONFIGURATION: ServiceTypeName;
+    readonly REGISTRY: ServiceTypeName;
+    readonly CORE_MANAGER: ServiceTypeName;
+};
+export declare enum PluginStatus {
+    READY = "ready",
+    LOADED = "loaded",
+    ERROR = "error",
+    UNLOADED = "unloaded"
+}
+export interface PluginComponents {
+    actions: Set<string>;
+    providers: Set<string>;
+    evaluators: Set<string>;
+    services: Set<string>;
+    eventHandlers: Map<string, Set<(params: EventPayloadMap[keyof EventPayloadMap] | EventPayload) => Promise<void>>>;
+}
+export interface ComponentRegistration {
+    pluginId: string;
+    componentType: "action" | "provider" | "evaluator" | "service" | "eventHandler";
+    componentName: string;
+    timestamp: number;
+}
+export interface PluginState {
+    id: string;
+    name: string;
+    status: PluginStatus;
+    plugin?: ElizaPlugin;
+    error?: string;
+    createdAt: number;
+    loadedAt?: number;
+    unloadedAt?: number;
+    version?: string;
+    components?: PluginComponents;
+}
+export interface PluginRegistry {
+    plugins: Map<string, PluginState>;
+    getPlugin(id: string): PluginState | undefined;
+    getAllPlugins(): PluginState[];
+    getLoadedPlugins(): PluginState[];
+    updatePluginState(id: string, update: Partial<PluginState>): void;
+}
+export interface LoadPluginParams {
+    pluginId: string;
+    force?: boolean;
+}
+export interface UnloadPluginParams {
+    pluginId: string;
+    force?: boolean;
+}
+export interface PluginManagerConfig {
+    pluginDirectory?: string;
+}
+export interface InstallProgress {
+    phase: "fetching-registry" | "resolving" | "downloading" | "extracting" | "installing-deps" | "validating" | "configuring" | "restarting" | "complete" | "error";
+    pluginName?: string;
+    message: string;
+}
+export interface PluginMetadata {
+    name: string;
+    description: string;
+    author: string;
+    repository: string;
+    versions: string[];
+    latestVersion: string;
+    runtimeVersion: string;
+    maintainer: string;
+    tags?: string[];
+    categories?: string[];
+}
+export interface UpstreamMetadata {
+    $schema: "milaidy-upstream-v1";
+    source: string;
+    gitUrl: string;
+    branch: string;
+    commitHash: string;
+    ejectedAt: string;
+    npmPackage: string;
+    npmVersion: string;
+    lastSyncAt: string | null;
+    localCommits: number;
+}
+export interface EjectedPluginInfo {
+    name: string;
+    path: string;
+    version: string;
+    upstream: UpstreamMetadata | null;
+}
+export interface EjectResult {
+    success: boolean;
+    pluginName: string;
+    ejectedPath: string;
+    upstreamCommit: string;
+    requiresRestart: boolean;
+    error?: string;
+}
+export interface SyncResult {
+    success: boolean;
+    pluginName: string;
+    ejectedPath: string;
+    upstreamCommits: number;
+    localChanges: boolean;
+    conflicts: string[];
+    commitHash: string;
+    requiresRestart: boolean;
+    error?: string;
+}
+export interface ReinjectResult {
+    success: boolean;
+    pluginName: string;
+    removedPath: string;
+    requiresRestart: boolean;
+    error?: string;
+}
+export interface InstallResult {
+    success: boolean;
+    pluginName: string;
+    version: string;
+    installPath: string;
+    requiresRestart: boolean;
+    error?: string;
+}
+export interface UninstallResult {
+    success: boolean;
+    pluginName: string;
+    requiresRestart: boolean;
+    error?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/packages/typescript/src/features/plugin-manager/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../../typescript/src/features/plugin-manager/types.ts"],"names":[],"mappings":"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"}

package/packages/typescript/src/features/plugin-manager/types.js

@@ -0,0 +1,13 @@
+export const PluginManagerServiceType = {
+    PLUGIN_MANAGER: "plugin_manager",
+    PLUGIN_CONFIGURATION: "plugin_configuration",
+    REGISTRY: "registry",
+    CORE_MANAGER: "core_manager",
+};
+export var PluginStatus;
+(function (PluginStatus) {
+    PluginStatus["READY"] = "ready";
+    PluginStatus["LOADED"] = "loaded";
+    PluginStatus["ERROR"] = "error";
+    PluginStatus["UNLOADED"] = "unloaded";
+})(PluginStatus || (PluginStatus = {}));

package/packages/typescript/src/features/plugin-manager/utils/paths.d.ts

@@ -0,0 +1,4 @@
+export declare function resolveUserPath(input: string): string;
+export declare function resolveStateDir(env?: NodeJS.ProcessEnv, homedir?: () => string): string;
+export declare function resolveConfigPath(env?: NodeJS.ProcessEnv, stateDirPath?: string): string;
+//# sourceMappingURL=paths.d.ts.map

package/packages/typescript/src/features/plugin-manager/utils/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../../../../../../typescript/src/features/plugin-manager/utils/paths.ts"],"names":[],"mappings":"AAUA,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAUrD;AAED,wBAAgB,eAAe,CAC9B,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,OAAO,GAAE,MAAM,MAAmB,GAChC,MAAM,CAMR;AAED,wBAAgB,iBAAiB,CAChC,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,YAAY,GAAE,MAAyC,GACrD,MAAM,CAMR"}