ictrp-mcp-server 0.1.0

package/dist/runtime/env-probe.js

@@ -0,0 +1,479 @@
+/**
+ * Read-only environment inspection.
+ *
+ * This module never writes to disk and never starts a process that can modify
+ * state. It answers one question -- "could this package do its job right now?"
+ * -- and it answers it without side effects, because it is called by installers,
+ * by `doctor`, and by an MCP tool that a language model may invoke at any time.
+ *
+ * Three separate readiness notions exist here and they are deliberately not the
+ * same thing:
+ *
+ *   - `canRunOnline`  -- a venv with the vendored package installed exists, so
+ *                        a live ICTRP search is possible.
+ *   - `canRunOffline` -- a bundled snapshot is present, so *something* can be
+ *                        answered with no network and no Python at all... almost.
+ *                        In practice the offline path also goes through Python,
+ *                        so this is reported for operator information.
+ *   - `ready`         -- what a client should check before enabling the server.
+ *
+ * Collapsing them into one boolean would make `doctor` unable to say *why* an
+ * installation is not usable, which is the only reason it exists.
+ */
+import { execFile } from "node:child_process";
+import { accessSync, constants, existsSync, readFileSync, statSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+/** Minimum Python the vendored package supports. Mirrors pyproject.toml. */
+export const MIN_PYTHON = [3, 10];
+/**
+ * Keep this list in sync with the `dependencies` in the Python package's
+ * pyproject.toml. A module missing here is a module the sidecar will fail to
+ * import at runtime, with a much worse error message.
+ */
+export const PYTHON_MODULES = ["mcp", "httpx", "pydantic"];
+/** Per-command timeout for the helper process spawns below. */
+export const PROBE_TIMEOUT_MS = 8_000;
+/** How long a computed report stays fresh before it is recomputed. */
+export const PROBE_TTL_MS = 30_000;
+// ---------------------------------------------------------------------------
+// Path resolution
+//
+// The package is used from three places: the repository itself (src/ and
+// dist/ both present), a global npm install (dist/ only), and a vendored copy
+// inside a desktop plugin. `packageRoot` therefore searches rather than
+// assuming, and scores candidates so that the repository root wins over a
+// coincidentally-shaped parent directory.
+// ---------------------------------------------------------------------------
+function looksLikeProjectRoot(dir) {
+    let score = 0;
+    const pkg = path.join(dir, "package.json");
+    const sidecar = path.join(dir, "sidecar", "ictrp_sidecar.py");
+    if (existsSync(pkg))
+        score += 1;
+    if (existsSync(sidecar))
+        score += 1;
+    if (score === 0)
+        return 0;
+    try {
+        const parsed = JSON.parse(readFileSync(pkg, "utf8"));
+        // A directory that merely happens to hold a package.json and a sidecar/
+        // is a weaker candidate than the real thing.
+        if (parsed.name === "ictrp-mcp-server")
+            score += 1;
+    }
+    catch {
+        /* an unreadable or malformed package.json just scores lower */
+    }
+    return score;
+}
+let cachedRoot;
+/**
+ * Where the *code* lives: the installed package directory, containing
+ * `sidecar/` and `package.json`.
+ *
+ * This is deliberately NOT affected by `ICTRP_HOME`. Code location and
+ * writable-state location are different questions, and conflating them breaks
+ * the packaged case: an Electron host sets `ICTRP_HOME` to its private data
+ * directory, and if that also redirected this lookup the sidecar script would
+ * be searched for inside an empty data directory. It would not be found, and
+ * the failure would present as "the package is incomplete" -- pointing at the
+ * wrong problem entirely.
+ */
+export function packageRoot() {
+    if (cachedRoot)
+        return cachedRoot;
+    const here = path.dirname(fileURLToPath(import.meta.url));
+    // From dist/runtime/ this is the package root; from src/runtime/ it is one
+    // level further up because TypeScript compiles two levels deep.
+    const candidates = [
+        path.resolve(here, "..", ".."),
+        path.resolve(here, "..", "..", ".."),
+    ];
+    let best = candidates[0];
+    let bestScore = -1;
+    for (const candidate of candidates) {
+        const score = looksLikeProjectRoot(candidate);
+        if (score > bestScore) {
+            bestScore = score;
+            best = candidate;
+        }
+    }
+    cachedRoot = best;
+    return cachedRoot;
+}
+/**
+ * Where writable state goes: virtualenv, snapshots, scratch files.
+ *
+ * Overridable with `ICTRP_HOME`, which the desktop integration sets to the
+ * application's private data directory so that a read-only package directory
+ * (an asar archive, a system-path global install) is never written to.
+ * Defaults to the package root, which is correct for a normal npm install.
+ */
+export function stateRoot() {
+    const override = process.env.ICTRP_HOME;
+    if (override && override.trim())
+        return path.resolve(override.trim());
+    return packageRoot();
+}
+/**
+ * @deprecated Use {@link packageRoot} for code or {@link stateRoot} for
+ * writable state. Kept because it is re-exported from the package entry point;
+ * it resolves to the code location, which is the answer most callers wanted.
+ */
+export function projectRoot() {
+    return packageRoot();
+}
+export function venvDir() {
+    const override = process.env.ICTRP_VENV;
+    if (override && override.trim())
+        return path.resolve(override.trim());
+    // Writable state, so it follows ICTRP_HOME.
+    return path.join(stateRoot(), ".venv");
+}
+export function venvPython() {
+    const dir = venvDir();
+    return process.platform === "win32"
+        ? path.join(dir, "Scripts", "python.exe")
+        : path.join(dir, "bin", "python3");
+}
+export function sidecarScript() {
+    // Shipped code, so it follows the package -- never ICTRP_HOME.
+    return path.join(packageRoot(), "sidecar", "ictrp_sidecar.py");
+}
+/** Where the Node layer caches materialized sets between sidecar restarts. */
+export function nodeCacheDir() {
+    const override = process.env.ICTRP_NODE_CACHE_DIR;
+    if (override && override.trim())
+        return path.resolve(override.trim());
+    return path.join(stateRoot(), ".cache");
+}
+// ---------------------------------------------------------------------------
+// Probes
+// ---------------------------------------------------------------------------
+async function run(cmd, args, timeout = PROBE_TIMEOUT_MS) {
+    try {
+        const { stdout, stderr } = await execFileAsync(cmd, args, {
+            timeout,
+            windowsHide: true,
+            env: { ...process.env, PYTHONUNBUFFERED: "1" },
+        });
+        return { ok: true, stdout, stderr };
+    }
+    catch (err) {
+        const e = err;
+        return { ok: false, stdout: e.stdout ?? "", stderr: e.stderr ?? e.message ?? "" };
+    }
+}
+function probeNode() {
+    const major = Number.parseInt(process.versions.node.split(".")[0] ?? "0", 10);
+    if (major >= 20) {
+        return { status: "ok", detail: `node ${process.versions.node}` };
+    }
+    return {
+        status: "outdated",
+        detail: `node ${process.versions.node}`,
+        hint: "Node 20 or newer is required.",
+    };
+}
+async function probeVenv() {
+    const python = venvPython();
+    if (!existsSync(python)) {
+        return {
+            check: {
+                status: "missing",
+                detail: `no interpreter at ${python}`,
+                hint: "Run `npx ictrp-setup setup` to create the private environment.",
+            },
+        };
+    }
+    const result = await run(python, ["--version"]);
+    const text = `${result.stdout}${result.stderr}`.trim();
+    if (!result.ok) {
+        return {
+            check: {
+                status: "error",
+                detail: `interpreter failed to run: ${text || "no output"}`,
+                hint: "The virtual environment is present but broken. Re-run `ictrp-setup setup`.",
+            },
+        };
+    }
+    const match = /(\d+)\.(\d+)/.exec(text);
+    if (!match) {
+        return { check: { status: "unknown", detail: text || "unparseable version" } };
+    }
+    const version = [Number(match[1]), Number(match[2])];
+    const tooOld = version[0] < MIN_PYTHON[0] ||
+        (version[0] === MIN_PYTHON[0] && version[1] < MIN_PYTHON[1]);
+    if (tooOld) {
+        return {
+            version,
+            check: {
+                status: "outdated",
+                detail: `python ${version[0]}.${version[1]} in venv`,
+                hint: `Python ${MIN_PYTHON[0]}.${MIN_PYTHON[1]}+ is required. Recreate the venv with a newer interpreter.`,
+            },
+        };
+    }
+    return { check: { status: "ok", detail: `python ${version[0]}.${version[1]}` }, version };
+}
+/**
+ * Are the vendored package's dependencies importable?
+ *
+ * `importlib.util.find_spec` rather than `pip show`, because it consults the
+ * actual import system: it needs no network, it is fast, and it reports what
+ * the sidecar would really experience rather than what pip believes it
+ * installed.
+ */
+async function probePythonDeps(venvOk) {
+    if (!venvOk) {
+        return { status: "unknown", detail: "no usable venv to inspect" };
+    }
+    const script = "import importlib.util as u,json,sys;" +
+        `mods=${JSON.stringify(PYTHON_MODULES)};` +
+        "missing=[m for m in mods if u.find_spec(m) is None];" +
+        "print(json.dumps(missing))";
+    const result = await run(venvPython(), ["-c", script]);
+    if (!result.ok) {
+        return {
+            status: "error",
+            detail: `could not inspect modules: ${result.stderr.trim() || "no output"}`,
+            hint: "Re-run `ictrp-setup setup`.",
+        };
+    }
+    let missing = [];
+    try {
+        const parsed = JSON.parse(result.stdout.trim());
+        if (Array.isArray(parsed))
+            missing = parsed.filter((x) => typeof x === "string");
+    }
+    catch {
+        return { status: "unknown", detail: `unparseable probe output: ${result.stdout.trim()}` };
+    }
+    if (missing.length === 0) {
+        return { status: "ok", detail: `all present (${PYTHON_MODULES.join(", ")})` };
+    }
+    return {
+        status: "missing",
+        detail: `missing: ${missing.join(", ")}`,
+        hint: "Run `npx ictrp-setup setup` to install them into the private venv.",
+    };
+}
+function probeSidecarScript() {
+    const script = sidecarScript();
+    if (!existsSync(script)) {
+        return {
+            status: "missing",
+            detail: `no sidecar at ${script}`,
+            hint: "The package is incomplete; reinstall it.",
+        };
+    }
+    return { status: "ok", detail: script };
+}
+/**
+ * Is the sidecar answering?
+ *
+ * "Not running" is reported as `missing`, not `unknown`: unlike a disabled
+ * optional feature, a non-answering sidecar means every network-backed tool
+ * call will fail. The caller may still choose to start it.
+ */
+async function probeSidecar() {
+    const url = `${sidecarBaseUrl()}/health`;
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), PROBE_TIMEOUT_MS);
+    try {
+        const res = await fetch(url, { signal: controller.signal });
+        if (!res.ok) {
+            return {
+                status: "error",
+                detail: `health returned HTTP ${res.status}`,
+                hint: "The sidecar is running but unhealthy. Check its log output.",
+            };
+        }
+        const body = (await res.json());
+        return {
+            status: "ok",
+            detail: `python ${body.python ?? "?"}, ${body.sets_held ?? 0} set(s) held`,
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            status: "missing",
+            detail: `not answering at ${url} (${message})`,
+            hint: "Start it with `npx ictrp-setup sidecar`, or let the server start it automatically.",
+        };
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+export function sidecarBaseUrl() {
+    const raw = process.env.ICTRP_SIDECAR_URL?.trim() || "http://127.0.0.1:8849";
+    return raw.replace(/\/+$/, "");
+}
+// ---------------------------------------------------------------------------
+// Report assembly
+// ---------------------------------------------------------------------------
+let cachedReport;
+let inFlight;
+export function invalidateEnvReport() {
+    cachedReport = undefined;
+}
+/**
+ * Build the environment report.
+ *
+ * Concurrent calls share one in-flight probe: an installer that fires several
+ * checks at once, or a client that renders several status rows, must not spawn
+ * a dozen Python processes.
+ */
+export async function getEnvReport(force = false) {
+    if (!force && cachedReport && Date.now() - cachedReport.at < PROBE_TTL_MS) {
+        return cachedReport.report;
+    }
+    if (!force && inFlight)
+        return inFlight;
+    const promise = buildReport();
+    if (!force) {
+        inFlight = promise;
+        promise.finally(() => {
+            if (inFlight === promise)
+                inFlight = undefined;
+        });
+    }
+    const report = await promise;
+    cachedReport = { at: Date.now(), report };
+    return report;
+}
+async function buildReport() {
+    const node = probeNode();
+    const { check: venv } = await probeVenv();
+    const pythonVersion = venv.status === "ok" || venv.status === "outdated"
+        ? { status: venv.status, detail: venv.detail, hint: venv.hint }
+        : { status: venv.status === "missing" ? "missing" : "unknown", detail: venv.detail };
+    const pythonDeps = await probePythonDeps(venv.status === "ok");
+    const script = probeSidecarScript();
+    const sidecar = await probeSidecar();
+    // Can this install do network work *right now*?
+    //
+    // Two independent routes reach the same answer, and either is sufficient:
+    //   * the sidecar is already answering -- it does not matter whether this
+    //     checkout has a venv, because the running process already has one;
+    //   * a complete local environment exists -- the supervisor will spawn the
+    //     sidecar on the first tool call.
+    //
+    // Treating the second as the only path makes `doctor` report "not ready"
+    // while the server is demonstrably serving searches, which is worse than
+    // useless: it sends the user to reinstall something that already works.
+    const canRunOnline = venv.status === "ok" && pythonDeps.status === "ok" && script.status === "ok";
+    const sidecarRunning = sidecar.status === "ok";
+    const ready = canRunOnline || sidecarRunning;
+    const actions = suggestActions({ node, venv, pythonDeps, script, sidecar, ready });
+    return {
+        root: packageRoot(),
+        platform: `${process.platform}-${process.arch}`,
+        node,
+        venv,
+        pythonVersion,
+        pythonDeps,
+        sidecarScript: script,
+        sidecar,
+        canRunOnline,
+        sidecarRunning,
+        ready,
+        summary: summarize({ ready, sidecarRunning, actions }),
+        actions,
+    };
+}
+function suggestActions(parts) {
+    const actions = [];
+    if (parts.node.status !== "ok") {
+        actions.push("Install Node.js 20 or newer.");
+    }
+    if (parts.script.status !== "ok") {
+        actions.push("Reinstall the package: the bundled sidecar script is missing.");
+    }
+    if (parts.venv.status === "missing") {
+        actions.push("Run `npx ictrp-setup setup` to create the private Python environment.");
+    }
+    else if (parts.venv.status === "outdated" || parts.venv.status === "error") {
+        actions.push("Recreate the private Python environment: `rm -rf .venv && npx ictrp-setup setup`.");
+    }
+    else if (parts.pythonDeps.status === "missing") {
+        actions.push("Run `npx ictrp-setup setup` to install the missing Python dependencies.");
+    }
+    // Only mention the sidecar when everything it depends on is in place;
+    // otherwise this would be noise on top of a more fundamental problem.
+    if (parts.ready && parts.sidecar.status !== "ok") {
+        actions.push("The sidecar is not running; it will be started on first use.");
+    }
+    return actions;
+}
+function summarize(state) {
+    if (state.sidecarRunning) {
+        return "就绪：sidecar 正在运行，检索可用（纯 HTTP，无浏览器）。";
+    }
+    if (state.ready) {
+        return "就绪：环境完整，sidecar 将在首次调用时自动启动。";
+    }
+    if (state.actions.length > 0) {
+        return `未就绪，需要 ${state.actions.length} 项动作。`;
+    }
+    return "未就绪。";
+}
+const ICONS = {
+    ok: "✅",
+    missing: "❌",
+    outdated: "⚠️",
+    error: "❌",
+    unknown: "➖",
+};
+export function formatEnvReport(report) {
+    const lines = [];
+    const rows = [
+        ["node", report.node],
+        ["venv", report.venv],
+        ["python", report.pythonVersion],
+        ["deps", report.pythonDeps],
+        ["sidecar script", report.sidecarScript],
+        ["sidecar", report.sidecar],
+    ];
+    lines.push(`项目根目录: ${report.root}`);
+    lines.push(`平台: ${report.platform}`);
+    lines.push("");
+    for (const [label, check] of rows) {
+        lines.push(`${ICONS[check.status]} ${label}: ${check.detail}`);
+    }
+    lines.push("");
+    lines.push(`就绪: ${report.ready ? "是" : "否"}`);
+    lines.push(report.summary);
+    const hints = [...new Set(rows.map(([, c]) => c.hint).filter((h) => !!h))];
+    if (hints.length > 0) {
+        lines.push("");
+        lines.push("建议:");
+        for (const hint of hints)
+            lines.push(`  - ${hint}`);
+    }
+    return lines.join("\n");
+}
+/** True when a path exists and is writable, used by the installer. */
+export function isWritable(dir) {
+    try {
+        const stat = statSync(dir);
+        if (!stat.isDirectory())
+            return false;
+    }
+    catch {
+        return false;
+    }
+    try {
+        accessSync(dir, constants.W_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=env-probe.js.map

package/dist/runtime/env-probe.js.map

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

package/dist/runtime/sidecar-client.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Node -> Python sidecar HTTP client.
+ *
+ * Contract: this module **fails fast and returns a result object, it never
+ * throws**. Callers decide whether a failed call is fatal, retryable, or
+ * irrelevant. Throwing here would force every call site into a try/catch and
+ * would tempt someone to write an empty catch that silently converts an
+ * upstream failure into "no results" -- the exact failure mode this whole
+ * project exists to prevent.
+ */
+/** Search drives a multi-megabyte export; it needs a much larger budget. */
+export declare const SEARCH_TIMEOUT_MS = 180000;
+export interface SidecarOk<T> {
+    ok: true;
+    data: T;
+}
+export interface SidecarErr {
+    ok: false;
+    /** Machine-readable code: an ICTRP ErrorCode, or a transport-level one. */
+    code: string;
+    message: string;
+    httpStatus?: number;
+    retryable: boolean;
+    hint?: string;
+}
+export type SidecarResult<T> = SidecarOk<T> | SidecarErr;
+export declare function lastSidecarError(): string | undefined;
+/**
+ * Call one sidecar endpoint.
+ *
+ * `opts.timeoutMs` overrides the environment default for this call only, which
+ * is how `/search` gets its much larger budget without changing the global.
+ */
+export declare function callSidecar<T>(endpoint: string, params?: Record<string, unknown>, opts?: {
+    timeoutMs?: number;
+    method?: "GET" | "POST";
+}): Promise<SidecarResult<T>>;
+export interface HealthPayload {
+    ok: boolean;
+    service: string;
+    version: string;
+    python: string;
+    cache_dir: string;
+    sets_held: number;
+    upstream: string;
+    browser_required: boolean;
+}
+export declare function pingSidecar(): Promise<SidecarResult<HealthPayload>>;
+/** Convert a failure into text safe to hand to a model, preserving the code. */
+export declare function toErrorText(err: SidecarErr): string;

package/dist/runtime/sidecar-client.js

@@ -0,0 +1,120 @@
+/**
+ * Node -> Python sidecar HTTP client.
+ *
+ * Contract: this module **fails fast and returns a result object, it never
+ * throws**. Callers decide whether a failed call is fatal, retryable, or
+ * irrelevant. Throwing here would force every call site into a try/catch and
+ * would tempt someone to write an empty catch that silently converts an
+ * upstream failure into "no results" -- the exact failure mode this whole
+ * project exists to prevent.
+ */
+import { sidecarBaseUrl } from "./env-probe.js";
+const DEFAULT_TIMEOUT_MS = 30_000;
+/** Search drives a multi-megabyte export; it needs a much larger budget. */
+export const SEARCH_TIMEOUT_MS = 180_000;
+let lastError;
+export function lastSidecarError() {
+    return lastError;
+}
+function timeoutFromEnv() {
+    const raw = process.env.ICTRP_SIDECAR_TIMEOUT_MS;
+    if (!raw)
+        return DEFAULT_TIMEOUT_MS;
+    const parsed = Number(raw);
+    if (!Number.isFinite(parsed) || parsed <= 0)
+        return DEFAULT_TIMEOUT_MS;
+    return parsed;
+}
+/**
+ * Call one sidecar endpoint.
+ *
+ * `opts.timeoutMs` overrides the environment default for this call only, which
+ * is how `/search` gets its much larger budget without changing the global.
+ */
+export async function callSidecar(endpoint, params = {}, opts = {}) {
+    const base = sidecarBaseUrl();
+    const url = `${base}${endpoint}`;
+    const timeoutMs = opts.timeoutMs ?? timeoutFromEnv();
+    const method = opts.method ?? "POST";
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const init = {
+            method,
+            signal: controller.signal,
+            headers: { Accept: "application/json" },
+        };
+        if (method === "POST") {
+            init.headers["Content-Type"] = "application/json";
+            init.body = JSON.stringify(params);
+        }
+        const res = await fetch(url, init);
+        const text = await res.text();
+        let body;
+        try {
+            body = JSON.parse(text);
+        }
+        catch {
+            lastError = `sidecar 返回非 JSON（HTTP ${res.status}）: ${text.slice(0, 200)}`;
+            return {
+                ok: false,
+                code: "SIDECAR_PROTOCOL_ERROR",
+                message: lastError,
+                httpStatus: res.status,
+                retryable: false,
+                hint: "The sidecar responded with something that is not JSON. Check its log output.",
+            };
+        }
+        const obj = body;
+        if (res.ok && obj["ok"] !== false) {
+            return { ok: true, data: body };
+        }
+        // The sidecar always names the failure. If it somehow does not, say so
+        // rather than inventing a code.
+        const code = typeof obj["error_code"] === "string" ? obj["error_code"] : `HTTP_${res.status}`;
+        const message = typeof obj["message"] === "string"
+            ? obj["message"]
+            : typeof obj["error"] === "string"
+                ? obj["error"]
+                : `sidecar returned HTTP ${res.status}`;
+        lastError = message;
+        const result = {
+            ok: false,
+            code,
+            message,
+            httpStatus: res.status,
+            retryable: obj["retryable"] === true,
+        };
+        if (typeof obj["hint"] === "string")
+            result.hint = obj["hint"];
+        return result;
+    }
+    catch (err) {
+        const isAbort = err instanceof Error && err.name === "AbortError";
+        const message = isAbort
+            ? `sidecar 调用超时（${timeoutMs}ms）: ${endpoint}`
+            : `无法连接 sidecar（${url}）: ${err instanceof Error ? err.message : String(err)}`;
+        lastError = message;
+        return {
+            ok: false,
+            code: isAbort ? "SIDECAR_TIMEOUT" : "SIDECAR_UNREACHABLE",
+            message,
+            retryable: true,
+            hint: "Start the sidecar with `npx ictrp-setup sidecar`, or let the server start it automatically.",
+        };
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+export async function pingSidecar() {
+    return callSidecar("/health", {}, { method: "GET", timeoutMs: 3_000 });
+}
+/** Convert a failure into text safe to hand to a model, preserving the code. */
+export function toErrorText(err) {
+    const lines = [`${err.code}: ${err.message}`];
+    if (err.hint)
+        lines.push(`hint: ${err.hint}`);
+    return lines.join("\n");
+}
+//# sourceMappingURL=sidecar-client.js.map