perplexity-user-mcp 0.8.39 → 0.8.44

package/README.md

@@ -377,6 +377,11 @@ Logging in still goes through the CLI (`npx perplexity-user-mcp login`) — the
 - A browser runtime — any of: real Chrome, Microsoft Edge, Brave, system Chromium, or patchright's bundled Chromium (see the [Browser requirement](#browser-requirement) section)
 - An active Perplexity account (free tier works; Pro/Max unlock reason/research/compute)
 
+## Troubleshooting
+
+- **External MCP clients hitting "Vault locked":** [Troubleshooting external MCP clients](../../docs/troubleshooting/external-mcp-clients.md)
+- **Vault unseal model and recovery:** [docs/vault-unseal.md](../../docs/vault-unseal.md)
+
 ## Issues
 
 Bug reports and feature requests: <https://github.com/Automations-Project/VSCode-Perplexity-MCP/issues>.

package/dist/attachments.d.ts

@@ -1,20 +1,10 @@
-interface DownloadedAttachment {
-  filename: string;
-  path: string;
-  sizeBytes: number;
-  mimeType?: string;
-  kind: "image" | "file";
-}
-
-declare const MAX_ATTACHMENT_BYTES: number;
-declare function sanitizeAttachmentFilename(name: string): string;
-declare function inferAttachmentKind(mimeType?: string): "image" | "file";
-declare function downloadAttachment(options: {
-  download: (url: string, targetPath: string) => Promise<unknown>;
-  url: string;
-  attachmentsDir: string;
-  filename?: string;
-  mimeType?: string;
-}): Promise<DownloadedAttachment>;
-
-export { type DownloadedAttachment, MAX_ATTACHMENT_BYTES, downloadAttachment, inferAttachmentKind, sanitizeAttachmentFilename };
+export function sanitizeAttachmentFilename(name: any): string;
+export function inferAttachmentKind(mimeType: any): "image" | "file";
+export function downloadAttachment(options: any): Promise<{
+    filename: string;
+    path: string;
+    sizeBytes: number;
+    mimeType: any;
+    kind: string;
+}>;
+export const MAX_ATTACHMENT_BYTES: number;

package/dist/browser-window.d.ts

@@ -0,0 +1 @@
+export function minimizePageWindow(page: any): Promise<boolean>;

package/dist/cf-warmup.d.ts

@@ -0,0 +1,32 @@
+import { type PlaywrightCookie } from "./config.js";
+export interface WarmCloudflareOptions {
+    /** Hard cap on the initial page.goto. Default 15_000ms. */
+    navigationTimeoutMs?: number;
+    /** How often to recheck context cookies for `cf_clearance`. Default 250ms. */
+    pollIntervalMs?: number;
+    /** Total wall-clock budget for the cookie poll loop after navigation. Default 10_000ms. */
+    cookieWaitMs?: number;
+}
+export interface WarmCloudflareResult {
+    /**
+     * True iff the browser launched and navigation succeeded. May be true even
+     * when `hasCfClearance` is false — distinguishes "browser unusable" from
+     * "browser fine, CF just didn't issue clearance this time".
+     */
+    ok: boolean;
+    /** All cookies present in the ephemeral context at teardown. Empty on launch failure. */
+    cookies: PlaywrightCookie[];
+    /** Whether `cf_clearance` was observed in `cookies`. */
+    hasCfClearance: boolean;
+    /** Wall-clock duration of the warmup attempt, in milliseconds. */
+    elapsedMs: number;
+    /** Populated when `ok=false`. Single-line, human-readable. */
+    error?: string;
+}
+/**
+ * Brief headless launch to capture cf_clearance for the impit-login flow.
+ *
+ * Always returns a result object — never throws. Caller falls back to the
+ * full browser-based login when ok=false or hasCfClearance=false.
+ */
+export declare function warmCloudflare(opts?: WarmCloudflareOptions): Promise<WarmCloudflareResult>;

package/dist/checks/browser.d.ts

@@ -1,100 +1,12 @@
-import { spawn } from 'node:child_process';
-
-const CATEGORY = "browser";
-
-/**
- * Read the Chrome-family browser's version string without launching the
- * browser GUI.
- *
- * Why this is non-trivial: on Windows, `chrome.exe --version` invoked from a
- * non-console parent (the VS Code extension host) forks the browser process —
- * the original exits with code 0 and empty stdout (which is why the doctor
- * report's `chrome-family` message was blank), and the forked children stay
- * alive as visible Chrome windows. Every `runDoctor()` call (Run, Deep check,
- * Capture diagnostics, Export) was therefore spawning a permanent visible
- * window.
- *
- * Fix: on Windows, query the PE header's ProductVersion via PowerShell's
- * `Get-Item ... .VersionInfo.ProductVersion` — no browser launch, returns
- * the same string the user sees in File Properties → Details. On macOS /
- * Linux, `--version` is a true CLI app contract and remains safe.
- */
-function probeVersion(path) {
-  if (process.platform === "win32") {
-    return new Promise((resolve, reject) => {
-      // Single-quote escape: PowerShell single-quoted strings need '' to
-      // represent a literal '. -LiteralPath bypasses wildcard expansion so
-      // bracketed install paths (e.g. Program Files (x86)) are safe.
-      const escaped = path.replace(/'/g, "''");
-      const child = spawn(
-        "powershell.exe",
-        [
-          "-NoProfile",
-          "-NonInteractive",
-          "-Command",
-          `(Get-Item -LiteralPath '${escaped}').VersionInfo.ProductVersion`,
-        ],
-        { timeout: 3000, windowsHide: true },
-      );
-      let out = "";
-      let err = "";
-      child.stdout?.on("data", (d) => { out += d.toString(); });
-      child.stderr?.on("data", (d) => { err += d.toString(); });
-      child.on("close", (code) => {
-        const trimmed = out.trim();
-        if (code === 0 && trimmed) resolve(trimmed);
-        else reject(new Error(err.trim() || `version probe exited ${code}`));
-      });
-      child.on("error", reject);
-    });
-  }
-  return new Promise((resolve, reject) => {
-    const child = spawn(path, ["--version"], { timeout: 2000 });
-    let out = "";
-    let err = "";
-    child.stdout?.on("data", (d) => { out += d.toString(); });
-    child.stderr?.on("data", (d) => { err += d.toString(); });
-    child.on("close", (code) => {
-      if (code === 0) resolve(out.trim() || err.trim());
-      else reject(new Error(err.trim() || `version probe exited ${code}`));
-    });
-    child.on("error", reject);
-  });
-}
-
-async function run(opts = {}) {
-  const results = [];
-  const findChrome = opts.findChromeOverride ?? (await import('../config.d.ts')).findChromeExecutable;
-  const versionProbe = opts.versionProbeOverride ?? probeVersion;
-
-  let chromePath = null;
-  try { chromePath = findChrome(); } catch { chromePath = null; }
-
-  if (!chromePath) {
-    results.push({
-      category: CATEGORY,
-      name: "chrome-family",
-      status: "fail",
-      message: "No Chrome / Edge / Chromium binary found on PATH or in standard locations.",
-      hint: "Run `npx perplexity-user-mcp install-browser` (Phase 4) or install Chrome/Edge manually.",
-    });
-    return results;
-  }
-
-  try {
-    const v = await versionProbe(chromePath);
-    results.push({ category: CATEGORY, name: "chrome-family", status: "pass", message: v });
-  } catch (err) {
-    results.push({ category: CATEGORY, name: "chrome-family", status: "pass", message: chromePath });
-    results.push({
-      category: CATEGORY,
-      name: "chrome-version",
-      status: "warn",
-      message: `version probe failed: ${err.message}`,
-    });
-  }
-
-  return results;
-}
-
-export { run };
+export function run(opts?: {}): Promise<{
+    category: string;
+    name: string;
+    status: string;
+    message: string;
+    hint: string;
+}[] | {
+    category: string;
+    name: string;
+    status: string;
+    message: any;
+}[]>;

package/dist/checks/config.d.ts

@@ -1,91 +1,25 @@
-import { existsSync, statSync, readFileSync } from 'node:fs';
-import { join } from 'node:path';
-
-const CATEGORY = "config";
-
-async function run(opts = {}) {
-  const dir = opts.configDir;
-  const results = [];
-
-  if (!existsSync(dir)) {
-    results.push({
-      category: CATEGORY,
-      name: "config-dir",
-      status: "fail",
-      message: `Config dir not found: ${dir}`,
-      hint: "Run `npx perplexity-user-mcp login` to initialize it.",
-    });
-    return results;
-  }
-  results.push({
-    category: CATEGORY,
-    name: "config-dir",
-    status: "pass",
-    message: `Config dir present at ${dir}`,
-  });
-
-  if (process.platform !== "win32") {
-    const mode = statSync(dir).mode & 0o777;
-    if (mode & 0o077) {
-      results.push({
-        category: CATEGORY,
-        name: "config-perms",
-        status: "warn",
-        message: `Config dir is world/group readable (mode 0${mode.toString(8)})`,
-        hint: "Run `chmod 700 ~/.perplexity-mcp`.",
-      });
-    } else {
-      results.push({ category: CATEGORY, name: "config-perms", status: "pass", message: "0700" });
-    }
-  } else {
-    results.push({ category: CATEGORY, name: "config-perms", status: "skip", message: "NTFS ACL (see icacls)" });
-  }
-
-  const activePath = join(dir, "active");
-  if (!existsSync(activePath)) {
-    results.push({
-      category: CATEGORY,
-      name: "active-pointer",
-      status: "warn",
-      message: "No active profile set.",
-      hint: "Add an account to create and activate your first profile.",
-      action: { label: "Add account", commandId: "Perplexity.addAccount" },
-    });
-  } else {
-    const name = readFileSync(activePath, "utf8").trim();
-    const metaPath = join(dir, "profiles", name, "meta.json");
-    if (!existsSync(metaPath)) {
-      results.push({
-        category: CATEGORY,
-        name: "active-pointer",
-        status: "fail",
-        message: `active -> '${name}' but profile does not exist`,
-        hint: "Run `npx perplexity-user-mcp list-accounts` and pick a real profile.",
-      });
-    } else {
-      results.push({ category: CATEGORY, name: "active-pointer", status: "pass", message: name });
-    }
-  }
-
-  const cfgJson = join(dir, "config.json");
-  if (!existsSync(cfgJson)) {
-    results.push({ category: CATEGORY, name: "config-json", status: "skip", message: "optional file absent" });
-  } else {
-    try {
-      JSON.parse(readFileSync(cfgJson, "utf8"));
-      results.push({ category: CATEGORY, name: "config-json", status: "pass", message: "valid" });
-    } catch (err) {
-      results.push({
-        category: CATEGORY,
-        name: "config-json",
-        status: "warn",
-        message: `config.json malformed: ${err.message}`,
-        hint: "Delete or fix the file — doctor reads it for reporting.githubIssueButton etc.",
-      });
-    }
-  }
-
-  return results;
-}
-
-export { run };
+export function run(opts?: {}): Promise<({
+    category: string;
+    name: string;
+    status: string;
+    message: string;
+    hint?: undefined;
+    action?: undefined;
+} | {
+    category: string;
+    name: string;
+    status: string;
+    message: string;
+    hint: string;
+    action?: undefined;
+} | {
+    category: string;
+    name: string;
+    status: string;
+    message: string;
+    hint: string;
+    action: {
+        label: string;
+        commandId: string;
+    };
+})[]>;

package/dist/checks/ide.d.ts

@@ -1,89 +1,31 @@
-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 };
+export function run(opts?: {}): Promise<({
+    category: string;
+    name: string;
+    status: string;
+    message: string;
+    hint?: undefined;
+    action?: undefined;
+    detail?: undefined;
+} | {
+    category: string;
+    name: string;
+    status: string;
+    message: string;
+    hint: string;
+    action: {
+        label: string;
+        commandId: string;
+        args: string[];
+    };
+    detail?: undefined;
+} | {
+    category: string;
+    name: string;
+    status: string;
+    message: string;
+    detail: {
+        viewers: Record<string, boolean>;
+    };
+    hint?: undefined;
+    action?: undefined;
+})[]>;

package/dist/checks/mcp.d.ts

@@ -1,61 +1,12 @@
-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 };
+export function run(opts?: {}): Promise<{
+    category: string;
+    name: string;
+    status: string;
+    message: string;
+}[] | {
+    category: string;
+    name: string;
+    status: string;
+    message: string;
+    hint: string;
+}[]>;