@skillfm/local 2.2.0 → 2.5.0

package/dist/skill-runner/spawner.js

@@ -0,0 +1,85 @@
+// M1 skill-runner — skill 子进程 spawn + health check
+//
+// 设计原则：
+// - 一旦 spawn 成功，立即返回 PID 给调用者（不阻塞等 health ready）
+// - health check 另起一次异步 poll，失败不 kill 子进程（交给调用者决定）—— 方便诊断
+import { spawn } from 'node:child_process';
+import { setTimeout as sleep } from 'node:timers/promises';
+function spawnEntry(entryPath, env, label) {
+    const proc = spawn(process.execPath, [entryPath], {
+        env,
+        detached: true,
+        stdio: 'ignore',
+    });
+    if (!proc.pid) {
+        throw Object.assign(new Error(`spawn ${label} 失败：pid 未返回`), { code: 'SPAWN_FAILED' });
+    }
+    // 脱离 parent 事件循环，允许 @skillfm/local 退出后子进程继续跑
+    proc.unref();
+    return proc;
+}
+export async function spawnSkill(params) {
+    const { location, env_overrides, start_daemon } = params;
+    const env = {
+        ...process.env,
+        ...env_overrides,
+        SKILL_HOST: '127.0.0.1',
+        SKILL_PORT: String(location.port),
+    };
+    const serverProc = spawnEntry(location.server_entry, env, `${location.slug} server`);
+    let daemonPid = null;
+    if (start_daemon && location.daemon_entry) {
+        const daemonProc = spawnEntry(location.daemon_entry, env, `${location.slug} daemon`);
+        daemonPid = daemonProc.pid ?? null;
+    }
+    return {
+        slug: location.slug,
+        version: location.version,
+        port: location.port,
+        server_pid: serverProc.pid,
+        daemon_pid: daemonPid,
+        started_at: new Date().toISOString(),
+        endpoint: `http://127.0.0.1:${location.port}`,
+    };
+}
+/** Poll GET {endpoint}/health 直到 200 或超时 */
+export async function waitForHealthy(endpoint, timeoutMs) {
+    const healthUrl = `${endpoint}/health`;
+    const deadline = Date.now() + timeoutMs;
+    let attempt = 0;
+    while (Date.now() < deadline) {
+        attempt += 1;
+        try {
+            const controller = new AbortController();
+            const timer = setTimeout(() => controller.abort(), 2000);
+            const res = await fetch(healthUrl, { signal: controller.signal });
+            clearTimeout(timer);
+            if (res.ok)
+                return true;
+        }
+        catch {
+            // fall through to sleep
+        }
+        // 指数退避但 cap 在 1s
+        const delay = Math.min(200 * 2 ** Math.min(attempt, 3), 1000);
+        await sleep(delay);
+    }
+    return false;
+}
+/** Kill a running skill process tree. Returns true if kill signal delivered. */
+export function killSkill(handle) {
+    let killed = false;
+    for (const pid of [handle.server_pid, handle.daemon_pid]) {
+        if (pid && pid > 0) {
+            try {
+                process.kill(pid, 'SIGTERM');
+                killed = true;
+            }
+            catch {
+                // Process may already be dead — swallow
+            }
+        }
+    }
+    return killed;
+}
+//# sourceMappingURL=spawner.js.map

package/dist/skill-runner/spawner.js.map

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

package/dist/skill-runner/types.d.ts

@@ -0,0 +1,62 @@
+export interface SkillBundleLocation {
+    /** skill slug（manifest.metadata.slug）*/
+    slug: string;
+    /** skill 语义版本（manifest.metadata.version）*/
+    version: string;
+    /** bundle 根目录绝对路径 */
+    bundle_dir: string;
+    /** runtime server 入口脚本绝对路径（默认 <bundle>/runtime/server.js）*/
+    server_entry: string;
+    /** runtime daemon 入口脚本绝对路径（可选）*/
+    daemon_entry: string | null;
+    /** loopback 监听端口，从 manifest runtime.endpoint 解析 */
+    port: number;
+}
+export interface SkillDaemonHandle {
+    slug: string;
+    version: string;
+    port: number;
+    /** server 子进程 PID */
+    server_pid: number;
+    /** daemon 子进程 PID（可选，M1 默认不启动 daemon 进程）*/
+    daemon_pid: number | null;
+    started_at: string;
+    /** loopback URL —— 永远 127.0.0.1，守 §1.5 BYOK 红线 */
+    endpoint: string;
+}
+export interface LocalSkillRegistryEntry extends SkillDaemonHandle {
+    /** skill bundle 目录（方便 stop 命令清理时直接找）*/
+    bundle_dir: string;
+    /** 上次 health check 成功时间（ms timestamp）*/
+    last_health_at: number;
+}
+/** `~/.skillfm/skills.local.json` 顶层结构 */
+export interface LocalSkillRegistry {
+    version: 1;
+    skills: Record<string, LocalSkillRegistryEntry>;
+}
+export interface RunSkillOptions {
+    /** skill slug，例如 `xianyu-avatar-adult` */
+    slug: string;
+    /** 可选：bundle 查找根目录覆盖。默认 env `SKILLFM_SKILL_BUNDLE_ROOT` 或 `~/.skillfm/skills` */
+    bundle_root_override?: string;
+    /** health check 轮询超时（默认 20s）*/
+    health_timeout_ms?: number;
+    /** 是否同时启动 daemon 子进程（默认 false —— M1 先只启动 server）*/
+    start_daemon?: boolean;
+    /** 注入到 skill 子进程的环境变量（用于 cookie 路径等 BYOK 配置）*/
+    env_overrides?: Record<string, string>;
+}
+/** run-skill CLI 输出（成功时）*/
+export interface RunSkillResult {
+    ok: true;
+    handle: SkillDaemonHandle;
+    hint_for_agent: string;
+}
+export interface RunSkillError {
+    ok: false;
+    error: 'SKILL_NOT_FOUND' | 'MANIFEST_INVALID' | 'ALREADY_RUNNING' | 'PORT_CONFLICT' | 'SPAWN_FAILED' | 'HEALTH_TIMEOUT';
+    message: string;
+    hint_for_agent: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/skill-runner/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/skill-runner/types.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,mBAAmB;IAClC,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,qBAAqB;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,YAAY,EAAE,MAAM,CAAC;IACrB,iCAAiC;IACjC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,uBAAwB,SAAQ,iBAAiB;IAChE,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,0CAA0C;AAC1C,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,CAAC,CAAC;IACX,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC;CACjD;AAED,MAAM,WAAW,eAAe;IAC9B,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,iFAAiF;IACjF,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,+BAA+B;IAC/B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,mDAAmD;IACnD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,+CAA+C;IAC/C,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC;AAED,2BAA2B;AAC3B,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,IAAI,CAAC;IACT,MAAM,EAAE,iBAAiB,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EACD,iBAAiB,GACjB,kBAAkB,GAClB,iBAAiB,GACjB,eAAe,GACf,cAAc,GACd,gBAAgB,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;CACxB"}

package/dist/skill-runner/types.js

@@ -0,0 +1,6 @@
+// M1 skill-runner — shared types
+//
+// 本文件是 @skillfm/local skill daemon 管理模块的对外类型。其它 subagent（M2 tunnel client）
+// 会依赖这里的 SkillDaemonHandle / LocalSkillRegistryEntry，不依赖内部实现。
+export {};
+//# sourceMappingURL=types.js.map

package/dist/skill-runner/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/skill-runner/types.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,EAAE;AACF,2EAA2E;AAC3E,8DAA8D"}

package/dist/skill-tunnel/cli.d.ts

@@ -0,0 +1,5 @@
+export declare function cmdTunnelStart(): Promise<void>;
+export declare function cmdTunnelStop(): void;
+export declare function cmdTunnelStatus(): void;
+export declare function cmdTunnel(): Promise<void>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/skill-tunnel/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/skill-tunnel/cli.ts"],"names":[],"mappings":"AA2EA,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAyFpD;AAED,wBAAgB,aAAa,IAAI,IAAI,CA8BpC;AAED,wBAAgB,eAAe,IAAI,IAAI,CAQtC;AAED,wBAAsB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAwB/C"}

package/dist/skill-tunnel/cli.js

@@ -0,0 +1,205 @@
+// M2 SkillTunnelClient — CLI subcommand
+//
+// `skillfm-local tunnel start|stop|status`
+// 简易实现: start 在当前进程起 tunnel（不 daemon 化），stop/status 通过 PID 文件。
+// daemon 化（launchd / nohup）留给上层部署脚本,这里只提供基础设施。
+import { readFileSync, writeFileSync, existsSync, mkdirSync, rmSync, } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { homedir } from 'node:os';
+import { readRegistry } from '../skill-runner/registry.js';
+import { SkillTunnelClient } from './client.js';
+const PID_FILE = join(homedir(), '.skillfm', 'tunnel.pid');
+const DEFAULT_BRAIN_URL = process.env.SKILLFM_BRAIN_TUNNEL_URL ?? 'wss://api.skillfm.ai/v1/skill-tunnel';
+function ensureDir() {
+    const dir = dirname(PID_FILE);
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true, mode: 0o700 });
+}
+function parseFlags(args) {
+    const flags = {};
+    for (let i = 0; i < args.length; i += 1) {
+        const t = args[i];
+        if (!t.startsWith('--'))
+            continue;
+        const eq = t.indexOf('=');
+        if (eq > 0) {
+            flags[t.slice(2, eq)] = t.slice(eq + 1);
+        }
+        else {
+            const next = args[i + 1];
+            if (next !== undefined && !next.startsWith('--')) {
+                flags[t.slice(2)] = next;
+                i += 1;
+            }
+            else {
+                flags[t.slice(2)] = true;
+            }
+        }
+    }
+    return flags;
+}
+function readConfig() {
+    const path = join(homedir(), '.skillfm', 'config.json');
+    if (!existsSync(path))
+        return {};
+    try {
+        return JSON.parse(readFileSync(path, 'utf-8'));
+    }
+    catch {
+        return {};
+    }
+}
+function readPackageVersion() {
+    // 只读顶层 package.json 里版本；build 后 dist/ 同级已经没有 package.json,fallback 环境变量
+    return process.env.SKILLFM_LOCAL_VERSION ?? '0.0.0';
+}
+function isProcessAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function cmdTunnelStart() {
+    const flags = parseFlags(process.argv.slice(3));
+    const brainUrl = typeof flags['brain-url'] === 'string' ? flags['brain-url'] : DEFAULT_BRAIN_URL;
+    // 检查是否已在跑
+    if (existsSync(PID_FILE)) {
+        const pid = Number.parseInt(readFileSync(PID_FILE, 'utf-8'), 10);
+        if (Number.isFinite(pid) && isProcessAlive(pid)) {
+            console.log(JSON.stringify({
+                ok: false,
+                error: 'ALREADY_RUNNING',
+                message: `tunnel 已在跑 (pid=${pid})`,
+            }));
+            process.exit(1);
+            return;
+        }
+        // PID 文件残留,清理
+        try {
+            rmSync(PID_FILE);
+        }
+        catch {
+            // ignore
+        }
+    }
+    const cfg = readConfig();
+    const agentToken = process.env.SKILLFM_AGENT_TOKEN ?? cfg.agent_token ?? '';
+    const authSecret = process.env.SKILLFM_SKILL_AUTH_SECRET ?? cfg.auth_secret ?? '';
+    if (!agentToken || !authSecret) {
+        console.log(JSON.stringify({
+            ok: false,
+            error: 'MISSING_CREDENTIALS',
+            message: 'agent_token / auth_secret 缺失. 请设 env SKILLFM_AGENT_TOKEN + SKILLFM_SKILL_AUTH_SECRET,或写入 ~/.skillfm/config.json',
+        }));
+        process.exit(1);
+        return;
+    }
+    const registry = readRegistry();
+    const localSkills = Object.values(registry.skills);
+    ensureDir();
+    writeFileSync(PID_FILE, String(process.pid), { mode: 0o600 });
+    const client = new SkillTunnelClient({
+        brainUrl,
+        agentToken,
+        authSecret,
+        localSkills,
+        skillfmLocalVersion: readPackageVersion(),
+        onStatusChange: (s) => {
+            console.error(`[tunnel] status=${s}`);
+        },
+    });
+    const cleanup = async () => {
+        try {
+            await client.stop();
+        }
+        finally {
+            try {
+                rmSync(PID_FILE);
+            }
+            catch {
+                // ignore
+            }
+        }
+    };
+    process.on('SIGINT', () => {
+        void cleanup().then(() => process.exit(0));
+    });
+    process.on('SIGTERM', () => {
+        void cleanup().then(() => process.exit(0));
+    });
+    console.log(JSON.stringify({
+        ok: true,
+        message: `tunnel 启动 pid=${process.pid} brain=${brainUrl} skills=${localSkills.length}`,
+        pid: process.pid,
+    }));
+    await client.start();
+    // 保持进程存活
+    await new Promise(() => { });
+}
+export function cmdTunnelStop() {
+    if (!existsSync(PID_FILE)) {
+        console.log(JSON.stringify({ ok: false, error: 'NOT_RUNNING' }));
+        process.exit(1);
+        return;
+    }
+    const pid = Number.parseInt(readFileSync(PID_FILE, 'utf-8'), 10);
+    if (!Number.isFinite(pid)) {
+        try {
+            rmSync(PID_FILE);
+        }
+        catch {
+            // ignore
+        }
+        console.log(JSON.stringify({ ok: false, error: 'BAD_PID_FILE' }));
+        process.exit(1);
+        return;
+    }
+    try {
+        process.kill(pid, 'SIGTERM');
+        console.log(JSON.stringify({ ok: true, pid, message: 'SIGTERM sent' }));
+    }
+    catch (err) {
+        console.log(JSON.stringify({
+            ok: false,
+            error: 'KILL_FAILED',
+            message: err.message,
+        }));
+        process.exit(1);
+    }
+}
+export function cmdTunnelStatus() {
+    if (!existsSync(PID_FILE)) {
+        console.log(JSON.stringify({ ok: true, running: false }));
+        return;
+    }
+    const pid = Number.parseInt(readFileSync(PID_FILE, 'utf-8'), 10);
+    const alive = Number.isFinite(pid) && isProcessAlive(pid);
+    console.log(JSON.stringify({ ok: true, running: alive, pid }));
+}
+export async function cmdTunnel() {
+    const sub = process.argv[3];
+    switch (sub) {
+        case 'start':
+            // shift argv so parseFlags 看到 `start` 之后的 flags
+            process.argv.splice(3, 1);
+            await cmdTunnelStart();
+            break;
+        case 'stop':
+            cmdTunnelStop();
+            break;
+        case 'status':
+            cmdTunnelStatus();
+            break;
+        default:
+            console.error(JSON.stringify({
+                ok: false,
+                error: 'UNKNOWN_SUBCOMMAND',
+                message: 'Usage: skillfm-local tunnel <start|stop|status> [--brain-url=<url>]',
+            }));
+            process.exit(1);
+    }
+}
+//# sourceMappingURL=cli.js.map

package/dist/skill-tunnel/cli.js.map

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

package/dist/skill-tunnel/client.d.ts

@@ -0,0 +1,56 @@
+import { WebSocket } from 'ws';
+import { TUNNEL_ERROR_CODES } from '@skillfm/contracts/skill-tunnel';
+import type { HeartbeatTunnelResult, JsonRpcSuccessResponse, JsonRpcErrorResponse, SkillUpdateTunnelParams } from '@skillfm/contracts/skill-tunnel';
+import type { LocalSkillRegistryEntry } from '../skill-runner/types.js';
+export type TunnelStatus = 'connecting' | 'connected' | 'disconnected';
+export interface SkillTunnelClientOptions {
+    /** e.g. wss://api.skillfm.ai/v1/skill-tunnel */
+    brainUrl: string;
+    agentToken: string;
+    /** 来自 M1 readRegistry() 的 entries 列表 */
+    localSkills: LocalSkillRegistryEntry[];
+    skillfmLocalVersion: string;
+    /** SKILLFM_SKILL_AUTH_SECRET — HMAC 密钥（handshake + JSON-RPC meta + 本地 skill 调用都用这把）*/
+    authSecret: string;
+    onStatusChange?: (status: TunnelStatus) => void;
+    /** 可选: 注入 fetch 给 LocalBridge（测试用）*/
+    fetch?: typeof fetch;
+    /** 可选: 注入 WebSocket 构造器（测试用）*/
+    webSocketCtor?: typeof WebSocket;
+}
+export declare class SkillTunnelClient {
+    private readonly opts;
+    private readonly bridge;
+    private readonly reconnect;
+    private readonly heartbeat;
+    private ws;
+    private status;
+    private lastConnectedAt;
+    private stopped;
+    private readonly pending;
+    constructor(opts: SkillTunnelClientOptions);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    status$(): {
+        connected: boolean;
+        lastConnectedAt: number | null;
+        reconnectAttempts: number;
+    };
+    /** 主动上报 skill lifecycle 事件 */
+    sendSkillUpdate(params: SkillUpdateTunnelParams): Promise<void>;
+    private connectOnce;
+    private onOpen;
+    private onError;
+    private onClose;
+    private onMessage;
+    private handleServerRequest;
+    private handleResponse;
+    private sendFrame;
+    private sendClientRequest;
+    private buildHeartbeatStatus;
+    private handleHeartbeatTimeout;
+    private setStatus;
+}
+export type { JsonRpcSuccessResponse, JsonRpcErrorResponse, HeartbeatTunnelResult };
+export { TUNNEL_ERROR_CODES };
+//# sourceMappingURL=client.d.ts.map

package/dist/skill-tunnel/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/skill-tunnel/client.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,SAAS,EAAgB,MAAM,IAAI,CAAC;AAC7C,OAAO,EAGL,kBAAkB,EACnB,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAEV,qBAAqB,EAIrB,sBAAsB,EACtB,oBAAoB,EAEpB,uBAAuB,EACxB,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAMxE,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG,WAAW,GAAG,cAAc,CAAC;AAEvE,MAAM,WAAW,wBAAwB;IACvC,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,WAAW,EAAE,uBAAuB,EAAE,CAAC;IACvC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,sFAAsF;IACtF,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,CAAC;IAChD,qCAAqC;IACrC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,+BAA+B;IAC/B,aAAa,CAAC,EAAE,OAAO,SAAS,CAAC;CAClC;AAQD,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA2B;IAChD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAC/C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgB;IAE1C,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,MAAM,CAAgC;IAC9C,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiC;gBAE7C,IAAI,EAAE,wBAAwB;IAkBpC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAmB3B,OAAO,IAAI;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,iBAAiB,EAAE,MAAM,CAAA;KAAE;IAQ5F,8BAA8B;IACxB,eAAe,CAAC,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;YAQvD,WAAW;IAyBzB,OAAO,CAAC,MAAM;IAOd,OAAO,CAAC,OAAO;IAKf,OAAO,CAAC,OAAO;IAsBf,OAAO,CAAC,SAAS;YAqBH,mBAAmB;IAKjC,OAAO,CAAC,cAAc;IAuBtB,OAAO,CAAC,SAAS;YASH,iBAAiB;IAsC/B,OAAO,CAAC,oBAAoB;IAc5B,OAAO,CAAC,sBAAsB;IAY9B,OAAO,CAAC,SAAS;CAKlB;AAGD,YAAY,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,CAAC;AACpF,OAAO,EAAE,kBAAkB,EAAE,CAAC"}