@cicctencent/agent-server 0.1.1

package/dist/esm/mcp/template-builder.js

@@ -0,0 +1,173 @@
+/**
+ * @file 通用模板请求构建器
+ * @description 配置驱动的 HTTP 请求构建，从 manifest/extra 中读取 URL 模板、body 模板、relay、认证和响应配置。
+ *              适用于所有“模板化 HTTP API → MCP”的连接器，无需编写连接器专属 builder 代码。
+ *
+ * 配置字段（来自 MCPServerEntity / manifest extra）：
+ * - urlTemplate: URL 构建模板，支持 {apiRoot} {entry} 占位符
+ * - apiRoot:     API 根 URL
+ * - apiMapping:  工具名 → { entry, body, method?, url? } 映射
+ * - relay:       可选的业务级代理转发配置（url + headers，通过 target-url header 转发）
+ * - auth:        可选的认证配置（bearer/basic/apiKey/custom）
+ * - response:    可选的响应处理配置（JSONPath 提取 + 错误码检测）
+ *
+ * 映射扩展字段：
+ * - method:  'GET' | 'POST'（默认 'POST'）
+ * - url:     直接覆盖 urlTemplate（支持 {apiRoot} 占位符）
+ * - entry:   支持 ${param} 路径参数（如 v8/finance/chart/${symbol}）
+ */
+import { resolveBodyTemplate } from "./body-template.js";
+/**
+ * 从 AuthConfig 构建认证 headers
+ *
+ * 支持 `${env.VAR_NAME}` 模板：运行时从环境变量读取凭证。
+ */
+function buildAuthHeaders(auth) {
+    if (!auth?.value)
+        return {};
+    const val = resolveEnvTemplate(auth.value);
+    switch (auth.type) {
+        case 'bearer': return { 'Authorization': `Bearer ${val}` };
+        case 'basic': return { 'Authorization': `Basic ${val}` };
+        case 'apiKey': return { [auth.name || 'X-API-Key']: val };
+        case 'custom': return { [auth.name || 'X-Custom-Auth']: val };
+        default: return {};
+    }
+}
+/**
+ * 解析 `${env.VAR_NAME}` 模板，从环境变量读取值
+ *
+ * - `${env.MY_API_KEY}` → process.env.MY_API_KEY
+ * - 普通字符串原样返回
+ */
+function resolveEnvTemplate(str) {
+    return str.replace(/\$\{env\.(\w+)\}/g, (_, name) => process.env[name] || '');
+}
+/**
+ * 通用模板请求构建器
+ *
+ * 纯配置驱动，从 extra 中读取所有构建参数：
+ * - URL 构建：urlTemplate 占位符替换 / mapping.url 直接覆盖
+ * - Body 构建：${param|default} 模板解析
+ * - GET 模式：body 模板 → query string
+ * - Relay 转发：relay 配置 → target-url / target-headers
+ * - Auth 认证：auth 配置 → Authorization / 自定义 headers
+ *
+ * 连接器只需在 manifest.json 中声明配置，无需编写专属 builder。
+ */
+/**
+ * 默认浏览器请求头
+ * 很多公开 API（如 Yahoo Finance）需要 User-Agent 才能返回 JSON 而非 HTML consent 页面
+ */
+const DEFAULT_BROWSER_HEADERS = {
+    'User-Agent': 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/137.0.0.0 Safari/537.36',
+    'Accept': 'application/json, text/plain, */*',
+    'Accept-Language': 'en-US,en;q=0.9',
+};
+export const buildFromTemplate = async (ctx) => {
+    const { toolName, args, mapping, extra } = ctx;
+    const config = extra;
+    const m = mapping;
+    // 1. 解析 entry（支持 ${param} 路径参数，如 v8/finance/chart/${symbol}）
+    const entryRaw = m.entry;
+    if (!entryRaw && !m.url) {
+        throw new Error(`Tool '${toolName}' has no 'entry' or 'url' defined in apiMapping`);
+    }
+    const entry = entryRaw
+        ? resolveString(entryRaw, args)
+        : '';
+    // 2. 构建目标 URL（mapping.url 优先，否则用全局 urlTemplate）
+    let targetUrl;
+    if (m.url) {
+        // mapping 级 url 覆盖：支持 {apiRoot} 占位符
+        targetUrl = m.url
+            .replace('{apiRoot}', config.apiRoot || '')
+            .replace('{entry}', encodeURIComponent(String(entry)));
+    }
+    else {
+        const urlTemplate = config.urlTemplate || '{apiRoot}?Entry={entry}';
+        targetUrl = urlTemplate
+            .replace('{apiRoot}', config.apiRoot || '')
+            .replace('{entry}', encodeURIComponent(String(entry)));
+    }
+    // 3. 解析 body 模板
+    const bodyTemplate = m.body;
+    const bodyObj = bodyTemplate ? resolveBodyTemplate(bodyTemplate, args) : {};
+    // 4. 确定 HTTP 方法（mapping 级 > 全局级 > 默认 POST）
+    const method = (m.method || config['method'] || 'POST').toUpperCase();
+    // 4.5 构建认证 headers
+    const authHeaders = buildAuthHeaders(config.auth);
+    // 4.6 合并默认浏览器头 + 连接器自定义头 + 认证头（后者优先级高）
+    const baseHeaders = {
+        ...DEFAULT_BROWSER_HEADERS,
+        ...(config.headers || {}),
+        ...authHeaders,
+    };
+    // 5. GET 模式：body 模板 → query string
+    if (method === 'GET') {
+        const params = new URLSearchParams();
+        for (const [k, v] of Object.entries(bodyObj)) {
+            if (v !== undefined && v !== null && v !== '') {
+                params.set(k, String(v));
+            }
+        }
+        const qs = params.toString();
+        const finalUrl = qs ? `${targetUrl}?${qs}` : targetUrl;
+        if (config.relay) {
+            return {
+                url: config.relay.url,
+                init: {
+                    method: 'GET',
+                    headers: {
+                        ...baseHeaders,
+                        ...(config.relay.headers || {}),
+                        'target-url': finalUrl,
+                    },
+                },
+            };
+        }
+        return {
+            url: finalUrl,
+            init: { method: 'GET', headers: { ...baseHeaders } },
+        };
+    }
+    // 6. POST 模式：body → JSON
+    const body = JSON.stringify(bodyObj);
+    if (config.relay) {
+        return {
+            url: config.relay.url,
+            init: {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    ...baseHeaders,
+                    ...(config.relay.headers || {}),
+                    'target-url': targetUrl,
+                    'target-headers': JSON.stringify({ 'Content-Type': 'application/json' }),
+                },
+                body,
+            },
+        };
+    }
+    return {
+        url: targetUrl,
+        init: {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                ...baseHeaders,
+            },
+            body,
+        },
+    };
+};
+/** 解析字符串中的 ${param|default} 模板（复用 body-template 的逻辑） */
+function resolveString(str, args) {
+    return str.replace(/\$\{(\w+)(?:\|([^}]*))?\}/g, (_, paramName, defaultStr) => {
+        if (args[paramName] !== undefined && args[paramName] !== null) {
+            return String(args[paramName]);
+        }
+        return defaultStr !== undefined ? defaultStr : '';
+    });
+}
+//# sourceMappingURL=template-builder.js.map

package/dist/esm/mcp/template-builder.js.map

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

package/dist/esm/model/automation.d.ts

@@ -0,0 +1,34 @@
+/** 自动化任务运行状态 */
+export type AutomationStatus = 'idle' | 'running' | 'success' | 'error';
+/** 自动化定时任务实体 */
+export interface AutomationEntity {
+    id: number;
+    name: string;
+    description?: string;
+    enabled: boolean;
+    schedule: string;
+    prompt: string;
+    agentProfileId?: number;
+    workspaceId?: number;
+    lastRunAt?: string;
+    lastStatus?: AutomationStatus;
+    lastResult?: string;
+    nextRunAt?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+/** 自动化任务执行记录 */
+export interface AutomationRunEntity {
+    id: number;
+    automationId: number;
+    status: AutomationStatus;
+    triggerType: 'schedule' | 'manual';
+    prompt: string;
+    result: string;
+    errors: string[];
+    startedAt: string;
+    finishedAt: string;
+    duration: number;
+    sessionId: string;
+}
+//# sourceMappingURL=automation.d.ts.map

package/dist/esm/model/automation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"automation.d.ts","sourceRoot":"","sources":["../../../src/model/automation.ts"],"names":[],"mappings":"AAIA,gBAAgB;AAChB,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAExE,gBAAgB;AAChB,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,gBAAgB;AAChB,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,gBAAgB,CAAC;IACzB,WAAW,EAAE,UAAU,GAAG,QAAQ,CAAC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/esm/model/automation.js

@@ -0,0 +1,5 @@
+// ============================================================
+// AutomationEntity — 自动化定时任务数据模型
+// ============================================================
+export {};
+//# sourceMappingURL=automation.js.map

package/dist/esm/model/automation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"automation.js","sourceRoot":"","sources":["../../../src/model/automation.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,iCAAiC;AACjC,+DAA+D"}

package/dist/esm/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "module"
+}

package/dist/esm/prompt/prompt-builder.d.ts

@@ -0,0 +1,14 @@
+import type { ToolRegistry, SkillManager } from '@cicctencent/agent-core';
+import type { AgentProfileEntity, PromptBuilderProvider, SpecialistResourceContext } from '../types.js';
+/**
+ * 默认 PromptBuilderProvider 实现
+ */
+export declare class DefaultPromptBuilder implements PromptBuilderProvider {
+    resolveToolDisplayName(toolName: string, _registry: ToolRegistry): string;
+    buildDefaultPrompt(profile: AgentProfileEntity, tools: ToolRegistry, memory?: string, specialists?: AgentProfileEntity[], specialistResourceMap?: Record<string, SpecialistResourceContext>): string;
+    buildSpecialistPrompt(profile: AgentProfileEntity, tools: ToolRegistry, skills: SkillManager, memory?: string): string;
+    buildToolDescList(registry: ToolRegistry): string;
+    buildMCPToolDescList(registry: ToolRegistry): string;
+}
+export declare const RESULT_SYNTHESIS_PROMPT = "Based on the specialist agents' outputs above, provide a comprehensive synthesis:\n1. Summarize key findings from each agent\n2. Identify any conflicts or contradictions\n3. Provide a unified recommendation\n4. Highlight any risks or caveats\nRespond in the same language as the user.";
+//# sourceMappingURL=prompt-builder.d.ts.map

package/dist/esm/prompt/prompt-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-builder.d.ts","sourceRoot":"","sources":["../../../src/prompt/prompt-builder.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC1E,OAAO,KAAK,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AA2BxG;;GAEG;AACH,qBAAa,oBAAqB,YAAW,qBAAqB;IAChE,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,GAAG,MAAM;IAIzE,kBAAkB,CAChB,OAAO,EAAE,kBAAkB,EAC3B,KAAK,EAAE,YAAY,EACnB,MAAM,CAAC,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,kBAAkB,EAAE,EAClC,qBAAqB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,yBAAyB,CAAC,GAChE,MAAM;IAkCT,qBAAqB,CACnB,OAAO,EAAE,kBAAkB,EAC3B,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,YAAY,EACpB,MAAM,CAAC,EAAE,MAAM,GACd,MAAM;IAuBT,iBAAiB,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM;IAYjD,oBAAoB,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM;CASrD;AAED,eAAO,MAAM,uBAAuB,iSAKM,CAAC"}

package/dist/esm/prompt/prompt-builder.js

@@ -0,0 +1,109 @@
+// ============================================================
+// PromptBuilder — 默认 Prompt 构建实现
+// ============================================================
+/** 内置工具名称可读化映射 */
+const BUILTIN_TOOL_LABELS = {
+    execute_command: '执行命令',
+    read_terminal: '读取终端',
+    write_file: '写入文件',
+    append_file: '追加文件',
+    read_file: '读取文件',
+    delegate_task: '分发任务',
+    web_fetch: '抓取网页',
+    save_memory: '保存记忆',
+    recall_memory: '回忆记忆',
+    delete_memory: '删除记忆',
+    read_tool_doc: '查阅工具文档',
+    run_script: '运行脚本',
+    show_widget: '渲染组件',
+    save_artifact: '保存文件',
+    read_tool_result: '读取工具结果',
+    read_offload: '读取卸载内容',
+    load_skill: '加载技能',
+    create_presentation: '创建演示文稿',
+    create_document: '创建文档',
+    create_pdf: '创建 PDF',
+    create_report: '生成报表',
+};
+/**
+ * 默认 PromptBuilderProvider 实现
+ */
+export class DefaultPromptBuilder {
+    resolveToolDisplayName(toolName, _registry) {
+        return BUILTIN_TOOL_LABELS[toolName] || toolName;
+    }
+    buildDefaultPrompt(profile, tools, memory, specialists, specialistResourceMap) {
+        const parts = [];
+        parts.push(profile.basePrompt || 'You are a helpful AI assistant with access to tools. Use tools when needed to accomplish tasks. Always explain your actions clearly. Respond in the same language as the user.');
+        if (memory) {
+            parts.push(`\n${memory}`);
+        }
+        const toolList = this.buildToolDescList(tools);
+        if (toolList) {
+            parts.push(`\n## Available Tools\n${toolList}`);
+        }
+        if (specialists && specialists.length > 0) {
+            const specialistList = specialists.map(s => {
+                const resources = specialistResourceMap?.[s.name];
+                let desc = `- **${s.name}**: ${s.description || s.domain || 'specialist agent'}`;
+                if (resources) {
+                    if (resources.connectorNames.length > 0) {
+                        desc += ` (数据源: ${resources.connectorNames.join(', ')})`;
+                    }
+                    if (resources.mcpServerNames.length > 0) {
+                        desc += ` (MCP: ${resources.mcpServerNames.join(', ')})`;
+                    }
+                }
+                return desc;
+            }).join('\n');
+            parts.push(`\n## Specialist Agents (via delegate_task)\n${specialistList}`);
+        }
+        return parts.join('\n');
+    }
+    buildSpecialistPrompt(profile, tools, skills, memory) {
+        const parts = [];
+        parts.push(profile.basePrompt || 'You are a specialist AI agent. Focus on your domain expertise and use tools to accomplish tasks.');
+        if (memory) {
+            parts.push(`\n${memory}`);
+        }
+        const toolList = this.buildToolDescList(tools);
+        if (toolList) {
+            parts.push(`\n## Available Tools\n${toolList}`);
+        }
+        const skillList = skills.getAll();
+        if (skillList.length > 0) {
+            const skillDesc = skillList.map(s => `- **${s.name}**: ${s.description}`).join('\n');
+            parts.push(`\n## Skills\n${skillDesc}`);
+        }
+        return parts.join('\n');
+    }
+    buildToolDescList(registry) {
+        const defs = registry.getDefinitions();
+        if (defs.length === 0)
+            return '';
+        const lines = defs.map(d => {
+            const name = d.function.name;
+            const desc = d.function.description || '';
+            const label = this.resolveToolDisplayName(name, registry);
+            return `- \`${name}\` (${label}): ${desc}`;
+        });
+        return lines.join('\n');
+    }
+    buildMCPToolDescList(registry) {
+        const names = registry.listNames().filter(n => n.startsWith('mcp_'));
+        if (names.length === 0)
+            return '';
+        return names.map(n => {
+            const tool = registry.get(n);
+            const def = tool?.definition;
+            return `- \`${n}\`: ${def?.function.description || ''}`;
+        }).join('\n');
+    }
+}
+export const RESULT_SYNTHESIS_PROMPT = `Based on the specialist agents' outputs above, provide a comprehensive synthesis:
+1. Summarize key findings from each agent
+2. Identify any conflicts or contradictions
+3. Provide a unified recommendation
+4. Highlight any risks or caveats
+Respond in the same language as the user.`;
+//# sourceMappingURL=prompt-builder.js.map

package/dist/esm/prompt/prompt-builder.js.map

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

package/dist/esm/sandbox/local-sandbox.d.ts

@@ -0,0 +1,70 @@
+/**
+ * @file LocalSandbox — 进程级沙箱实现
+ * @description 为每个 Agent 会话提供隔离的文件系统和 Shell 执行环境
+ *              文件系统限制在沙箱目录内，命令执行受 SecurityGuard + 沙箱黑名单保护
+ */
+import type { ShellExecutor, FileSystemExecutor, Sandbox, SandboxConfig, ScriptLanguage } from '@cicctencent/agent-core';
+/**
+ * 沙箱文件系统执行器
+ * 所有路径操作限制在沙箱 rootDir 内，阻止路径穿越
+ */
+export declare class SandboxFileSystemExecutor implements FileSystemExecutor {
+    private readonly rootDir;
+    private readonly maxFileSize;
+    constructor(rootDir: string, maxFileSize: number);
+    readFile(filePath: string): Promise<string>;
+    readFileBuffer(filePath: string): Promise<Buffer>;
+    writeFile(filePath: string, content: string): Promise<void>;
+    appendFile(filePath: string, content: string): Promise<void>;
+    listDir(dirPath: string): Promise<string[]>;
+    /**
+     * 解析路径并验证是否在沙箱目录内
+     * 如果路径越界（绝对路径或 .. 穿越），自动修正到沙箱内而非抛错
+     */
+    private resolveAndValidate;
+    /**
+     * 解析只读路径 — 允许读取沙箱目录和项目 data/ 目录
+     * data/ 目录存放对话内容、主题配置等只读资源，read_file 可安全访问
+     */
+    private resolveReadPath;
+}
+/**
+ * 沙箱 Shell 执行器
+ * - cwd 限制在沙箱目录
+ * - 环境变量经过白名单过滤
+ * - 命令经过 SecurityGuard + 沙箱黑名单检查
+ */
+export declare class SandboxShellExecutor implements ShellExecutor {
+    private readonly rootDir;
+    private readonly commandRestriction;
+    private readonly guard;
+    private outputBuffer;
+    private readonly maxBuffer;
+    private readonly sandboxEnv;
+    constructor(rootDir: string, commandRestriction: boolean);
+    exec(command: string, timeout?: number): Promise<string>;
+    write(_data: string): void;
+    read(lines?: number): string;
+}
+/**
+ * 本地沙箱实例
+ * 封装受限的 Shell 和 FileSystem 执行器，提供 runScript 能力
+ */
+export declare class LocalSandbox implements Sandbox {
+    readonly id: string;
+    readonly rootDir: string;
+    private readonly config;
+    private readonly shellExecutor;
+    private readonly fsExecutor;
+    private readonly scriptsDir;
+    constructor(id: string, config: SandboxConfig);
+    /** 初始化沙箱目录（创建后必须调用） */
+    init(): Promise<void>;
+    /** 将 html-renderer.cjs 和主题文件注入沙箱 _scripts/ 目录 */
+    private injectHtmlRenderer;
+    getShellExecutor(): ShellExecutor;
+    getFileSystemExecutor(): FileSystemExecutor;
+    runScript(language: ScriptLanguage, code: string, timeout?: number): Promise<string>;
+    destroy(): Promise<void>;
+}
+//# sourceMappingURL=local-sandbox.d.ts.map

package/dist/esm/sandbox/local-sandbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-sandbox.d.ts","sourceRoot":"","sources":["../../../src/sandbox/local-sandbox.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,KAAK,EACV,aAAa,EACb,kBAAkB,EAClB,OAAO,EACP,aAAa,EACb,cAAc,EACf,MAAM,yBAAyB,CAAC;AAgCjC;;;GAGG;AACH,qBAAa,yBAA0B,YAAW,kBAAkB;IAClE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAEzB,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAK1C,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK3C,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKjD,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB3D,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO5D,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAMjD;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAqB1B;;;OAGG;IACH,OAAO,CAAC,eAAe;CAmCxB;AAID;;;;;GAKG;AACH,qBAAa,oBAAqB,YAAW,aAAa;IACxD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAU;IAC7C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IACtC,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAO;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAyB;gBAExC,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,OAAO;IAelD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,SAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAkD5D,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI1B,IAAI,CAAC,KAAK,SAAK,GAAG,MAAM;CAIzB;AAwDD;;;GAGG;AACH,qBAAa,YAAa,YAAW,OAAO;IAC1C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAuB;IACrD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA4B;IACvD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa;IAgB7C,uBAAuB;IACjB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAS3B,iDAAiD;YACnC,kBAAkB;IAyBhC,gBAAgB,IAAI,aAAa;IAIjC,qBAAqB,IAAI,kBAAkB;IAIrC,SAAS,CAAC,QAAQ,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAuEpF,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAO/B"}