@sulala/agent 0.1.0

package/dist/agent/skill-install.js

@@ -0,0 +1,211 @@
+import { readFileSync, writeFileSync, mkdirSync, existsSync, readdirSync, unlinkSync } from 'fs';
+import { homedir } from 'os';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const projectRoot = join(__dirname, '..', '..');
+const registryPath = join(projectRoot, 'registry', 'skills-registry.json');
+export async function getRegistrySkills(overrideUrl) {
+    const url = overrideUrl?.trim() || process.env.SKILLS_REGISTRY_URL?.trim();
+    if (url) {
+        try {
+            const res = await fetch(url.trim());
+            if (!res.ok)
+                throw new Error(`HTTP ${res.status}`);
+            const data = (await res.json());
+            return data.skills || [];
+        }
+        catch {
+            return getRegistrySkillsLocal();
+        }
+    }
+    return getRegistrySkillsLocal();
+}
+export function getRegistrySkillsLocal() {
+    if (!existsSync(registryPath))
+        return [];
+    try {
+        const data = JSON.parse(readFileSync(registryPath, 'utf8'));
+        return data.skills || [];
+    }
+    catch {
+        return [];
+    }
+}
+function getRegistryContentPath(slug) {
+    return join(projectRoot, 'registry', `${slug}.md`);
+}
+function getInstalledVersionsPath() {
+    const base = process.env.SULALA_SKILLS_DIR || join(homedir(), '.sulala', 'skills');
+    return join(dirname(base), 'installed-versions.json');
+}
+function loadInstalledVersions() {
+    const path = getInstalledVersionsPath();
+    if (!existsSync(path))
+        return {};
+    try {
+        return JSON.parse(readFileSync(path, 'utf8'));
+    }
+    catch {
+        return {};
+    }
+}
+function saveInstalledVersions(data) {
+    const path = getInstalledVersionsPath();
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, JSON.stringify(data, null, 2), 'utf8');
+}
+/** Compare semver strings; returns -1 if a < b, 0 if equal, 1 if a > b. */
+function compareVersions(a, b) {
+    const pa = a.split('.').map(Number);
+    const pb = b.split('.').map(Number);
+    for (let i = 0; i < Math.max(pa.length, pb.length); i++) {
+        const va = pa[i] ?? 0;
+        const vb = pb[i] ?? 0;
+        if (va < vb)
+            return -1;
+        if (va > vb)
+            return 1;
+    }
+    return 0;
+}
+function getManagedDir() {
+    return process.env.SULALA_SKILLS_DIR || join(homedir(), '.sulala', 'skills');
+}
+function getWorkspaceDir() {
+    const cwd = process.cwd();
+    const path = process.env.AGENT_CONTEXT_PATH || 'context';
+    return join(cwd, path.trim());
+}
+export async function installSkill(slug, target, opts) {
+    const skills = await getRegistrySkills(opts?.registryUrl);
+    const entry = skills.find((s) => s.slug === slug);
+    if (!entry) {
+        return { success: false, path: '', error: `Skill not found: ${slug}` };
+    }
+    let content;
+    if (entry.url) {
+        try {
+            const res = await fetch(entry.url);
+            if (!res.ok)
+                throw new Error(`HTTP ${res.status}`);
+            content = await res.text();
+        }
+        catch (e) {
+            return {
+                success: false,
+                path: '',
+                error: `Failed to fetch ${entry.url}: ${e.message}`,
+            };
+        }
+    }
+    else {
+        const localPath = getRegistryContentPath(slug);
+        if (!existsSync(localPath)) {
+            return { success: false, path: '', error: `Registry content missing: ${localPath}` };
+        }
+        content = readFileSync(localPath, 'utf8');
+    }
+    const dir = target === 'managed' ? getManagedDir() : getWorkspaceDir();
+    mkdirSync(dir, { recursive: true });
+    const destPath = join(dir, `${slug}.md`);
+    writeFileSync(destPath, content, 'utf8');
+    if (entry.version) {
+        const versions = loadInstalledVersions();
+        versions[slug] = { version: entry.version, target };
+        saveInstalledVersions(versions);
+    }
+    return { success: true, path: destPath };
+}
+export function uninstallSkill(slug, target) {
+    const dir = target === 'managed' ? getManagedDir() : getWorkspaceDir();
+    const filePath = join(dir, `${slug}.md`);
+    if (!existsSync(filePath)) {
+        return { success: false, path: '', error: `Skill not installed: ${slug}` };
+    }
+    try {
+        unlinkSync(filePath);
+        const versions = loadInstalledVersions();
+        delete versions[slug];
+        saveInstalledVersions(versions);
+        return { success: true, path: filePath };
+    }
+    catch (e) {
+        return {
+            success: false,
+            path: '',
+            error: `Failed to remove ${filePath}: ${e.message}`,
+        };
+    }
+}
+/** Get installed skills as { slug, target } where target is where the file lives. */
+function getInstalledSkills() {
+    const seen = new Set();
+    const out = [];
+    const managed = getManagedDir();
+    const workspace = getWorkspaceDir();
+    const dirs = [
+        [workspace, 'workspace'],
+        [managed, 'managed'],
+    ];
+    for (const [dir, target] of dirs) {
+        if (!existsSync(dir))
+            continue;
+        try {
+            for (const n of readdirSync(dir)) {
+                if (!n.endsWith('.md'))
+                    continue;
+                const slug = n.replace(/\.md$/, '');
+                if (seen.has(slug))
+                    continue;
+                seen.add(slug);
+                out.push({ slug, target });
+            }
+        }
+        catch {
+            // skip
+        }
+    }
+    return out;
+}
+export async function updateSkillsAll() {
+    const installed = getInstalledSkills();
+    const registry = await getRegistrySkills();
+    const bySlug = new Map(registry.map((s) => [s.slug, s]));
+    const updated = [];
+    const failed = [];
+    for (const { slug, target } of installed) {
+        if (!bySlug.has(slug))
+            continue;
+        const result = await installSkill(slug, target);
+        if (result.success)
+            updated.push(slug);
+        else
+            failed.push({ slug, error: result.error || 'unknown' });
+    }
+    return { updated, failed };
+}
+export async function getAvailableUpdates() {
+    const installed = getInstalledSkills();
+    const versions = loadInstalledVersions();
+    const registry = await getRegistrySkills();
+    const bySlug = new Map(registry.map((s) => [s.slug, s]));
+    const out = [];
+    for (const { slug } of installed) {
+        const reg = bySlug.get(slug);
+        const inst = versions[slug];
+        const instVer = inst?.version;
+        const regVer = reg?.version;
+        if (!regVer)
+            continue;
+        const updateAvailable = !instVer || compareVersions(instVer, regVer) < 0;
+        out.push({
+            slug,
+            installedVersion: instVer,
+            registryVersion: regVer,
+            updateAvailable,
+        });
+    }
+    return out.filter((u) => u.updateAvailable);
+}
+//# sourceMappingURL=skill-install.js.map

package/dist/agent/skill-install.js.map

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

package/dist/agent/skills-config.d.ts

@@ -0,0 +1,24 @@
+export type SkillEntry = {
+    enabled?: boolean;
+    handle?: string;
+    apiKey?: string;
+    [key: string]: unknown;
+};
+export type SkillsConfig = {
+    entries?: Record<string, SkillEntry>;
+};
+export type SulalaConfig = {
+    skills?: SkillsConfig;
+    [key: string]: unknown;
+};
+/** Config path: SULALA_CONFIG_PATH > .sulala/config.json in cwd (if exists) > ~/.sulala/config.json */
+export declare function getConfigPath(): string;
+export declare function loadFullConfig(): SulalaConfig;
+export declare function saveFullConfig(data: SulalaConfig): void;
+export declare function loadSkillsConfig(): SkillsConfig;
+export declare function saveSkillsConfig(cfg: SkillsConfig): void;
+export declare function isSkillEnabled(skillName: string): boolean;
+export declare function setSkillEnabled(skillName: string, enabled: boolean): void;
+/** Build env vars from all skill entries (key = env name, value = string). Used by run_command so curl etc. see PERIGON_API_KEY etc. */
+export declare function getSkillConfigEnv(): Record<string, string>;
+//# sourceMappingURL=skills-config.d.ts.map

package/dist/agent/skills-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills-config.d.ts","sourceRoot":"","sources":["../../src/agent/skills-config.ts"],"names":[],"mappings":"AAYA,MAAM,MAAM,UAAU,GAAG;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAC;AAEzG,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAcF,uGAAuG;AACvG,wBAAgB,aAAa,IAAI,MAAM,CAMtC;AAWD,wBAAgB,cAAc,IAAI,YAAY,CAY7C;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CAKvD;AAED,wBAAgB,gBAAgB,IAAI,YAAY,CAgB/C;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,CAWxD;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAKzD;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAMzE;AAED,wIAAwI;AACxI,wBAAgB,iBAAiB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAW1D"}

package/dist/agent/skills-config.js

@@ -0,0 +1,126 @@
+/**
+ * Skills config: single JSON file, no DB.
+ * Path: SULALA_CONFIG_PATH > .sulala/config.json in cwd (if exists) > ~/.sulala/config.json.
+ * Read: loadFullConfig/loadSkillsConfig from that path; cache invalidated on file mtime change.
+ * Write: saveFullConfig/saveSkillsConfig to the same path.
+ * See docs/CONFIG.md for full resolution and read/write flow.
+ */
+import { readFileSync, writeFileSync, mkdirSync, existsSync, statSync } from 'fs';
+import { join, dirname } from 'path';
+import { homedir } from 'os';
+import { cwd } from 'process';
+let cached = undefined;
+let cachedPath = null;
+let cachedMtime = 0;
+/** Expand leading ~ to homedir; .env is loaded as-is so ~ is not expanded by the shell. */
+function expandTilde(path) {
+    const s = path.trim();
+    if (s === '~')
+        return homedir();
+    if (s.startsWith('~/') || s.startsWith('~\\'))
+        return join(homedir(), s.slice(2));
+    return path;
+}
+/** Config path: SULALA_CONFIG_PATH > .sulala/config.json in cwd (if exists) > ~/.sulala/config.json */
+export function getConfigPath() {
+    const fromEnv = process.env.SULALA_CONFIG_PATH;
+    if (fromEnv?.trim())
+        return expandTilde(fromEnv.trim());
+    const workspaceConfig = join(cwd(), '.sulala', 'config.json');
+    if (existsSync(workspaceConfig))
+        return workspaceConfig;
+    return join(homedir(), '.sulala', 'config.json');
+}
+function getConfigMtime(path) {
+    try {
+        if (!existsSync(path))
+            return 0;
+        return statSync(path).mtimeMs;
+    }
+    catch {
+        return 0;
+    }
+}
+export function loadFullConfig() {
+    try {
+        const path = getConfigPath();
+        if (!existsSync(path)) {
+            mkdirSync(dirname(path), { recursive: true });
+            writeFileSync(path, '{}', 'utf8');
+            return {};
+        }
+        return JSON.parse(readFileSync(path, 'utf8'));
+    }
+    catch {
+        return {};
+    }
+}
+export function saveFullConfig(data) {
+    const path = getConfigPath();
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, JSON.stringify(data, null, 2), 'utf8');
+    cached = undefined;
+}
+export function loadSkillsConfig() {
+    const path = getConfigPath();
+    const mtime = getConfigMtime(path);
+    if (cached !== undefined && cachedPath === path && cachedMtime === mtime) {
+        return cached ?? {};
+    }
+    cachedPath = path;
+    cachedMtime = mtime;
+    try {
+        const data = loadFullConfig();
+        cached = data.skills ?? {};
+        return cached ?? {};
+    }
+    catch {
+        cached = {};
+        return {};
+    }
+}
+export function saveSkillsConfig(cfg) {
+    const full = loadFullConfig();
+    const existingEntries = full.skills?.entries ?? {};
+    const incomingEntries = cfg.entries ?? {};
+    const mergedEntries = { ...existingEntries };
+    for (const [name, entry] of Object.entries(incomingEntries)) {
+        mergedEntries[name] = { ...existingEntries[name], ...entry };
+    }
+    full.skills = { ...full.skills, entries: mergedEntries };
+    saveFullConfig(full);
+    cached = full.skills;
+}
+export function isSkillEnabled(skillName) {
+    const cfg = loadSkillsConfig();
+    const entry = cfg.entries?.[skillName];
+    if (!entry)
+        return true;
+    return entry.enabled !== false;
+}
+export function setSkillEnabled(skillName, enabled) {
+    const cfg = loadSkillsConfig();
+    if (!cfg.entries)
+        cfg.entries = {};
+    if (!cfg.entries[skillName])
+        cfg.entries[skillName] = {};
+    cfg.entries[skillName].enabled = enabled;
+    saveSkillsConfig(cfg);
+}
+/** Build env vars from all skill entries (key = env name, value = string). Used by run_command so curl etc. see PERIGON_API_KEY etc. */
+export function getSkillConfigEnv() {
+    const cfg = loadSkillsConfig();
+    const out = {};
+    for (const entry of Object.values(cfg.entries ?? {})) {
+        if (!entry || typeof entry !== 'object')
+            continue;
+        for (const [key, value] of Object.entries(entry)) {
+            if (key === 'enabled')
+                continue;
+            if (typeof value === 'string' && value.trim())
+                out[key] = value;
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=skills-config.js.map

package/dist/agent/skills-config.js.map

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

package/dist/agent/skills-watcher.d.ts

@@ -0,0 +1,7 @@
+import { type FSWatcher } from 'chokidar';
+import type { Config } from '../types.js';
+export declare function startSkillsWatcher(config: Config, onChanged: (event: {
+    type: 'skills_changed';
+    ts: number;
+}) => void): FSWatcher | null;
+//# sourceMappingURL=skills-watcher.d.ts.map

package/dist/agent/skills-watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills-watcher.d.ts","sourceRoot":"","sources":["../../src/agent/skills-watcher.ts"],"names":[],"mappings":"AAAA,OAAiB,EAAE,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AAGpD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAI1C,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,KAAK,IAAI,GACjE,SAAS,GAAG,IAAI,CAsBlB"}

package/dist/agent/skills-watcher.js

@@ -0,0 +1,32 @@
+import chokidar from 'chokidar';
+import { existsSync } from 'fs';
+import { getSkillPaths } from './skills.js';
+let watcher = null;
+export function startSkillsWatcher(config, onChanged) {
+    if (!config.skillsWatch)
+        return null;
+    if (watcher)
+        return watcher;
+    const paths = getSkillPaths(config).map((p) => p.path);
+    const dirs = paths.filter((p) => existsSync(p));
+    if (dirs.length === 0)
+        return null;
+    const debounceMs = 250;
+    let timer = null;
+    const fire = () => {
+        if (timer)
+            clearTimeout(timer);
+        timer = setTimeout(() => {
+            timer = null;
+            onChanged({ type: 'skills_changed', ts: Date.now() });
+        }, debounceMs);
+    };
+    watcher = chokidar.watch(dirs, {
+        ignoreInitial: true,
+        depth: 1,
+        ignored: (p) => !/\.(md|txt)$/.test(p),
+    });
+    watcher.on('add', fire).on('change', fire).on('unlink', fire);
+    return watcher;
+}
+//# sourceMappingURL=skills-watcher.js.map

package/dist/agent/skills-watcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills-watcher.js","sourceRoot":"","sources":["../../src/agent/skills-watcher.ts"],"names":[],"mappings":"AAAA,OAAO,QAA4B,MAAM,UAAU,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,IAAI,OAAO,GAAqB,IAAI,CAAC;AAErC,MAAM,UAAU,kBAAkB,CAChC,MAAc,EACd,SAAkE;IAElE,IAAI,CAAC,MAAM,CAAC,WAAW;QAAE,OAAO,IAAI,CAAC;IACrC,IAAI,OAAO;QAAE,OAAO,OAAO,CAAC;IAC5B,MAAM,KAAK,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACvD,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IAChD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,MAAM,UAAU,GAAG,GAAG,CAAC;IACvB,IAAI,KAAK,GAAyC,IAAI,CAAC;IACvD,MAAM,IAAI,GAAG,GAAG,EAAE;QAChB,IAAI,KAAK;YAAE,YAAY,CAAC,KAAK,CAAC,CAAC;QAC/B,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YACtB,KAAK,GAAG,IAAI,CAAC;YACb,SAAS,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACxD,CAAC,EAAE,UAAU,CAAC,CAAC;IACjB,CAAC,CAAC;IACF,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE;QAC7B,aAAa,EAAE,IAAI;QACnB,KAAK,EAAE,CAAC;QACR,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;KACvC,CAAC,CAAC;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC9D,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/agent/skills.d.ts

@@ -0,0 +1,32 @@
+import type { Config } from '../types.js';
+export type SkillStatus = 'eligible' | 'blocked' | 'unknown';
+export type Skill = {
+    name: string;
+    description: string;
+    filePath: string;
+    status: SkillStatus;
+    missing?: string[];
+    bins?: string[];
+    /** Required env vars from metadata sulala.requires.env (e.g. BSKY_HANDLE, BSKY_APP_PASSWORD). */
+    env?: string[];
+    source?: 'workspace' | 'managed' | 'bundled' | 'plugin' | 'extra';
+};
+export declare function validateSkillContent(content: string): {
+    valid: boolean;
+    name?: string;
+    description?: string;
+    bins?: string[];
+    errors: string[];
+};
+/** Collect all required bins from enabled skills (for auto-merge with ALLOWED_BINARIES). */
+export declare function getAllRequiredBins(config: Config): string[];
+/** Paths in precedence order: workspace > managed > bundled > extra. */
+export declare function getSkillPaths(config: Config): {
+    path: string;
+    source: Skill['source'];
+}[];
+/** List skills from all paths with precedence: workspace > managed > bundled > extra. By default filtered by skills.entries.<name>.enabled; set includeDisabled true to return all (e.g. for dashboard). */
+export declare function listSkills(config: Config, options?: {
+    includeDisabled?: boolean;
+}): Skill[];
+//# sourceMappingURL=skills.d.ts.map

package/dist/agent/skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/agent/skills.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAG1C,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,CAAC;AAE7D,MAAM,MAAM,KAAK,GAAG;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,iGAAiG;IACjG,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;CACnE,CAAC;AA2CF,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG;IACrD,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAaA;AA+CD,4FAA4F;AAC5F,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAS3D;AAED,wEAAwE;AACxE,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAA;CAAE,EAAE,CAmBzF;AAyDD,4MAA4M;AAC5M,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;IAAE,eAAe,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,KAAK,EAAE,CAW3F"}