antitone 1.1.0

package/dist/cli.js

@@ -0,0 +1,371 @@
+#!/usr/bin/env node
+/**
+ * antitone —— 命令行入口（CLI + Skill 的载体）
+ *
+ * 为什么要有 CLI：
+ *   绝大多数 agent harness 都能跑 shell，但让模型**手写 curl** 有三个毛病 ——
+ *   命令长易错、参数名要猜、密钥容易被展开进对话记录。CLI 把这三件事一次解决：
+ *     1) 命令短：antitone news --q 半导体 --limit 20 --json
+ *     2) 参数由 zod 校验（就是 MCP 用的那份 schema）
+ *     3) 密钥只从 $ANTITONE_API_KEY 读，永不出现在命令行（对话记录里只留变量名）
+ *
+ * 命令一览：
+ *   antitone <tool> [--key value ...] [--json]     调用单个工具（16 个，见 antitone tools）
+ *   antitone tools [--json]                        列出全部工具与参数
+ *   antitone skill --print                         打印 SKILL.md（给 agent 的用法说明书）
+ *   antitone skill --install [--dir <path>]        安装到检测到的 skill 目录
+ *   antitone balance                               查余额与今日免费额度（= get_usage）
+ */
+import { homedir } from "node:os";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { z } from "zod";
+import { AntitoneClient } from "./client.js";
+import { ConfigError, loadConfig } from "./config.js";
+import { collectTools, TOOL_NAMES } from "./tools/index.js";
+const HERE = dirname(fileURLToPath(import.meta.url));
+/**
+ * 短别名：让 agent 写的命令更短、更不容易打错（也省 token）。
+ * 例：antitone news --q 半导体   ←→   antitone search_news --q 半导体
+ */
+const TOOL_ALIASES = {
+    news: "search_news",
+    doc: "get_news",
+    story: "get_story",
+    market: "market_overview",
+    sectors: "list_sectors",
+    sector: "get_sector",
+    themes: "list_themes",
+    theme_news: "get_theme_news",
+    quote: "get_quotes",
+    quotes: "get_quotes",
+    kline: "get_kline",
+    calendar: "get_calendar",
+    briefing: "get_briefing",
+    entity: "get_entity",
+    astock: "get_astock_board",
+    backtest: "run_backtest",
+    usage: "get_usage",
+    balance: "get_usage",
+};
+/** 参数别名：容忍更自然的写法（antitone briefing --kind premarket） */
+const ARG_ALIASES = {
+    kind: "type", // antitone briefing --kind premarket
+    full_text: "include_full_text",
+    financials: "include_financials",
+    board_type: "board",
+    board: "board",
+    imp: "min_imp",
+    min_importance: "min_imp",
+};
+function parseArgv(argv) {
+    const positional = [];
+    const flags = new Map();
+    let json = false;
+    for (let i = 0; i < argv.length; i++) {
+        const tok = argv[i];
+        if (tok === "--json" || tok === "-j") {
+            json = true;
+            continue;
+        }
+        if (tok.startsWith("--")) {
+            const eq = tok.indexOf("=");
+            const rawKey = (eq > 0 ? tok.slice(2, eq) : tok.slice(2)).replace(/-/g, "_");
+            const key = ARG_ALIASES[rawKey] ?? rawKey;
+            let raw;
+            if (eq > 0) {
+                raw = tok.slice(eq + 1);
+            }
+            else {
+                const next = argv[i + 1];
+                if (next === undefined || next.startsWith("--")) {
+                    flags.set(key, true);
+                    continue;
+                }
+                raw = next;
+                i++;
+            }
+            // 重复的键 -> 数组（如 --symbols 600519 --symbols 000001）
+            const prev = flags.get(key);
+            if (prev === undefined)
+                flags.set(key, raw);
+            else if (Array.isArray(prev))
+                prev.push(raw);
+            else
+                flags.set(key, [String(prev), raw]);
+            continue;
+        }
+        positional.push(tok);
+    }
+    return { positional, flags, json };
+}
+/** 按工具 schema 把字符串参数转成正确类型（CLI 与 MCP 用同一份 zod schema）。 */
+function coerceArgs(tool, flags, positional) {
+    const shape = (tool.meta.inputSchema ?? {});
+    const out = {};
+    const positionalFields = Object.keys(shape).filter((k) => /^(symbols?|codes?|q|query|path|id)$/.test(k));
+    for (const [key, value] of flags) {
+        const field = shape[key];
+        if (!field)
+            throw new Error(`未知参数 --${key}（用 antitone tools 查看该工具支持的参数）`);
+        out[key] = coerceOne(unwrap(field), value);
+    }
+    // 位置参数：按 schema 里第一个"像主参数"的字段顺序填入（antitone quote 600519 000001）
+    let pi = 0;
+    for (const name of positionalFields) {
+        if (pi >= positional.length)
+            break;
+        if (out[name] !== undefined)
+            continue;
+        const raw = shape[name];
+        if (isListLike(raw)) {
+            out[name] = positional.slice(pi);
+            pi = positional.length;
+        }
+        else {
+            out[name] = coerceOne(unwrap(raw), positional[pi]);
+            pi++;
+        }
+    }
+    if (pi < positional.length) {
+        throw new Error(`多余的位置参数：${positional.slice(pi).join(" ")}（用 antitone tools 查看用法）`);
+    }
+    return out;
+}
+/**
+ * 是否"列表型"参数：直接是数组，或是 union 里含数组分支
+ * （get_quotes.symbols 就是 union(数组, 逗号串)，只能这样识别）。
+ */
+function isListLike(field) {
+    const f = unwrap(field);
+    if (f instanceof z.ZodArray)
+        return true;
+    if (f instanceof z.ZodUnion) {
+        const options = f._def?.options ?? [];
+        return options.some((o) => unwrap(o) instanceof z.ZodArray);
+    }
+    return false;
+}
+function unwrap(t) {
+    let cur = t;
+    for (let i = 0; i < 10; i++) {
+        const def = cur._def;
+        if (!def?.innerType)
+            break;
+        cur = def.innerType;
+    }
+    return cur;
+}
+function coerceOne(field, value) {
+    if (field instanceof z.ZodNumber) {
+        const n = Number(value);
+        if (!Number.isFinite(n))
+            throw new Error(`需要数字，收到「${String(value)}」`);
+        return n;
+    }
+    if (field instanceof z.ZodBoolean) {
+        const s = String(value).toLowerCase();
+        return s === "true" || s === "1" || s === "yes" || value === true;
+    }
+    if (field instanceof z.ZodArray) {
+        const raw = Array.isArray(value) ? value : String(value).split(",");
+        return raw.map((v) => coerceOne(field.element, v));
+    }
+    if (field instanceof z.ZodUnion) {
+        const options = field._def?.options ?? [];
+        const arr = options.map(unwrap).find((o) => o instanceof z.ZodArray);
+        if (arr instanceof z.ZodArray) {
+            const raw = Array.isArray(value) ? value : String(value).split(",");
+            return raw.map((v) => coerceOne(arr.element, v));
+        }
+    }
+    return String(value);
+}
+/* ────────────────────────── 输出 ────────────────────────── */
+function billingLine(billing) {
+    if (!billing)
+        return "";
+    const bits = [];
+    if (billing.credits !== undefined)
+        bits.push(`本次 ${billing.credits} 积分`);
+    if (billing.balance !== undefined)
+        bits.push(`余额 ${billing.balance}`);
+    const f = billing.free_daily;
+    if (f)
+        bits.push(`今日免费额度剩 ${f.remaining}/${f.limit}`);
+    if (billing.note)
+        bits.push(billing.note);
+    return bits.length ? `\n· ${bits.join(" · ")}` : "";
+}
+function renderResult(run, wantJson) {
+    const res = run;
+    const text = (res.content ?? [])
+        .map((c) => (c.type === "text" ? (c.text ?? "") : `<${c.type}>`))
+        .join("\n");
+    if (wantJson)
+        return text;
+    try {
+        const parsed = JSON.parse(text);
+        const billing = parsed["billing"];
+        const payload = { ...parsed };
+        delete payload["billing"];
+        return `${JSON.stringify(payload, null, 2)}${billingLine(billing)}`;
+    }
+    catch {
+        return text;
+    }
+}
+/* ────────────────────────── skill 安装 ────────────────────────── */
+const SKILL_SOURCES = [
+    { label: "DSH / 通用 agents", dir: join(homedir(), ".agents", "skills") },
+    { label: "Claude Code", dir: join(homedir(), ".claude", "skills") },
+    { label: "Codex", dir: join(homedir(), ".codex", "skills") },
+];
+function skillText() {
+    const candidates = [join(HERE, "..", "SKILL.md"), join(HERE, "SKILL.md")];
+    for (const p of candidates) {
+        if (existsSync(p)) {
+            return readFileSync(p, "utf8");
+        }
+    }
+    throw new Error("包内未找到 SKILL.md（安装包损坏？）");
+}
+function installSkill(explicitDir) {
+    const body = skillText();
+    const targets = explicitDir
+        ? [{ label: "指定目录", dir: explicitDir }]
+        : SKILL_SOURCES.filter((s) => existsSync(s.dir) || s.dir.includes(".agents"));
+    if (targets.length === 0) {
+        process.stdout.write("未检测到任何 skill 目录。用 --dir <path> 指定，或先创建 ~/.agents/skills/\n");
+        return;
+    }
+    for (const t of targets) {
+        const dest = join(t.dir, "antitone");
+        mkdirSync(dest, { recursive: true });
+        writeFileSync(join(dest, "SKILL.md"), body, "utf8");
+        process.stdout.write(`✓ 已安装到 ${t.label}：${join(dest, "SKILL.md")}\n`);
+    }
+    process.stdout.write("\n重启你的 agent 后，问「今天半导体有什么利空」即应触发。\n");
+}
+/* ────────────────────────── 入口 ────────────────────────── */
+/** CLI 主体（导出以便被 MCP 入口复用：`npx antitone-mcp <命令>` 会转发到这里）。 */
+export async function runCli(argv) {
+    const cmd = argv[0];
+    if (!cmd || cmd === "help" || cmd === "--help" || cmd === "-h") {
+        process.stdout.write([
+            "antitone —— Antitone 财经情报命令行",
+            "",
+            "用法：",
+            "  antitone <tool> [--参数 值 ...] [--json]   调用工具",
+            "  antitone tools                            列出 16 个工具与参数",
+            "  antitone balance                          余额与今日免费额度",
+            "  antitone skill --print | --install        取/装给 agent 的用法说明书",
+            "",
+            "示例：",
+            "  antitone news --q 半导体 --limit 10",
+            "  antitone quote 600519 000001",
+            "  antitone kline 600519 --days 20 --period 1d",
+            "  antitone briefing --kind postmarket",
+            "",
+            "鉴权：环境变量 ANTITONE_API_KEY（形如 nhk_xxx.yyy）。",
+            "     密钥只从环境变量读 —— 不要写进命令行，避免落进对话记录。",
+            "",
+        ].join("\n"));
+        return 0;
+    }
+    if (cmd === "tools") {
+        const wantJson = argv.includes("--json");
+        let client;
+        try {
+            client = new AntitoneClient(loadConfig());
+        }
+        catch {
+            client = undefined;
+        }
+        if (!client) {
+            process.stdout.write("需要 ANTITONE_API_KEY 才能列出工具参数（先设置环境变量）。\n");
+            process.stdout.write(`已知工具：${TOOL_NAMES.join(", ")}\n`);
+            return 1;
+        }
+        const tools = collectTools(client);
+        if (wantJson) {
+            process.stdout.write(JSON.stringify(tools.map((t) => ({ name: t.name, ...t.meta })), null, 2) + "\n");
+            return 0;
+        }
+        const aliasOf = {};
+        for (const [a, full] of Object.entries(TOOL_ALIASES))
+            (aliasOf[full] ??= []).push(a);
+        for (const t of tools) {
+            const shape = (t.meta.inputSchema ?? {});
+            const params = Object.keys(shape).map((k) => `--${k.replace(/_/g, "-")}`).join(" ");
+            const alias = aliasOf[t.name]?.join(" / ") ?? "";
+            process.stdout.write(`${t.name.padEnd(18)} ${params}\n`);
+            process.stdout.write(`${" ".repeat(18)} ${alias ? `[${alias}] ` : ""}${(t.meta.title ?? "")}\n`);
+        }
+        return 0;
+    }
+    if (cmd === "skill") {
+        const { flags } = parseArgv(argv.slice(1));
+        if (flags.has("install")) {
+            const dir = flags.get("dir");
+            installSkill(typeof dir === "string" ? dir : undefined);
+            return 0;
+        }
+        process.stdout.write(skillText());
+        if (!process.stdout.hasColors?.())
+            process.stdout.write("\n");
+        process.stdout.write("\n# 安装：antitone skill --install\n");
+        return 0;
+    }
+    /* 其余命令 = 工具名或短别名 */
+    const toolName = TOOL_ALIASES[cmd] ?? cmd;
+    const { positional, flags, json } = parseArgv(argv.slice(1));
+    let config;
+    try {
+        config = loadConfig();
+    }
+    catch (e) {
+        const msg = e instanceof ConfigError ? e.message : String(e);
+        process.stderr.write(`✗ ${msg}\n`);
+        process.stderr.write("  设置：export ANTITONE_API_KEY=nhk_xxx.yyy\n");
+        return 2;
+    }
+    const client = new AntitoneClient(config);
+    const tools = collectTools(client);
+    const tool = tools.find((t) => t.name === toolName);
+    if (!tool) {
+        process.stderr.write(`✗ 未知命令「${cmd}」。\n  可用工具：${TOOL_NAMES.join(", ")}\n  短别名：${Object.keys(TOOL_ALIASES).join(", ")}\n`);
+        return 2;
+    }
+    let args;
+    try {
+        args = coerceArgs(tool, flags, positional);
+    }
+    catch (e) {
+        process.stderr.write(`✗ ${e.message}\n`);
+        return 2;
+    }
+    const ctl = new AbortController();
+    const run = await tool.handler(args, { signal: ctl.signal });
+    const out = renderResult(run, json);
+    const failed = run.isError === true;
+    process.stdout.write(out + "\n");
+    return failed ? 1 : 0;
+}
+/* 仅在作为 CLI 直接运行时才自执行（被 index.ts 复用时不抢控制权） */
+const isCliEntry = (() => {
+    const entry = process.argv[1];
+    if (!entry)
+        return false;
+    return entry.endsWith("cli.js") || entry.endsWith("cli.ts") || entry.endsWith("antitone");
+})();
+if (isCliEntry) {
+    runCli(process.argv.slice(2))
+        .then((code) => process.exit(code))
+        .catch((e) => {
+        process.stderr.write(`✗ ${e instanceof Error ? e.message : String(e)}\n`);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/client.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Antitone HTTP 客户端：只做三件事 —— 拼请求（含鉴权头与计费头）、解析计费回执、规范化错误。
+ *
+ * 鉴权：Authorization: Bearer <nhk_xxx.yyy>
+ *       User-Agent: antitone-mcp/0.1.0
+ *       X-Request-Id: <随机>
+ *       X-Antitone-Billing-Detail: 1  → 服务端在 body 追加 _billing 明细
+ * 注意：API Key 通道免 X-NS-SIG 签名（签名只用于桌面端 session_key 通道）。
+ */
+import { type AntitoneConfig } from "./config.js";
+/** 每日免费额度快照（服务端 _billing.free_daily / X-Antitone-Free-*）。 */
+export interface FreeDaily {
+    /** 每日上限（积分） */
+    limit: number;
+    /** 今日已用 */
+    used: number;
+    /** 今日剩余（这是"余额 0 也能继续调"的底气） */
+    remaining: number;
+    /** 剩余额度折合人民币 */
+    cny_remaining?: number;
+    /** 重置时间说明 */
+    resets?: string;
+}
+/** 计费回执：_billing（body）与 X-Antitone-*（响应头）合并后的形状。 */
+export interface Billing {
+    /** 本次消耗积分（免费端点 = 0）。 */
+    credits?: number;
+    /** 当前余额（服务端 60 秒缓存）。注意：余额 0 ≠ 不能用，见 free_daily。 */
+    balance?: number;
+    /** 每日免费额度：不体现在 balance 里，但会自动抵扣，用不完当日作废。 */
+    free_daily?: FreeDaily;
+    /** 计费来源：rest | stream | webhook | ai。 */
+    source?: string;
+    /** 价目表版本（对账用）。 */
+    pricing_version?: number;
+    /** false = 已计费、待整点入账。 */
+    settled?: boolean;
+    /** 服务端返回的 _billing.breakdown 明细（base / volume / modifiers）。 */
+    breakdown?: unknown;
+    /** credits 的来源标记：'body' ｜ 'header'。 */
+    credits_from?: "body" | "header";
+    /** 人话提示（余额 0 但免费额度尚有余额时给出，避免模型自行放弃调用）。 */
+    note?: string;
+}
+export interface DataEnvelope<T> {
+    data: T;
+    billing?: Billing;
+    /** 数据时刻（ISO8601）。 */
+    asOf: string;
+    /** as_of 的来源：payload 字段名 / header.date / request_time。 */
+    asOfSource: string;
+    stale: boolean;
+    staleAfterMs: number;
+    requestId: string;
+    httpStatus: number;
+    durationMs: number;
+    endpoint: string;
+}
+export interface RequestOptions {
+    /** query 参数（undefined / null 自动剔除）。 */
+    query?: Record<string, unknown>;
+    /** 判定 stale 的阈值（毫秒），由工具按数据性质给出。 */
+    staleAfterMs: number;
+    /** JSON body（POST）。 */
+    body?: unknown;
+    /** 上游取消信号（MCP 请求中断）。 */
+    signal?: AbortSignal;
+}
+/** 从 payload 中挖掘数据时刻；挖不到就用响应头 Date，再退到请求时刻。 */
+export declare function extractAsOf(data: unknown, headerDate: string | null | undefined, now?: number): {
+    asOf: string;
+    asOfSource: string;
+};
+/** 显式 stale 标记（服务端说 stale 时不能反着报 false）。 */
+export declare function extractExplicitStale(data: unknown): boolean | undefined;
+/** body `_billing` + 响应头 X-Antitone-* → Billing。body 优先（含 breakdown）。 */
+export declare function parseBilling(body: unknown, headers: Headers): Billing | undefined;
+/** 去掉 body 里的 _billing（已提升到 billing 字段，避免重复占预算）。 */
+export declare function stripBilling(body: unknown): unknown;
+export declare function buildQuery(query: Record<string, unknown> | undefined): string;
+export declare class AntitoneClient {
+    private readonly config;
+    private readonly fetchImpl;
+    constructor(config: AntitoneConfig, fetchImpl?: typeof fetch);
+    get baseUrl(): string;
+    get timeoutMs(): number;
+    get<T>(path: string, options: RequestOptions): Promise<DataEnvelope<T>>;
+    post<T>(path: string, options: RequestOptions): Promise<DataEnvelope<T>>;
+    private request;
+}
+export interface MergedEnvelopes {
+    data: Record<string, unknown>;
+    billing?: Billing;
+    asOf: string;
+    asOfSource: string;
+    stale: boolean;
+    staleAfterMs: number;
+    requestId: string;
+    httpStatus: number;
+    durationMs: number;
+    endpoints: string[];
+}
+/**
+ * 合并多个端点的结果（market_overview / get_usage / get_entity?include_financials）。
+ * 计费取各次之和；as_of 取最早（对 stale 判定最保守）；stale 取或。
+ */
+export declare function mergeEnvelopes(entries: Array<[string, DataEnvelope<unknown>]>): MergedEnvelopes;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAG9D,6DAA6D;AAC7D,MAAM,WAAW,SAAS;IACxB,eAAe;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW;IACX,IAAI,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,oDAAoD;AACpD,MAAM,WAAW,OAAO;IACtB,wBAAwB;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kBAAkB;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,yBAAyB;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,uCAAuC;IACvC,YAAY,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IACjC,0CAA0C;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,IAAI,EAAE,CAAC,CAAC;IACR,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,mCAAmC;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,uBAAuB;IACvB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,wBAAwB;IACxB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAmDD,+CAA+C;AAC/C,wBAAgB,WAAW,CACzB,IAAI,EAAE,OAAO,EACb,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACrC,GAAG,GAAE,MAAmB,GACvB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAkBtC;AAED,4CAA4C;AAC5C,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,CAUvE;AAED,yEAAyE;AACzE,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,CAmEjF;AAED,oDAAoD;AACpD,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAKnD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,MAAM,CAoB7E;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;gBAE7B,MAAM,EAAE,cAAc,EAAE,SAAS,CAAC,EAAE,OAAO,KAAK;IAK5D,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,IAAI,SAAS,IAAI,MAAM,CAEtB;IAEK,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAIvE,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YAIhE,OAAO;CA4FtB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,eAAe,CA8E/F"}