agent-nuvira 1.14.0

package/dist/workflow/registry.js

@@ -0,0 +1,482 @@
+/**
+ * Workflow Registry — GitHub-hosted marketplace for community workflow templates.
+ *
+ * The registry is a GitHub repo (agent-nuvira/workflows) that contains:
+ *   index.json          — Master index of all available templates
+ *   templates/          — Directory of individual template files
+ *     quick-fix.json
+ *     security-audit.json
+ *     ...
+ *
+ * Each template file is a JSON document matching the WorkflowTemplate interface
+ * extended with version, author, and source metadata.
+ *
+ * Commands:
+ *   buff workflow search <query>    — Search the GitHub registry
+ *   buff workflow install <name>    — Install a template from the registry
+ *   buff workflow publish           — Publish a local template to the registry
+ *   buff workflow info <name>       — Show template details from the registry
+ */
+import { readFileSync, writeFileSync, existsSync, mkdirSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { getWorkflowTemplate, isValidWorkflowTemplate, } from './templates.js';
+import { logger } from '../utils/logger.js';
+// ─── Constants ──────────────────────────────────────────────────────────────
+/** GitHub raw content base URL for the workflow registry */
+const REGISTRY_RAW_BASE = 'https://raw.githubusercontent.com/imdheerajKube/agent-nuvira/main';
+/** GitHub API URL for the registry */
+const REGISTRY_API_BASE = 'https://api.github.com/repos/imdheerajKube/agent-nuvira';
+/** Local storage for installed registry templates */
+const BUFF_DIR = join(homedir(), '.buff');
+const INSTALLED_REGISTRY_DIR = join(BUFF_DIR, 'workflows', 'registry');
+/** Cache file for the registry index */
+const REGISTRY_CACHE_PATH = join(BUFF_DIR, 'workflows', 'registry-cache.json');
+/** How long to cache the registry index (1 hour in ms) */
+const REGISTRY_CACHE_TTL = 60 * 60 * 1000;
+// ─── Helpers ────────────────────────────────────────────────────────────────
+function ensureDirs() {
+    for (const dir of [INSTALLED_REGISTRY_DIR, join(BUFF_DIR, 'workflows')]) {
+        if (!existsSync(dir)) {
+            try {
+                mkdirSync(dir, { recursive: true });
+            }
+            catch { /* best-effort */ }
+        }
+    }
+}
+// ─── Registry Index ─────────────────────────────────────────────────────────
+/**
+ * Fetch the registry index from GitHub (with TTL caching).
+ */
+export async function fetchRegistryIndex() {
+    // Check cache first
+    const cached = readRegistryCache();
+    if (cached)
+        return cached;
+    try {
+        const response = await fetch(`${REGISTRY_RAW_BASE}/index.json`, {
+            headers: {
+                'User-Agent': 'agent-nuvira/2.0',
+                'Accept': 'application/json',
+            },
+            signal: AbortSignal.timeout(10000), // 10s timeout
+        });
+        if (!response.ok) {
+            logger.debug(`Registry index fetch failed (${response.status}), using cache`);
+            return cached || [];
+        }
+        const index = await response.json();
+        if (!index.templates || !Array.isArray(index.templates)) {
+            logger.debug('Invalid registry index format');
+            return cached || [];
+        }
+        // Update cache
+        writeRegistryCache(index.templates);
+        return index.templates;
+    }
+    catch (err) {
+        logger.debug(`Failed to fetch registry index: ${err}`);
+        return cached || [];
+    }
+}
+/**
+ * Search the registry for templates matching a query.
+ */
+export async function searchRegistry(query) {
+    const templates = await fetchRegistryIndex();
+    const q = query.toLowerCase();
+    return templates.filter((t) => {
+        const searchable = `${t.id} ${t.name} ${t.description} ${t.tags.join(' ')}`.toLowerCase();
+        return searchable.includes(q);
+    });
+}
+/**
+ * Get a specific template entry from the registry by ID.
+ */
+export async function getRegistryEntry(id) {
+    const templates = await fetchRegistryIndex();
+    return templates.find((t) => t.id === id) || null;
+}
+// ─── Install ────────────────────────────────────────────────────────────────
+/**
+ * Install a workflow template from the registry.
+ *
+ * Downloads the template JSON file from GitHub and saves it to
+ * ~/.buff/workflows/registry/<id>.json where the workflow system
+ * can auto-discover it.
+ *
+ * @param templateId  The template ID to install
+ * @returns           The installed WorkflowTemplate, or null if failed
+ */
+export async function installTemplate(templateId) {
+    // First check if it exists in the registry index
+    const entry = await getRegistryEntry(templateId);
+    if (!entry) {
+        logger.error(`Template '${templateId}' not found in the registry.`);
+        logger.info('Search available templates: buff workflow search <query>');
+        return null;
+    }
+    // Check if already installed
+    const localPath = join(INSTALLED_REGISTRY_DIR, `${templateId}.json`);
+    if (existsSync(localPath)) {
+        logger.info(`Template '${templateId}' is already installed.`);
+        logger.info('To reinstall, first remove it: rm ~/.buff/workflows/registry/<id>.json');
+        // Still return the existing one so it can be used
+        return readLocalTemplate(templateId);
+    }
+    // Download the template file
+    try {
+        const url = `${REGISTRY_RAW_BASE}/templates/${templateId}.json`;
+        const response = await fetch(url, {
+            headers: {
+                'User-Agent': 'agent-nuvira/2.0',
+                'Accept': 'application/json',
+            },
+            signal: AbortSignal.timeout(15000),
+        });
+        if (!response.ok) {
+            logger.error(`Failed to download template '${templateId}' (${response.status})`);
+            return null;
+        }
+        const template = await response.json();
+        // Validate the template
+        if (!isValidWorkflowTemplate(template)) {
+            logger.error(`Downloaded template '${templateId}' is not a valid workflow template.`);
+            return null;
+        }
+        // Save locally
+        ensureDirs();
+        const enriched = {
+            ...template,
+            _registryVersion: entry.version,
+            _registryAuthor: entry.author,
+            _installedAt: new Date().toISOString(),
+        };
+        writeFileSync(localPath, JSON.stringify(enriched, null, 2), 'utf-8');
+        logger.success(`Installed workflow template: ${template.name} v${entry.version}`);
+        return template;
+    }
+    catch (err) {
+        logger.error(`Failed to install template '${templateId}': ${err instanceof Error ? err.message : String(err)}`);
+        logger.info('Check your internet connection or try again later.');
+        return null;
+    }
+}
+/**
+ * Read an installed template from local storage.
+ */
+function readLocalTemplate(templateId) {
+    const localPath = join(INSTALLED_REGISTRY_DIR, `${templateId}.json`);
+    try {
+        if (!existsSync(localPath))
+            return null;
+        const content = readFileSync(localPath, 'utf-8');
+        const template = JSON.parse(content);
+        // Strip internal metadata before returning
+        delete template._registryVersion;
+        delete template._registryAuthor;
+        delete template._installedAt;
+        return template;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Get all locally installed registry templates.
+ */
+export function getInstalledTemplates() {
+    ensureDirs();
+    const templates = [];
+    try {
+        const files = readdirSync(INSTALLED_REGISTRY_DIR).filter((f) => f.endsWith('.json'));
+        for (const file of files) {
+            const template = readLocalTemplate(file.replace('.json', ''));
+            if (template) {
+                templates.push(template);
+            }
+        }
+    }
+    catch {
+        // Directory might not exist yet
+    }
+    return templates;
+}
+/**
+ * Validate a local workflow template for publishing.
+ * Checks for required fields, valid steps, etc.
+ */
+export function validateForPublish(templateId) {
+    // Find the template in local workflows
+    const localPath = join(BUFF_DIR, 'workflows', `${templateId}.json`);
+    if (!existsSync(localPath)) {
+        // Also check .buff/workflows/registry/
+        const registryPath = join(INSTALLED_REGISTRY_DIR, `${templateId}.json`);
+        if (!existsSync(registryPath)) {
+            return {
+                valid: false,
+                errors: [`Template '${templateId}' not found in ~/.buff/workflows/ or ~/.buff/workflows/registry/`],
+                warnings: [],
+            };
+        }
+    }
+    try {
+        const filePath = existsSync(join(BUFF_DIR, 'workflows', `${templateId}.json`))
+            ? join(BUFF_DIR, 'workflows', `${templateId}.json`)
+            : join(INSTALLED_REGISTRY_DIR, `${templateId}.json`);
+        const content = readFileSync(filePath, 'utf-8');
+        const template = JSON.parse(content);
+        const errors = [];
+        const warnings = [];
+        // Required fields
+        if (!template.id || typeof template.id !== 'string')
+            errors.push('Missing or invalid: id (string)');
+        if (!template.name || typeof template.name !== 'string')
+            errors.push('Missing or invalid: name (string)');
+        if (!template.description || typeof template.description !== 'string')
+            errors.push('Missing or invalid: description (string)');
+        if (!Array.isArray(template.steps) || template.steps.length === 0)
+            errors.push('Missing or invalid: steps (non-empty array)');
+        // Validate steps
+        if (Array.isArray(template.steps)) {
+            for (let i = 0; i < template.steps.length; i++) {
+                const step = template.steps[i];
+                if (!step.agentType || typeof step.agentType !== 'string') {
+                    errors.push(`steps[${i}]: missing or invalid agentType`);
+                }
+                if (!step.description || typeof step.description !== 'string') {
+                    errors.push(`steps[${i}]: missing or invalid description`);
+                }
+            }
+        }
+        // ID format
+        if (template.id && typeof template.id === 'string' && !/^[a-z0-9-]+$/.test(template.id)) {
+            errors.push('Template ID must be lowercase alphanumeric with hyphens only');
+        }
+        // Warnings
+        if (!template.recommendedModels)
+            warnings.push('No recommendedModels defined — agents will use default provider');
+        if (!template.useMemory && template.useMemory !== false)
+            warnings.push('useMemory not set — defaulting to false');
+        if (template.description && typeof template.description === 'string' && template.description.length > 200) {
+            warnings.push('Description is longer than 200 characters — consider shortening');
+        }
+        return { valid: errors.length === 0, errors, warnings };
+    }
+    catch (err) {
+        return {
+            valid: false,
+            errors: [`Failed to read template: ${err instanceof Error ? err.message : String(err)}`],
+            warnings: [],
+        };
+    }
+}
+/**
+ * Prepare a local template for publishing.
+ * Returns a JSON string that can be submitted as a PR to the registry.
+ */
+export function prepareForPublish(templateId) {
+    const validation = validateForPublish(templateId);
+    if (!validation.valid) {
+        logger.error('Validation failed. Fix these issues:');
+        for (const err of validation.errors) {
+            logger.error(`  ${err}`);
+        }
+        return null;
+    }
+    // Find and read the template
+    const localPath = join(BUFF_DIR, 'workflows', `${templateId}.json`);
+    const filePath = existsSync(localPath)
+        ? localPath
+        : join(INSTALLED_REGISTRY_DIR, `${templateId}.json`);
+    try {
+        const content = readFileSync(filePath, 'utf-8');
+        const template = JSON.parse(content);
+        // Add/update metadata for publishing
+        const publishData = {
+            id: template.id,
+            name: template.name,
+            description: template.description,
+            version: template.version || '1.0.0',
+            author: template.author || 'anonymous',
+            steps: template.steps,
+            recommendedModels: template.recommendedModels || {},
+            useMemory: template.useMemory || false,
+            tags: template.tags || [],
+        };
+        return JSON.stringify(publishData, null, 2);
+    }
+    catch (err) {
+        logger.error(`Failed to prepare template for publish: ${err}`);
+        return null;
+    }
+}
+/**
+ * Get the URL for submitting a new template to the registry.
+ */
+export function getPublishUrl() {
+    return 'https://github.com/imdheerajKube/agent-nuvira/issues/new?template=template-submission.md';
+}
+// ─── Version & Dependency Resolution ────────────────────────────────────────
+/**
+ * Compare two semantic version strings.
+ * Returns 1 if a > b, -1 if a < b, 0 if equal.
+ */
+export function compareVersions(a, b) {
+    const aParts = a.split('.').map(Number);
+    const bParts = b.split('.').map(Number);
+    for (let i = 0; i < Math.max(aParts.length, bParts.length); i++) {
+        const aVal = aParts[i] || 0;
+        const bVal = bParts[i] || 0;
+        if (aVal > bVal)
+            return 1;
+        if (aVal < bVal)
+            return -1;
+    }
+    return 0;
+}
+/**
+ * Check if a version satisfies a semver constraint (e.g., ">=1.0.0", "^2.0.0").
+ */
+export function versionSatisfies(version, constraint) {
+    // Simple prefix-based constraint check
+    if (constraint.startsWith('>=')) {
+        return compareVersions(version, constraint.slice(2)) >= 0;
+    }
+    if (constraint.startsWith('<=')) {
+        return compareVersions(version, constraint.slice(2)) <= 0;
+    }
+    if (constraint.startsWith('^')) {
+        // ^1.2.3 means >=1.2.3 and <2.0.0
+        const target = constraint.slice(1).split('.').map(Number);
+        const current = version.split('.').map(Number);
+        if (compareVersions(version, constraint.slice(1)) < 0)
+            return false;
+        if (target[0] !== undefined && (current[0] || 0) > target[0])
+            return false;
+        return true;
+    }
+    if (constraint.startsWith('~')) {
+        // ~1.2.3 means >=1.2.3 and <1.3.0
+        const target = constraint.slice(1).split('.').map(Number);
+        const current = version.split('.').map(Number);
+        if (compareVersions(version, constraint.slice(1)) < 0)
+            return false;
+        if (target[0] !== undefined && (current[0] || 0) !== target[0])
+            return false;
+        if (target[1] !== undefined && (current[1] || 0) > target[1])
+            return false;
+        return true;
+    }
+    // Exact match or bare number
+    return compareVersions(version, constraint) === 0;
+}
+/**
+ * Check if an installed template has a newer version available in the registry.
+ */
+export async function checkForUpgrades() {
+    const installed = getInstalledTemplates();
+    if (installed.length === 0)
+        return [];
+    const registry = await fetchRegistryIndex();
+    const upgrades = [];
+    for (const t of installed) {
+        if (!t.version || !t.id)
+            continue;
+        const entry = registry.find((e) => e.id === t.id);
+        if (entry && compareVersions(entry.version, t.version) > 0) {
+            upgrades.push({ id: t.id, currentVersion: t.version, latestVersion: entry.version });
+        }
+    }
+    return upgrades;
+}
+/**
+ * Resolve dependencies for a template.
+ * Returns any missing dependencies that need to be installed.
+ */
+export async function resolveDependencies(template) {
+    const deps = template.dependencies || [];
+    const met = [];
+    const missing = [];
+    for (const dep of deps) {
+        switch (dep.type) {
+            case 'template': {
+                // Check if the dependency template exists (built-in or installed)
+                const builtin = getWorkflowTemplate(dep.name);
+                if (builtin) {
+                    met.push(dep);
+                    continue;
+                }
+                const localPath = join(INSTALLED_REGISTRY_DIR, `${dep.name}.json`);
+                if (existsSync(localPath)) {
+                    met.push(dep);
+                    continue;
+                }
+                // Check registry
+                const entry = await getRegistryEntry(dep.name);
+                if (entry) {
+                    missing.push(dep);
+                }
+                else {
+                    missing.push({ ...dep, description: `${dep.description || dep.name} (not found in registry)` });
+                }
+                break;
+            }
+            case 'npm':
+            case 'cli':
+                // For npm/cli dependencies, we can't easily verify during a template install
+                // Just record them as met-with-caveats
+                met.push(dep);
+                break;
+        }
+    }
+    return { met, missing };
+}
+/**
+ * Validate that all dependencies of a template are satisfied.
+ * Returns true if all dependencies are met or optional.
+ */
+export function dependenciesMet(deps) {
+    return deps.every((d) => d.optional);
+}
+// ─── Registry Cache ─────────────────────────────────────────────────────────
+function readRegistryCache() {
+    try {
+        if (!existsSync(REGISTRY_CACHE_PATH))
+            return null;
+        const raw = readFileSync(REGISTRY_CACHE_PATH, 'utf-8');
+        const cached = JSON.parse(raw);
+        // Check TTL
+        if (Date.now() - cached.timestamp > REGISTRY_CACHE_TTL)
+            return null;
+        return cached.templates;
+    }
+    catch {
+        return null;
+    }
+}
+function writeRegistryCache(templates) {
+    try {
+        ensureDirs();
+        const data = { timestamp: Date.now(), templates };
+        writeFileSync(REGISTRY_CACHE_PATH, JSON.stringify(data, null, 2), 'utf-8');
+    }
+    catch {
+        // Non-critical
+    }
+}
+/**
+ * Clear the registry index cache.
+ */
+export function clearRegistryCache() {
+    try {
+        if (existsSync(REGISTRY_CACHE_PATH)) {
+            writeFileSync(REGISTRY_CACHE_PATH, JSON.stringify({ timestamp: 0, templates: [] }), 'utf-8');
+        }
+    }
+    catch {
+        // Non-critical
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/workflow/registry.js.map

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

package/dist/workflow/templates.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Workflow Templates — Pre-built agent pipeline templates.
+ *
+ * Each template defines a sequence of agent steps for common tasks.
+ * The WorkflowEngine uses these to pre-fill the orchestrator's task plan,
+ * bypassing the PlannerAgent when a fixed workflow is desired.
+ *
+ * Built-in templates:
+ * - quick-fix: gather context → edit → run → review (small, fast changes)
+ * - feature-implement: plan → gather → write → test → review (new features)
+ * - create-and-run: write → run → review (create from scratch + execute)
+ * - publish-release: test → build → version → publish (release pipeline)
+ */
+import type { TaskStep } from '../agents/agent.js';
+import type { OrchestratorOptions } from '../agents/orchestrator.js';
+export interface WorkflowTemplate {
+    /** Template identifier (used in CLI: `buff workflow run quick-fix`) */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** Short description */
+    description: string;
+    /** Ordered agent steps that form the pipeline */
+    steps: WorkflowStep[];
+    /** Recommended model routing for this workflow */
+    recommendedModels?: Partial<Record<string, string>>;
+    /** Whether to use memory for this workflow type */
+    useMemory?: boolean;
+    /** Semantic version (for registry-published templates) */
+    version?: string;
+    /** Author name or GitHub handle (for registry-published templates) */
+    author?: string;
+    /** Tags for categorization (e.g., ['test', 'release', 'security']) */
+    tags?: string[];
+    /**
+     * Template and package dependencies required by this template.
+     * Used for version resolution and dependency checking during install.
+     */
+    dependencies?: WorkflowDependency[];
+}
+/**
+ * A dependency declaration for a workflow template.
+ * Can reference other templates, npm packages, or CLI tools.
+ */
+export interface WorkflowDependency {
+    /** Type of dependency: 'template' | 'npm' | 'cli' */
+    type: 'template' | 'npm' | 'cli';
+    /** Name/identifier of the dependency */
+    name: string;
+    /** Semantic version constraint (e.g., ">=1.0.0", "^2.0.0") */
+    version?: string;
+    /** Whether this dependency is optional */
+    optional?: boolean;
+    /** Description of why this dependency is needed */
+    description?: string;
+}
+export interface WorkflowStep {
+    /** Agent type (must be registered in Orchestrator's createAgent) */
+    agentType: string;
+    /** Description of what this step does (becomes the task description) */
+    description: string;
+    /** IDs of steps this step depends on (index-based: ['step-0', 'step-1']) */
+    dependsOn: string[];
+}
+/**
+ * Get all available workflow templates.
+ */
+export declare function getWorkflowTemplates(): WorkflowTemplate[];
+/**
+ * Get a specific workflow template by ID.
+ */
+export declare function getWorkflowTemplate(id: string): WorkflowTemplate | undefined;
+/**
+ * Build a task plan from a workflow template, filling in the user's goal.
+ * Each step gets a stable ID (step-0, step-1, etc.) and the dependsOn
+ * references are translated from index-based to ID-based.
+ */
+export declare function buildTaskPlanFromTemplate(template: WorkflowTemplate, goal: string): TaskStep[];
+/**
+ * Build OrchestratorOptions from a workflow template.
+ * Merges the template's recommended models with user overrides.
+ */
+/**
+ * Validate that an object is a valid WorkflowTemplate.
+ * Used by the workflow registry when installing templates.
+ */
+export declare function isValidWorkflowTemplate(obj: unknown): obj is WorkflowTemplate;
+/**
+ * Build OrchestratorOptions from a workflow template.
+ * Merges the template's recommended models with user overrides.
+ */
+export declare function buildWorkflowOptions(template: WorkflowTemplate, userOptions?: Partial<OrchestratorOptions>): OrchestratorOptions;
+//# sourceMappingURL=templates.d.ts.map

package/dist/workflow/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/workflow/templates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAIrE,MAAM,WAAW,gBAAgB;IAC/B,uEAAuE;IACvE,EAAE,EAAE,MAAM,CAAC;IACX,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,kDAAkD;IAClD,iBAAiB,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACpD,mDAAmD;IACnD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB;;;OAGG;IACH,YAAY,CAAC,EAAE,kBAAkB,EAAE,CAAC;CACrC;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,qDAAqD;IACrD,IAAI,EAAE,UAAU,GAAG,KAAK,GAAG,KAAK,CAAC;IACjC,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,oEAAoE;IACpE,SAAS,EAAE,MAAM,CAAC;IAClB,wEAAwE;IACxE,WAAW,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AA0ZD;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,gBAAgB,EAAE,CAEzD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAE5E;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,gBAAgB,EAC1B,IAAI,EAAE,MAAM,GACX,QAAQ,EAAE,CAQZ;AAED;;;GAGG;AACH;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,gBAAgB,CAgB7E;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,gBAAgB,EAC1B,WAAW,GAAE,OAAO,CAAC,mBAAmB,CAAM,GAC7C,mBAAmB,CAUrB"}