perplexity-user-mcp 0.8.36

package/dist/doctor.d-CXmUqOXX.d.ts

@@ -0,0 +1,43 @@
+type DoctorStatus = "pass" | "warn" | "fail" | "skip";
+
+type DoctorCategory =
+  | "runtime" | "config" | "profiles" | "vault" | "browser"
+  | "native-deps" | "network" | "ide" | "mcp" | "probe";
+
+interface DoctorCheck {
+  category: DoctorCategory;
+  name: string;
+  status: DoctorStatus;
+  message: string;
+  detail?: Record<string, unknown>;
+  hint?: string;
+}
+
+interface DoctorReport {
+  overall: DoctorStatus;
+  generatedAt: string;
+  durationMs: number;
+  activeProfile: string | null;
+  probeRan: boolean;
+  byCategory: Record<DoctorCategory, {
+    status: DoctorStatus;
+    checks: DoctorCheck[];
+  }>;
+}
+
+interface RunAllOpts {
+  configDir?: string;
+  profile?: string;
+  probe?: boolean;
+  allProfiles?: boolean;
+  ideStatuses?: Record<string, unknown>;
+  baseDir?: string;
+  injected?: Partial<Record<DoctorCategory, DoctorCheck[]>>;
+}
+
+declare const CATEGORIES: ReadonlyArray<DoctorCategory>;
+declare function exitCodeFor(report: { overall: DoctorStatus }): number;
+declare function runAll(opts?: RunAllOpts): Promise<DoctorReport>;
+declare function formatReportMarkdown(report: DoctorReport): string;
+
+export { CATEGORIES, type DoctorCategory, type DoctorCheck, type DoctorReport, type DoctorStatus, type RunAllOpts, exitCodeFor, formatReportMarkdown, runAll };

package/dist/doctor.d.ts

@@ -0,0 +1,44 @@
+type DoctorStatus = "pass" | "warn" | "fail" | "skip";
+
+type DoctorCategory =
+  | "runtime" | "config" | "profiles" | "vault" | "browser"
+  | "native-deps" | "network" | "ide" | "mcp" | "probe";
+
+interface DoctorCheck {
+  category: DoctorCategory;
+  name: string;
+  status: DoctorStatus;
+  message: string;
+  detail?: Record<string, unknown>;
+  hint?: string;
+}
+
+interface DoctorReport {
+  overall: DoctorStatus;
+  generatedAt: string;
+  durationMs: number;
+  activeProfile: string | null;
+  probeRan: boolean;
+  byCategory: Record<DoctorCategory, {
+    status: DoctorStatus;
+    checks: DoctorCheck[];
+  }>;
+}
+
+interface RunAllOpts {
+  configDir?: string;
+  profile?: string;
+  probe?: boolean;
+  allProfiles?: boolean;
+  ideStatuses?: Record<string, unknown>;
+  baseDir?: string;
+  injected?: Partial<Record<DoctorCategory, DoctorCheck[]>>;
+}
+
+declare const CATEGORIES: ReadonlyArray<DoctorCategory>;
+declare function rollupStatus(statuses: DoctorStatus[]): DoctorStatus;
+declare function exitCodeFor(report: { overall: DoctorStatus }): number;
+declare function runAll(opts?: RunAllOpts): Promise<DoctorReport>;
+declare function formatReportMarkdown(report: DoctorReport): string;
+
+export { CATEGORIES, type DoctorCategory, type DoctorCheck, type DoctorReport, type DoctorStatus, type RunAllOpts, exitCodeFor, formatReportMarkdown, rollupStatus, runAll };

package/dist/doctor.mjs

@@ -0,0 +1,16 @@
+import {
+  CATEGORIES,
+  exitCodeFor,
+  formatReportMarkdown,
+  rollupStatus,
+  runAll
+} from "./chunk-7JL36EBH.mjs";
+import "./chunk-XKSWCEGI.mjs";
+import "./chunk-4UEJOM6W.mjs";
+export {
+  CATEGORIES,
+  exitCodeFor,
+  formatReportMarkdown,
+  rollupStatus,
+  runAll
+};

package/dist/export.d.ts

@@ -0,0 +1,19 @@
+type ExportFormat = "pdf" | "markdown" | "docx";
+
+interface ExportResult {
+  buffer: Buffer;
+  filename: string;
+  contentType: string;
+}
+
+declare const FORMAT_TO_CONTENT_TYPE: Record<ExportFormat, string>;
+declare function resolveExportApiFormat(format: ExportFormat): "pdf" | "md" | "docx";
+declare function exportThread(options: {
+  entryUuid: string;
+  format: ExportFormat;
+  fetchImpl?: (input: string, init?: RequestInit) => Promise<Response>;
+  baseUrl?: string;
+  headers?: HeadersInit;
+}): Promise<ExportResult>;
+
+export { type ExportFormat, type ExportResult, FORMAT_TO_CONTENT_TYPE, exportThread, resolveExportApiFormat };

package/dist/export.mjs

@@ -0,0 +1,15 @@
+import {
+  FORMAT_TO_CONTENT_TYPE,
+  exportThread,
+  resolveExportApiFormat
+} from "./chunk-LZPLNZ5U.mjs";
+import "./chunk-LKJMLGFP.mjs";
+import "./chunk-TQLCLE4L.mjs";
+import "./chunk-MTDFKNXX.mjs";
+import "./chunk-XKSWCEGI.mjs";
+import "./chunk-4UEJOM6W.mjs";
+export {
+  FORMAT_TO_CONTENT_TYPE,
+  exportThread,
+  resolveExportApiFormat
+};

package/dist/health-check.d.ts

@@ -0,0 +1,108 @@
+import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
+import { chromium } from 'patchright';
+import { Vault } from './vault.d-BtRSLZiM.js';
+import { getProfilePaths, getActiveName } from './profiles.d-DqS1oZWr.js';
+import { getOrCreateContext, findBrowser } from './config.js';
+import { redact } from './redact.js';
+import { c as collectSessionMetadata } from './session-metadata-B9aV_n5g.js';
+
+// Spawnable health-check runner. Reads the active profile's vault cookies,
+// launches a NON-persistent Chromium, injects cookies, probes auth + rest
+// endpoints, writes models-cache.json on success, emits one JSON line,
+// and exits. Never touches the long-lived MCP server's browser profile dir.
+
+
+const ORIGIN = process.env.PERPLEXITY_ORIGIN || "https://www.perplexity.ai";
+const LOGIN_PATH = process.env.PERPLEXITY_LOGIN_PATH || "/account";
+
+function resolveProfile() {
+  return process.env.PERPLEXITY_PROFILE || getActiveName() || "default";
+}
+
+/**
+ * Launch a browser suitable for the health check. Respects
+ * PERPLEXITY_BROWSER_CHANNEL / PERPLEXITY_BROWSER_PATH overrides from the
+ * extension's AuthManager.
+ */
+async function launchHealthBrowser() {
+  const probe = findBrowser();
+  return chromium.launch({
+    headless: true,
+    ...(probe ? { executablePath: probe.path } : {}),
+    ...(probe && ["chrome", "msedge", "chromium"].includes(probe.channel)
+      ? { channel: probe.channel }
+      : {}),
+  });
+}
+
+async function main() {
+  const PROFILE = resolveProfile();
+  const vault = new Vault();
+  const cookiesRaw = await vault.get(PROFILE, "cookies").catch(() => null);
+  if (!cookiesRaw) {
+    emit({ valid: false, reason: "no_cookies" });
+    process.exit(2);
+  }
+  const cookies = JSON.parse(cookiesRaw);
+  if (!Array.isArray(cookies) || cookies.length === 0) {
+    emit({ valid: false, reason: "no_cookies" });
+    process.exit(2);
+  }
+
+  const browser = await launchHealthBrowser();
+  let result;
+  try {
+    const ctx = await getOrCreateContext(browser);
+    // Patchright's addCookies wants EITHER url OR (domain+path), not both.
+    // Pass cookies with domain/url already set through untouched; only
+    // synthesize a url from ORIGIN when neither is present. Additionally,
+    // Chromium rejects `__Secure-`-prefixed cookies with `secure:false` —
+    // force the flag so imports from other tools stay usable (Chromium
+    // treats localhost/127.0.0.1 as secure origins, so the cookie will
+    // still be delivered over plain HTTP in tests).
+    const normalized = cookies.map((c) => {
+      const withSecure = c.name?.startsWith("__Secure-") ? { ...c, secure: true } : c;
+      return (withSecure.url || withSecure.domain) ? withSecure : { ...withSecure, url: `${ORIGIN}${withSecure.path ?? "/"}` };
+    });
+    await ctx.addCookies(normalized);
+    const page = await ctx.newPage();
+    // Navigate to an origin URL so page-context fetches are same-origin
+    // (required for `credentials: "include"` to attach the cookies we just
+    // injected). The default path `/account` exists on production; mock
+    // integration tests override via PERPLEXITY_LOGIN_PATH to point at the
+    // mock's `/login` route.
+    await page.goto(`${ORIGIN}${LOGIN_PATH}`, { waitUntil: "domcontentloaded" }).catch(() => {});
+
+    const metadata = await collectSessionMetadata(page, ORIGIN, { sessionTimeoutMs: 4_000 });
+
+    if (!metadata.sessionData?.user?.id) {
+      result = { valid: false, reason: "expired" };
+    } else {
+      result = {
+        valid: true,
+        tier: metadata.tier,
+        modelCount: Object.keys(metadata.models?.models ?? {}).length,
+        rateLimits: metadata.rateLimits ?? null,
+      };
+      try {
+        const paths = getProfilePaths(PROFILE);
+        if (!existsSync(paths.dir)) mkdirSync(paths.dir, { recursive: true });
+        writeFileSync(paths.modelsCache, JSON.stringify(metadata.cache, null, 2));
+      } catch {}
+    }
+  } finally {
+    await browser.close().catch(() => {});
+  }
+
+  emit(result);
+  process.exit(result.valid ? 0 : 2);
+}
+
+function emit(obj) {
+  process.stdout.write(JSON.stringify(obj) + "\n");
+}
+
+main().catch((err) => {
+  emit({ valid: false, reason: "crash", error: redact(String(err?.message ?? err)) });
+  process.exit(5);
+});

package/dist/health-check.mjs

@@ -0,0 +1,92 @@
+import {
+  collectSessionMetadata
+} from "./chunk-HU5B4FXS.mjs";
+import {
+  redact
+} from "./chunk-HMKLWVXB.mjs";
+import {
+  findBrowser,
+  getOrCreateContext
+} from "./chunk-LKJMLGFP.mjs";
+import {
+  Vault
+} from "./chunk-TQLCLE4L.mjs";
+import "./chunk-MTDFKNXX.mjs";
+import {
+  getActiveName,
+  getProfilePaths
+} from "./chunk-XKSWCEGI.mjs";
+import "./chunk-4UEJOM6W.mjs";
+
+// src/health-check.js
+import { writeFileSync, existsSync, mkdirSync } from "fs";
+import { chromium } from "patchright";
+var ORIGIN = process.env.PERPLEXITY_ORIGIN || "https://www.perplexity.ai";
+var LOGIN_PATH = process.env.PERPLEXITY_LOGIN_PATH || "/account";
+function resolveProfile() {
+  return process.env.PERPLEXITY_PROFILE || getActiveName() || "default";
+}
+async function launchHealthBrowser() {
+  const probe = findBrowser();
+  return chromium.launch({
+    headless: true,
+    ...probe ? { executablePath: probe.path } : {},
+    ...probe && ["chrome", "msedge", "chromium"].includes(probe.channel) ? { channel: probe.channel } : {}
+  });
+}
+async function main() {
+  const PROFILE = resolveProfile();
+  const vault = new Vault();
+  const cookiesRaw = await vault.get(PROFILE, "cookies").catch(() => null);
+  if (!cookiesRaw) {
+    emit({ valid: false, reason: "no_cookies" });
+    process.exit(2);
+  }
+  const cookies = JSON.parse(cookiesRaw);
+  if (!Array.isArray(cookies) || cookies.length === 0) {
+    emit({ valid: false, reason: "no_cookies" });
+    process.exit(2);
+  }
+  const browser = await launchHealthBrowser();
+  let result;
+  try {
+    const ctx = await getOrCreateContext(browser);
+    const normalized = cookies.map((c) => {
+      const withSecure = c.name?.startsWith("__Secure-") ? { ...c, secure: true } : c;
+      return withSecure.url || withSecure.domain ? withSecure : { ...withSecure, url: `${ORIGIN}${withSecure.path ?? "/"}` };
+    });
+    await ctx.addCookies(normalized);
+    const page = await ctx.newPage();
+    await page.goto(`${ORIGIN}${LOGIN_PATH}`, { waitUntil: "domcontentloaded" }).catch(() => {
+    });
+    const metadata = await collectSessionMetadata(page, ORIGIN, { sessionTimeoutMs: 4e3 });
+    if (!metadata.sessionData?.user?.id) {
+      result = { valid: false, reason: "expired" };
+    } else {
+      result = {
+        valid: true,
+        tier: metadata.tier,
+        modelCount: Object.keys(metadata.models?.models ?? {}).length,
+        rateLimits: metadata.rateLimits ?? null
+      };
+      try {
+        const paths = getProfilePaths(PROFILE);
+        if (!existsSync(paths.dir)) mkdirSync(paths.dir, { recursive: true });
+        writeFileSync(paths.modelsCache, JSON.stringify(metadata.cache, null, 2));
+      } catch {
+      }
+    }
+  } finally {
+    await browser.close().catch(() => {
+    });
+  }
+  emit(result);
+  process.exit(result.valid ? 0 : 2);
+}
+function emit(obj) {
+  process.stdout.write(JSON.stringify(obj) + "\n");
+}
+main().catch((err) => {
+  emit({ valid: false, reason: "crash", error: redact(String(err?.message ?? err)) });
+  process.exit(5);
+});

package/dist/history-store.d-BzjBF2m3.d.ts

@@ -0,0 +1,65 @@
+import { HistoryItem, HistoryEntryDetail } from '@perplexity-user-mcp/shared';
+
+interface HistoryStoreEntryInput extends Partial<HistoryItem> {
+  tool: string;
+  query: string;
+  body?: string;
+}
+
+interface RebuildIndexResult {
+  scanned: number;
+  recovered: number;
+  skipped: number;
+  items: Array<HistoryItem & { filename: string }>;
+}
+
+declare const HISTORY_LIMIT: number;
+declare function getHistoryDir(): string;
+declare function getAttachmentsRoot(): string;
+declare function getIndexPath(): string;
+declare function append(entry: HistoryStoreEntryInput): HistoryItem;
+declare function update(id: string, patch?: Partial<HistoryStoreEntryInput> & { body?: string }): HistoryItem | null;
+declare function list(options?: {
+  limit?: number;
+  status?: "completed" | "pending" | "failed";
+  tool?: string;
+  tools?: string[];
+  filter?: string;
+}): HistoryItem[];
+declare function get(id: string): HistoryEntryDetail | null;
+declare function deleteEntry(id: string): boolean;
+declare function pin(id: string, pinned: boolean): HistoryItem | null;
+declare function tag(id: string, tags: string[]): HistoryItem | null;
+declare function rebuildIndex(): RebuildIndexResult;
+declare function getMdPath(id: string): string | null;
+declare function getAttachmentsDir(id: string): string | null;
+declare function findPendingByThread(threadSlug: string): HistoryItem | null;
+declare function countAll(): number;
+declare function appendHistory(entry: HistoryStoreEntryInput): HistoryItem;
+declare function readHistory(limit?: number): HistoryItem[];
+
+interface CloudUpsertMeta {
+  backendUuid: string;
+  query?: string;
+  answerPreview?: string;
+  createdAt?: string;
+  threadUrl?: string;
+  threadSlug?: string | null;
+  readWriteToken?: string | null;
+  mode?: string | null;
+  model?: string | null;
+  sourceCount?: number;
+  status?: "completed" | "pending" | "failed";
+  tool?: string;
+  tier?: HistoryItem["tier"];
+  language?: string | null;
+}
+
+declare function findByBackendUuid(backendUuid: string | null | undefined): (HistoryItem & { filename: string }) | null;
+declare function upsertFromCloud(meta: CloudUpsertMeta): { action: "inserted" | "updated" | "skipped-local"; id: string };
+declare function hydrateCloudEntry(
+  id: string,
+  payload: { body?: string; sources?: HistoryItem["sources"]; attachments?: HistoryItem["attachments"]; answerPreview?: string; sourceCount?: number },
+): HistoryItem | null;
+
+export { type CloudUpsertMeta, HISTORY_LIMIT, type HistoryStoreEntryInput, type RebuildIndexResult, append, appendHistory, countAll, deleteEntry, findByBackendUuid, findPendingByThread, get, getAttachmentsDir, getAttachmentsRoot, getHistoryDir, getIndexPath, getMdPath, hydrateCloudEntry, list, pin, readHistory, rebuildIndex, tag, update, upsertFromCloud };

package/dist/history-store.d.ts

@@ -0,0 +1,65 @@
+import { HistoryItem, HistoryEntryDetail } from '@perplexity-user-mcp/shared';
+
+interface HistoryStoreEntryInput extends Partial<HistoryItem> {
+  tool: string;
+  query: string;
+  body?: string;
+}
+
+interface RebuildIndexResult {
+  scanned: number;
+  recovered: number;
+  skipped: number;
+  items: Array<HistoryItem & { filename: string }>;
+}
+
+declare const HISTORY_LIMIT: number;
+declare function getHistoryDir(): string;
+declare function getAttachmentsRoot(): string;
+declare function getIndexPath(): string;
+declare function append(entry: HistoryStoreEntryInput): HistoryItem;
+declare function update(id: string, patch?: Partial<HistoryStoreEntryInput> & { body?: string }): HistoryItem | null;
+declare function list(options?: {
+  limit?: number;
+  status?: "completed" | "pending" | "failed";
+  tool?: string;
+  tools?: string[];
+  filter?: string;
+}): HistoryItem[];
+declare function get(id: string): HistoryEntryDetail | null;
+declare function deleteEntry(id: string): boolean;
+declare function pin(id: string, pinned: boolean): HistoryItem | null;
+declare function tag(id: string, tags: string[]): HistoryItem | null;
+declare function rebuildIndex(): RebuildIndexResult;
+declare function getMdPath(id: string): string | null;
+declare function getAttachmentsDir(id: string): string | null;
+declare function findPendingByThread(threadSlug: string): HistoryItem | null;
+declare function countAll(): number;
+declare function appendHistory(entry: HistoryStoreEntryInput): HistoryItem;
+declare function readHistory(limit?: number): HistoryItem[];
+
+interface CloudUpsertMeta {
+  backendUuid: string;
+  query?: string;
+  answerPreview?: string;
+  createdAt?: string;
+  threadUrl?: string;
+  threadSlug?: string | null;
+  readWriteToken?: string | null;
+  mode?: string | null;
+  model?: string | null;
+  sourceCount?: number;
+  status?: "completed" | "pending" | "failed";
+  tool?: string;
+  tier?: HistoryItem["tier"];
+  language?: string | null;
+}
+
+declare function findByBackendUuid(backendUuid: string | null | undefined): (HistoryItem & { filename: string }) | null;
+declare function upsertFromCloud(meta: CloudUpsertMeta): { action: "inserted" | "updated" | "skipped-local"; id: string };
+declare function hydrateCloudEntry(
+  id: string,
+  payload: { body?: string; sources?: HistoryItem["sources"]; attachments?: HistoryItem["attachments"]; answerPreview?: string; sourceCount?: number },
+): HistoryItem | null;
+
+export { type CloudUpsertMeta, HISTORY_LIMIT, type HistoryStoreEntryInput, type RebuildIndexResult, append, appendHistory, countAll, deleteEntry, findByBackendUuid, findPendingByThread, get, getAttachmentsDir, getAttachmentsRoot, getHistoryDir, getIndexPath, getMdPath, hydrateCloudEntry, list, pin, readHistory, rebuildIndex, tag, update, upsertFromCloud };

package/dist/history-store.mjs

@@ -0,0 +1,48 @@
+import {
+  HISTORY_LIMIT,
+  append,
+  appendHistory,
+  countAll,
+  deleteEntry,
+  findByBackendUuid,
+  findPendingByThread,
+  get,
+  getAttachmentsDir,
+  getAttachmentsRoot,
+  getHistoryDir,
+  getIndexPath,
+  getMdPath,
+  hydrateCloudEntry,
+  list,
+  pin,
+  readHistory,
+  rebuildIndex,
+  tag,
+  update,
+  upsertFromCloud
+} from "./chunk-OF4DMAPJ.mjs";
+import "./chunk-XKSWCEGI.mjs";
+import "./chunk-4UEJOM6W.mjs";
+export {
+  HISTORY_LIMIT,
+  append,
+  appendHistory,
+  countAll,
+  deleteEntry,
+  findByBackendUuid,
+  findPendingByThread,
+  get,
+  getAttachmentsDir,
+  getAttachmentsRoot,
+  getHistoryDir,
+  getIndexPath,
+  getMdPath,
+  hydrateCloudEntry,
+  list,
+  pin,
+  readHistory,
+  rebuildIndex,
+  tag,
+  update,
+  upsertFromCloud
+};