perplexity-user-mcp 0.8.36

package/dist/checks/ide.d.ts

@@ -0,0 +1,89 @@
+const CATEGORY = "ide";
+
+async function run(opts = {}) {
+  const results = [];
+  const statuses = opts.ideStatuses;
+
+  if (!statuses) {
+    results.push({
+      category: CATEGORY,
+      name: "ide-audit",
+      status: "skip",
+      message: "IDE audit requires the VS Code extension (or pass ideStatuses explicitly).",
+    });
+    return results;
+  }
+
+  for (const [id, s] of Object.entries(statuses)) {
+    if (!s.detected) {
+      results.push({ category: CATEGORY, name: id, status: "skip", message: `${s.displayName} not installed` });
+      continue;
+    }
+    if (!s.configured) {
+      results.push({
+        category: CATEGORY,
+        name: id,
+        status: "warn",
+        message: `${s.displayName} installed but Perplexity MCP is not configured.`,
+        hint: "Open the IDEs dashboard tab and click Configure.",
+        action: { label: "Configure", commandId: "Perplexity.generateConfigs", args: [id] },
+      });
+      continue;
+    }
+    // Order of evaluation: stale-args (the launcher path no longer exists)
+    // wins over a bad-command warning. A stale launcher is the higher-impact
+    // breakage — the IDE will fail to spawn anything at all — so the doctor
+    // surfaces that first and elides the command-health note for the same row.
+    if (s.health === "stale") {
+      results.push({
+        category: CATEGORY,
+        name: id,
+        status: "warn",
+        message: `${s.displayName} config is stale.`,
+        hint: "Click Configure to refresh.",
+        action: { label: "Refresh config", commandId: "Perplexity.generateConfigs", args: [id] },
+      });
+      continue;
+    }
+    if (s.commandHealth && s.commandHealth !== "ok") {
+      results.push({
+        category: CATEGORY,
+        name: id,
+        status: "warn",
+        message: `${s.displayName} configured but command path is ${s.commandHealth} — re-run 'Configure for All' to refresh.`,
+        hint: "The MCP config's `command` field doesn't look like a Node.js binary. Re-running Configure rewrites it with a resolved Node path.",
+        action: { label: "Refresh config", commandId: "Perplexity.generateConfigs", args: [id] },
+      });
+      continue;
+    }
+    results.push({ category: CATEGORY, name: id, status: "pass", message: `${s.displayName} configured` });
+  }
+
+  try {
+    const { detectAllViewers } = await import('../viewer-detect.d-HWGnyFAA.d.ts');
+    const viewers = await detectAllViewers();
+    const detected = Object.entries(viewers)
+      .filter(([, present]) => present)
+      .map(([id]) => id);
+    results.push({
+      category: CATEGORY,
+      name: "mdViewers",
+      status: "pass",
+      message: detected.length > 0
+        ? `Detected MD viewers: ${detected.join(", ")}`
+        : "No external MD viewers detected (VS Code preview and Rich View remain available).",
+      detail: { viewers },
+    });
+  } catch (err) {
+    results.push({
+      category: CATEGORY,
+      name: "mdViewers",
+      status: "warn",
+      message: `Viewer detection failed: ${(err instanceof Error ? err.message : String(err))}`,
+    });
+  }
+
+  return results;
+}
+
+export { run };

package/dist/checks/ide.mjs

@@ -0,0 +1,80 @@
+import "../chunk-4UEJOM6W.mjs";
+
+// src/checks/ide.js
+var CATEGORY = "ide";
+async function run(opts = {}) {
+  const results = [];
+  const statuses = opts.ideStatuses;
+  if (!statuses) {
+    results.push({
+      category: CATEGORY,
+      name: "ide-audit",
+      status: "skip",
+      message: "IDE audit requires the VS Code extension (or pass ideStatuses explicitly)."
+    });
+    return results;
+  }
+  for (const [id, s] of Object.entries(statuses)) {
+    if (!s.detected) {
+      results.push({ category: CATEGORY, name: id, status: "skip", message: `${s.displayName} not installed` });
+      continue;
+    }
+    if (!s.configured) {
+      results.push({
+        category: CATEGORY,
+        name: id,
+        status: "warn",
+        message: `${s.displayName} installed but Perplexity MCP is not configured.`,
+        hint: "Open the IDEs dashboard tab and click Configure.",
+        action: { label: "Configure", commandId: "Perplexity.generateConfigs", args: [id] }
+      });
+      continue;
+    }
+    if (s.health === "stale") {
+      results.push({
+        category: CATEGORY,
+        name: id,
+        status: "warn",
+        message: `${s.displayName} config is stale.`,
+        hint: "Click Configure to refresh.",
+        action: { label: "Refresh config", commandId: "Perplexity.generateConfigs", args: [id] }
+      });
+      continue;
+    }
+    if (s.commandHealth && s.commandHealth !== "ok") {
+      results.push({
+        category: CATEGORY,
+        name: id,
+        status: "warn",
+        message: `${s.displayName} configured but command path is ${s.commandHealth} \u2014 re-run 'Configure for All' to refresh.`,
+        hint: "The MCP config's `command` field doesn't look like a Node.js binary. Re-running Configure rewrites it with a resolved Node path.",
+        action: { label: "Refresh config", commandId: "Perplexity.generateConfigs", args: [id] }
+      });
+      continue;
+    }
+    results.push({ category: CATEGORY, name: id, status: "pass", message: `${s.displayName} configured` });
+  }
+  try {
+    const { detectAllViewers } = await import("../viewer-detect.mjs");
+    const viewers = await detectAllViewers();
+    const detected = Object.entries(viewers).filter(([, present]) => present).map(([id]) => id);
+    results.push({
+      category: CATEGORY,
+      name: "mdViewers",
+      status: "pass",
+      message: detected.length > 0 ? `Detected MD viewers: ${detected.join(", ")}` : "No external MD viewers detected (VS Code preview and Rich View remain available).",
+      detail: { viewers }
+    });
+  } catch (err) {
+    results.push({
+      category: CATEGORY,
+      name: "mdViewers",
+      status: "warn",
+      message: `Viewer detection failed: ${err instanceof Error ? err.message : String(err)}`
+    });
+  }
+  return results;
+}
+export {
+  run
+};

package/dist/checks/mcp.d.ts

@@ -0,0 +1,61 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+
+const CATEGORY = "mcp";
+const KNOWN_PROFILES = new Set(["read-only", "full", "custom"]);
+
+async function run(opts = {}) {
+  const results = [];
+  const dir = opts.configDir;
+  const toolCfgPath = join(dir, "tools-config.json");
+
+  if (!existsSync(toolCfgPath)) {
+    results.push({
+      category: CATEGORY,
+      name: "tool-config",
+      status: "skip",
+      message: "no tools-config.json (default: full)",
+    });
+    results.push({
+      category: CATEGORY,
+      name: "enabled-tools",
+      status: "pass",
+      message: "default profile 'full'",
+    });
+    return results;
+  }
+  let cfg;
+  try {
+    cfg = JSON.parse(readFileSync(toolCfgPath, "utf8"));
+  } catch (err) {
+    results.push({
+      category: CATEGORY,
+      name: "tool-config",
+      status: "fail",
+      message: `tools-config.json malformed: ${err.message}`,
+      hint: "Delete the file to restore defaults.",
+    });
+    return results;
+  }
+
+  if (!KNOWN_PROFILES.has(cfg.profile)) {
+    results.push({
+      category: CATEGORY,
+      name: "tool-config",
+      status: "warn",
+      message: `unknown profile '${cfg.profile}' — falling back to 'full'`,
+    });
+  } else {
+    results.push({ category: CATEGORY, name: "tool-config", status: "pass", message: `profile=${cfg.profile}` });
+  }
+  const count = cfg.profile === "custom"
+    ? (cfg.customEnabled?.length ?? 0)
+    : cfg.profile === "read-only"
+      ? 9
+      : 11;
+  results.push({ category: CATEGORY, name: "enabled-tools", status: "pass", message: `${count} tools enabled` });
+
+  return results;
+}
+
+export { run };

package/dist/checks/mcp.mjs

@@ -0,0 +1,56 @@
+import "../chunk-4UEJOM6W.mjs";
+
+// src/checks/mcp.js
+import { existsSync, readFileSync } from "fs";
+import { join } from "path";
+var CATEGORY = "mcp";
+var KNOWN_PROFILES = /* @__PURE__ */ new Set(["read-only", "full", "custom"]);
+async function run(opts = {}) {
+  const results = [];
+  const dir = opts.configDir;
+  const toolCfgPath = join(dir, "tools-config.json");
+  if (!existsSync(toolCfgPath)) {
+    results.push({
+      category: CATEGORY,
+      name: "tool-config",
+      status: "skip",
+      message: "no tools-config.json (default: full)"
+    });
+    results.push({
+      category: CATEGORY,
+      name: "enabled-tools",
+      status: "pass",
+      message: "default profile 'full'"
+    });
+    return results;
+  }
+  let cfg;
+  try {
+    cfg = JSON.parse(readFileSync(toolCfgPath, "utf8"));
+  } catch (err) {
+    results.push({
+      category: CATEGORY,
+      name: "tool-config",
+      status: "fail",
+      message: `tools-config.json malformed: ${err.message}`,
+      hint: "Delete the file to restore defaults."
+    });
+    return results;
+  }
+  if (!KNOWN_PROFILES.has(cfg.profile)) {
+    results.push({
+      category: CATEGORY,
+      name: "tool-config",
+      status: "warn",
+      message: `unknown profile '${cfg.profile}' \u2014 falling back to 'full'`
+    });
+  } else {
+    results.push({ category: CATEGORY, name: "tool-config", status: "pass", message: `profile=${cfg.profile}` });
+  }
+  const count = cfg.profile === "custom" ? cfg.customEnabled?.length ?? 0 : cfg.profile === "read-only" ? 9 : 11;
+  results.push({ category: CATEGORY, name: "enabled-tools", status: "pass", message: `${count} tools enabled` });
+  return results;
+}
+export {
+  run
+};

package/dist/checks/native-deps.d.ts

@@ -0,0 +1,131 @@
+import { createRequire } from 'node:module';
+import { readFileSync, existsSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+
+const CATEGORY = "native-deps";
+
+/**
+ * Build a `require` that resolves as if invoked from `baseDir`. Falls back
+ * to this module's own file when no baseDir is supplied. The fallback works
+ * in plain Node ESM (CLI mode). In tsup-bundled CJS, `import.meta.url` is
+ * polyfilled to undefined, so the extension MUST pass a baseDir derived
+ * from `vscode.ExtensionContext.extensionUri` (e.g. `<extensionUri>/dist`).
+ */
+function makeRequire(baseDir) {
+  if (baseDir) {
+    return createRequire(join(baseDir, "_resolver.js"));
+  }
+  const self = import.meta.url ?? null;
+  if (!self) return null;
+  try {
+    // Resolve against this module's own file, which works in native Node ESM.
+    return createRequire(self);
+  } catch {
+    return null;
+  }
+}
+
+function resolveGotScrapingChain(baseDir) {
+  const req = makeRequire(baseDir);
+  if (!req) throw new Error("no resolver context (pass baseDir)");
+  const hg = req.resolve("header-generator");
+  const hgReq = createRequire(hg);
+  const dp = hgReq.resolve("dot-prop");
+  const dpReq = createRequire(dp);
+  const io = dpReq.resolve("is-obj");
+  return { hg, dp, io };
+}
+
+function getImpitRuntimeDirFallback() {
+  return join(process.env.PERPLEXITY_CONFIG_DIR || join(homedir(), ".perplexity-mcp"), "native-deps");
+}
+
+async function run(opts = {}) {
+  const results = [];
+  const baseDir = opts.baseDir;
+
+  // patchright — required
+  try {
+    const req = makeRequire(baseDir);
+    if (!req) throw new Error("no resolver context");
+    const pkgPath = req.resolve("patchright/package.json");
+    const { version } = JSON.parse(readFileSync(pkgPath, "utf8"));
+    results.push({ category: CATEGORY, name: "patchright", status: "pass", message: `patchright ${version}` });
+  } catch {
+    results.push({
+      category: CATEGORY,
+      name: "patchright",
+      status: "fail",
+      message: "patchright not resolvable",
+      hint: "Run `pnpm install` or reinstall the VSIX.",
+    });
+  }
+
+  // got-scraping packaging chain — carry-over #5 detector
+  const resolveChain = opts.resolveChainOverride ?? (() => resolveGotScrapingChain(baseDir));
+  try {
+    const chain = resolveChain();
+    results.push({
+      category: CATEGORY,
+      name: "got-scraping-chain",
+      status: "pass",
+      message: "header-generator -> dot-prop -> is-obj resolves",
+      detail: chain,
+    });
+  } catch (err) {
+    results.push({
+      category: CATEGORY,
+      name: "got-scraping-chain",
+      status: "warn",
+      message: "got-scraping packaging chain is broken — runtime will fall back to browser tier",
+      detail: { chainError: err.message },
+      hint: "Add the missing package to rootPackages in packages/extension/scripts/prepare-package-deps.mjs and rebuild the VSIX.",
+    });
+  }
+
+  // impit (optional speed boost)
+  let impitStatus = opts.impitStatusOverride;
+  if (!impitStatus) {
+    try {
+      const { getImpitRuntimeDir } = await import('../refresh.d.ts');
+      const runtimeDir = typeof getImpitRuntimeDir === "function" ? getImpitRuntimeDir() : getImpitRuntimeDirFallback();
+      const marker = join(runtimeDir, "native-deps-state.json");
+      const pkgPath = join(runtimeDir, "node_modules", "impit", "package.json");
+      const state = existsSync(marker) ? JSON.parse(readFileSync(marker, "utf8")) : null;
+      if (existsSync(pkgPath)) {
+        const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
+        impitStatus = {
+          installed: true,
+          version: pkg.version ?? state?.version ?? null,
+          installedAt: state?.installedAt ?? null,
+        };
+      } else {
+        impitStatus = { installed: false, version: state?.version ?? null, installedAt: state?.installedAt ?? null };
+      }
+    } catch {
+      impitStatus = { installed: false, version: null };
+    }
+  }
+  if (impitStatus.installed) {
+    results.push({
+      category: CATEGORY,
+      name: "impit",
+      status: "pass",
+      message: `impit ${impitStatus.version ?? "(unknown version)"}${impitStatus.installedAt ? ` - installed ${impitStatus.installedAt}` : ""}`,
+    });
+  } else {
+    results.push({
+      category: CATEGORY,
+      name: "impit",
+      status: "skip",
+      message: "not installed (optional — skips browser launches for sync, hydrate, retrieve, export, models, login)",
+      hint: "Install with: `npx perplexity-user-mcp install-speed-boost` — or click 'Install Speed Boost' in the VS Code extension dashboard.",
+      action: { label: "Install Speed Boost", commandId: "Perplexity.installSpeedBoost" },
+    });
+  }
+
+  return results;
+}
+
+export { run };

package/dist/checks/native-deps.mjs

@@ -0,0 +1,115 @@
+import "../chunk-4UEJOM6W.mjs";
+
+// src/checks/native-deps.js
+import { createRequire } from "module";
+import { existsSync, readFileSync } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+var CATEGORY = "native-deps";
+function makeRequire(baseDir) {
+  if (baseDir) {
+    return createRequire(join(baseDir, "_resolver.js"));
+  }
+  const self = import.meta.url ?? null;
+  if (!self) return null;
+  try {
+    return createRequire(self);
+  } catch {
+    return null;
+  }
+}
+function resolveGotScrapingChain(baseDir) {
+  const req = makeRequire(baseDir);
+  if (!req) throw new Error("no resolver context (pass baseDir)");
+  const hg = req.resolve("header-generator");
+  const hgReq = createRequire(hg);
+  const dp = hgReq.resolve("dot-prop");
+  const dpReq = createRequire(dp);
+  const io = dpReq.resolve("is-obj");
+  return { hg, dp, io };
+}
+function getImpitRuntimeDirFallback() {
+  return join(process.env.PERPLEXITY_CONFIG_DIR || join(homedir(), ".perplexity-mcp"), "native-deps");
+}
+async function run(opts = {}) {
+  const results = [];
+  const baseDir = opts.baseDir;
+  try {
+    const req = makeRequire(baseDir);
+    if (!req) throw new Error("no resolver context");
+    const pkgPath = req.resolve("patchright/package.json");
+    const { version } = JSON.parse(readFileSync(pkgPath, "utf8"));
+    results.push({ category: CATEGORY, name: "patchright", status: "pass", message: `patchright ${version}` });
+  } catch {
+    results.push({
+      category: CATEGORY,
+      name: "patchright",
+      status: "fail",
+      message: "patchright not resolvable",
+      hint: "Run `pnpm install` or reinstall the VSIX."
+    });
+  }
+  const resolveChain = opts.resolveChainOverride ?? (() => resolveGotScrapingChain(baseDir));
+  try {
+    const chain = resolveChain();
+    results.push({
+      category: CATEGORY,
+      name: "got-scraping-chain",
+      status: "pass",
+      message: "header-generator -> dot-prop -> is-obj resolves",
+      detail: chain
+    });
+  } catch (err) {
+    results.push({
+      category: CATEGORY,
+      name: "got-scraping-chain",
+      status: "warn",
+      message: "got-scraping packaging chain is broken \u2014 runtime will fall back to browser tier",
+      detail: { chainError: err.message },
+      hint: "Add the missing package to rootPackages in packages/extension/scripts/prepare-package-deps.mjs and rebuild the VSIX."
+    });
+  }
+  let impitStatus = opts.impitStatusOverride;
+  if (!impitStatus) {
+    try {
+      const { getImpitRuntimeDir } = await import("../refresh.mjs");
+      const runtimeDir = typeof getImpitRuntimeDir === "function" ? getImpitRuntimeDir() : getImpitRuntimeDirFallback();
+      const marker = join(runtimeDir, "native-deps-state.json");
+      const pkgPath = join(runtimeDir, "node_modules", "impit", "package.json");
+      const state = existsSync(marker) ? JSON.parse(readFileSync(marker, "utf8")) : null;
+      if (existsSync(pkgPath)) {
+        const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
+        impitStatus = {
+          installed: true,
+          version: pkg.version ?? state?.version ?? null,
+          installedAt: state?.installedAt ?? null
+        };
+      } else {
+        impitStatus = { installed: false, version: state?.version ?? null, installedAt: state?.installedAt ?? null };
+      }
+    } catch {
+      impitStatus = { installed: false, version: null };
+    }
+  }
+  if (impitStatus.installed) {
+    results.push({
+      category: CATEGORY,
+      name: "impit",
+      status: "pass",
+      message: `impit ${impitStatus.version ?? "(unknown version)"}${impitStatus.installedAt ? ` - installed ${impitStatus.installedAt}` : ""}`
+    });
+  } else {
+    results.push({
+      category: CATEGORY,
+      name: "impit",
+      status: "skip",
+      message: "not installed (optional \u2014 skips browser launches for sync, hydrate, retrieve, export, models, login)",
+      hint: "Install with: `npx perplexity-user-mcp install-speed-boost` \u2014 or click 'Install Speed Boost' in the VS Code extension dashboard.",
+      action: { label: "Install Speed Boost", commandId: "Perplexity.installSpeedBoost" }
+    });
+  }
+  return results;
+}
+export {
+  run
+};

package/dist/checks/network.d.ts

@@ -0,0 +1,71 @@
+import { lookup } from 'node:dns/promises';
+import { request } from 'node:https';
+
+const CATEGORY = "network";
+const DEFAULT_HOST = "www.perplexity.ai";
+
+function httpsHead(url, { timeoutMs = 5000 } = {}) {
+  return new Promise((resolve, reject) => {
+    const req = request(url, { method: "HEAD", timeout: timeoutMs }, (res) => {
+      resolve({ statusCode: res.statusCode, headers: res.headers });
+      res.resume();
+    });
+    req.on("timeout", () => { req.destroy(new Error("HTTPS HEAD timeout")); });
+    req.on("error", reject);
+    req.end();
+  });
+}
+
+async function run(opts = {}) {
+  const results = [];
+  const host = opts.host ?? DEFAULT_HOST;
+  const dns = opts.dnsLookupOverride ?? lookup;
+  const head = opts.httpsHeadOverride ?? ((u) => httpsHead(u));
+
+  let addr = null;
+  try {
+    addr = await dns(host);
+    results.push({ category: CATEGORY, name: "dns", status: "pass", message: `${host} -> ${addr.address}` });
+  } catch (err) {
+    results.push({
+      category: CATEGORY,
+      name: "dns",
+      status: "fail",
+      message: `DNS lookup failed: ${err.message}`,
+      hint: "Check internet connection / proxy / VPN.",
+    });
+    return results;
+  }
+
+  let headRes;
+  try {
+    headRes = await head(`https://${host}${process.env.PERPLEXITY_LOGIN_PATH || "/account"}`);
+    results.push({ category: CATEGORY, name: "https", status: "pass", message: `HEAD / status ${headRes.statusCode}` });
+  } catch (err) {
+    results.push({
+      category: CATEGORY,
+      name: "https",
+      status: "fail",
+      message: `HTTPS failed: ${err.message}`,
+      hint: "TLS/MITM proxy? Corporate firewall?",
+    });
+    return results;
+  }
+
+  const isCf = String(headRes.headers?.server ?? "").toLowerCase().includes("cloudflare") && headRes.statusCode === 503;
+  if (isCf) {
+    results.push({
+      category: CATEGORY,
+      name: "cf-challenge",
+      status: "warn",
+      message: "Cloudflare challenge active — logins may need manual captcha.",
+      hint: "Try login --mode manual if auto mode fails.",
+    });
+  } else {
+    results.push({ category: CATEGORY, name: "cf-challenge", status: "pass", message: "no challenge detected" });
+  }
+
+  return results;
+}
+
+export { run };

package/dist/checks/network.mjs

@@ -0,0 +1,70 @@
+import "../chunk-4UEJOM6W.mjs";
+
+// src/checks/network.js
+import { lookup } from "dns/promises";
+import { request } from "https";
+var CATEGORY = "network";
+var DEFAULT_HOST = "www.perplexity.ai";
+function httpsHead(url, { timeoutMs = 5e3 } = {}) {
+  return new Promise((resolve, reject) => {
+    const req = request(url, { method: "HEAD", timeout: timeoutMs }, (res) => {
+      resolve({ statusCode: res.statusCode, headers: res.headers });
+      res.resume();
+    });
+    req.on("timeout", () => {
+      req.destroy(new Error("HTTPS HEAD timeout"));
+    });
+    req.on("error", reject);
+    req.end();
+  });
+}
+async function run(opts = {}) {
+  const results = [];
+  const host = opts.host ?? DEFAULT_HOST;
+  const dns = opts.dnsLookupOverride ?? lookup;
+  const head = opts.httpsHeadOverride ?? ((u) => httpsHead(u));
+  let addr = null;
+  try {
+    addr = await dns(host);
+    results.push({ category: CATEGORY, name: "dns", status: "pass", message: `${host} -> ${addr.address}` });
+  } catch (err) {
+    results.push({
+      category: CATEGORY,
+      name: "dns",
+      status: "fail",
+      message: `DNS lookup failed: ${err.message}`,
+      hint: "Check internet connection / proxy / VPN."
+    });
+    return results;
+  }
+  let headRes;
+  try {
+    headRes = await head(`https://${host}${process.env.PERPLEXITY_LOGIN_PATH || "/account"}`);
+    results.push({ category: CATEGORY, name: "https", status: "pass", message: `HEAD / status ${headRes.statusCode}` });
+  } catch (err) {
+    results.push({
+      category: CATEGORY,
+      name: "https",
+      status: "fail",
+      message: `HTTPS failed: ${err.message}`,
+      hint: "TLS/MITM proxy? Corporate firewall?"
+    });
+    return results;
+  }
+  const isCf = String(headRes.headers?.server ?? "").toLowerCase().includes("cloudflare") && headRes.statusCode === 503;
+  if (isCf) {
+    results.push({
+      category: CATEGORY,
+      name: "cf-challenge",
+      status: "warn",
+      message: "Cloudflare challenge active \u2014 logins may need manual captcha.",
+      hint: "Try login --mode manual if auto mode fails."
+    });
+  } else {
+    results.push({ category: CATEGORY, name: "cf-challenge", status: "pass", message: "no challenge detected" });
+  }
+  return results;
+}
+export {
+  run
+};