@mulsok/traders-client 0.1.0

package/dist/server/llm/claude-cli.js

@@ -0,0 +1,204 @@
+/**
+ * Claude CLI Provider · taeeun-life/agent-server/src/claude-cli.ts 레퍼런스.
+ *
+ * Anthropic API key 없이 **Claude Code 구독** 만으로 작동 (Max/Team 플랜).
+ * 시스템에 `claude` 바이너리가 설치돼 있어야 함.
+ *
+ * 호출:
+ *   claude --dangerously-skip-permissions -p "<user prompt>" \
+ *     --output-format json --model <sonnet|opus|haiku> \
+ *     --system-prompt "<system>"
+ */
+import { spawn } from "node:child_process";
+/**
+ * Claude CLI subprocess timeout (사용자 정정 · 2026-05-03).
+ *
+ * 사용자 의도: timeout 으로 답변 도중 끊기면 재호출 비용 더 큼 → 충분히 길게.
+ * 기본 30분 (sonnet extended thinking + tool use 도 안전).
+ * 환경 변수 `CLAUDE_CLI_TIMEOUT_SEC` 로 override 가능 (운영 중 조정).
+ *
+ * spawnSafe 가 timeout 도달 시 SIGTERM kill — 이 시점에서 stdout 텍스트 손실 + 비용은 이미 발생.
+ * 그래서 default 가 충분히 커야 함.
+ */
+const DEFAULT_TIMEOUT_SEC = (() => {
+    const env = process.env.CLAUDE_CLI_TIMEOUT_SEC;
+    if (env && /^\d+$/.test(env)) {
+        const n = Number(env);
+        if (n >= 60 && n <= 3600)
+            return n; // 1분~1시간 사이만 허용 (오타 보호)
+    }
+    return 30 * 60; // 기본 30분
+})();
+export function createClaudeCliProvider(opts) {
+    const binary = opts.binaryPath ?? "claude";
+    return {
+        kind: "claude-cli",
+        async test() {
+            try {
+                const version = await runVersion(binary);
+                return {
+                    ok: true,
+                    provider: "claude-cli",
+                    model: opts.model,
+                    detail: `감지됨 · ${version}`,
+                };
+            }
+            catch (e) {
+                return {
+                    ok: false,
+                    provider: "claude-cli",
+                    error: `Claude CLI 미설치 또는 실행 실패 · ${String(e)}`,
+                };
+            }
+        },
+        async complete(c) {
+            // 프로젝트 루트 (.claude/skills 위치 = mulsok-traders).
+            // tsx watch 의 cwd 가 mulsok-traders 인 가정 (monorepo root).
+            // 다르면 사용자 환경변수 MULSOK_PROJECT_ROOT 로 override.
+            const projectRoot = process.env.MULSOK_PROJECT_ROOT ?? process.cwd();
+            const args = [
+                "--dangerously-skip-permissions",
+                // Skills 인식 + helper script 실행 권한
+                "--add-dir", projectRoot,
+                "-p",
+                c.userPrompt,
+                "--output-format",
+                "json",
+                "--model",
+                opts.model,
+            ];
+            if (c.systemPrompt) {
+                args.push("--system-prompt", c.systemPrompt);
+            }
+            const { stdout } = await runClaude(binary, args, DEFAULT_TIMEOUT_SEC);
+            // Claude Code 2.x 의 JSON output 은 이벤트 배열 스트림 or 단일 객체.
+            // 우리가 원하는 "마지막 assistant message" 추출.
+            const text = extractAssistantText(stdout);
+            // claude-cli 는 finish_reason 노출 안 함 (subprocess wrapper).
+            // 추출 텍스트가 비어있으면 의심 (실패 케이스 다른 곳에서 throw).
+            return {
+                text,
+                model: opts.model,
+                provider: "claude-cli",
+                stopReason: text ? "stop" : "unknown",
+                raw: stdout,
+            };
+        },
+    };
+}
+async function runVersion(binary) {
+    const { stdout } = await spawnSafe(binary, ["--version"], 10);
+    return stdout.trim();
+}
+async function runClaude(binary, args, timeoutSec) {
+    // Claude 관련 env (CLAUDE_*) 는 inherit 금지 (taeeun-life 패턴)
+    const env = Object.fromEntries(Object.entries(process.env).filter(([k]) => !k.startsWith("CLAUDE")));
+    return spawnSafe(binary, args, timeoutSec, env);
+}
+function spawnSafe(binary, args, timeoutSec, env) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(binary, args, {
+            env: env ?? process.env,
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        let stdout = "";
+        let stderr = "";
+        let killed = false;
+        const timer = setTimeout(() => {
+            killed = true;
+            try {
+                child.kill("SIGTERM");
+            }
+            catch {
+                /* ignore */
+            }
+        }, timeoutSec * 1000);
+        child.stdout.on("data", (d) => {
+            stdout += d.toString("utf-8");
+        });
+        child.stderr.on("data", (d) => {
+            stderr += d.toString("utf-8");
+        });
+        child.on("error", (e) => {
+            clearTimeout(timer);
+            reject(e);
+        });
+        child.on("close", (code) => {
+            clearTimeout(timer);
+            if (killed)
+                return reject(new Error(`Claude CLI 타임아웃 (${timeoutSec}s)`));
+            if (code !== 0 && code !== null) {
+                return reject(new Error(`Claude CLI exit ${code}: ${stderr.slice(0, 200)}`));
+            }
+            resolve({ stdout, stderr });
+        });
+    });
+}
+/**
+ * Claude CLI --output-format json 의 결과 파싱.
+ * 2.x: 단일 JSON 객체 또는 줄바꿈 구분 이벤트 배열. 본문 텍스트 추출.
+ */
+function extractAssistantText(stdout) {
+    // 1) single object 시도
+    const trimmed = stdout.trim();
+    try {
+        const obj = JSON.parse(trimmed);
+        if (typeof obj === "object" && obj !== null) {
+            // shape 예:
+            //   { result: "...", session_id, messages: [...] }
+            //   또는 { content: [{type:"text", text:"..."}] }
+            //   또는 messages 배열의 마지막 assistant message
+            if (typeof obj.result === "string") {
+                return obj.result;
+            }
+            const content = obj.content;
+            if (Array.isArray(content)) {
+                return content.map((b) => (b.type === "text" ? b.text ?? "" : "")).join("");
+            }
+            const messages = obj.messages;
+            if (Array.isArray(messages)) {
+                for (let i = messages.length - 1; i >= 0; i--) {
+                    const m = messages[i];
+                    if (m.role === "assistant") {
+                        if (typeof m.content === "string")
+                            return m.content;
+                        if (Array.isArray(m.content)) {
+                            return m.content
+                                .map((b) => (b.type === "text" ? b.text ?? "" : ""))
+                                .join("");
+                        }
+                    }
+                }
+            }
+        }
+    }
+    catch {
+        // 2) line-delimited 이벤트 스트림 시도
+        const lines = stdout.split("\n").filter((l) => l.trim());
+        for (let i = lines.length - 1; i >= 0; i--) {
+            try {
+                const ev = JSON.parse(lines[i]);
+                if (ev.type === "assistant" || ev.type === "message") {
+                    if (typeof ev.text === "string")
+                        return ev.text;
+                    if (ev.message && typeof ev.message === "object") {
+                        const mc = ev.message.content;
+                        if (typeof mc === "string")
+                            return mc;
+                        if (Array.isArray(mc)) {
+                            return mc
+                                .map((b) => (b.type === "text" ? b.text ?? "" : ""))
+                                .join("");
+                        }
+                    }
+                }
+            }
+            catch {
+                /* skip */
+            }
+        }
+    }
+    // fallback: raw
+    return stdout.slice(0, 4000);
+}
+//# sourceMappingURL=claude-cli.js.map

package/dist/server/llm/claude-cli.js.map

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

package/dist/server/llm/context-builder.js

@@ -0,0 +1,229 @@
+/**
+ * Layer 3 Context Builder (apps/client)
+ *
+ * 책임: LLM 호출 시 Layer 3 (사용자 저널) 부분 자동 조합
+ *
+ * 입력:
+ *   - personaSlug · 어떤 페르소나 컨텍스트
+ *   - 보유 종목 (account.getHoldings)
+ *   - 활성 watcher (ConditionWatcher.list)
+ *   - 활성 미체결 주문 (OrderTracker.list)
+ *   - 최근 lessons (trade-journal · 직전 N건)
+ *   - 시장 지수 (코스피/코스닥)
+ *
+ * 출력: layer3Header (string) · LLM 에 system prompt 마지막에 들어감
+ *
+ * Context 절약 전략 (사용자 5번 질문):
+ *   - 보유 + 관심 (watcher 등록 종목) 만 포함
+ *   - 전체 종목 데이터는 보내지 않음
+ *   - lessons 는 최신 5건만
+ *   - 인덱스 데이터는 한 줄 요약
+ */
+import fs from "node:fs";
+import path from "node:path";
+import os from "node:os";
+import { getHoldings, getMarketIndex } from "../broker/kiwoom/index.js";
+import { getConditionWatcher } from "../watchers/condition-watcher.js";
+import { getOrderTracker } from "../broker/kiwoom/order-tracker.js";
+import { readEvents } from "../journal/trade-journal.js";
+/**
+ * Layer 3 patches 디렉토리 (Coach 가 출력한 patch 파일 모음)
+ *
+ * 구조:
+ *   ~/.mulsok-traders/layer3-patches/<personaSlug>/<yyyy-mm-dd>-<idx>.md
+ *
+ * Coach 가 patch 를 발행 (P15+ executor) → 사용자가 승인 → 이 디렉토리에 markdown 파일로 저장.
+ * buildLayer3Patches() 가 자동 reload 해서 LLM context 에 주입.
+ */
+const PATCHES_DIR = path.join(os.homedir(), ".mulsok-traders", "layer3-patches");
+/** 활성 patch 모음 · markdown 합쳐서 반환 */
+export function loadActivePatches(personaSlug) {
+    const personaDir = path.join(PATCHES_DIR, personaSlug);
+    if (!fs.existsSync(personaDir))
+        return "";
+    const files = fs
+        .readdirSync(personaDir)
+        .filter((f) => f.endsWith(".md"))
+        .sort();
+    if (files.length === 0)
+        return "";
+    const sections = [];
+    for (const f of files) {
+        try {
+            const text = fs.readFileSync(path.join(personaDir, f), "utf-8");
+            sections.push(`<!-- patch: ${f} -->\n${text.trim()}`);
+        }
+        catch {
+            // skip
+        }
+    }
+    return sections.join("\n\n---\n\n");
+}
+/**
+ * Layer3 컨텍스트 데이터 수집 (raw 객체 반환 · 마크다운 X).
+ *
+ * - 외부 API (kiwoom · 시장 지수 · 보유) 모두 1회씩만 호출
+ * - 실패 시 null 또는 빈 배열 fallback (throw 없음)
+ *
+ * 호출자:
+ *   - formatLayer3Markdown() · LLM prompt 용
+ *   - executor.ts · journal layer3_snapshot 저장 용
+ *
+ * 두 곳에서 같은 collect 결과를 공유하면 외부 API 중복 호출 없음.
+ */
+export async function collectLayer3Snapshot(opts) {
+    const { personaSlug, maxLessons = 5, includeMarketIndex = true, includeHoldings = true, includeWatchers = true, includePendingOrders = true, } = opts;
+    const snapshot = {
+        capturedAt: new Date().toISOString(),
+        personaSlug,
+    };
+    if (includeMarketIndex) {
+        const [kospi, kosdaq] = await Promise.all([
+            getMarketIndex("kospi").catch(() => null),
+            getMarketIndex("kosdaq").catch(() => null),
+        ]);
+        snapshot.marketIndex = {
+            kospi: kospi?.ok ? { currentValue: kospi.data.currentValue, changePct: kospi.data.changePct } : null,
+            kosdaq: kosdaq?.ok ? { currentValue: kosdaq.data.currentValue, changePct: kosdaq.data.changePct } : null,
+        };
+    }
+    if (includeHoldings) {
+        try {
+            const holdingsRes = await getHoldings();
+            if (holdingsRes.ok) {
+                snapshot.holdings = {
+                    items: holdingsRes.data.items.map((h) => ({
+                        symbolCode: h.symbolCode,
+                        symbolName: h.symbolName,
+                        quantity: h.quantity,
+                        avgBuyPriceKrw: h.avgBuyPriceKrw,
+                        currentPriceKrw: h.currentPriceKrw,
+                        pnlPct: h.pnlPct,
+                    })),
+                    totalEvalKrw: holdingsRes.data.totalEvalKrw,
+                    totalPnlKrw: holdingsRes.data.totalPnlKrw,
+                    totalPnlPct: holdingsRes.data.totalPnlPct,
+                };
+            }
+            else {
+                snapshot.holdings = null;
+            }
+        }
+        catch {
+            snapshot.holdings = null;
+        }
+    }
+    if (includePendingOrders) {
+        const orders = getOrderTracker().list({ activeOnly: true }).filter((o) => o.personaSlug === personaSlug);
+        snapshot.pendingOrders = orders.map((o) => ({
+            symbolCode: o.symbolCode,
+            side: o.side,
+            intendedQty: o.intendedQty,
+            intendedPriceKrw: o.intendedPriceKrw,
+            status: o.status,
+            filledQty: o.filledQty,
+        }));
+    }
+    if (includeWatchers) {
+        const watchers = getConditionWatcher().list({ personaSlug, activeOnly: true });
+        snapshot.activeWatchers = watchers.map((w) => ({
+            id: w.id,
+            type: w.spec.condition.type,
+            intent: w.spec.intent,
+            expiresAt: w.expiresAt,
+            triggerCount: w.triggerCount,
+        }));
+    }
+    // 최근 lessons (decision 이벤트의 llmContext.lesson)
+    const recentEvents = readEvents({
+        personaSlug,
+        eventTypes: ["decision"],
+        limit: maxLessons * 3,
+    });
+    snapshot.recentLessons = recentEvents
+        .filter((e) => e.llmContext?.lesson)
+        .slice(0, maxLessons)
+        .map((e) => ({
+        time: e.timestamp.slice(0, 16),
+        symbolCode: e.symbolCode,
+        lesson: e.llmContext?.lesson,
+    }));
+    return snapshot;
+}
+/**
+ * 스냅샷을 LLM prompt 마크다운으로 변환 (외부 API 호출 X · 순수).
+ */
+export function formatLayer3Markdown(snap) {
+    const sections = [];
+    sections.push(`# Layer 3 · 사용자 컨텍스트 (persona: ${snap.personaSlug} · ${snap.capturedAt.slice(0, 19)})`);
+    if (snap.marketIndex) {
+        const lines = ["## 시장 분위기"];
+        if (snap.marketIndex.kospi) {
+            lines.push(`- KOSPI ${snap.marketIndex.kospi.currentValue.toLocaleString()} (${fmtPct(snap.marketIndex.kospi.changePct)})`);
+        }
+        else {
+            lines.push("- KOSPI 조회 실패");
+        }
+        if (snap.marketIndex.kosdaq) {
+            lines.push(`- KOSDAQ ${snap.marketIndex.kosdaq.currentValue.toLocaleString()} (${fmtPct(snap.marketIndex.kosdaq.changePct)})`);
+        }
+        else {
+            lines.push("- KOSDAQ 조회 실패");
+        }
+        sections.push(lines.join("\n"));
+    }
+    if (snap.holdings !== undefined) {
+        const lines = ["## 현재 보유 종목"];
+        if (snap.holdings && snap.holdings.items.length > 0) {
+            for (const h of snap.holdings.items) {
+                lines.push(`- ${h.symbolName} (${h.symbolCode}) · ${h.quantity}주 · 평균 ${h.avgBuyPriceKrw.toLocaleString()}원 · 현재 ${h.currentPriceKrw.toLocaleString()}원 · 평가 ${fmtPct(h.pnlPct)}`);
+            }
+            lines.push(`- 총 평가 ${snap.holdings.totalEvalKrw.toLocaleString()}원 · 손익 ${snap.holdings.totalPnlKrw.toLocaleString()}원 (${fmtPct(snap.holdings.totalPnlPct)})`);
+        }
+        else {
+            lines.push("- 보유 종목 없음");
+        }
+        sections.push(lines.join("\n"));
+    }
+    if (snap.pendingOrders && snap.pendingOrders.length > 0) {
+        const lines = ["## 활성 미체결 주문 (이 페르소나)"];
+        for (const o of snap.pendingOrders) {
+            lines.push(`- ${o.symbolCode} · ${o.side} ${o.intendedQty}주 @ ${o.intendedPriceKrw.toLocaleString()}원 · ${o.status} · 체결 ${o.filledQty}/${o.intendedQty}`);
+        }
+        lines.push("⚠️ 같은 종목 신규 주문은 OrderTracker 가 자동 거부합니다 (중복 방지).");
+        sections.push(lines.join("\n"));
+    }
+    if (snap.activeWatchers && snap.activeWatchers.length > 0) {
+        const lines = ["## 활성 감시자 (wake_plan.watchers)"];
+        for (const w of snap.activeWatchers) {
+            lines.push(`- [${w.type}] ${w.intent} · 만료 ${w.expiresAt.slice(0, 19)}`);
+        }
+        sections.push(lines.join("\n"));
+    }
+    if (snap.recentLessons && snap.recentLessons.length > 0) {
+        const lines = ["## 최근 학습 (Layer 1 §2 매일 반성)"];
+        for (const l of snap.recentLessons) {
+            lines.push(`- ${l.time}${l.symbolCode ? " · " + l.symbolCode : ""} · ${l.lesson}`);
+        }
+        sections.push(lines.join("\n"));
+    }
+    return sections.join("\n\n");
+}
+/**
+ * 사용자 보유/관심 정보 + 최근 학습을 묶어 layer3Header 문자열 반환.
+ * Bundle.ts assembleFullPrompt() 의 layer3Header 인자로 전달.
+ *
+ * @deprecated 새 코드는 collectLayer3Snapshot + formatLayer3Markdown 분리 사용 권장.
+ *             이 함수는 두 단계를 한 번에 호출하는 편의 wrapper.
+ */
+export async function buildLayer3Header(opts) {
+    const snap = await collectLayer3Snapshot(opts);
+    return formatLayer3Markdown(snap);
+}
+function fmtPct(n) {
+    if (!Number.isFinite(n))
+        return "0.00%";
+    const sign = n > 0 ? "+" : "";
+    return `${sign}${n.toFixed(2)}%`;
+}
+//# sourceMappingURL=context-builder.js.map

package/dist/server/llm/context-builder.js.map

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

package/dist/server/llm/gemini.js

@@ -0,0 +1,86 @@
+/** Gemini finishReason → 표준 LlmStopReason 매핑 */
+function mapGeminiStopReason(raw) {
+    switch (raw) {
+        case "STOP": return "stop";
+        case "MAX_TOKENS": return "max_tokens";
+        case "SAFETY": return "safety";
+        case "RECITATION": return "safety";
+        default: return "unknown";
+    }
+}
+const BASE = "https://generativelanguage.googleapis.com/v1beta";
+/**
+ * Gemini 기본 maxOutputTokens — 응답 잘림 방지 (사용자 정정 · 2026-05-03).
+ * Gemini 2.5 Flash/Pro 의 model 한계 (8192) 까지 자유 출력 허용.
+ * fetch timeout 없음 (무한대 대기).
+ */
+const DEFAULT_MAX_TOKENS = 8192;
+export function createGeminiProvider(opts) {
+    return {
+        kind: "gemini",
+        async test() {
+            if (!opts.apiKey)
+                return { ok: false, provider: "gemini", error: "apiKey 없음" };
+            try {
+                // model list · 존재하는지만 확인
+                const res = await fetch(`${BASE}/models?key=${encodeURIComponent(opts.apiKey)}`, {
+                    headers: { accept: "application/json" },
+                });
+                if (!res.ok) {
+                    return {
+                        ok: false,
+                        provider: "gemini",
+                        error: `HTTP ${res.status}: ${(await res.text()).slice(0, 120)}`,
+                    };
+                }
+                const data = (await res.json());
+                const has = data.models?.some((m) => m.name?.includes(opts.model));
+                return {
+                    ok: !!has,
+                    provider: "gemini",
+                    model: opts.model,
+                    detail: has ? "model 확인됨" : "model 미발견 (지원 목록에 없음)",
+                };
+            }
+            catch (e) {
+                return { ok: false, provider: "gemini", error: String(e) };
+            }
+        },
+        async complete(c) {
+            if (!opts.apiKey)
+                throw new Error("Gemini apiKey 없음");
+            const url = `${BASE}/models/${encodeURIComponent(opts.model)}:generateContent?key=${encodeURIComponent(opts.apiKey)}`;
+            const body = {
+                systemInstruction: c.systemPrompt ? { parts: [{ text: c.systemPrompt }] } : undefined,
+                contents: [{ role: "user", parts: [{ text: c.userPrompt }] }],
+                generationConfig: {
+                    maxOutputTokens: c.maxTokens ?? DEFAULT_MAX_TOKENS,
+                    temperature: c.temperature ?? 0.2,
+                },
+            };
+            const res = await fetch(url, {
+                method: "POST",
+                headers: { "content-type": "application/json" },
+                body: JSON.stringify(body),
+            });
+            if (!res.ok)
+                throw new Error(`Gemini HTTP ${res.status}: ${await res.text()}`);
+            const data = (await res.json());
+            const text = data.candidates?.[0]?.content?.parts?.map((p) => p.text ?? "").join("") ?? "";
+            return {
+                text,
+                model: opts.model,
+                provider: "gemini",
+                stopReason: mapGeminiStopReason(data.candidates?.[0]?.finishReason),
+                usage: data.usageMetadata
+                    ? {
+                        inputTokens: data.usageMetadata.promptTokenCount ?? 0,
+                        outputTokens: data.usageMetadata.candidatesTokenCount ?? 0,
+                    }
+                    : undefined,
+                raw: data,
+            };
+        },
+    };
+}
+//# sourceMappingURL=gemini.js.map

package/dist/server/llm/gemini.js.map

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

package/dist/server/llm/index.js

@@ -0,0 +1,36 @@
+export { createGeminiProvider } from "./gemini.js";
+export { createOpenAIProvider } from "./openai.js";
+export { createAnthropicProvider } from "./anthropic.js";
+export { createClaudeCliProvider } from "./claude-cli.js";
+import { createGeminiProvider } from "./gemini.js";
+import { createOpenAIProvider } from "./openai.js";
+import { createAnthropicProvider } from "./anthropic.js";
+import { createClaudeCliProvider } from "./claude-cli.js";
+export function createLlmProvider(cfg) {
+    switch (cfg.llm.provider) {
+        case "gemini":
+            return createGeminiProvider({
+                apiKey: cfg.llm.apiKey ?? "",
+                model: cfg.llm.model ?? "gemini-2.5-flash",
+            });
+        case "openai":
+            return createOpenAIProvider({
+                apiKey: cfg.llm.apiKey ?? "",
+                model: cfg.llm.model ?? "gpt-4o-mini",
+            });
+        case "anthropic":
+            return createAnthropicProvider({
+                apiKey: cfg.llm.apiKey ?? "",
+                model: cfg.llm.model ?? "claude-haiku-3-5",
+            });
+        case "claude-cli":
+            return createClaudeCliProvider({
+                binaryPath: cfg.llm.claudeCli?.binaryPath,
+                model: cfg.llm.claudeCli?.model ?? "sonnet",
+            });
+        case "none":
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/server/llm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src-server/llm/index.ts"],"names":[],"mappings":"AAoDA,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,MAAM,UAAU,iBAAiB,CAAC,GAAiB;IACjD,QAAQ,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;QACzB,KAAK,QAAQ;YACX,OAAO,oBAAoB,CAAC;gBAC1B,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE;gBAC5B,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI,kBAAkB;aAC3C,CAAC,CAAC;QACL,KAAK,QAAQ;YACX,OAAO,oBAAoB,CAAC;gBAC1B,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE;gBAC5B,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI,aAAa;aACtC,CAAC,CAAC;QACL,KAAK,WAAW;YACd,OAAO,uBAAuB,CAAC;gBAC7B,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE;gBAC5B,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI,kBAAkB;aAC3C,CAAC,CAAC;QACL,KAAK,YAAY;YACf,OAAO,uBAAuB,CAAC;gBAC7B,UAAU,EAAE,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,UAAU;gBACzC,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,IAAI,QAAQ;aAC5C,CAAC,CAAC;QACL,KAAK,MAAM,CAAC;QACZ;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC"}