desic-okx-agent 0.2.0 → 0.3.0

package/dist/setup/wizard.js

@@ -1,9 +1,12 @@
 import * as prompts from "@clack/prompts";
+import { detectAccountEnvironment } from "../account/service.js";
 import { loadStoredConfig, saveConfig } from "../config/loader.js";
 import { CONFIG_PATH } from "../config/paths.js";
-import { checkOkxConnectivity } from "../network/connectivity.js";
+import { publicError } from "../core/errors.js";
+import { OkxClient } from "../core/okx-client.js";
+import { checkOkxConnectivity, OKX_REST_BASE_URL } from "../network/connectivity.js";
 import { displayProxy, normalizeProxyUrl, resolveProxy } from "../network/proxy.js";
-import { SETUP_TARGETS, SetupCancelledError, setupSucceeded, setupTargets } from "./installer.js";
+import { bundledSkillCount, SETUP_TARGETS, SetupCancelledError, setupSucceeded, setupTargets } from "./installer.js";
 const TARGET_LABELS = {
     codex: "Codex",
     "claude-code": "Claude Code",
@@ -13,12 +16,13 @@ const TARGET_LABELS = {
 };
 export async function runSetupWizard(options = {}) {
     prompts.intro("Desic OKX Agent setup");
+    const skillHint = `MCP + ${bundledSkillCount()} Skills`;
     const selection = await prompts.multiselect({
         message: "Choose AI clients to configure",
         options: [
             { value: "all", label: "All supported clients", hint: "MCP for all clients; Skills where supported" },
-            { value: "codex", label: "Codex", hint: "MCP + 7 Skills" },
-            { value: "claude-code", label: "Claude Code", hint: "MCP + 7 Skills" },
+            { value: "codex", label: "Codex", hint: skillHint },
+            { value: "claude-code", label: "Claude Code", hint: skillHint },
             { value: "cursor", label: "Cursor", hint: "MCP" },
             { value: "vscode", label: "VS Code / GitHub Copilot", hint: "MCP" },
             { value: "cline", label: "Cline", hint: "MCP" }
@@ -93,11 +97,132 @@ export async function runSetupWizard(options = {}) {
         prompts.log.success(formatNetworkSuccess(network, proxy));
     if (networkSkipped)
         prompts.log.warn("Network check skipped. Public and trading tools may be unavailable.");
+    const account = await configureAccount(network?.ok === true, proxy);
     const succeeded = setupSucceeded(results) && (network?.ok || networkSkipped);
     prompts.outro(succeeded
-        ? "Setup complete. Restart the selected AI clients."
+        ? formatSetupComplete(account)
         : "Setup finished with errors. Review the failed clients above.");
-    return { targets, results, network, proxy, proxyChanged, networkSkipped };
+    return {
+        targets,
+        results,
+        network,
+        proxy,
+        proxyChanged,
+        networkSkipped,
+        accountChanged: account.changed,
+        accountSkipped: account.skipped,
+        accountName: account.name
+    };
+}
+async function configureAccount(networkAvailable, proxy) {
+    const stored = loadStoredConfig();
+    const existingNames = Object.keys(stored.accounts);
+    prompts.note([
+        "Public market and derivatives tools work without an API key.",
+        "An API key is required for account and trading tools.",
+        "Remote News and Smart Money also require a live-account API key; read-only permission is sufficient.",
+        "Create the key in the official OKX website or app. You can skip this step and run `desic-okx account add` later."
+    ].join("\n"), "OKX API account (optional)");
+    if (!networkAvailable) {
+        prompts.log.info("Account setup skipped because OKX connectivity was not verified. Configure it later with `desic-okx account add`.");
+        return { changed: false, skipped: true };
+    }
+    const action = await prompts.select({
+        message: existingNames.length
+            ? `${existingNames.length} OKX account(s) already configured. What would you like to do?`
+            : "Would you like to configure an OKX API account now?",
+        options: existingNames.length
+            ? [
+                { value: "keep", label: "Keep existing accounts", hint: "You can add or edit accounts later" },
+                { value: "add", label: "Add another account", hint: "Verify before saving" }
+            ]
+            : [
+                { value: "add", label: "Configure an account now", hint: "Verify before saving" },
+                { value: "keep", label: "Skip for now", hint: "Public tools remain available" }
+            ]
+    });
+    cancelIfNeeded(action);
+    if (action === "keep") {
+        prompts.log.info(existingNames.length
+            ? "Existing account configuration kept."
+            : "API account setup skipped. Run `desic-okx account add` whenever you need private tools.");
+        return { changed: false, skipped: true };
+    }
+    while (true) {
+        const nameValue = await prompts.text({
+            message: "Account alias",
+            placeholder: "default",
+            defaultValue: "default",
+            validate: (value) => {
+                const normalized = value?.trim() ?? "";
+                if (!normalized)
+                    return "Account alias is required";
+                if (normalized.length > 64)
+                    return "Account alias must be 64 characters or fewer";
+                if (existingNames.includes(normalized))
+                    return `Account '${normalized}' already exists; use a different alias or run desic-okx account edit`;
+                return undefined;
+            }
+        });
+        cancelIfNeeded(nameValue);
+        const name = nameValue.trim();
+        const apiKey = await requiredPassword("API Key");
+        const secretKey = await requiredPassword("Secret Key");
+        const passphrase = await requiredPassword("Passphrase");
+        const spinner = prompts.spinner();
+        spinner.start(`Verifying '${name}' and detecting its OKX environment`);
+        try {
+            const client = new OkxClient(OKX_REST_BASE_URL, proxy.url);
+            const detected = await detectAccountEnvironment(client, { name, apiKey, secretKey, passphrase });
+            const candidate = loadStoredConfig();
+            candidate.accounts[name] = {
+                environment: detected.account.environment,
+                apiKey,
+                secretKey,
+                passphrase
+            };
+            candidate.defaultAccount ??= name;
+            saveConfig(candidate);
+            spinner.stop(`Account '${name}' verified as ${detected.account.environment} and saved`);
+            prompts.note(formatAccountPermissions(detected.account.environment, detected.config), "OKX account");
+            return { changed: true, skipped: false, name };
+        }
+        catch (error) {
+            spinner.stop(`Could not verify account '${name}'`);
+            prompts.log.warn(String(publicError(error).message));
+            const next = await prompts.select({
+                message: "How should account setup continue?",
+                options: [
+                    { value: "retry", label: "Try again", hint: "Re-enter the account and credentials" },
+                    { value: "skip", label: "Skip for now", hint: "No credentials will be saved" }
+                ]
+            });
+            cancelIfNeeded(next);
+            if (next === "skip") {
+                prompts.log.info("No API credentials were saved. Run `desic-okx account add` later.");
+                return { changed: false, skipped: true };
+            }
+        }
+    }
+}
+async function requiredPassword(message) {
+    const value = await prompts.password({
+        message,
+        mask: "*",
+        validate: (input) => input?.trim() ? undefined : `${message} is required`
+    });
+    cancelIfNeeded(value);
+    return value.trim();
+}
+function formatAccountPermissions(environment, data) {
+    const permission = String(data.perm ?? data.permissions ?? "reported by OKX");
+    return `Saved to ${CONFIG_PATH}\nDetected environment: ${environment}\nAPI permissions: ${permission}`;
+}
+function formatSetupComplete(account) {
+    const accountMessage = account.changed
+        ? `OKX account '${account.name}' is ready.`
+        : "Public tools are ready. Configure an API account later when private tools are needed.";
+    return `Setup complete. ${accountMessage} Restart the selected AI clients, then run \`desic-okx doctor\`.`;
 }
 async function checkWithSpinner(proxy) {
     const spinner = prompts.spinner();

package/dist/setup/wizard.js.map

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

package/dist/strategy/constants.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Values shared with the Python engine.
+ *
+ * These must stay in step with `python/desic_strategy/report.py`; a test asserts
+ * the Python module still declares the same number.
+ */
+/**
+ * Annualized return and Calmar are withheld below this window length.
+ *
+ * A five-day run extrapolates to five-digit percentages that read as precision
+ * but carry none, and any ratio built on them inherits that noise.
+ */
+export declare const MINIMUM_ANNUALIZATION_DAYS = 30;
+/**
+ * Largest page a paged read will return, and therefore the largest `limit` the
+ * tools accept.
+ *
+ * One value shared by the tool schema, the store, and the paginating reader.
+ * When these drifted apart, a caller asking for 200,000 was rejected by the
+ * schema while a caller asking for exactly the store's cap silently received a
+ * prefix — two failure modes for the same mistake.
+ */
+export declare const MAX_PAGE_ROWS = 20000;

package/dist/strategy/constants.js

@@ -0,0 +1,24 @@
+/**
+ * Values shared with the Python engine.
+ *
+ * These must stay in step with `python/desic_strategy/report.py`; a test asserts
+ * the Python module still declares the same number.
+ */
+/**
+ * Annualized return and Calmar are withheld below this window length.
+ *
+ * A five-day run extrapolates to five-digit percentages that read as precision
+ * but carry none, and any ratio built on them inherits that noise.
+ */
+export const MINIMUM_ANNUALIZATION_DAYS = 30;
+/**
+ * Largest page a paged read will return, and therefore the largest `limit` the
+ * tools accept.
+ *
+ * One value shared by the tool schema, the store, and the paginating reader.
+ * When these drifted apart, a caller asking for 200,000 was rejected by the
+ * schema while a caller asking for exactly the store's cap silently received a
+ * prefix — two failure modes for the same mistake.
+ */
+export const MAX_PAGE_ROWS = 20_000;
+//# sourceMappingURL=constants.js.map

package/dist/strategy/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/strategy/constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,EAAE,CAAC;AAE7C;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC"}

package/dist/strategy/environment.d.ts

@@ -0,0 +1,52 @@
+export declare const PYTHON_ROOT: string;
+export declare const VENV_DIR: string;
+export declare const MINIMUM_PYTHON: readonly [3, 11];
+export declare const REQUIRED_PACKAGES: readonly ["numpy", "pandas"];
+/**
+ * Package index fallback chain.
+ *
+ * A single index is not enough in practice: a mirror that starts returning 403
+ * stalls setup completely, so each is tried in turn before failing.
+ */
+export declare const PACKAGE_INDEXES: readonly [{
+    readonly name: "tsinghua";
+    readonly url: "https://pypi.tuna.tsinghua.edu.cn/simple";
+    readonly host: "pypi.tuna.tsinghua.edu.cn";
+}, {
+    readonly name: "aliyun";
+    readonly url: "https://mirrors.aliyun.com/pypi/simple";
+    readonly host: "mirrors.aliyun.com";
+}, {
+    readonly name: "pypi";
+    readonly url: "https://pypi.org/simple";
+    readonly host: "pypi.org";
+}];
+export interface PythonStatus {
+    ready: boolean;
+    interpreter: string | null;
+    version: string | null;
+    venvPath: string;
+    packages: Record<string, boolean>;
+    engineRoot: string;
+    problems: string[];
+}
+/** Root of the bundled `desic_strategy` package and its `main.py` entry point. */
+export declare function engineRoot(): string;
+export declare function venvInterpreter(venvPath?: string): string;
+/**
+ * Reports whether a usable interpreter exists, preferring the managed venv.
+ *
+ * The engine itself needs only the standard library, so a run is possible even
+ * when numpy and pandas are absent; they are reported so a strategy that
+ * imports them fails with a clear message instead of a traceback.
+ */
+export declare function pythonStatus(): Promise<PythonStatus>;
+export interface SetupResult {
+    interpreter: string;
+    venvPath: string;
+    index: string | null;
+    installed: string[];
+    log: string[];
+}
+/** Creates the managed venv when absent and installs the pinned packages. */
+export declare function setupPythonEnvironment(onLog?: (line: string) => void): Promise<SetupResult>;

package/dist/strategy/environment.js

@@ -0,0 +1,187 @@
+import { execFile } from "node:child_process";
+import fs from "node:fs";
+import path from "node:path";
+import { promisify } from "node:util";
+import { RuntimeError } from "../core/errors.js";
+import { DATA_DIR } from "../config/paths.js";
+const run = promisify(execFile);
+export const PYTHON_ROOT = path.join(DATA_DIR, "python");
+export const VENV_DIR = path.join(PYTHON_ROOT, "venv");
+export const MINIMUM_PYTHON = [3, 11];
+export const REQUIRED_PACKAGES = ["numpy", "pandas"];
+/**
+ * Package index fallback chain.
+ *
+ * A single index is not enough in practice: a mirror that starts returning 403
+ * stalls setup completely, so each is tried in turn before failing.
+ */
+export const PACKAGE_INDEXES = [
+    { name: "tsinghua", url: "https://pypi.tuna.tsinghua.edu.cn/simple", host: "pypi.tuna.tsinghua.edu.cn" },
+    { name: "aliyun", url: "https://mirrors.aliyun.com/pypi/simple", host: "mirrors.aliyun.com" },
+    { name: "pypi", url: "https://pypi.org/simple", host: "pypi.org" }
+];
+/** Root of the bundled `desic_strategy` package and its `main.py` entry point. */
+export function engineRoot() {
+    // Resolved relative to this module so it works from `src` and from `dist`.
+    const fromDist = path.resolve(import.meta.dirname, "../../python");
+    if (fs.existsSync(path.join(fromDist, "main.py")))
+        return fromDist;
+    const fromSrc = path.resolve(import.meta.dirname, "../../../python");
+    if (fs.existsSync(path.join(fromSrc, "main.py")))
+        return fromSrc;
+    return fromDist;
+}
+export function venvInterpreter(venvPath = VENV_DIR) {
+    return process.platform === "win32"
+        ? path.join(venvPath, "Scripts", "python.exe")
+        : path.join(venvPath, "bin", "python3");
+}
+/** Interpreters to consider, most specific first. */
+function candidateInterpreters() {
+    const candidates = [venvInterpreter()];
+    for (let minor = 13; minor >= MINIMUM_PYTHON[1]; minor -= 1) {
+        candidates.push(`python3.${minor}`);
+    }
+    candidates.push("python3");
+    return candidates;
+}
+async function interpreterVersion(interpreter) {
+    try {
+        const { stdout } = await run(interpreter, ["-c", "import sys;print('%d.%d.%d' % sys.version_info[:3])"], {
+            timeout: 10_000
+        });
+        return stdout.trim() || null;
+    }
+    catch {
+        return null;
+    }
+}
+function versionIsSupported(version) {
+    const [major = 0, minor = 0] = version.split(".").map((part) => Number(part));
+    if (major !== MINIMUM_PYTHON[0])
+        return false;
+    return minor >= MINIMUM_PYTHON[1];
+}
+async function packagePresence(interpreter) {
+    const presence = {};
+    for (const name of REQUIRED_PACKAGES) {
+        try {
+            await run(interpreter, ["-c", `import ${name}`], { timeout: 20_000 });
+            presence[name] = true;
+        }
+        catch {
+            presence[name] = false;
+        }
+    }
+    return presence;
+}
+/**
+ * Reports whether a usable interpreter exists, preferring the managed venv.
+ *
+ * The engine itself needs only the standard library, so a run is possible even
+ * when numpy and pandas are absent; they are reported so a strategy that
+ * imports them fails with a clear message instead of a traceback.
+ */
+export async function pythonStatus() {
+    const root = engineRoot();
+    const problems = [];
+    if (!fs.existsSync(path.join(root, "main.py"))) {
+        problems.push(`The bundled strategy engine is missing from ${root}`);
+    }
+    for (const candidate of candidateInterpreters()) {
+        const version = await interpreterVersion(candidate);
+        if (!version)
+            continue;
+        if (!versionIsSupported(version)) {
+            problems.push(`${candidate} is Python ${version}; ${MINIMUM_PYTHON.join(".")}+ is required`);
+            continue;
+        }
+        const packages = await packagePresence(candidate);
+        const missing = Object.entries(packages)
+            .filter(([, present]) => !present)
+            .map(([name]) => name);
+        if (missing.length) {
+            problems.push(`Missing Python packages: ${missing.join(", ")}. Run 'desic-okx strategy env --setup' to install them.`);
+        }
+        return {
+            ready: problems.length === 0,
+            interpreter: candidate,
+            version,
+            venvPath: VENV_DIR,
+            packages,
+            engineRoot: root,
+            problems
+        };
+    }
+    problems.push(`No Python ${MINIMUM_PYTHON.join(".")}+ interpreter was found. Install Python, then run 'desic-okx strategy env --setup'.`);
+    return {
+        ready: false,
+        interpreter: null,
+        version: null,
+        venvPath: VENV_DIR,
+        packages: {},
+        engineRoot: root,
+        problems
+    };
+}
+/** Creates the managed venv when absent and installs the pinned packages. */
+export async function setupPythonEnvironment(onLog) {
+    const log = [];
+    const note = (line) => {
+        log.push(line);
+        onLog?.(line);
+    };
+    let base = null;
+    for (const candidate of candidateInterpreters().slice(1)) {
+        const version = await interpreterVersion(candidate);
+        if (version && versionIsSupported(version)) {
+            base = candidate;
+            note(`Using ${candidate} (Python ${version}) to create the environment`);
+            break;
+        }
+    }
+    if (!base) {
+        throw new RuntimeError("CAPABILITY_UNAVAILABLE", `No Python ${MINIMUM_PYTHON.join(".")}+ interpreter was found on PATH`);
+    }
+    fs.mkdirSync(PYTHON_ROOT, { recursive: true, mode: 0o700 });
+    const interpreter = venvInterpreter();
+    if (!fs.existsSync(interpreter)) {
+        note(`Creating a virtual environment at ${VENV_DIR}`);
+        await run(base, ["-m", "venv", VENV_DIR], { timeout: 180_000 });
+    }
+    else {
+        note("Reusing the existing virtual environment");
+    }
+    let usedIndex = null;
+    let lastError;
+    for (const index of PACKAGE_INDEXES) {
+        try {
+            note(`Installing ${REQUIRED_PACKAGES.join(", ")} from ${index.name}`);
+            await run(interpreter, [
+                "-m",
+                "pip",
+                "install",
+                "--disable-pip-version-check",
+                "--no-input",
+                "--index-url",
+                index.url,
+                "--trusted-host",
+                index.host,
+                ...REQUIRED_PACKAGES
+            ], { timeout: 600_000 });
+            usedIndex = index.name;
+            break;
+        }
+        catch (error) {
+            lastError = error;
+            note(`${index.name} failed; trying the next index`);
+        }
+    }
+    if (!usedIndex) {
+        const detail = lastError instanceof Error ? lastError.message : "unknown error";
+        throw new RuntimeError("NETWORK", `Could not install Python packages from any index (${PACKAGE_INDEXES.map((item) => item.name).join(", ")}): ${detail}`, true);
+    }
+    note("Environment ready");
+    return { interpreter, venvPath: VENV_DIR, index: usedIndex, installed: [...REQUIRED_PACKAGES], log };
+}
+//# sourceMappingURL=environment.js.map

package/dist/strategy/environment.js.map

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

package/dist/strategy/instrument.d.ts

@@ -0,0 +1,29 @@
+import type { MarketService } from "../market/service.js";
+/**
+ * Contract specification a backtest needs, as the exchange reports it.
+ *
+ * Sizing depends entirely on these: `contractValue * contractMultiplier` is how
+ * many base-currency units one contract represents, and `lotSize` / `minSize`
+ * decide what quantities are legal. Guessing them produces a run whose position
+ * sizes are wrong by whatever factor the guess was off, while every reported
+ * metric still looks plausible.
+ */
+export interface ContractSpec {
+    instId: string;
+    contractValue: number;
+    contractMultiplier: number;
+    lotSize: number;
+    minSize: number;
+    tickSize: number;
+    /** Base currency one contract is denominated in, for display. */
+    contractValueCurrency: string | null;
+}
+/**
+ * Reads an instrument's specification from the market service.
+ *
+ * The values are cached by that service, so a repeated backtest on one
+ * instrument does not re-fetch. Every field is validated: a specification that
+ * arrived incomplete must stop the run rather than fall back to a default that
+ * silently changes what was simulated.
+ */
+export declare function loadContractSpec(market: MarketService, instId: string): Promise<ContractSpec>;

package/dist/strategy/instrument.js

@@ -0,0 +1,39 @@
+import { RuntimeError } from "../core/errors.js";
+/**
+ * Reads an instrument's specification from the market service.
+ *
+ * The values are cached by that service, so a repeated backtest on one
+ * instrument does not re-fetch. Every field is validated: a specification that
+ * arrived incomplete must stop the run rather than fall back to a default that
+ * silently changes what was simulated.
+ */
+export async function loadContractSpec(market, instId) {
+    const result = await market.getInstrument(instId);
+    const row = result.data;
+    const contractValue = positive(row.ctVal, "ctVal", instId);
+    // OKX omits ctMult on some instruments; absent means one, but a present value
+    // that is unparseable is an error rather than something to assume away.
+    const contractMultiplier = row.ctMult === undefined || row.ctMult === null || row.ctMult === ""
+        ? 1
+        : positive(row.ctMult, "ctMult", instId);
+    const lotSize = positive(row.lotSz, "lotSz", instId);
+    const minSize = positive(row.minSz, "minSz", instId);
+    const tickSize = positive(row.tickSz, "tickSz", instId);
+    return {
+        instId,
+        contractValue,
+        contractMultiplier,
+        lotSize,
+        minSize,
+        tickSize,
+        contractValueCurrency: typeof row.ctValCcy === "string" && row.ctValCcy ? row.ctValCcy : null
+    };
+}
+function positive(value, field, instId) {
+    const parsed = Number(value);
+    if (!Number.isFinite(parsed) || parsed <= 0) {
+        throw new RuntimeError("STALE_DATA", `OKX did not report a usable ${field} for ${instId}; a backtest cannot size positions without it`, true, { instId, field, received: value === undefined ? null : String(value) });
+    }
+    return parsed;
+}
+//# sourceMappingURL=instrument.js.map

package/dist/strategy/instrument.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instrument.js","sourceRoot":"","sources":["../../src/strategy/instrument.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAuBjD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAAqB,EAAE,MAAc;IAC1E,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;IAClD,MAAM,GAAG,GAAG,MAAM,CAAC,IAA+B,CAAC;IAEnD,MAAM,aAAa,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAC3D,8EAA8E;IAC9E,wEAAwE;IACxE,MAAM,kBAAkB,GAAG,GAAG,CAAC,MAAM,KAAK,SAAS,IAAI,GAAG,CAAC,MAAM,KAAK,IAAI,IAAI,GAAG,CAAC,MAAM,KAAK,EAAE;QAC7F,CAAC,CAAC,CAAC;QACH,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IACrD,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IACrD,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IAExD,OAAO;QACL,MAAM;QACN,aAAa;QACb,kBAAkB;QAClB,OAAO;QACP,OAAO;QACP,QAAQ;QACR,qBAAqB,EAAE,OAAO,GAAG,CAAC,QAAQ,KAAK,QAAQ,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI;KAC9F,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc,EAAE,KAAa,EAAE,MAAc;IAC7D,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,YAAY,CACpB,YAAY,EACZ,+BAA+B,KAAK,QAAQ,MAAM,+CAA+C,EACjG,IAAI,EACJ,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACxE,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}