mcp-xray-pilot 0.10.0

package/data/docs/transports__transports_websocket.md

@@ -0,0 +1,75 @@
+---
+url: https://xtls.github.io/en/config/transports/websocket.html
+source_url: https://raw.githubusercontent.com/XTLS/Xray-docs-next/main/docs/en/config/transports/websocket.md
+title: WebSocket
+category: transports
+slug: transports/websocket
+fetched_at: 2026-05-04T18:43:04.294Z
+---
+# WebSocket
+
+Uses standard WebSocket to transport data.
+
+WebSocket connections can be routed by other HTTP servers (such as Nginx) or by VLESS fallbacks path.
+
+::: danger
+**It is recommended to switch to [XHTTP](https://github.com/XTLS/Xray-core/discussions/4113) to avoid significant traffic characteristics like WebSocket "ALPN is http/1.1".**
+:::
+
+::: tip
+WebSocket will recognize the `X-Forwarded-For` header in HTTP requests to overwrite the source address of the traffic, which has higher priority than the PROXY protocol.
+:::
+
+## WebSocketObject
+
+`WebSocketObject` corresponds to the `wsSettings` item in the transport configuration.
+
+```json
+{
+  "acceptProxyProtocol": false,
+  "path": "/",
+  "host": "xray.com",
+  "headers": {
+    "key": "value"
+  },
+  "heartbeatPeriod": 10
+}
+```
+
+> `acceptProxyProtocol`: true | false
+
+Only used for inbound, indicating whether to receive PROXY protocol.
+
+[PROXY protocol](https://www.haproxy.org/download/2.2/doc/proxy-protocol.txt) is specifically used to pass the real source IP and port of the request. **If you don't understand it, please ignore this item.**
+
+Common reverse proxy software (such as HAProxy, Nginx) can be configured to send it, and VLESS fallbacks xver can also send it.
+
+When set to `true`, after the underlying TCP connection is established, the requester must send PROXY protocol v1 or v2 first; otherwise, the connection will be closed.
+
+> `path`: string
+
+The HTTP protocol path used by WebSocket. The default value is `"/"`.
+
+If the client path contains the `ed` parameter (e.g., `/mypath?ed=2560`), `Early Data` will be enabled to reduce latency. It uses the `Sec-WebSocket-Protocol` header to carry the first packet data during the upgrade, where the value represents the first packet length threshold. If the length of the first packet exceeds this value, `Early Data` will not be enabled. The recommended value is 2560, and the maximum value is 8192. Excessively large values may cause some compatibility issues. If you encounter compatibility issues, try lowering the threshold.
+
+> `host`: string
+
+The host sent in the WebSocket HTTP request. Default value is empty. If the server-side value is empty, the host value sent by the client is not verified.
+
+When this value is specified on the server side, or `host` is specified in `headers`, it will verify whether it matches the client request host.
+
+Client priority for sending host: `host` > `headers` > `address`.
+
+> `headers`: map \{string: string\}
+
+Client only. Custom HTTP headers, key-value pairs. Each key represents the name of an HTTP header, and the corresponding value is a string.
+
+Default is empty.
+
+> `heartbeatPeriod`: int
+
+Specifies a fixed time interval to send a Ping message to keep the connection alive. If not specified or set to 0, no Ping message is sent, which is the current default behavior.
+
+## Browser Dialer
+
+Use a browser to handle TLS. See [Browser Dialer](../features/browser_dialer.md) for details.

package/data/docs/transports__transports_xhttp.md

@@ -0,0 +1,11 @@
+---
+url: https://xtls.github.io/en/config/transports/xhttp.html
+source_url: https://raw.githubusercontent.com/XTLS/Xray-docs-next/main/docs/en/config/transports/xhttp.md
+title: "XHTTP: Beyond REALITY"
+category: transports
+slug: transports/xhttp
+fetched_at: 2026-05-04T18:43:02.279Z
+---
+# XHTTP: Beyond REALITY
+
+See [XHTTP: Beyond REALITY](https://github.com/XTLS/Xray-core/discussions/4113)

package/dist/data/compatibility.js

@@ -0,0 +1,170 @@
+/*
+ * Protocol × transport × security compatibility matrix.
+ *
+ * Hand-curated from XTLS docs + battle-tested config recipes (Hiddify, v2rayN,
+ * Remnawave). Used by lint to flag impossible combos and by suggest tools to
+ * pick a sane next step.
+ *
+ * Conservative: only mark combos as "supported" if there's a documented or
+ * widely-deployed example. Unknown combos = warn, not error.
+ */
+export const matrix = {
+    vless: {
+        transports: ["raw", "tcp", "xhttp", "splithttp", "grpc", "ws", "websocket", "httpupgrade", "kcp", "mkcp"],
+        security: ["none", "tls", "reality"],
+        flows: {
+            "xtls-rprx-vision": { transport: ["raw", "tcp"], security: ["tls", "reality"] },
+            "xtls-rprx-vision-udp443": { transport: ["raw", "tcp"], security: ["tls", "reality"] },
+        },
+        notes: "VLESS is the most permissive — supports REALITY, vision flow, all transports.",
+    },
+    vmess: {
+        transports: ["raw", "tcp", "xhttp", "grpc", "ws", "websocket", "httpupgrade", "kcp", "mkcp"],
+        security: ["none", "tls"],
+        notes: "VMess does NOT support REALITY (no protocol header to hide).",
+    },
+    trojan: {
+        transports: ["raw", "tcp", "xhttp", "grpc", "ws", "websocket", "httpupgrade"],
+        security: ["tls"],
+        notes: "Trojan requires TLS. REALITY is unsupported on inbound.",
+    },
+    shadowsocks: {
+        transports: ["raw", "tcp", "ws", "websocket", "grpc", "kcp", "mkcp", "httpupgrade"],
+        security: ["none"],
+        notes: "Shadowsocks ciphers are self-encrypting. REALITY/TLS not supported.",
+    },
+    socks: {
+        transports: ["raw", "tcp"],
+        security: ["none", "tls"],
+        notes: "SOCKS over TLS (stunnel-style) is supported but rare.",
+    },
+    http: {
+        transports: ["raw", "tcp"],
+        security: ["none", "tls"],
+    },
+    wireguard: {
+        transports: ["raw"],
+        security: ["none"],
+        notes: "WireGuard is its own transport over UDP; xray exposes it as a protocol.",
+    },
+    hysteria: {
+        transports: ["hysteria"],
+        security: ["tls"],
+        notes: "Hysteria(2) brings its own QUIC-based transport.",
+    },
+    hysteria2: {
+        transports: ["hysteria"],
+        security: ["tls"],
+    },
+};
+export function isProtocolSecuritySupported(protocol, security) {
+    const m = matrix[protocol];
+    if (!m)
+        return { ok: true }; /* unknown protocol — let validate.ts handle */
+    if (!m.security.includes(security)) {
+        return {
+            ok: false,
+            reason: `protocol "${protocol}" does not support security "${security}". Allowed: ${m.security.join(", ")}.`,
+        };
+    }
+    return { ok: true };
+}
+export function isProtocolTransportSupported(protocol, transport) {
+    const m = matrix[protocol];
+    if (!m)
+        return { ok: true };
+    if (!m.transports.includes(transport)) {
+        return {
+            ok: false,
+            reason: `protocol "${protocol}" does not support transport "${transport}". Allowed: ${m.transports.join(", ")}.`,
+        };
+    }
+    return { ok: true };
+}
+export function checkFlow(protocol, flow, transport, security) {
+    if (!flow)
+        return { ok: true };
+    const m = matrix[protocol];
+    if (!m || !m.flows || !m.flows[flow]) {
+        return { ok: true }; /* no rule registered → don't complain. */
+    }
+    const req = m.flows[flow];
+    const tOk = req.transport.includes(transport);
+    const sOk = req.security.includes(security);
+    if (!tOk || !sOk) {
+        return {
+            ok: false,
+            reason: `flow "${flow}" requires transport ∈ {${req.transport.join(", ")}} and security ∈ {${req.security.join(", ")}} (got transport=${transport}, security=${security}).`,
+        };
+    }
+    return { ok: true };
+}
+export const protocolFeatures = {
+    vless: {
+        transports: matrix.vless.transports.slice(),
+        security: matrix.vless.security.slice(),
+        multiplexing: 1,
+        padding: 1,
+        antiDpi: 5,
+        mobileFriendly: 4,
+        battery: 4,
+        ease: 3,
+        notes: "Best DPI resistance via REALITY+xhttp/raw+vision. Steeper config.",
+    },
+    vmess: {
+        transports: matrix.vmess.transports.slice(),
+        security: matrix.vmess.security.slice(),
+        multiplexing: 1,
+        padding: 0,
+        antiDpi: 2,
+        mobileFriendly: 4,
+        battery: 4,
+        ease: 4,
+        notes: "Legacy. AEAD only post-2022. No REALITY. UUID-based auth.",
+    },
+    trojan: {
+        transports: matrix.trojan.transports.slice(),
+        security: matrix.trojan.security.slice(),
+        multiplexing: 1,
+        padding: 0,
+        antiDpi: 3,
+        mobileFriendly: 4,
+        battery: 4,
+        ease: 4,
+        notes: "Looks like vanilla TLS HTTPS. Needs a real cert.",
+    },
+    shadowsocks: {
+        transports: matrix.shadowsocks.transports.slice(),
+        security: matrix.shadowsocks.security.slice(),
+        multiplexing: 0,
+        padding: 0,
+        antiDpi: 2,
+        mobileFriendly: 5,
+        battery: 5,
+        ease: 5,
+        notes: "Lightest, broadest client support. SS-2022 ciphers required for serious DPI environments.",
+    },
+    hysteria2: {
+        transports: matrix.hysteria2.transports.slice(),
+        security: matrix.hysteria2.security.slice(),
+        multiplexing: 1,
+        padding: 1,
+        antiDpi: 4,
+        mobileFriendly: 3,
+        battery: 2,
+        ease: 4,
+        notes: "QUIC over UDP. Best throughput on lossy links. Battery-hungry on phones.",
+    },
+    wireguard: {
+        transports: matrix.wireguard.transports.slice(),
+        security: matrix.wireguard.security.slice(),
+        multiplexing: 0,
+        padding: 0,
+        antiDpi: 1,
+        mobileFriendly: 5,
+        battery: 5,
+        ease: 5,
+        notes: "Easiest, best battery, but trivially DPI-blockable in 2025 RU.",
+    },
+};
+//# sourceMappingURL=compatibility.js.map

package/dist/data/compatibility.js.map

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

package/dist/data/geocatalogue.js

@@ -0,0 +1,191 @@
+/*
+ * Embedded catalogue of well-known geosite/geoip categories.
+ *
+ * Sources:
+ *   - github.com/v2fly/domain-list-community  (geosite)
+ *   - github.com/v2fly/geoip                  (geoip)
+ *   - github.com/runetfreedom/russia-v2ray-rules-dat  (Russia-flavoured set)
+ *
+ * Hand-curated subset of the most-referenced tags. Not exhaustive — used
+ * as a "did you mean?" check, not as a hard error. Unknown tag → warn.
+ */
+/* All ISO 3166-1 alpha-2 country codes (lowercase). Most are valid geoip:* /
+ * geosite:geolocation-* tags. */
+export const ISO_COUNTRY_CODES = [
+    "ad", "ae", "af", "ag", "ai", "al", "am", "ao", "aq", "ar", "as", "at", "au", "aw",
+    "ax", "az", "ba", "bb", "bd", "be", "bf", "bg", "bh", "bi", "bj", "bl", "bm", "bn",
+    "bo", "bq", "br", "bs", "bt", "bv", "bw", "by", "bz", "ca", "cc", "cd", "cf", "cg",
+    "ch", "ci", "ck", "cl", "cm", "cn", "co", "cr", "cu", "cv", "cw", "cx", "cy", "cz",
+    "de", "dj", "dk", "dm", "do", "dz", "ec", "ee", "eg", "eh", "er", "es", "et", "fi",
+    "fj", "fk", "fm", "fo", "fr", "ga", "gb", "gd", "ge", "gf", "gg", "gh", "gi", "gl",
+    "gm", "gn", "gp", "gq", "gr", "gs", "gt", "gu", "gw", "gy", "hk", "hm", "hn", "hr",
+    "ht", "hu", "id", "ie", "il", "im", "in", "io", "iq", "ir", "is", "it", "je", "jm",
+    "jo", "jp", "ke", "kg", "kh", "ki", "km", "kn", "kp", "kr", "kw", "ky", "kz", "la",
+    "lb", "lc", "li", "lk", "lr", "ls", "lt", "lu", "lv", "ly", "ma", "mc", "md", "me",
+    "mf", "mg", "mh", "mk", "ml", "mm", "mn", "mo", "mp", "mq", "mr", "ms", "mt", "mu",
+    "mv", "mw", "mx", "my", "mz", "na", "nc", "ne", "nf", "ng", "ni", "nl", "no", "np",
+    "nr", "nu", "nz", "om", "pa", "pe", "pf", "pg", "ph", "pk", "pl", "pm", "pn", "pr",
+    "ps", "pt", "pw", "py", "qa", "re", "ro", "rs", "ru", "rw", "sa", "sb", "sc", "sd",
+    "se", "sg", "sh", "si", "sj", "sk", "sl", "sm", "sn", "so", "sr", "ss", "st", "sv",
+    "sx", "sy", "sz", "tc", "td", "tf", "tg", "th", "tj", "tk", "tl", "tm", "tn", "to",
+    "tr", "tt", "tv", "tw", "tz", "ua", "ug", "um", "us", "uy", "uz", "va", "vc", "ve",
+    "vg", "vi", "vn", "vu", "wf", "ws", "ye", "yt", "za", "zm", "zw",
+];
+/* Special geoip tags. */
+const GEOIP_SPECIAL = [
+    "private",
+    "tor",
+    "telegram",
+    "facebook",
+    "google",
+    "twitter",
+    "netflix",
+    "cloudflare",
+    "fastly",
+    "cloudfront",
+];
+/* geosite tags. Curated from domain-list-community + ru flavoured forks. */
+const GEOSITE_NAMES = [
+    /* core */
+    "category-ads",
+    "category-ads-all",
+    "category-public-tracker",
+    "geolocation-cn",
+    "geolocation-!cn",
+    /* country-flavoured (ru fork) */
+    "category-ru",
+    "category-gov-ru",
+    "category-banks-ru",
+    "category-media-ru",
+    /* common services */
+    "apple",
+    "google",
+    "google-cn",
+    "googlefcm",
+    "googleads",
+    "googlescholar",
+    "microsoft",
+    "amazon",
+    "amazon-aws",
+    "amazon-cn",
+    "youtube",
+    "netflix",
+    "spotify",
+    "twitter",
+    "facebook",
+    "instagram",
+    "telegram",
+    "whatsapp",
+    "discord",
+    "dropbox",
+    "github",
+    "gitlab",
+    "bitbucket",
+    "openai",
+    "claude",
+    "anthropic",
+    "huggingface",
+    "tiktok",
+    "bilibili",
+    "reddit",
+    "twitch",
+    "steam",
+    "steam@cn",
+    "epicgames",
+    "ea",
+    "blizzard",
+    "riot-games",
+    "ubisoft",
+    /* dev / package mirrors */
+    "category-dev",
+    "category-game-platforms",
+    "category-game-platforms-download",
+    "category-games-cn",
+    "category-cdn",
+    /* bittorrent / private */
+    "category-bittorrent",
+    /* ai */
+    "category-ai-!cn",
+    "category-ai-chat-!cn",
+    "category-ai-chat-cn",
+    /* misc */
+    "private",
+    "cn",
+];
+function geoip(name, description) {
+    return { prefix: "geoip", name, description };
+}
+function geosite(name, description) {
+    return { prefix: "geosite", name, description };
+}
+const COUNTRY_NAMES = {
+    ru: "Russia", us: "United States", cn: "China", jp: "Japan", de: "Germany",
+    gb: "United Kingdom", fr: "France", kr: "South Korea", hk: "Hong Kong",
+    sg: "Singapore", tw: "Taiwan", ir: "Iran", in: "India", br: "Brazil",
+    ca: "Canada", au: "Australia", nl: "Netherlands", se: "Sweden",
+    fi: "Finland", no: "Norway", pl: "Poland", ua: "Ukraine", by: "Belarus",
+    kz: "Kazakhstan", tr: "Turkey", il: "Israel", ae: "United Arab Emirates",
+    sa: "Saudi Arabia", za: "South Africa", mx: "Mexico", ar: "Argentina",
+    cl: "Chile", co: "Colombia", th: "Thailand", vn: "Vietnam", id: "Indonesia",
+    my: "Malaysia", ph: "Philippines", pk: "Pakistan", bd: "Bangladesh",
+};
+const entries = [];
+/* geoip per country */
+for (const code of ISO_COUNTRY_CODES) {
+    const human = COUNTRY_NAMES[code] ?? code.toUpperCase();
+    entries.push(geoip(code, `IPs geolocated to ${human}`));
+}
+/* geoip special */
+for (const t of GEOIP_SPECIAL)
+    entries.push(geoip(t, `Special IP set: ${t}`));
+/* geosite well-known */
+for (const t of GEOSITE_NAMES)
+    entries.push(geosite(t, `Domain list: ${t}`));
+/* geosite per country (geolocation-XX) */
+for (const code of ISO_COUNTRY_CODES) {
+    const human = COUNTRY_NAMES[code] ?? code.toUpperCase();
+    entries.push(geosite(`geolocation-${code}`, `Domains geolocated to ${human}`));
+}
+export const GEO_CATALOGUE = entries;
+const GEOIP_SET = new Set(entries.filter((e) => e.prefix === "geoip").map((e) => e.name));
+const GEOSITE_SET = new Set(entries.filter((e) => e.prefix === "geosite").map((e) => e.name));
+/* "geoip:ru" / "geosite:youtube" → known? */
+export function isKnownGeoTag(tag) {
+    if (!tag.includes(":"))
+        return false;
+    const [prefix, rawName] = tag.split(":", 2);
+    /* Tags can carry "@cn" suffixes (steam@cn) or "!" negations (geolocation-!cn). */
+    const name = rawName.split("@")[0];
+    if (prefix === "geoip")
+        return GEOIP_SET.has(name);
+    if (prefix === "geosite")
+        return GEOSITE_SET.has(name);
+    return false;
+}
+export function searchGeoCatalogue(query, limit = 30) {
+    const q = query.toLowerCase().trim();
+    if (!q)
+        return [];
+    const hits = [];
+    for (const e of entries) {
+        let score = 0;
+        if (e.name === q)
+            score += 100;
+        else if (e.name.startsWith(q))
+            score += 50;
+        else if (e.name.includes(q))
+            score += 20;
+        if (e.description.toLowerCase().includes(q))
+            score += 10;
+        if (score > 0)
+            hits.push({ e, score });
+    }
+    hits.sort((a, b) => b.score - a.score);
+    return hits.slice(0, limit).map(({ e }) => ({
+        prefix: e.prefix,
+        name: e.name,
+        description: e.description,
+        tag: `${e.prefix}:${e.name}`,
+    }));
+}
+//# sourceMappingURL=geocatalogue.js.map

package/dist/data/geocatalogue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"geocatalogue.js","sourceRoot":"","sources":["../../src/data/geocatalogue.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;iCACiC;AACjC,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;IAClF,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;IAClF,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;IAClF,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;IAClF,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;IAClF,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;IAClF,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;IAClF,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;IAClF,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;IAClF,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;IAClF,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;IAClF,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;IAClF,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;IAClF,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;IAClF,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;IAClF,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;IAClF,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI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"}