mcp-xray-pilot 0.10.0

package/dist/tools_impl/github.js

@@ -0,0 +1,416 @@
+/*
+ * xray_github_search + xray_github_fetch_issue.
+ *
+ * Thin wrapper over the GitHub REST search API for issues/PRs and the
+ * GraphQL endpoint for discussions. No third-party deps — node 18+ ships
+ * `fetch` natively.
+ *
+ * Auth: optional. If `process.env.GITHUB_TOKEN` is set, it is sent as
+ * `Authorization: Bearer …` which raises the unauth rate limit from 60/h
+ * to 5000/h and is *required* for discussions (GraphQL).
+ *
+ * Rate-limit warnings are surfaced inline in the response when
+ * `X-RateLimit-Remaining` < 10.
+ */
+const USER_AGENT = "mcp-xray-pilot/0.10";
+const REPO_MAP = {
+    "xray-core": "XTLS/Xray-core",
+    reality: "XTLS/REALITY",
+    "xray-docs-next": "XTLS/Xray-docs-next",
+};
+function authHeaders() {
+    const h = {
+        "User-Agent": USER_AGENT,
+        Accept: "application/vnd.github+json",
+        "X-GitHub-Api-Version": "2022-11-28",
+    };
+    const tok = process.env.GITHUB_TOKEN;
+    if (tok && tok.trim())
+        h.Authorization = `Bearer ${tok.trim()}`;
+    return h;
+}
+function rateLimitWarning(res) {
+    const remaining = Number(res.headers.get("x-ratelimit-remaining") ?? "");
+    if (Number.isFinite(remaining) && remaining < 10) {
+        const reset = res.headers.get("x-ratelimit-reset");
+        const hint = process.env.GITHUB_TOKEN
+            ? ""
+            : " (set GITHUB_TOKEN env var to raise limit from 60/h to 5000/h)";
+        return `GitHub rate limit nearly exhausted: ${remaining} remaining (resets at unix=${reset})${hint}`;
+    }
+    return null;
+}
+function snippet(body, n = 240) {
+    if (!body)
+        return "";
+    const flat = body.replace(/\s+/g, " ").trim();
+    return flat.length <= n ? flat : flat.slice(0, n - 1) + "…";
+}
+function sumReactions(reactions) {
+    if (!reactions)
+        return 0;
+    const total = reactions.total_count;
+    if (typeof total === "number")
+        return total;
+    let s = 0;
+    for (const [k, v] of Object.entries(reactions)) {
+        if (k === "url")
+            continue;
+        if (typeof v === "number")
+            s += v;
+    }
+    return s;
+}
+async function ghJson(url) {
+    const res = await fetch(url, { headers: authHeaders() });
+    const warning = rateLimitWarning(res);
+    if (!res.ok) {
+        const txt = await res.text().catch(() => "");
+        let hint = "";
+        if (res.status === 403) {
+            hint = process.env.GITHUB_TOKEN
+                ? " (token may lack scope or be invalid)"
+                : " — likely rate limit; set GITHUB_TOKEN env var to raise to 5000/h";
+        }
+        else if (res.status === 404) {
+            hint = " — repo or item does not exist";
+        }
+        throw new Error(`GitHub API ${res.status} ${res.statusText} for ${url}${hint}\n${txt.slice(0, 300)}`);
+    }
+    const data = await res.json();
+    return { data, warning, status: res.status, raw: res };
+}
+async function ghGraphQL(query, variables) {
+    if (!process.env.GITHUB_TOKEN) {
+        throw new Error("GitHub Discussions require a GITHUB_TOKEN env variable (GraphQL API has no anonymous access)");
+    }
+    const res = await fetch("https://api.github.com/graphql", {
+        method: "POST",
+        headers: {
+            ...authHeaders(),
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify({ query, variables }),
+    });
+    if (!res.ok) {
+        const txt = await res.text().catch(() => "");
+        throw new Error(`GitHub GraphQL ${res.status} ${res.statusText}: ${txt.slice(0, 300)}`);
+    }
+    const json = (await res.json());
+    if (json.errors && json.errors.length) {
+        throw new Error(`GitHub GraphQL errors: ${json.errors.map((e) => e.message).join("; ")}`);
+    }
+    return json.data;
+}
+function repoFromUrl(repoUrl, fallback) {
+    if (!repoUrl)
+        return fallback;
+    /* repository_url shape: https://api.github.com/repos/OWNER/NAME */
+    const m = repoUrl.match(/repos\/([^/]+\/[^/]+)$/);
+    return m ? m[1] : fallback;
+}
+async function searchIssuesOneRepo(repoFull, params) {
+    const qParts = [params.query.trim(), `repo:${repoFull}`];
+    if (params.type === "issue")
+        qParts.push("is:issue");
+    else if (params.type === "pr")
+        qParts.push("is:pr");
+    if (params.state && params.state !== "all")
+        qParts.push(`state:${params.state}`);
+    const q = qParts.join(" ");
+    const per = Math.min(params.max_results ?? 10, 50);
+    const sort = params.sort ?? "updated";
+    const order = params.order ?? "desc";
+    const url = `https://api.github.com/search/issues?q=${encodeURIComponent(q)}` +
+        `&sort=${sort}&order=${order}&per_page=${per}`;
+    const { data, warning } = await ghJson(url);
+    const d = data;
+    const hits = (d.items || []).map((it) => ({
+        repo: repoFromUrl(it.repository_url, repoFull),
+        type: it.pull_request ? "pr" : "issue",
+        number: it.number,
+        title: it.title,
+        state: it.state,
+        url: it.html_url,
+        created_at: it.created_at,
+        updated_at: it.updated_at,
+        comments: it.comments,
+        reactions: sumReactions(it.reactions),
+        author: it.user?.login ?? "unknown",
+        body_snippet: snippet(it.body ?? ""),
+    }));
+    return { items: hits, total: d.total_count ?? hits.length, warning };
+}
+async function searchDiscussionsOneRepo(repoFull, params) {
+    const per = Math.min(params.max_results ?? 10, 50);
+    const stateFilter = params.state === "open" ? " is:open" : params.state === "closed" ? " is:closed" : "";
+    const q = `${params.query.trim()} repo:${repoFull}${stateFilter}`;
+    const query = `
+    query($q: String!, $first: Int!) {
+      search(query: $q, type: DISCUSSION, first: $first) {
+        discussionCount
+        nodes {
+          ... on Discussion {
+            number
+            title
+            url
+            createdAt
+            updatedAt
+            bodyText
+            closed
+            comments { totalCount }
+            reactions { totalCount }
+            author { login }
+            repository { nameWithOwner }
+          }
+        }
+      }
+    }`;
+    const data = (await ghGraphQL(query, { q, first: per }));
+    const nodes = data.search?.nodes ?? [];
+    const items = nodes.map((n) => ({
+        repo: n.repository?.nameWithOwner ?? repoFull,
+        type: "discussion",
+        number: n.number,
+        title: n.title,
+        state: n.closed ? "closed" : "open",
+        url: n.url,
+        created_at: n.createdAt,
+        updated_at: n.updatedAt,
+        comments: n.comments?.totalCount ?? 0,
+        reactions: n.reactions?.totalCount ?? 0,
+        author: n.author?.login ?? "unknown",
+        body_snippet: snippet(n.bodyText ?? ""),
+    }));
+    return { items, total: data.search?.discussionCount ?? items.length };
+}
+export async function searchGithub(params) {
+    if (!params.query || !params.query.trim()) {
+        throw new Error("`query` is required");
+    }
+    const repoKey = params.repo ?? "xray-core";
+    const type = params.type ?? "all";
+    const repos = repoKey === "all" ? Object.keys(REPO_MAP) : [repoKey];
+    const warnings = [];
+    const tasks = [];
+    for (const r of repos) {
+        const repoFull = REPO_MAP[r];
+        if (type === "discussion") {
+            tasks.push(searchDiscussionsOneRepo(repoFull, params));
+        }
+        else if (type === "all") {
+            tasks.push(searchIssuesOneRepo(repoFull, params).then((x) => {
+                if (x.warning)
+                    warnings.push(x.warning);
+                return { items: x.items, total: x.total };
+            }));
+            /* discussions only if we have a token; otherwise skip silently with warn */
+            if (process.env.GITHUB_TOKEN) {
+                tasks.push(searchDiscussionsOneRepo(repoFull, params).catch((e) => {
+                    warnings.push(`discussion search failed for ${repoFull}: ${e.message}`);
+                    return { items: [], total: 0 };
+                }));
+            }
+            else {
+                warnings.push(`discussions skipped for ${repoFull} (no GITHUB_TOKEN; GraphQL needs auth)`);
+            }
+        }
+        else {
+            tasks.push(searchIssuesOneRepo(repoFull, params).then((x) => {
+                if (x.warning)
+                    warnings.push(x.warning);
+                return { items: x.items, total: x.total };
+            }));
+        }
+    }
+    const results = await Promise.all(tasks);
+    let allHits = [];
+    let totalSum = 0;
+    for (const r of results) {
+        allHits = allHits.concat(r.items);
+        totalSum += r.total;
+    }
+    /* Sort merged across repos. Default sort=updated desc. */
+    const sortKey = params.sort ?? "updated";
+    const order = params.order ?? "desc";
+    const dir = order === "asc" ? 1 : -1;
+    allHits.sort((a, b) => {
+        let av = 0;
+        let bv = 0;
+        if (sortKey === "updated") {
+            av = a.updated_at;
+            bv = b.updated_at;
+        }
+        else if (sortKey === "created") {
+            av = a.created_at;
+            bv = b.created_at;
+        }
+        else if (sortKey === "comments") {
+            av = a.comments;
+            bv = b.comments;
+        }
+        else if (sortKey === "reactions") {
+            av = a.reactions;
+            bv = b.reactions;
+        }
+        if (av < bv)
+            return -1 * dir;
+        if (av > bv)
+            return 1 * dir;
+        return 0;
+    });
+    const limit = params.max_results ?? 10;
+    const truncated = allHits.length > limit;
+    if (truncated)
+        allHits = allHits.slice(0, limit);
+    return {
+        query: params.query,
+        total: totalSum,
+        truncated,
+        warnings: warnings.length ? warnings : undefined,
+        hits: allHits,
+    };
+}
+function reactionsObject(raw) {
+    const out = {};
+    if (!raw)
+        return out;
+    const map = {
+        "+1": "thumbs_up",
+        "-1": "thumbs_down",
+        laugh: "laugh",
+        hooray: "hooray",
+        confused: "confused",
+        heart: "heart",
+        rocket: "rocket",
+        eyes: "eyes",
+        total_count: "total",
+    };
+    for (const [k, v] of Object.entries(raw)) {
+        if (typeof v !== "number")
+            continue;
+        const mapped = map[k] ?? k;
+        out[mapped] = v;
+    }
+    return out;
+}
+async function fetchIssueRest(repoFull, num, maxComments) {
+    const issueUrl = `https://api.github.com/repos/${repoFull}/issues/${num}`;
+    const { data, warning } = await ghJson(issueUrl);
+    const issue = data;
+    const warnings = [];
+    if (warning)
+        warnings.push(warning);
+    let comments = [];
+    if (maxComments > 0) {
+        const cUrl = `${issueUrl}/comments?per_page=${Math.min(maxComments, 50)}`;
+        const { data: cData, warning: cWarn } = await ghJson(cUrl);
+        if (cWarn)
+            warnings.push(cWarn);
+        const arr = cData;
+        comments = arr.map((c) => ({
+            author: c.user?.login ?? "unknown",
+            created_at: c.created_at,
+            body: c.body ?? "",
+        }));
+    }
+    return {
+        repo: repoFull,
+        type: issue.pull_request ? "pr" : "issue",
+        number: issue.number,
+        title: issue.title,
+        state: issue.state,
+        url: issue.html_url,
+        author: issue.user?.login ?? "unknown",
+        created_at: issue.created_at,
+        updated_at: issue.updated_at,
+        body: issue.body ?? "",
+        reactions: reactionsObject(issue.reactions),
+        comments,
+        warnings: warnings.length ? warnings : undefined,
+    };
+}
+async function fetchDiscussionGraphQL(repoFull, num, maxComments) {
+    const [owner, name] = repoFull.split("/");
+    const first = Math.max(0, Math.min(maxComments, 50));
+    const query = `
+    query($owner: String!, $name: String!, $num: Int!, $first: Int!) {
+      repository(owner: $owner, name: $name) {
+        discussion(number: $num) {
+          number
+          title
+          url
+          body
+          createdAt
+          updatedAt
+          closed
+          author { login }
+          reactionGroups { content reactors { totalCount } }
+          comments(first: $first) {
+            nodes {
+              author { login }
+              createdAt
+              body
+            }
+          }
+        }
+      }
+    }`;
+    const data = (await ghGraphQL(query, { owner, name, num, first }));
+    const d = data.repository?.discussion;
+    if (!d)
+        throw new Error(`Discussion #${num} not found in ${repoFull}`);
+    const reactions = {};
+    const reactionMap = {
+        THUMBS_UP: "thumbs_up",
+        THUMBS_DOWN: "thumbs_down",
+        LAUGH: "laugh",
+        HOORAY: "hooray",
+        CONFUSED: "confused",
+        HEART: "heart",
+        ROCKET: "rocket",
+        EYES: "eyes",
+    };
+    let total = 0;
+    for (const g of d.reactionGroups ?? []) {
+        const k = reactionMap[g.content] ?? g.content.toLowerCase();
+        reactions[k] = g.reactors.totalCount;
+        total += g.reactors.totalCount;
+    }
+    reactions.total = total;
+    const comments = (d.comments?.nodes ?? []).map((c) => ({
+        author: c.author?.login ?? "unknown",
+        created_at: c.createdAt,
+        body: c.body ?? "",
+    }));
+    return {
+        repo: repoFull,
+        type: "discussion",
+        number: d.number,
+        title: d.title,
+        state: d.closed ? "closed" : "open",
+        url: d.url,
+        author: d.author?.login ?? "unknown",
+        created_at: d.createdAt,
+        updated_at: d.updatedAt,
+        body: d.body ?? "",
+        reactions,
+        comments,
+    };
+}
+export async function fetchGithubIssue(params) {
+    if (typeof params.number !== "number" || !Number.isFinite(params.number)) {
+        throw new Error("`number` is required and must be a positive integer");
+    }
+    const repoKey = params.repo ?? "xray-core";
+    const repoFull = REPO_MAP[repoKey];
+    if (!repoFull)
+        throw new Error(`Unknown repo: ${repoKey}`);
+    const type = params.type ?? "issue";
+    const maxComments = params.max_comments ?? 10;
+    if (type === "discussion") {
+        return fetchDiscussionGraphQL(repoFull, params.number, maxComments);
+    }
+    return fetchIssueRest(repoFull, params.number, maxComments);
+}
+//# sourceMappingURL=github.js.map

package/dist/tools_impl/github.js.map

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

package/dist/tools_impl/merge.js

@@ -0,0 +1,181 @@
+/*
+ * xray_merge_configs — combine N xray configs into one.
+ *
+ * Strategy:
+ *   - inbounds[]/outbounds[]/routing.rules[]/dns.servers[] are concatenated.
+ *   - Tag conflicts are resolved by suffixing "-2", "-3", … on the second-and-later
+ *     occurrence; warning emitted.
+ *   - Inbound port collisions on the same `listen` (or default 0.0.0.0) → warning.
+ *   - Top-level singletons (log, policy, api, stats, transport, fakeDns,
+ *     observatory) take the value from the FIRST config that has it; warning
+ *     if a later config disagrees.
+ *   - routing.balancers[] concatenated, balancer tag conflict same suffixing.
+ */
+const SINGLETON_KEYS = [
+    "log",
+    "policy",
+    "api",
+    "stats",
+    "transport",
+    "fakeDns",
+    "observatory",
+    "metrics",
+    "reverse",
+    "burstObservatory",
+];
+function isObject(x) {
+    return typeof x === "object" && x !== null && !Array.isArray(x);
+}
+function uniquifyTag(base, used, warnings, source) {
+    if (!used.has(base)) {
+        used.add(base);
+        return base;
+    }
+    let n = 2;
+    while (used.has(`${base}-${n}`))
+        n++;
+    const next = `${base}-${n}`;
+    warnings.push(`tag collision on "${base}" (from ${source}); renamed to "${next}".`);
+    used.add(next);
+    return next;
+}
+export function mergeConfigs(jsonStrings) {
+    const warnings = [];
+    const out = {
+        inbounds: [],
+        outbounds: [],
+    };
+    const usedInboundTags = new Set();
+    const usedOutboundTags = new Set();
+    const usedBalancerTags = new Set();
+    const portsByListen = new Map();
+    const routingRules = [];
+    const routingBalancers = [];
+    let routingMeta = null;
+    const dnsServers = [];
+    let dnsMeta = null;
+    const singletons = {};
+    jsonStrings.forEach((raw, idx) => {
+        let parsed;
+        try {
+            parsed = JSON.parse(raw);
+        }
+        catch (e) {
+            warnings.push(`config[${idx}] failed to parse, skipped: ${e.message}`);
+            return;
+        }
+        if (!isObject(parsed)) {
+            warnings.push(`config[${idx}] is not an object, skipped.`);
+            return;
+        }
+        const source = `config[${idx}]`;
+        /* inbounds */
+        const ib = parsed["inbounds"];
+        if (Array.isArray(ib)) {
+            for (const e of ib) {
+                if (!isObject(e))
+                    continue;
+                const t = e;
+                if (typeof t.tag === "string" && t.tag) {
+                    t.tag = uniquifyTag(t.tag, usedInboundTags, warnings, source);
+                }
+                /* port collision */
+                const listen = typeof e["listen"] === "string" ? e["listen"] : "0.0.0.0";
+                const port = e["port"];
+                if (typeof port === "number" || typeof port === "string") {
+                    let set = portsByListen.get(listen);
+                    if (!set) {
+                        set = new Set();
+                        portsByListen.set(listen, set);
+                    }
+                    if (set.has(port)) {
+                        warnings.push(`inbound port collision: ${listen}:${port} (from ${source}).`);
+                    }
+                    else {
+                        set.add(port);
+                    }
+                }
+                out["inbounds"].push(e);
+            }
+        }
+        /* outbounds */
+        const ob = parsed["outbounds"];
+        if (Array.isArray(ob)) {
+            for (const e of ob) {
+                if (!isObject(e))
+                    continue;
+                const t = e;
+                if (typeof t.tag === "string" && t.tag) {
+                    t.tag = uniquifyTag(t.tag, usedOutboundTags, warnings, source);
+                }
+                out["outbounds"].push(e);
+            }
+        }
+        /* routing */
+        const r = parsed["routing"];
+        if (isObject(r)) {
+            if (!routingMeta) {
+                routingMeta = { ...r };
+                delete routingMeta["rules"];
+                delete routingMeta["balancers"];
+            }
+            if (Array.isArray(r["rules"]))
+                routingRules.push(...r["rules"]);
+            if (Array.isArray(r["balancers"])) {
+                for (const b of r["balancers"]) {
+                    if (!isObject(b))
+                        continue;
+                    const t = b;
+                    if (typeof t.tag === "string" && t.tag) {
+                        t.tag = uniquifyTag(t.tag, usedBalancerTags, warnings, source);
+                    }
+                    routingBalancers.push(b);
+                }
+            }
+        }
+        /* dns */
+        const d = parsed["dns"];
+        if (isObject(d)) {
+            if (!dnsMeta) {
+                dnsMeta = { ...d };
+                delete dnsMeta["servers"];
+            }
+            if (Array.isArray(d["servers"]))
+                dnsServers.push(...d["servers"]);
+        }
+        /* singletons */
+        for (const key of SINGLETON_KEYS) {
+            if (parsed[key] === undefined)
+                continue;
+            if (singletons[key] === undefined) {
+                singletons[key] = { source: idx, value: parsed[key] };
+            }
+            else if (JSON.stringify(singletons[key].value) !== JSON.stringify(parsed[key])) {
+                warnings.push(`singleton "${key}" differs between config[${singletons[key].source}] and config[${idx}]; kept the first.`);
+            }
+        }
+    });
+    /* compose final */
+    for (const key of SINGLETON_KEYS) {
+        if (singletons[key] !== undefined)
+            out[key] = singletons[key].value;
+    }
+    if (routingRules.length > 0 || routingBalancers.length > 0 || routingMeta) {
+        out["routing"] = {
+            ...(routingMeta ?? {}),
+            rules: routingRules,
+            ...(routingBalancers.length ? { balancers: routingBalancers } : {}),
+        };
+    }
+    if (dnsServers.length > 0 || dnsMeta) {
+        out["dns"] = {
+            ...(dnsMeta ?? {}),
+            servers: dnsServers,
+        };
+    }
+    return {
+        merged: JSON.stringify(out, null, 2),
+        warnings,
+    };
+}
+//# sourceMappingURL=merge.js.map

package/dist/tools_impl/merge.js.map

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

package/dist/tools_impl/refresh.js

@@ -0,0 +1,46 @@
+/*
+ * Tool: xray_refresh_cache
+ *
+ * Thin wrapper around docs.refreshDocs() with input validation. The actual
+ * fetch loop lives in src/docs.ts so the CLI script (scripts/fetch-docs.ts)
+ * and the MCP tool share one code path.
+ */
+import { refreshDocs } from "../docs.js";
+const VALID_SCOPES = ["all", "stale", "category"];
+const VALID_CATEGORIES = [
+    "basic",
+    "features",
+    "inbounds",
+    "outbounds",
+    "transports",
+];
+export async function runRefresh(args) {
+    const scope = (args.scope ?? "stale");
+    if (!VALID_SCOPES.includes(scope)) {
+        throw new Error(`Invalid scope "${args.scope}". Expected one of: ${VALID_SCOPES.join(", ")}`);
+    }
+    let category;
+    if (scope === "category") {
+        if (!args.category) {
+            throw new Error("scope=category requires `category`");
+        }
+        if (!VALID_CATEGORIES.includes(args.category)) {
+            throw new Error(`Invalid category "${args.category}". Expected one of: ${VALID_CATEGORIES.join(", ")}`);
+        }
+        category = args.category;
+    }
+    const max_age_days = args.max_age_days ?? 30;
+    if (typeof max_age_days !== "number" ||
+        !Number.isFinite(max_age_days) ||
+        max_age_days < 1 ||
+        max_age_days > 365) {
+        throw new Error("max_age_days must be a number in [1, 365]");
+    }
+    return refreshDocs({
+        scope,
+        category,
+        max_age_days,
+        discover: !!args.discover,
+    });
+}
+//# sourceMappingURL=refresh.js.map