@sulala/agent 0.1.0

package/dist/agent/skills.js

@@ -0,0 +1,208 @@
+import { readdirSync, readFileSync, statSync, existsSync } from 'fs';
+import { join, resolve } from 'path';
+import { spawnSync } from 'child_process';
+import { isSkillEnabled } from './skills-config.js';
+function parseFrontmatter(content) {
+    const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/);
+    if (!match)
+        return {};
+    const block = match[1];
+    let name;
+    let description;
+    let metadataRaw;
+    let inMetadata = false;
+    const metaLines = [];
+    for (const line of block.split(/\r?\n/)) {
+        const nameMatch = line.match(/^name:\s*(.+)$/);
+        if (nameMatch) {
+            name = nameMatch[1].trim().replace(/^['"]|['"]$/g, '');
+            inMetadata = false;
+            continue;
+        }
+        const descMatch = line.match(/^description:\s*(.+)$/);
+        if (descMatch) {
+            description = descMatch[1].trim().replace(/^['"]|['"]$/g, '');
+            inMetadata = false;
+            continue;
+        }
+        const metaStart = line.match(/^metadata:\s*$/);
+        if (metaStart) {
+            inMetadata = true;
+            continue;
+        }
+        if (inMetadata) {
+            metaLines.push(line);
+        }
+    }
+    if (metaLines.length) {
+        metadataRaw = metaLines.join('\n').trim();
+    }
+    return { name, description, metadata: metadataRaw };
+}
+export function validateSkillContent(content) {
+    const errors = [];
+    const { name, description, metadata } = parseFrontmatter(content);
+    if (!name?.trim())
+        errors.push('Missing or empty name');
+    if (!description?.trim())
+        errors.push('Missing or empty description');
+    const bins = extractRequiredBins(metadata);
+    return {
+        valid: errors.length === 0,
+        name: name?.trim(),
+        description: description?.trim(),
+        bins: bins.length ? bins : undefined,
+        errors,
+    };
+}
+function extractRequiredBins(metadataRaw) {
+    if (!metadataRaw)
+        return [];
+    try {
+        const jsonStr = metadataRaw.replace(/^\s+/gm, ' ').replace(/\s+/g, ' ');
+        const parsed = JSON.parse(jsonStr);
+        return (parsed?.sulala?.requires?.bins || []);
+    }
+    catch {
+        const m = metadataRaw.match(/"bins"\s*:\s*\[([^\]]*)\]/);
+        if (!m)
+            return [];
+        const inner = m[1];
+        return inner
+            .split(',')
+            .map((s) => s.trim().replace(/^["']|["']$/g, ''))
+            .filter(Boolean);
+    }
+}
+function extractRequiredEnv(metadataRaw) {
+    if (!metadataRaw)
+        return [];
+    try {
+        const jsonStr = metadataRaw.replace(/^\s+/gm, ' ').replace(/\s+/g, ' ');
+        const parsed = JSON.parse(jsonStr);
+        const env = parsed?.sulala?.requires?.env;
+        return Array.isArray(env) ? env.filter((e) => typeof e === 'string' && e.trim().length > 0) : [];
+    }
+    catch {
+        const m = metadataRaw.match(/"env"\s*:\s*\[([^\]]*)\]/);
+        if (!m)
+            return [];
+        const inner = m[1];
+        return inner
+            .split(',')
+            .map((s) => s.trim().replace(/^["']|["']$/g, ''))
+            .filter(Boolean);
+    }
+}
+function binAvailable(bin) {
+    const allowed = (process.env.ALLOWED_BINARIES || '')
+        .split(',')
+        .map((s) => s.trim().toLowerCase())
+        .filter(Boolean);
+    if (allowed.includes(bin.toLowerCase()))
+        return true;
+    const r = spawnSync('which', [bin], { encoding: 'utf8' });
+    return r.status === 0 && !!r.stdout?.trim();
+}
+/** Collect all required bins from enabled skills (for auto-merge with ALLOWED_BINARIES). */
+export function getAllRequiredBins(config) {
+    const skills = listSkills(config);
+    const bins = new Set();
+    for (const s of skills) {
+        for (const b of s.bins || []) {
+            if (b?.trim())
+                bins.add(b.trim().toLowerCase());
+        }
+    }
+    return [...bins];
+}
+/** Paths in precedence order: workspace > managed > bundled > extra. */
+export function getSkillPaths(config) {
+    const out = [];
+    const cwd = process.cwd();
+    if (config.agentContextPath?.trim()) {
+        out.push({
+            path: resolve(cwd, config.agentContextPath.trim()),
+            source: 'workspace',
+        });
+    }
+    out.push({ path: config.skillsManagedDir, source: 'managed' });
+    out.push({ path: config.skillsBundledDir, source: 'bundled' });
+    for (const p of config.skillsPluginDirs) {
+        out.push({ path: p, source: 'plugin' });
+    }
+    for (const p of config.skillsExtraDirs) {
+        out.push({ path: resolve(cwd, p), source: 'extra' });
+    }
+    return out;
+}
+function scanDirForSkills(base, source) {
+    if (!existsSync(base))
+        return [];
+    const skills = [];
+    try {
+        const stat = statSync(base);
+        const files = [];
+        if (stat.isFile() && (base.endsWith('.md') || base.endsWith('.txt'))) {
+            files.push({ path: base, name: base.split(/[/\\]/).pop() || '' });
+        }
+        else if (stat.isDirectory()) {
+            const names = readdirSync(base).sort();
+            for (const n of names) {
+                if (!n.endsWith('.md') && !n.endsWith('.txt'))
+                    continue;
+                files.push({ path: join(base, n), name: n });
+            }
+        }
+        for (const { path: fullPath, name: fileName } of files) {
+            if (!fileName.endsWith('.md'))
+                continue;
+            try {
+                const raw = readFileSync(fullPath, 'utf8');
+                const { name, description, metadata } = parseFrontmatter(raw);
+                if (!name || !description)
+                    continue;
+                const bins = extractRequiredBins(metadata);
+                const env = extractRequiredEnv(metadata);
+                const missing = [];
+                for (const b of bins) {
+                    if (!binAvailable(b))
+                        missing.push(b);
+                }
+                const status = bins.length === 0 ? 'unknown' : missing.length === 0 ? 'eligible' : 'blocked';
+                skills.push({
+                    name,
+                    description,
+                    filePath: fullPath,
+                    status,
+                    source,
+                    bins: bins.length ? bins : undefined,
+                    env: env.length ? env : undefined,
+                    ...(missing.length ? { missing } : {}),
+                });
+            }
+            catch {
+                // skip
+            }
+        }
+    }
+    catch {
+        // skip
+    }
+    return skills;
+}
+/** 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 function listSkills(config, options) {
+    const paths = getSkillPaths(config);
+    const byName = new Map();
+    for (const { path: p, source } of paths) {
+        for (const s of scanDirForSkills(p, source)) {
+            if (!byName.has(s.name)) {
+                if (options?.includeDisabled || isSkillEnabled(s.name))
+                    byName.set(s.name, s);
+            }
+        }
+    }
+    return Array.from(byName.values()).sort((a, b) => a.name.localeCompare(b.name));
+}
+//# sourceMappingURL=skills.js.map

package/dist/agent/skills.js.map

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

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=skills.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skills.test.d.ts","sourceRoot":"","sources":["../../src/agent/skills.test.ts"],"names":[],"mappings":""}

package/dist/agent/skills.test.js

@@ -0,0 +1,59 @@
+import { describe, it, expect } from "vitest";
+import { validateSkillContent } from "./skills.js";
+describe("skills", () => {
+    describe("validateSkillContent", () => {
+        it("accepts valid skill with name and description", () => {
+            const content = `---
+name: test-skill
+description: A test skill
+---
+# Body`;
+            const r = validateSkillContent(content);
+            expect(r.valid).toBe(true);
+            expect(r.name).toBe("test-skill");
+            expect(r.description).toBe("A test skill");
+            expect(r.errors).toHaveLength(0);
+        });
+        it("rejects missing name", () => {
+            const content = `---
+description: Only description
+---
+# Body`;
+            const r = validateSkillContent(content);
+            expect(r.valid).toBe(false);
+            expect(r.errors).toContain("Missing or empty name");
+        });
+        it("rejects missing description", () => {
+            const content = `---
+name: no-desc
+---
+# Body`;
+            const r = validateSkillContent(content);
+            expect(r.valid).toBe(false);
+            expect(r.errors).toContain("Missing or empty description");
+        });
+        it("extracts required bins from metadata", () => {
+            const content = `---
+name: git
+description: Git ops
+metadata:
+  { "sulala": { "requires": { "bins": ["git"] } } }
+---
+# Body`;
+            const r = validateSkillContent(content);
+            expect(r.valid).toBe(true);
+            expect(r.bins).toEqual(["git"]);
+        });
+        it("accepts skill without metadata", () => {
+            const content = `---
+name: simple
+description: No bins
+---
+# Body`;
+            const r = validateSkillContent(content);
+            expect(r.valid).toBe(true);
+            expect(r.bins).toBeUndefined();
+        });
+    });
+});
+//# sourceMappingURL=skills.test.js.map

package/dist/agent/skills.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.test.js","sourceRoot":"","sources":["../../src/agent/skills.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEnD,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE;IACtB,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;QACpC,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;YACvD,MAAM,OAAO,GAAG;;;;OAIf,CAAC;YACF,MAAM,CAAC,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;YACxC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC3B,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAClC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YAC3C,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,sBAAsB,EAAE,GAAG,EAAE;YAC9B,MAAM,OAAO,GAAG;;;OAGf,CAAC;YACF,MAAM,CAAC,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;YACxC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC5B,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,uBAAuB,CAAC,CAAC;QACtD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;YACrC,MAAM,OAAO,GAAG;;;OAGf,CAAC;YACF,MAAM,CAAC,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;YACxC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC5B,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,8BAA8B,CAAC,CAAC;QAC7D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;YAC9C,MAAM,OAAO,GAAG;;;;;;OAMf,CAAC;YACF,MAAM,CAAC,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;YACxC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC3B,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;QAClC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;YACxC,MAAM,OAAO,GAAG;;;;OAIf,CAAC;YACF,MAAM,CAAC,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;YACxC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC3B,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,CAAC;QACjC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/agent/tools.d.ts

@@ -0,0 +1,8 @@
+import type { ToolDef } from '../types.js';
+export declare function registerTool(tool: ToolDef): void;
+export declare function getTool(name: string): ToolDef | undefined;
+export declare function listTools(): ToolDef[];
+export declare function executeTool(name: string, args: Record<string, unknown>): Promise<unknown>;
+/** Built-in: enqueue a task (type + optional payload) */
+export declare function registerBuiltInTools(enqueueTask: (taskId: string) => void): void;
+//# sourceMappingURL=tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/agent/tools.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAI3C,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAEhD;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAEzD;AAED,wBAAgB,SAAS,IAAI,OAAO,EAAE,CAErC;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAKzF;AAED,yDAAyD;AACzD,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAkHhF"}

package/dist/agent/tools.js

@@ -0,0 +1,147 @@
+import { readFileSync, existsSync } from 'fs';
+import { resolve, relative } from 'path';
+import { spawnSync } from 'child_process';
+import { insertTask } from '../db/index.js';
+import { config } from '../config.js';
+import { getAllRequiredBins } from './skills.js';
+import { getSkillConfigEnv } from './skills-config.js';
+const registry = new Map();
+export function registerTool(tool) {
+    registry.set(tool.name, tool);
+}
+export function getTool(name) {
+    return registry.get(name);
+}
+export function listTools() {
+    return [...registry.values()];
+}
+export function executeTool(name, args) {
+    const tool = registry.get(name);
+    if (!tool)
+        throw new Error(`Unknown tool: ${name}`);
+    const result = tool.execute(args);
+    return Promise.resolve(result);
+}
+/** Built-in: enqueue a task (type + optional payload) */
+export function registerBuiltInTools(enqueueTask) {
+    registerTool({
+        name: 'run_task',
+        description: 'Enqueue a background task by type and optional payload. Use for scheduling work (e.g. heartbeat, file_event, or custom types).',
+        parameters: {
+            type: 'object',
+            properties: {
+                type: { type: 'string', description: 'Task type (e.g. heartbeat, file_event)' },
+                payload: { type: 'object', description: 'Optional JSON payload' },
+            },
+            required: ['type'],
+        },
+        execute: (args) => {
+            const type = args.type;
+            const payload = args.payload ?? null;
+            const taskId = `task_${Date.now()}_${Math.random().toString(36).slice(2, 9)}`;
+            insertTask({ id: taskId, type, payload: payload ?? undefined });
+            enqueueTask(taskId);
+            return { taskId, type, status: 'enqueued' };
+        },
+    });
+    if (process.env.ALLOW_SHELL_TOOL === '1') {
+        const envBins = (process.env.ALLOWED_BINARIES || '')
+            .split(',')
+            .map((b) => b.trim().toLowerCase())
+            .filter(Boolean);
+        const skillBins = getAllRequiredBins(config);
+        const allowed = [...new Set([...envBins, ...skillBins])];
+        registerTool({
+            name: 'run_command',
+            description: 'Run a single command (binary + args). Only binaries in the ALLOWED_BINARIES list are permitted. Use for skills that document CLI usage (e.g. memo for Apple Notes): read the skill doc, then run the commands it describes.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    binary: { type: 'string', description: 'Executable name (e.g. memo, git). Must be in ALLOWED_BINARIES.' },
+                    args: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: 'Arguments (e.g. ["notes", "-a", "buy saiko"] for memo).',
+                    },
+                },
+                required: ['binary', 'args'],
+            },
+            execute: (args) => {
+                const binary = String(args.binary || '').trim().toLowerCase();
+                if (!binary)
+                    return { error: 'binary is required' };
+                if (allowed.length > 0 && !allowed.includes(binary)) {
+                    return { error: `binary "${binary}" is not in ALLOWED_BINARIES (allowed: ${allowed.join(', ')})` };
+                }
+                const rawArgs = Array.isArray(args.args) ? args.args : [];
+                const argsList = rawArgs.map((a) => String(a).replace(/\0/g, '').trim()).filter((_, i) => i < 50);
+                if (binary === 'curl') {
+                    const allowedHosts = (process.env.ALLOWED_CURL_HOSTS || '').split(',').map((h) => h.trim().toLowerCase()).filter(Boolean);
+                    if (allowedHosts.length > 0) {
+                        const urls = argsList.join(' ').match(/https?:\/\/[^/\s"'<>]+/g) || [];
+                        for (const u of urls) {
+                            try {
+                                const host = new URL(u).hostname.toLowerCase();
+                                const allowed = allowedHosts.some((h) => host === h || host.endsWith('.' + h));
+                                if (!allowed)
+                                    return { error: `curl URL host not allowed: ${host} (ALLOWED_CURL_HOSTS)` };
+                            }
+                            catch {
+                                // skip malformed URL
+                            }
+                        }
+                    }
+                }
+                try {
+                    const skillEnv = getSkillConfigEnv();
+                    const env = { ...process.env, ...skillEnv };
+                    const result = spawnSync(binary, argsList, { encoding: 'utf8', timeout: 30000, env });
+                    if (result.error)
+                        return { error: result.error.message };
+                    return {
+                        status: result.status ?? null,
+                        stdout: result.stdout?.trim() ?? '',
+                        stderr: result.stderr?.trim() ?? '',
+                    };
+                }
+                catch (e) {
+                    return { error: e.message };
+                }
+            },
+        });
+    }
+    if (config.agentWorkspaceRoot) {
+        const workspaceRoot = resolve(process.cwd(), config.agentWorkspaceRoot);
+        registerTool({
+            name: 'read_file',
+            description: 'Read the contents of a file from the workspace. Path is relative to the workspace root.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    path: { type: 'string', description: 'Relative path to the file (e.g. README.md, src/index.ts)' },
+                },
+                required: ['path'],
+            },
+            execute: (args) => {
+                const rawPath = args.path || '';
+                if (!rawPath.trim())
+                    return { error: 'path is required' };
+                const requested = resolve(workspaceRoot, rawPath.trim());
+                const relativePath = relative(workspaceRoot, requested);
+                if (relativePath.startsWith('..')) {
+                    return { error: 'path must be inside the workspace' };
+                }
+                if (!existsSync(requested))
+                    return { error: `file not found: ${rawPath}` };
+                try {
+                    const content = readFileSync(requested, 'utf8');
+                    return { path: rawPath.trim(), content };
+                }
+                catch (e) {
+                    return { error: e.message };
+                }
+            },
+        });
+    }
+}
+//# sourceMappingURL=tools.js.map

package/dist/agent/tools.js.map

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

package/dist/ai/orchestrator.d.ts

@@ -0,0 +1,38 @@
+import type { AIAdapter, CompleteOptions } from '../types.js';
+export declare function registerProvider(name: string, adapter: AIAdapter): void;
+export declare function getProvider(name?: string | null): AIAdapter;
+export type StreamChunkEvent = {
+    type: 'delta';
+    content: string;
+} | {
+    type: 'finish';
+    content: string;
+    tool_calls?: Array<{
+        id: string;
+        name: string;
+        arguments: string;
+    }>;
+    usage?: Record<string, number>;
+};
+/** Stream completion (OpenAI and OpenRouter). Falls back to non-streaming for other providers. */
+export declare function completeStream(options: CompleteOptions, onChunk: (ev: StreamChunkEvent) => void): Promise<{
+    content: string;
+    tool_calls?: Array<{
+        id: string;
+        name: string;
+        arguments: string;
+    }>;
+    usage?: Record<string, number>;
+}>;
+export declare function complete(options?: CompleteOptions): Promise<{
+    id: string;
+    content: string;
+    usage?: Record<string, number>;
+    meta?: Record<string, unknown>;
+    tool_calls?: Array<{
+        id: string;
+        name: string;
+        arguments: string;
+    }>;
+}>;
+//# sourceMappingURL=orchestrator.d.ts.map

package/dist/ai/orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../src/ai/orchestrator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAK9D,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,GAAG,IAAI,CAEvE;AAED,wBAAgB,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAK3D;AAED,MAAM,MAAM,gBAAgB,GACxB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC;AAE7I,kGAAkG;AAClG,wBAAsB,cAAc,CAClC,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,CAAC,EAAE,EAAE,gBAAgB,KAAK,IAAI,GACtC,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC,CAwEnI;AAMD,wBAAsB,QAAQ,CAAC,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC;IACrE,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,UAAU,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrE,CAAC,CAkCD"}