mcp-xray-pilot 0.10.0

package/dist/state.js.map

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

package/dist/tools.js

@@ -0,0 +1,274 @@
+/*
+ * MCP tool schemas. Pure data — descriptions are tuned for LLM tool selection.
+ */
+export const TOOL_SCHEMAS = [
+    {
+        name: "xray_list_topics",
+        description: "List all available xray-core documentation topics, grouped by category. " +
+            "Use this first to discover what slugs exist before calling xray_fetch_topic.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                category: {
+                    type: "string",
+                    enum: ["basic", "features", "inbounds", "outbounds", "transports", "all"],
+                    default: "all",
+                    description: "Filter by category. 'all' returns every topic.",
+                },
+            },
+        },
+    },
+    {
+        name: "xray_fetch_topic",
+        description: "Fetch a specific xray docs page as markdown. Tries XTLS/Xray-docs-next on " +
+            "github raw first; on success the response also overwrites the packaged " +
+            "offline cache. If the network fails (offline, blocked, timeout), falls back " +
+            "to the bundled offline copy and sets a `warning` field. Use force_offline=true " +
+            "to skip the network entirely.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                slug: {
+                    type: "string",
+                    description: 'Topic slug, e.g. "transports/xhttp", "inbounds/vless", "routing".',
+                },
+                force_offline: {
+                    type: "boolean",
+                    default: false,
+                    description: "If true, skip the network and read straight from the bundled cache.",
+                },
+            },
+            required: ["slug"],
+        },
+    },
+    {
+        name: "xray_search",
+        description: "Full-text search across all cached xray docs. Returns matched topics with " +
+            "a relevance score and a ~240-char snippet around the best match.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                query: { type: "string", description: "Search query." },
+                max_results: { type: "number", default: 10, minimum: 1, maximum: 50 },
+            },
+            required: ["query"],
+        },
+    },
+    {
+        name: "xray_validate_config",
+        description: "Parse and structurally validate an xray JSON config. Checks: valid JSON, " +
+            "required top-level fields, known protocols, per-protocol settings shape via " +
+            "Zod schemas (vless/vmess/trojan/ss/socks/http/wireguard/hysteria/freedom/...), " +
+            "transport-specific *Settings shape (raw/xhttp/grpc/ws/mkcp/httpupgrade), " +
+            "security blocks (tls/reality), routing tag references. Returns issues with " +
+            "severity (error/warn/info) and JSON-pointer paths.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                config: {
+                    type: "string",
+                    description: "JSON string of the xray config.",
+                },
+            },
+            required: ["config"],
+        },
+    },
+    {
+        name: "xray_lint",
+        description: "Run best-practice lint on an xray config. Covers things validation doesn't " +
+            "catch: VLESS decryption mode, REALITY pubkey/shortId/target syntax, XTLS " +
+            "vision flow compatibility, TLS fingerprint enum, ALPN collisions, geosite/" +
+            "geoip catalogue check, protocol×transport×security compatibility matrix, " +
+            "private LAN block rule, sniffing on 80/443, etc. ~20 rules in v0.6.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                config: { type: "string", description: "JSON string of the xray config." },
+            },
+            required: ["config"],
+        },
+    },
+    {
+        name: "xray_geo_search",
+        description: "Search the bundled geosite/geoip catalogue for a category by substring. " +
+            "Use to typo-check or discover the right tag (geoip:ru, geosite:youtube, …) " +
+            "before adding it to routing.rules.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                query: { type: "string", description: "Substring to search for, case-insensitive." },
+                max_results: { type: "number", default: 30, minimum: 1, maximum: 100 },
+            },
+            required: ["query"],
+        },
+    },
+    {
+        name: "xray_diff_protocols",
+        description: "Side-by-side comparison of two xray protocols (vless/vmess/trojan/" +
+            "shadowsocks/hysteria2/wireguard) on transports, security, anti-DPI, " +
+            "mobile friendliness, battery, ease. Returns a table-shaped JSON.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                a: { type: "string", description: "First protocol name." },
+                b: { type: "string", description: "Second protocol name." },
+            },
+            required: ["a", "b"],
+        },
+    },
+    {
+        name: "xray_suggest_alternative",
+        description: "Recommend a protocol+transport+security stack for a goal. Goals include " +
+            "anti-dpi-russia, anti-dpi-iran, anti-dpi-china, low-latency, mobile-battery, " +
+            "high-throughput, stealth-cdn, simple-getting-started. Optionally pass " +
+            "current_config to also get a list of issues with what you have today.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                goal: {
+                    type: "string",
+                    enum: [
+                        "anti-dpi-russia",
+                        "anti-dpi-iran",
+                        "anti-dpi-china",
+                        "low-latency",
+                        "mobile-battery",
+                        "high-throughput",
+                        "stealth-cdn",
+                        "simple-getting-started",
+                    ],
+                },
+                current_config: {
+                    type: "string",
+                    description: "Optional JSON string of an existing config to lint alongside.",
+                },
+            },
+            required: ["goal"],
+        },
+    },
+    {
+        name: "xray_github_search",
+        description: "Search GitHub issues, pull requests and discussions across XTLS repositories " +
+            "(Xray-core, REALITY, Xray-docs-next). Returns matched items with title, number, " +
+            "state, updated date, URL, and a short body snippet. Useful for finding " +
+            "state-of-the-art bypass techniques, RKN/TSPU/DPI discussions, protocol " +
+            "comparisons, bug reports. Discussions require GITHUB_TOKEN env var; " +
+            "issues/PRs work anonymously but with a 60/h rate limit.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                query: { type: "string", description: 'Free-text search query, e.g. "REALITY blocked Russia".' },
+                repo: {
+                    type: "string",
+                    enum: ["xray-core", "reality", "xray-docs-next", "all"],
+                    default: "xray-core",
+                    description: "Which XTLS repo to search. 'all' fans out across all three.",
+                },
+                state: {
+                    type: "string",
+                    enum: ["open", "closed", "all"],
+                    default: "all",
+                },
+                type: {
+                    type: "string",
+                    enum: ["issue", "pr", "discussion", "all"],
+                    default: "all",
+                    description: "Filter by item type. 'discussion' uses GraphQL and needs GITHUB_TOKEN.",
+                },
+                sort: {
+                    type: "string",
+                    enum: ["updated", "created", "reactions", "comments"],
+                    default: "updated",
+                },
+                order: { type: "string", enum: ["desc", "asc"], default: "desc" },
+                max_results: { type: "number", default: 10, minimum: 1, maximum: 50 },
+            },
+            required: ["query"],
+        },
+    },
+    {
+        name: "xray_github_fetch_issue",
+        description: "Fetch a specific GitHub issue, pull request or discussion from an XTLS repo " +
+            "with its full body and top comments. Use after xray_github_search points you " +
+            "at something interesting and you need full context.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                repo: {
+                    type: "string",
+                    enum: ["xray-core", "reality", "xray-docs-next"],
+                    default: "xray-core",
+                },
+                number: { type: "number", description: "Issue/PR/discussion number." },
+                type: {
+                    type: "string",
+                    enum: ["issue", "pr", "discussion"],
+                    default: "issue",
+                    description: "PR uses the same REST endpoint as issue in GitHub API. Discussion uses GraphQL and needs GITHUB_TOKEN.",
+                },
+                max_comments: {
+                    type: "number",
+                    default: 10,
+                    minimum: 0,
+                    maximum: 50,
+                    description: "How many comments to include. 0 = none.",
+                },
+            },
+            required: ["number"],
+        },
+    },
+    {
+        name: "xray_refresh_cache",
+        description: "Re-fetch xray docs cache from XTLS/Xray-docs-next on github. Use to " +
+            "actualize docs when upstream changed (e.g. new transport added, page " +
+            "rewritten). Returns per-topic status and updated count.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                scope: {
+                    type: "string",
+                    enum: ["all", "stale", "category"],
+                    default: "stale",
+                    description: "'all' = refetch every page (~60). 'stale' = only entries older than max_age_days. 'category' = restrict to one category (requires `category`).",
+                },
+                category: {
+                    type: "string",
+                    enum: ["basic", "features", "inbounds", "outbounds", "transports"],
+                    description: "Required when scope=category.",
+                },
+                max_age_days: {
+                    type: "number",
+                    minimum: 1,
+                    maximum: 365,
+                    default: 30,
+                    description: "For scope=stale: refetch entries older than this.",
+                },
+                discover: {
+                    type: "boolean",
+                    default: false,
+                    description: "Also call the github tree API and return slugs that exist upstream but are not in DOCS_CATALOGUE (for manual addition to src/docs.ts).",
+                },
+            },
+        },
+    },
+    {
+        name: "xray_merge_configs",
+        description: "Merge two or more xray JSON configs. Concatenates inbounds/outbounds/" +
+            "routing.rules/dns.servers, auto-renames colliding tags with a -2/-3 suffix " +
+            "and warns. Singleton blocks (log, policy, api, …) keep the first occurrence " +
+            "and warn on disagreement. Returns merged JSON + list of warnings.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                configs: {
+                    type: "array",
+                    items: { type: "string" },
+                    minItems: 2,
+                    description: "Array of xray config JSON strings.",
+                },
+            },
+            required: ["configs"],
+        },
+    },
+];
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

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

package/dist/tools_impl/diff.js

@@ -0,0 +1,55 @@
+/*
+ * xray_diff_protocols — side-by-side comparison of two protocols.
+ *
+ * Output is plain JSON the agent can render as a table. No markdown formatting
+ * here so callers can pretty-print however they like.
+ */
+import { matrix, protocolFeatures } from "../data/compatibility.js";
+const featureOrder = [
+    { key: "transports", label: "Transports" },
+    { key: "security", label: "Security" },
+    { key: "multiplexing", label: "Multiplexing (xmux/grpc)" },
+    { key: "padding", label: "Built-in padding" },
+    { key: "antiDpi", label: "Anti-DPI rating (1-5)" },
+    { key: "mobileFriendly", label: "Mobile friendliness (1-5)" },
+    { key: "battery", label: "Battery score (1-5, higher=better)" },
+    { key: "ease", label: "Ease of setup (1-5)" },
+    { key: "notes", label: "Notes" },
+];
+function fmt(v) {
+    if (Array.isArray(v))
+        return v.join(", ");
+    if (typeof v === "string" || typeof v === "number" || typeof v === "boolean")
+        return v;
+    return String(v);
+}
+export function diffProtocols(a, b) {
+    const fa = protocolFeatures[a];
+    const fb = protocolFeatures[b];
+    if (!fa)
+        throw new Error(`unknown protocol "${a}"; known: ${Object.keys(protocolFeatures).join(", ")}`);
+    if (!fb)
+        throw new Error(`unknown protocol "${b}"; known: ${Object.keys(protocolFeatures).join(", ")}`);
+    const rows = [];
+    for (const { key, label } of featureOrder) {
+        const va = fa[key];
+        const vb = fb[key];
+        rows.push({
+            feature: label,
+            a: fmt(va),
+            b: fmt(vb),
+            same: JSON.stringify(va) === JSON.stringify(vb),
+        });
+    }
+    const ma = matrix[a];
+    const mb = matrix[b];
+    const summary = [
+        `${a} ↔ ${b}: `,
+        ma && mb
+            ? `${a} supports ${ma.security.join("/")}; ${b} supports ${mb.security.join("/")}.`
+            : "(matrix incomplete)",
+        ` ${a} score (anti-DPI×mobile×battery) = ${fa.antiDpi * fa.mobileFriendly * fa.battery}, ${b} = ${fb.antiDpi * fb.mobileFriendly * fb.battery}.`,
+    ].join("");
+    return { a, b, rows, summary };
+}
+//# sourceMappingURL=diff.js.map

package/dist/tools_impl/diff.js.map

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