perplexity-user-mcp 0.8.52 → 0.8.53

package/README.md

@@ -273,6 +273,31 @@ Path: `~/.config/opencode/opencode.json`.
 - `perplexity_login` — returns login instructions (interactive login runs via the CLI / extension)
 - `perplexity_doctor` — run diagnostic checks across browser, profile, auth, and network and return a Markdown report (pass `probe:true` for a live search probe)
 
+## Prompts (custom slash-commands)
+
+The server also exposes MCP **prompts** — reusable templates that show up as `/slash-commands` in clients that support them (Claude Desktop, Cursor, …). Five are built in:
+
+- `perplexity.researchPlan` `{topic}` · `perplexity.reasoningPlan` `{question}`
+- `perplexity-fact-check` `{claim}` · `perplexity-compare` `{optionA} {optionB}` · `perplexity-latest` `{topic}`
+
+You can add your own (and override/reset the built-ins) without touching code — they're read from `~/.perplexity-mcp/prompts.json`:
+
+```json
+{
+  "overrides": {},
+  "custom": [
+    {
+      "name": "my-summary",
+      "description": "Summarize a URL with citations",
+      "arguments": [{ "name": "url", "description": "Page to summarize", "required": true }],
+      "template": "Use perplexity_search to read {url} and summarize the key points with citations."
+    }
+  ]
+}
+```
+
+`{arg}` placeholders are substituted with the values the client passes. Built-in names live under `overrides`; everything else is a `custom` entry. The **VS Code extension's "Prompts" tab** is a visual editor for this file. Clients cache the prompt list at connect-time, so reconnect (or reload the window) after editing to pick up changes; the embedded daemon refreshes on its next connection automatically.
+
 ## Search sources and advanced queries
 
 Search-style tools support Perplexity source focus through a `sources` argument:

package/dist/{chunk-CV6NITDS.mjs → chunk-2PXHRVDZ.mjs}

@@ -1,9 +1,9 @@
 import {
   ensureDaemon
-} from "./chunk-MIHIG4M4.mjs";
+} from "./chunk-OUQRRFAU.mjs";
 import {
   getPackageVersion
-} from "./chunk-OOSSV7G3.mjs";
+} from "./chunk-ZUOZ5KXV.mjs";
 
 // src/daemon/client-http.ts
 import { randomUUID } from "crypto";

package/dist/chunk-5IKZJVZZ.mjs

@@ -0,0 +1,127 @@
+import {
+  safeAtomicWriteFileSync
+} from "./chunk-MTDFKNXX.mjs";
+import {
+  getConfigDir
+} from "./chunk-E3GRJXXJ.mjs";
+
+// src/prompts-config.ts
+import { mkdirSync, readFileSync } from "fs";
+import { dirname, join } from "path";
+var CUSTOM_NAME_RE = /^[a-z][a-z0-9-]*$/;
+var ARG_RE = /\{([a-z][a-zA-Z0-9]*)\}/g;
+var BUILTIN_PROMPTS = [
+  {
+    name: "perplexity.researchPlan",
+    description: "Deep research brief on a topic, routed to perplexity_research.",
+    arguments: [{ name: "topic", description: "The subject to research", required: true }],
+    template: 'Use perplexity_research to produce a sourced research brief about "{topic}". Emphasize citations, key findings, and next questions.'
+  },
+  {
+    name: "perplexity.reasoningPlan",
+    description: "Step-by-step reasoning on a question, routed to perplexity_reason.",
+    arguments: [{ name: "question", description: "The question to reason about", required: true }],
+    template: "Use perplexity_reason on the following question and provide the reasoning trace plus a concise final answer: {question}"
+  },
+  {
+    name: "perplexity-fact-check",
+    description: "Verify a claim with cited primary sources via perplexity_search.",
+    arguments: [{ name: "claim", description: "The statement to verify", required: true }],
+    template: "Use perplexity_search to verify the following claim and cite primary sources. State clearly whether it is true, false, misleading, or unverifiable, and explain the evidence.\n\nClaim: {claim}"
+  },
+  {
+    name: "perplexity-compare",
+    description: "Compare two options with a sourced comparison table.",
+    arguments: [
+      { name: "optionA", description: "First option", required: true },
+      { name: "optionB", description: "Second option", required: true }
+    ],
+    template: "Use perplexity_search to compare {optionA} and {optionB}. Produce a concise comparison table of the key differences, then a recommendation backed by cited sources."
+  },
+  {
+    name: "perplexity-latest",
+    description: "Find the latest developments on a topic via perplexity_search.",
+    arguments: [{ name: "topic", description: "The topic to track", required: true }],
+    template: 'Use perplexity_search to find the latest developments about "{topic}" from the past few weeks. Prioritize recent, credible sources and cite publication dates.'
+  }
+];
+function promptsConfigPath(configDir = getConfigDir()) {
+  return join(configDir, "prompts.json");
+}
+function normalizeConfig(raw) {
+  const obj = raw && typeof raw === "object" ? raw : {};
+  const overrides = obj.overrides && typeof obj.overrides === "object" && !Array.isArray(obj.overrides) ? obj.overrides : {};
+  const custom = Array.isArray(obj.custom) ? obj.custom : [];
+  return { overrides, custom };
+}
+function readPromptsConfig(configDir = getConfigDir()) {
+  try {
+    return normalizeConfig(JSON.parse(readFileSync(promptsConfigPath(configDir), "utf8")));
+  } catch {
+    return { overrides: {}, custom: [] };
+  }
+}
+function writePromptsConfig(config, configDir = getConfigDir()) {
+  const p = promptsConfigPath(configDir);
+  mkdirSync(dirname(p), { recursive: true });
+  safeAtomicWriteFileSync(p, JSON.stringify(config, null, 2) + "\n", "utf8");
+}
+function toStored(prompt) {
+  return {
+    name: prompt.name,
+    description: prompt.description,
+    arguments: (prompt.arguments ?? []).map((a) => ({
+      name: a.name,
+      description: a.description,
+      required: !!a.required
+    })),
+    template: prompt.template
+  };
+}
+function mergePrompts(config) {
+  const builtinNames = new Set(BUILTIN_PROMPTS.map((b) => b.name));
+  const builtins = BUILTIN_PROMPTS.map((b) => {
+    const override = config.overrides[b.name];
+    const base = override ?? b;
+    return { ...toStored(base), name: b.name, isBuiltin: true, isModified: !!override };
+  });
+  const custom = config.custom.filter((c) => c && c.name && !builtinNames.has(c.name)).map((c) => ({ ...toStored(c), isBuiltin: false, isModified: false }));
+  return [...builtins, ...custom];
+}
+function upsertPrompt(config, prompt) {
+  const stored = toStored(prompt);
+  if (BUILTIN_PROMPTS.some((b) => b.name === stored.name)) {
+    return { ...config, overrides: { ...config.overrides, [stored.name]: stored } };
+  }
+  const exists = config.custom.some((c) => c.name === stored.name);
+  const custom = exists ? config.custom.map((c) => c.name === stored.name ? stored : c) : [...config.custom, stored];
+  return { ...config, custom };
+}
+function deleteCustomPrompt(config, name) {
+  return { ...config, custom: config.custom.filter((c) => c.name !== name) };
+}
+function resetBuiltin(config, name) {
+  if (!(name in config.overrides)) return config;
+  const overrides = { ...config.overrides };
+  delete overrides[name];
+  return { ...config, overrides };
+}
+function substituteTemplate(template, args) {
+  return template.replace(ARG_RE, (_match, key) => {
+    const value = args[key];
+    return value == null ? "" : String(value);
+  });
+}
+
+export {
+  CUSTOM_NAME_RE,
+  BUILTIN_PROMPTS,
+  promptsConfigPath,
+  readPromptsConfig,
+  writePromptsConfig,
+  mergePrompts,
+  upsertPrompt,
+  deleteCustomPrompt,
+  resetBuiltin,
+  substituteTemplate
+};

package/dist/{chunk-E7GU4PUX.mjs → chunk-HAO6U55U.mjs}

@@ -1,6 +1,6 @@
 import {
   ensureDaemon
-} from "./chunk-MIHIG4M4.mjs";
+} from "./chunk-OUQRRFAU.mjs";
 
 // src/daemon/attach.ts
 import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";

package/dist/{chunk-MIHIG4M4.mjs → chunk-OUQRRFAU.mjs}

@@ -13,7 +13,7 @@ import {
 import {
   getPackageVersion,
   startDaemonServer
-} from "./chunk-OOSSV7G3.mjs";
+} from "./chunk-ZUOZ5KXV.mjs";
 import {
   ensureToken,
   getTokenPath,
@@ -25,7 +25,7 @@ import {
 } from "./chunk-3LUO5ATM.mjs";
 import {
   PerplexityClient
-} from "./chunk-SF3BG2IA.mjs";
+} from "./chunk-XQ32SABC.mjs";
 import {
   getActiveName,
   getConfigDir

package/dist/{chunk-REY5WMXY.mjs → chunk-V7HUK4A5.mjs}

@@ -2,7 +2,7 @@ import {
   PerplexityClient,
   getCloudThreadViaImpit,
   listCloudThreadsViaImpit
-} from "./chunk-SF3BG2IA.mjs";
+} from "./chunk-XQ32SABC.mjs";
 import {
   hydrateCloudEntry,
   upsertFromCloud

package/dist/{chunk-OOSSV7G3.mjs → chunk-ZUOZ5KXV.mjs}

@@ -1,23 +1,31 @@
+import {
+  ensureToken,
+  getTokenPath,
+  rotateToken
+} from "./chunk-DKEJZ4FI.mjs";
 import {
   appendAuditEntry,
   getAuditLogPath,
   readAuditTail
 } from "./chunk-TSLRTZYR.mjs";
 import {
-  ensureToken,
-  getTokenPath,
-  rotateToken
-} from "./chunk-DKEJZ4FI.mjs";
+  mergePrompts,
+  readPromptsConfig,
+  substituteTemplate
+} from "./chunk-5IKZJVZZ.mjs";
 import {
   hydrateCloudHistoryEntry,
   syncCloudHistory
-} from "./chunk-REY5WMXY.mjs";
+} from "./chunk-V7HUK4A5.mjs";
 import {
   PerplexityClient,
   exportThreadViaImpit,
   readCachedAccountInfoFromDisk,
   retrieveThreadViaImpit
-} from "./chunk-SF3BG2IA.mjs";
+} from "./chunk-XQ32SABC.mjs";
+import {
+  safeAtomicWriteFileSync
+} from "./chunk-MTDFKNXX.mjs";
 import {
   append,
   findPendingByThread,
@@ -27,9 +35,6 @@ import {
   list,
   update
 } from "./chunk-6E6XTHTG.mjs";
-import {
-  safeAtomicWriteFileSync
-} from "./chunk-MTDFKNXX.mjs";
 import {
   getConfigDir
 } from "./chunk-E3GRJXXJ.mjs";
@@ -44,51 +49,49 @@ import express from "express";
 
 // src/prompts.ts
 import { z } from "zod";
+function buildArgsSchema(args) {
+  const shape = {};
+  for (const arg of args) {
+    if (!arg?.name) continue;
+    let field = z.string();
+    if (arg.description) field = field.describe(arg.description);
+    shape[arg.name] = arg.required ? field : field.optional();
+  }
+  return shape;
+}
 function registerPrompts(server) {
-  server.registerPrompt(
-    "perplexity.researchPlan",
-    {
-      title: "Perplexity Research Plan",
-      description: "Generate a prompt that routes to the deep research tool.",
-      argsSchema: {
-        topic: z.string()
-      }
-    },
-    ({ topic }) => ({
-      description: `Deep research prompt for ${topic}`,
+  const prompts = mergePrompts(readPromptsConfig());
+  const seen = /* @__PURE__ */ new Set();
+  for (const prompt of prompts) {
+    if (!prompt.name || seen.has(prompt.name)) continue;
+    seen.add(prompt.name);
+    const render = (args = {}) => ({
+      description: prompt.description,
       messages: [
         {
           role: "user",
-          content: {
-            type: "text",
-            text: `Use perplexity_research to produce a sourced research brief about "${topic}". Emphasize citations, key findings, and next questions.`
-          }
+          content: { type: "text", text: substituteTemplate(prompt.template, args) }
         }
       ]
-    })
-  );
-  server.registerPrompt(
-    "perplexity.reasoningPlan",
-    {
-      title: "Perplexity Reasoning Plan",
-      description: "Generate a prompt that routes to the reasoning tool.",
-      argsSchema: {
-        question: z.string()
+    });
+    try {
+      if (prompt.arguments.length === 0) {
+        server.registerPrompt(prompt.name, { title: prompt.name, description: prompt.description }, () => render());
+      } else {
+        server.registerPrompt(
+          prompt.name,
+          {
+            title: prompt.name,
+            description: prompt.description,
+            argsSchema: buildArgsSchema(prompt.arguments)
+          },
+          (args) => render(args)
+        );
       }
-    },
-    ({ question }) => ({
-      description: `Reasoning prompt for ${question}`,
-      messages: [
-        {
-          role: "user",
-          content: {
-            type: "text",
-            text: `Use perplexity_reason on the following question and provide the reasoning trace plus a concise final answer: ${question}`
-          }
-        }
-      ]
-    })
-  );
+    } catch (err) {
+      console.error(`[perplexity-mcp] failed to register prompt '${prompt.name}':`, err);
+    }
+  }
 }
 
 // src/resources.ts

package/dist/client.mjs

@@ -8,10 +8,10 @@ import {
   readCachedAccountInfoFromDisk,
   retrieveThreadViaImpit,
   searchPerplexityViaImpit
-} from "./chunk-SF3BG2IA.mjs";
+} from "./chunk-XQ32SABC.mjs";
 import "./chunk-KVV3JBSN.mjs";
-import "./chunk-2GOOGBD6.mjs";
 import "./chunk-ZQZC634I.mjs";
+import "./chunk-2GOOGBD6.mjs";
 import "./chunk-2FBDBRC5.mjs";
 import "./chunk-C5I7KXHK.mjs";
 import "./chunk-MTDFKNXX.mjs";

package/dist/cloud-sync.mjs

@@ -1,15 +1,15 @@
 import {
   hydrateCloudHistoryEntry,
   syncCloudHistory
-} from "./chunk-REY5WMXY.mjs";
-import "./chunk-SF3BG2IA.mjs";
+} from "./chunk-V7HUK4A5.mjs";
+import "./chunk-XQ32SABC.mjs";
 import "./chunk-KVV3JBSN.mjs";
-import "./chunk-2GOOGBD6.mjs";
-import "./chunk-6E6XTHTG.mjs";
 import "./chunk-ZQZC634I.mjs";
+import "./chunk-2GOOGBD6.mjs";
 import "./chunk-2FBDBRC5.mjs";
 import "./chunk-C5I7KXHK.mjs";
 import "./chunk-MTDFKNXX.mjs";
+import "./chunk-6E6XTHTG.mjs";
 import "./chunk-E3GRJXXJ.mjs";
 import "./chunk-4UEJOM6W.mjs";
 export {

package/dist/daemon/attach.mjs

@@ -1,25 +1,26 @@
 import {
   DaemonAttachError,
   attachToDaemon
-} from "../chunk-E7GU4PUX.mjs";
-import "../chunk-MIHIG4M4.mjs";
+} from "../chunk-HAO6U55U.mjs";
+import "../chunk-OUQRRFAU.mjs";
 import "../chunk-LGH5BSUY.mjs";
 import "../chunk-6YMQVLFX.mjs";
 import "../chunk-TIWHN4IW.mjs";
 import "../chunk-NMKNEEZB.mjs";
-import "../chunk-OOSSV7G3.mjs";
-import "../chunk-TSLRTZYR.mjs";
+import "../chunk-ZUOZ5KXV.mjs";
 import "../chunk-DKEJZ4FI.mjs";
+import "../chunk-TSLRTZYR.mjs";
 import "../chunk-3LUO5ATM.mjs";
-import "../chunk-REY5WMXY.mjs";
-import "../chunk-SF3BG2IA.mjs";
+import "../chunk-5IKZJVZZ.mjs";
+import "../chunk-V7HUK4A5.mjs";
+import "../chunk-XQ32SABC.mjs";
 import "../chunk-KVV3JBSN.mjs";
-import "../chunk-2GOOGBD6.mjs";
-import "../chunk-6E6XTHTG.mjs";
 import "../chunk-ZQZC634I.mjs";
+import "../chunk-2GOOGBD6.mjs";
 import "../chunk-2FBDBRC5.mjs";
 import "../chunk-C5I7KXHK.mjs";
 import "../chunk-MTDFKNXX.mjs";
+import "../chunk-6E6XTHTG.mjs";
 import "../chunk-E3GRJXXJ.mjs";
 import "../chunk-4UEJOM6W.mjs";
 export {

package/dist/daemon/client-http.mjs

@@ -2,25 +2,26 @@ import {
   exportHistoryViaDaemon,
   hydrateCloudHistoryEntryViaDaemon,
   syncCloudHistoryViaDaemon
-} from "../chunk-CV6NITDS.mjs";
-import "../chunk-MIHIG4M4.mjs";
+} from "../chunk-2PXHRVDZ.mjs";
+import "../chunk-OUQRRFAU.mjs";
 import "../chunk-LGH5BSUY.mjs";
 import "../chunk-6YMQVLFX.mjs";
 import "../chunk-TIWHN4IW.mjs";
 import "../chunk-NMKNEEZB.mjs";
-import "../chunk-OOSSV7G3.mjs";
-import "../chunk-TSLRTZYR.mjs";
+import "../chunk-ZUOZ5KXV.mjs";
 import "../chunk-DKEJZ4FI.mjs";
+import "../chunk-TSLRTZYR.mjs";
 import "../chunk-3LUO5ATM.mjs";
-import "../chunk-REY5WMXY.mjs";
-import "../chunk-SF3BG2IA.mjs";
+import "../chunk-5IKZJVZZ.mjs";
+import "../chunk-V7HUK4A5.mjs";
+import "../chunk-XQ32SABC.mjs";
 import "../chunk-KVV3JBSN.mjs";
-import "../chunk-2GOOGBD6.mjs";
-import "../chunk-6E6XTHTG.mjs";
 import "../chunk-ZQZC634I.mjs";
+import "../chunk-2GOOGBD6.mjs";
 import "../chunk-2FBDBRC5.mjs";
 import "../chunk-C5I7KXHK.mjs";
 import "../chunk-MTDFKNXX.mjs";
+import "../chunk-6E6XTHTG.mjs";
 import "../chunk-E3GRJXXJ.mjs";
 import "../chunk-4UEJOM6W.mjs";
 export {

package/dist/daemon/index.mjs

@@ -2,10 +2,10 @@ import {
   exportHistoryViaDaemon,
   hydrateCloudHistoryEntryViaDaemon,
   syncCloudHistoryViaDaemon
-} from "../chunk-CV6NITDS.mjs";
+} from "../chunk-2PXHRVDZ.mjs";
 import {
   attachToDaemon
-} from "../chunk-E7GU4PUX.mjs";
+} from "../chunk-HAO6U55U.mjs";
 import {
   disableDaemonTunnel,
   enableDaemonTunnel,
@@ -21,7 +21,7 @@ import {
   rotateDaemonToken,
   startDaemon,
   stopDaemon
-} from "../chunk-MIHIG4M4.mjs";
+} from "../chunk-OUQRRFAU.mjs";
 import "../chunk-LGH5BSUY.mjs";
 import {
   extractTunnelUrl,
@@ -43,12 +43,7 @@ import {
 } from "../chunk-NMKNEEZB.mjs";
 import {
   startDaemonServer
-} from "../chunk-OOSSV7G3.mjs";
-import {
-  appendAuditEntry,
-  getAuditLogPath,
-  readAuditTail
-} from "../chunk-TSLRTZYR.mjs";
+} from "../chunk-ZUOZ5KXV.mjs";
 import {
   ensureToken,
   generateBearerToken,
@@ -56,16 +51,22 @@ import {
   readToken,
   rotateToken
 } from "../chunk-DKEJZ4FI.mjs";
+import {
+  appendAuditEntry,
+  getAuditLogPath,
+  readAuditTail
+} from "../chunk-TSLRTZYR.mjs";
 import "../chunk-3LUO5ATM.mjs";
-import "../chunk-REY5WMXY.mjs";
-import "../chunk-SF3BG2IA.mjs";
+import "../chunk-5IKZJVZZ.mjs";
+import "../chunk-V7HUK4A5.mjs";
+import "../chunk-XQ32SABC.mjs";
 import "../chunk-KVV3JBSN.mjs";
-import "../chunk-2GOOGBD6.mjs";
-import "../chunk-6E6XTHTG.mjs";
 import "../chunk-ZQZC634I.mjs";
+import "../chunk-2GOOGBD6.mjs";
 import "../chunk-2FBDBRC5.mjs";
 import "../chunk-C5I7KXHK.mjs";
 import "../chunk-MTDFKNXX.mjs";
+import "../chunk-6E6XTHTG.mjs";
 import "../chunk-E3GRJXXJ.mjs";
 import "../chunk-4UEJOM6W.mjs";
 export {

package/dist/daemon/launcher.mjs

@@ -13,24 +13,25 @@ import {
   rotateDaemonToken,
   startDaemon,
   stopDaemon
-} from "../chunk-MIHIG4M4.mjs";
+} from "../chunk-OUQRRFAU.mjs";
 import "../chunk-LGH5BSUY.mjs";
 import "../chunk-6YMQVLFX.mjs";
 import "../chunk-TIWHN4IW.mjs";
 import "../chunk-NMKNEEZB.mjs";
-import "../chunk-OOSSV7G3.mjs";
-import "../chunk-TSLRTZYR.mjs";
+import "../chunk-ZUOZ5KXV.mjs";
 import "../chunk-DKEJZ4FI.mjs";
+import "../chunk-TSLRTZYR.mjs";
 import "../chunk-3LUO5ATM.mjs";
-import "../chunk-REY5WMXY.mjs";
-import "../chunk-SF3BG2IA.mjs";
+import "../chunk-5IKZJVZZ.mjs";
+import "../chunk-V7HUK4A5.mjs";
+import "../chunk-XQ32SABC.mjs";
 import "../chunk-KVV3JBSN.mjs";
-import "../chunk-2GOOGBD6.mjs";
-import "../chunk-6E6XTHTG.mjs";
 import "../chunk-ZQZC634I.mjs";
+import "../chunk-2GOOGBD6.mjs";
 import "../chunk-2FBDBRC5.mjs";
 import "../chunk-C5I7KXHK.mjs";
 import "../chunk-MTDFKNXX.mjs";
+import "../chunk-6E6XTHTG.mjs";
 import "../chunk-E3GRJXXJ.mjs";
 import "../chunk-4UEJOM6W.mjs";
 export {

package/dist/daemon/server.mjs

@@ -1,18 +1,19 @@
 import {
   resolveRequestResource,
   startDaemonServer
-} from "../chunk-OOSSV7G3.mjs";
-import "../chunk-TSLRTZYR.mjs";
+} from "../chunk-ZUOZ5KXV.mjs";
 import "../chunk-DKEJZ4FI.mjs";
-import "../chunk-REY5WMXY.mjs";
-import "../chunk-SF3BG2IA.mjs";
+import "../chunk-TSLRTZYR.mjs";
+import "../chunk-5IKZJVZZ.mjs";
+import "../chunk-V7HUK4A5.mjs";
+import "../chunk-XQ32SABC.mjs";
 import "../chunk-KVV3JBSN.mjs";
-import "../chunk-2GOOGBD6.mjs";
-import "../chunk-6E6XTHTG.mjs";
 import "../chunk-ZQZC634I.mjs";
+import "../chunk-2GOOGBD6.mjs";
 import "../chunk-2FBDBRC5.mjs";
 import "../chunk-C5I7KXHK.mjs";
 import "../chunk-MTDFKNXX.mjs";
+import "../chunk-6E6XTHTG.mjs";
 import "../chunk-E3GRJXXJ.mjs";
 import "../chunk-4UEJOM6W.mjs";
 export {

package/dist/doctor.mjs

@@ -4,7 +4,7 @@ import {
   formatReportMarkdown,
   rollupStatus,
   runAll
-} from "./chunk-S2XSNVXF.mjs";
+} from "./chunk-ANX7Q4F5.mjs";
 import "./chunk-E3GRJXXJ.mjs";
 import "./chunk-4UEJOM6W.mjs";
 export {

package/dist/index.mjs

@@ -1,22 +1,11 @@
 #!/usr/bin/env node
-import {
-  CATEGORIES,
-  formatReportMarkdown,
-  runAll
-} from "./chunk-S2XSNVXF.mjs";
-import {
-  buildIssueBody,
-  buildIssueUrl,
-  decideTransport,
-  redactIssueBody
-} from "./chunk-DPGMKSSA.mjs";
 import {
   attachToDaemon
-} from "./chunk-E7GU4PUX.mjs";
+} from "./chunk-HAO6U55U.mjs";
 import {
   ensureDaemon,
   startDaemon
-} from "./chunk-MIHIG4M4.mjs";
+} from "./chunk-OUQRRFAU.mjs";
 import "./chunk-LGH5BSUY.mjs";
 import "./chunk-6YMQVLFX.mjs";
 import "./chunk-TIWHN4IW.mjs";
@@ -35,31 +24,53 @@ import {
   registerTools,
   saveToolConfig,
   watchToolConfig
-} from "./chunk-OOSSV7G3.mjs";
-import "./chunk-TSLRTZYR.mjs";
+} from "./chunk-ZUOZ5KXV.mjs";
 import "./chunk-DKEJZ4FI.mjs";
+import "./chunk-TSLRTZYR.mjs";
 import {
   watchActiveProfile,
   watchReinit
 } from "./chunk-3LUO5ATM.mjs";
+import {
+  CATEGORIES,
+  formatReportMarkdown,
+  runAll
+} from "./chunk-ANX7Q4F5.mjs";
+import {
+  buildIssueBody,
+  buildIssueUrl,
+  decideTransport,
+  redactIssueBody
+} from "./chunk-DPGMKSSA.mjs";
 import {
   isMainModule
 } from "./chunk-GPUGKWXH.mjs";
 import "./chunk-HMKLWVXB.mjs";
+import "./chunk-5IKZJVZZ.mjs";
 import {
   hydrateCloudHistoryEntry,
   syncCloudHistory
-} from "./chunk-REY5WMXY.mjs";
+} from "./chunk-V7HUK4A5.mjs";
 import {
   PerplexityClient
-} from "./chunk-SF3BG2IA.mjs";
+} from "./chunk-XQ32SABC.mjs";
 import "./chunk-KVV3JBSN.mjs";
+import {
+  exportThread
+} from "./chunk-ZQZC634I.mjs";
 import {
   getImpitRuntimeDir,
   getModelsCacheInfo,
   isImpitAvailable,
   refreshAccountInfo
 } from "./chunk-2GOOGBD6.mjs";
+import {
+  findBrowser
+} from "./chunk-2FBDBRC5.mjs";
+import {
+  getUnsealMaterial
+} from "./chunk-C5I7KXHK.mjs";
+import "./chunk-MTDFKNXX.mjs";
 import {
   append,
   countAll,
@@ -80,16 +91,6 @@ import {
   update,
   upsertFromCloud
 } from "./chunk-6E6XTHTG.mjs";
-import {
-  exportThread
-} from "./chunk-ZQZC634I.mjs";
-import {
-  findBrowser
-} from "./chunk-2FBDBRC5.mjs";
-import {
-  getUnsealMaterial
-} from "./chunk-C5I7KXHK.mjs";
-import "./chunk-MTDFKNXX.mjs";
 import {
   getActiveName
 } from "./chunk-E3GRJXXJ.mjs";

package/dist/prompts-config.d.ts

@@ -0,0 +1,56 @@
+/** A single declared argument of a prompt template. */
+export interface PromptArg {
+    name: string;
+    description: string;
+    required: boolean;
+}
+/** A prompt as persisted on disk (no computed flags). */
+export interface StoredPrompt {
+    name: string;
+    description: string;
+    arguments: PromptArg[];
+    template: string;
+}
+/** A merged prompt as rendered in the dashboard + registered with the server. */
+export interface PromptDef extends StoredPrompt {
+    isBuiltin: boolean;
+    isModified: boolean;
+}
+/** On-disk shape of `prompts.json`. */
+export interface PromptsConfig {
+    /** Built-in name → user override of that built-in. */
+    overrides: Record<string, StoredPrompt>;
+    /** Fully user-defined prompts. */
+    custom: StoredPrompt[];
+}
+/** Valid custom slash-command name: lowercase, digits, hyphens; leading letter. */
+export declare const CUSTOM_NAME_RE: RegExp;
+/**
+ * Shipped prompts. Always present (unless overridden); cannot be deleted.
+ * Names mix the original dotted built-ins (kept for back-compat) with the
+ * hyphenated convention recommended for new custom prompts.
+ */
+export declare const BUILTIN_PROMPTS: StoredPrompt[];
+/** Absolute path to the prompts file. */
+export declare function promptsConfigPath(configDir?: string): string;
+/** Read + normalize `prompts.json`. Returns an empty config on miss/parse error. */
+export declare function readPromptsConfig(configDir?: string): PromptsConfig;
+/** Atomically persist `prompts.json` (creates the config dir if needed). */
+export declare function writePromptsConfig(config: PromptsConfig, configDir?: string): void;
+/**
+ * Merge built-ins + overrides + custom into the flat list the UI/server use.
+ * Built-ins come first (overridden in place), then custom prompts. A custom
+ * prompt may not shadow a built-in name.
+ */
+export declare function mergePrompts(config: PromptsConfig): PromptDef[];
+/**
+ * Upsert a prompt. A built-in name writes/updates an override; any other name
+ * upserts the custom list. Returns a new config (pure).
+ */
+export declare function upsertPrompt(config: PromptsConfig, prompt: StoredPrompt): PromptsConfig;
+/** Remove a custom prompt by name. Built-ins are unaffected. */
+export declare function deleteCustomPrompt(config: PromptsConfig, name: string): PromptsConfig;
+/** Clear a built-in's override, reverting it to the shipped default. */
+export declare function resetBuiltin(config: PromptsConfig, name: string): PromptsConfig;
+/** Replace `{arg}` placeholders with provided values (missing → empty string). */
+export declare function substituteTemplate(template: string, args: Record<string, unknown>): string;

package/dist/prompts-config.mjs

@@ -0,0 +1,27 @@
+import {
+  BUILTIN_PROMPTS,
+  CUSTOM_NAME_RE,
+  deleteCustomPrompt,
+  mergePrompts,
+  promptsConfigPath,
+  readPromptsConfig,
+  resetBuiltin,
+  substituteTemplate,
+  upsertPrompt,
+  writePromptsConfig
+} from "./chunk-5IKZJVZZ.mjs";
+import "./chunk-MTDFKNXX.mjs";
+import "./chunk-E3GRJXXJ.mjs";
+import "./chunk-4UEJOM6W.mjs";
+export {
+  BUILTIN_PROMPTS,
+  CUSTOM_NAME_RE,
+  deleteCustomPrompt,
+  mergePrompts,
+  promptsConfigPath,
+  readPromptsConfig,
+  resetBuiltin,
+  substituteTemplate,
+  upsertPrompt,
+  writePromptsConfig
+};

package/dist/prompts.d.ts

@@ -1,2 +1,11 @@
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Register all prompts — shipped built-ins (merged with any user overrides)
+ * plus user-defined custom prompts from `<configDir>/prompts.json`. Called by
+ * the stdio entrypoint once at startup and by the daemon per HTTP request
+ * (which is why daemon clients pick up edits on their next connection).
+ *
+ * Reads the config synchronously; never throws. A single malformed prompt is
+ * logged and skipped rather than failing the whole registration.
+ */
 export declare function registerPrompts(server: McpServer): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "perplexity-user-mcp",
-  "version": "0.8.52",
+  "version": "0.8.53",
   "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.",
@@ -88,6 +88,10 @@
       "types": "./dist/config.d.ts",
       "import": "./dist/config.mjs"
     },
+    "./prompts-config": {
+      "types": "./dist/prompts-config.d.ts",
+      "import": "./dist/prompts-config.mjs"
+    },
     "./refresh": {
       "types": "./dist/refresh.d.ts",
       "import": "./dist/refresh.mjs"

package/dist/{chunk-SF3BG2IA.mjs → chunk-XQ32SABC.mjs}

@@ -1,15 +1,15 @@
 import {
   OFFSCREEN_POSITION_ARG
 } from "./chunk-KVV3JBSN.mjs";
-import {
-  impitFetchJson,
-  isImpitAvailable
-} from "./chunk-2GOOGBD6.mjs";
 import {
   FORMAT_TO_CONTENT_TYPE,
   exportThread,
   resolveExportApiFormat
 } from "./chunk-ZQZC634I.mjs";
+import {
+  impitFetchJson,
+  isImpitAvailable
+} from "./chunk-2GOOGBD6.mjs";
 import {
   ASI_ACCESS_ENDPOINT,
   AUTH_SESSION_ENDPOINT,