perplexity-user-mcp 0.8.36

package/dist/vault.d.ts

@@ -0,0 +1,37 @@
+declare function encryptBlob(plaintext: Buffer, key: Buffer): Buffer;
+declare function decryptBlob(blob: Buffer, key: Buffer): Buffer;
+declare function __resetKeyCache(): void;
+declare function getMasterKey(): Promise<Buffer>;
+
+/**
+ * TEST SEAM — drop scrypt cost during tests by overriding the (logN, r, p)
+ * parameters used at write time. Reads always use the params embedded in the
+ * blob, regardless of any override.
+ *
+ * Cleared by `__resetKeyCache()` so tests do not leak state across files.
+ * MUST NOT be called from production code paths. The decrypt-time floor
+ * check (logN >= SCRYPT_LOGN_FLOOR) remains enforced unconditionally.
+ */
+declare function __setKdfParamsForTest(params: { logN: number; r: number; p: number }): void;
+
+/**
+ * Sibling of `getMasterKey()` introduced with the v2 vault format. Returns
+ * the unseal context WITHOUT prematurely deriving the HKDF key — for v2
+ * blobs, key derivation needs the salt embedded in each blob, so it can no
+ * longer happen up front. Cached just like `_keyCache`; cleared by
+ * `__resetKeyCache()`.
+ */
+type UnsealMaterial =
+  | { kind: "key"; key: Buffer }
+  | { kind: "passphrase"; passphrase: string };
+
+declare function getUnsealMaterial(): Promise<UnsealMaterial>;
+
+declare class Vault {
+  get(profile: string, key: string): Promise<string | null>;
+  set(profile: string, key: string, value: string): Promise<void>;
+  delete(profile: string, key: string): Promise<void>;
+  deleteAll(profile: string): Promise<void>;
+}
+
+export { type UnsealMaterial, Vault, __resetKeyCache, __setKdfParamsForTest, decryptBlob, encryptBlob, getMasterKey, getUnsealMaterial };

package/dist/vault.mjs

@@ -0,0 +1,21 @@
+import {
+  Vault,
+  __resetKeyCache,
+  __setKdfParamsForTest,
+  decryptBlob,
+  encryptBlob,
+  getMasterKey,
+  getUnsealMaterial
+} from "./chunk-TQLCLE4L.mjs";
+import "./chunk-MTDFKNXX.mjs";
+import "./chunk-XKSWCEGI.mjs";
+import "./chunk-4UEJOM6W.mjs";
+export {
+  Vault,
+  __resetKeyCache,
+  __setKdfParamsForTest,
+  decryptBlob,
+  encryptBlob,
+  getMasterKey,
+  getUnsealMaterial
+};

package/dist/viewer-detect.d-HWGnyFAA.d.ts

@@ -0,0 +1,4 @@
+declare function detectViewer(id: string): Promise<boolean>;
+declare function detectAllViewers(): Promise<Record<string, boolean>>;
+
+export { detectAllViewers, detectViewer };

package/dist/viewer-detect.d.ts

@@ -0,0 +1,4 @@
+declare function detectViewer(id: string): Promise<boolean>;
+declare function detectAllViewers(): Promise<Record<string, boolean>>;
+
+export { detectAllViewers, detectViewer };

package/dist/viewer-detect.mjs

@@ -0,0 +1,37 @@
+import "./chunk-4UEJOM6W.mjs";
+
+// src/viewer-detect.js
+import { promisify } from "util";
+import { execFile as execFileCallback } from "child_process";
+var execFile = promisify(execFileCallback);
+var VIEWER_BINARIES = {
+  obsidian: process.platform === "win32" ? "obsidian.exe" : "obsidian",
+  typora: process.platform === "win32" ? "typora.exe" : "typora",
+  logseq: process.platform === "win32" ? "logseq.exe" : "logseq"
+};
+async function detectBinary(binary) {
+  const command = process.platform === "win32" ? "where" : "which";
+  try {
+    const { stdout } = await execFile(command, [binary]);
+    return stdout.trim().length > 0;
+  } catch {
+    return false;
+  }
+}
+async function detectViewer(id) {
+  const binary = VIEWER_BINARIES[id];
+  if (!binary) {
+    return false;
+  }
+  return detectBinary(binary);
+}
+async function detectAllViewers() {
+  const entries = await Promise.all(
+    Object.keys(VIEWER_BINARIES).map(async (id) => [id, await detectViewer(id)])
+  );
+  return Object.fromEntries(entries);
+}
+export {
+  detectAllViewers,
+  detectViewer
+};

package/dist/viewers.d-BGCK6sw6.d.ts

@@ -0,0 +1,10 @@
+import { ExternalViewer } from '@perplexity-user-mcp/shared';
+
+declare function listViewers(overrides?: ExternalViewer[]): ExternalViewer[];
+declare function buildViewerUrl(options: {
+  viewer: ExternalViewer;
+  mdPath: string;
+  profile?: string;
+}): string;
+
+export { buildViewerUrl, listViewers };

package/dist/viewers.d.ts

@@ -0,0 +1,18 @@
+import { ExternalViewer } from '@perplexity-user-mcp/shared';
+
+declare function listViewers(overrides?: ExternalViewer[]): ExternalViewer[];
+declare function loadViewerConfig(): ExternalViewer[];
+declare function saveViewerConfig(viewer: ExternalViewer): ExternalViewer;
+declare function substituteViewerTemplate(viewer: ExternalViewer, values: Record<string, string>): string;
+declare function ensureObsidianBridge(options: {
+  mdPath: string;
+  viewer: ExternalViewer;
+  profile?: string;
+}): string;
+declare function buildViewerUrl(options: {
+  viewer: ExternalViewer;
+  mdPath: string;
+  profile?: string;
+}): string;
+
+export { buildViewerUrl, ensureObsidianBridge, listViewers, loadViewerConfig, saveViewerConfig, substituteViewerTemplate };

package/dist/viewers.mjs

@@ -0,0 +1,122 @@
+import {
+  getActiveName,
+  getConfigDir,
+  getProfilePaths
+} from "./chunk-XKSWCEGI.mjs";
+import "./chunk-4UEJOM6W.mjs";
+
+// src/viewers.js
+import { copyFileSync, existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "fs";
+import { dirname, join, relative, resolve } from "path";
+var BUILTIN_VIEWERS = [
+  {
+    id: "obsidian",
+    label: "Obsidian",
+    urlTemplate: "obsidian://open?vault={vaultName}&file={relPath}",
+    needsVaultBridge: true
+  },
+  {
+    id: "typora",
+    label: "Typora",
+    urlTemplate: "typora://{absPath}",
+    needsVaultBridge: false
+  },
+  {
+    id: "logseq",
+    label: "Logseq",
+    urlTemplate: "logseq://graph/{graphName}?page={filenameNoExt}",
+    needsVaultBridge: true
+  }
+];
+function listViewers(overrides = []) {
+  const resolvedOverrides = overrides.length > 0 ? overrides : loadViewerConfig();
+  const byId = new Map(BUILTIN_VIEWERS.map((viewer) => [viewer.id, {
+    ...viewer,
+    detected: false,
+    enabled: false
+  }]));
+  for (const viewer of resolvedOverrides) {
+    byId.set(viewer.id, { ...byId.get(viewer.id), ...viewer });
+  }
+  return [...byId.values()];
+}
+function getConfigPath() {
+  return join(getConfigDir(), "config.json");
+}
+function readConfig() {
+  if (!existsSync(getConfigPath())) {
+    return {};
+  }
+  try {
+    return JSON.parse(readFileSync(getConfigPath(), "utf8"));
+  } catch {
+    return {};
+  }
+}
+function writeConfig(nextConfig) {
+  mkdirSync(dirname(getConfigPath()), { recursive: true });
+  const tempPath = `${getConfigPath()}.tmp`;
+  writeFileSync(tempPath, `${JSON.stringify(nextConfig, null, 2)}
+`, "utf8");
+  renameSync(tempPath, getConfigPath());
+}
+function loadViewerConfig() {
+  const config = readConfig();
+  return Array.isArray(config.mdViewers) ? config.mdViewers : [];
+}
+function saveViewerConfig(viewer) {
+  const config = readConfig();
+  const current = Array.isArray(config.mdViewers) ? config.mdViewers : [];
+  const next = [...current.filter((item) => item?.id !== viewer.id), viewer];
+  writeConfig({ ...config, mdViewers: next });
+  return viewer;
+}
+function substituteViewerTemplate(viewer, values) {
+  const requiredSafe = ["absPath", "relPath", "vault", "vaultName", "filename", "filenameNoExt", "profile", "graphName"];
+  const safeValues = Object.fromEntries(requiredSafe.map((key) => [key, encodeURIComponent(String(values?.[key] ?? ""))]));
+  return viewer.urlTemplate.replace(/\{([a-zA-Z0-9]+)\}/g, (_, key) => safeValues[key] ?? "");
+}
+function ensureObsidianBridge(options) {
+  const { mdPath, viewer, profile = process.env.PERPLEXITY_PROFILE || getActiveName() || "default" } = options;
+  if (!viewer?.vaultPath || !viewer?.vaultName) {
+    throw new Error("Obsidian viewer requires vaultPath and vaultName.");
+  }
+  const historyDir = getProfilePaths(profile).history;
+  const relPath = relative(historyDir, mdPath);
+  if (relPath.startsWith("..")) {
+    throw new Error("Refusing to bridge a markdown file outside the profile history directory.");
+  }
+  const bridgePath = resolve(join(viewer.vaultPath, "Perplexity", profile, relPath));
+  mkdirSync(dirname(bridgePath), { recursive: true });
+  copyFileSync(mdPath, bridgePath);
+  return bridgePath;
+}
+function buildViewerUrl(options) {
+  const {
+    viewer,
+    mdPath,
+    profile = process.env.PERPLEXITY_PROFILE || getActiveName() || "default"
+  } = options;
+  const activePath = viewer.needsVaultBridge ? ensureObsidianBridge({ mdPath, viewer, profile }) : mdPath;
+  const relPath = relative(getConfigDir(), activePath).replace(/\\/g, "/");
+  const filename = activePath.split(/[\\/]/).pop() ?? "entry.md";
+  const filenameNoExt = filename.replace(/\.[^.]+$/, "");
+  return substituteViewerTemplate(viewer, {
+    absPath: activePath,
+    relPath,
+    vault: viewer.vaultPath ?? "",
+    vaultName: viewer.vaultName ?? "",
+    filename,
+    filenameNoExt,
+    profile,
+    graphName: viewer.graphName ?? ""
+  });
+}
+export {
+  buildViewerUrl,
+  ensureObsidianBridge,
+  listViewers,
+  loadViewerConfig,
+  saveViewerConfig,
+  substituteViewerTemplate
+};

package/package.json

@@ -0,0 +1,152 @@
+{
+  "name": "perplexity-user-mcp",
+  "version": "0.8.36",
+  "mcpName": "io.github.Automations-Project/perplexity-user-mcp",
+  "type": "module",
+  "description": "Perplexity AI MCP server — browser automation for search, reasoning, research, and compute. Not affiliated with Perplexity AI, Inc.",
+  "author": {
+    "name": "Nskha",
+    "url": "https://github.com/automations-Project"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Automations-Project/VSCode-Perplexity-MCP.git",
+    "directory": "packages/mcp-server"
+  },
+  "homepage": "https://github.com/Automations-Project/VSCode-Perplexity-MCP/tree/main/packages/mcp-server#readme",
+  "bugs": {
+    "url": "https://github.com/Automations-Project/VSCode-Perplexity-MCP/issues"
+  },
+  "funding": [
+    {
+      "type": "github",
+      "url": "https://github.com/sponsors/automations-Project"
+    },
+    {
+      "type": "individual",
+      "url": "https://github.com/Automations-Project/VSCode-Perplexity-MCP"
+    }
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "keywords": [
+    "perplexity",
+    "mcp",
+    "model-context-protocol",
+    "mcp-server",
+    "ai",
+    "search",
+    "research",
+    "reasoning",
+    "claude",
+    "cursor",
+    "windsurf",
+    "browser-automation",
+    "patchright"
+  ],
+  "bin": {
+    "perplexity-user-mcp": "./dist/cli.mjs"
+  },
+  "main": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs"
+    },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "import": "./dist/client.mjs"
+    },
+    "./history-store": {
+      "types": "./dist/history-store.d.ts",
+      "import": "./dist/history-store.mjs"
+    },
+    "./attachments": {
+      "types": "./dist/attachments.d.ts",
+      "import": "./dist/attachments.mjs"
+    },
+    "./export": {
+      "types": "./dist/export.d.ts",
+      "import": "./dist/export.mjs"
+    },
+    "./viewers": {
+      "types": "./dist/viewers.d.ts",
+      "import": "./dist/viewers.mjs"
+    },
+    "./viewer-detect": {
+      "types": "./dist/viewer-detect.d.ts",
+      "import": "./dist/viewer-detect.mjs"
+    },
+    "./config": {
+      "types": "./dist/config.d.ts",
+      "import": "./dist/config.mjs"
+    },
+    "./refresh": {
+      "types": "./dist/refresh.d.ts",
+      "import": "./dist/refresh.mjs"
+    },
+    "./logout": {
+      "types": "./dist/logout.d.ts",
+      "import": "./dist/logout.mjs"
+    },
+    "./profiles": {
+      "types": "./dist/profiles.d.ts",
+      "import": "./dist/profiles.mjs"
+    },
+    "./doctor": {
+      "types": "./dist/doctor.d.ts",
+      "import": "./dist/doctor.mjs"
+    },
+    "./redact": {
+      "types": "./dist/redact.d.ts",
+      "import": "./dist/redact.mjs"
+    },
+    "./daemon": {
+      "types": "./dist/daemon/index.d.ts",
+      "import": "./dist/daemon/index.mjs"
+    },
+    "./daemon/tunnel-providers": {
+      "types": "./dist/daemon/tunnel-providers/index.d.ts",
+      "import": "./dist/daemon/tunnel-providers/index.mjs"
+    }
+  },
+  "files": [
+    "dist/**/*.mjs",
+    "dist/**/*.d.ts",
+    "dist/**/*.js",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "cd ../.. && npx vitest run packages/mcp-server/test",
+    "test:coverage": "cd ../.. && npx vitest run --coverage packages/mcp-server/test"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@ngrok/ngrok": "^1.7.0",
+    "express": "^5.2.1",
+    "got-scraping": "^4.2.1",
+    "gray-matter": "^4.0.3",
+    "helmet": "^8.1.0",
+    "patchright": "^1.59.4",
+    "zod": "^3.24.0"
+  },
+  "optionalDependencies": {
+    "keytar": "^7.9.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsup": "^8.5.1",
+    "typescript": "^5.7.0"
+  }
+}