@plaud-ai/mcp 0.3.8 → 0.3.9

package/dist/{chunk-DKOQXKKG.js → chunk-FSNFNJXH.js}

@@ -21,7 +21,29 @@ var toolHooks = null;
 var MAX_FILTER_PAGES = 5;
 var FILTER_PAGE_SIZE = 100;
 var TRANSCRIPT_PAGE_SIZE = 50;
-var TRANSCRIPT_BLOCKS = ["transaction", "outline", "transaction_polish"];
+var TRANSCRIPT_BLOCKS = ["transaction", "outline", "transaction_polish", "mark_memo"];
+var BLOCK_ITEMS_KEY = { mark_memo: "marks" };
+function linkBackedTypes(list) {
+  return (list ?? []).filter(
+    (b) => !(typeof b.data_content === "string" && b.data_content.length > 0) && typeof b.data_link === "string" && b.data_link.length > 0
+  ).map((b) => typeof b.data_type === "string" ? b.data_type : "(untyped)");
+}
+async function resolveNotes(noteList) {
+  return Promise.all(
+    noteList.map(async (note) => {
+      if (typeof note.data_content === "string" && note.data_content.length > 0) return note;
+      if (typeof note.data_link !== "string" || note.data_link.length === 0) return note;
+      try {
+        return { ...note, data_content: await loadBlockContent(note) };
+      } catch (err) {
+        return {
+          ...note,
+          data_content_error: err instanceof Error ? err.message : "Failed to fetch content from data_link"
+        };
+      }
+    })
+  );
+}
 function encodeTranscriptCursor(offset) {
   return Buffer.from(JSON.stringify({ o: offset }), "utf8").toString("base64url");
 }
@@ -175,6 +197,18 @@ function registerTools(server, client, hooks) {
           const synced = !!(file.duration || file.source_list && file.source_list.length);
           text += synced ? "\n\nNote: `presigned_url` (audio download URL) is null for this otherwise-synced recording. This is usually a transient backend signing issue \u2014 retry get_file in a few minutes to obtain the URL." : "\n\nNote: `presigned_url` (audio download URL) is null \u2014 audio may not yet be available for this recording.";
         }
+        const linkedBlocks = linkBackedTypes(file.source_list);
+        const linkedNotes = linkBackedTypes(file.note_list);
+        if (linkedBlocks.length) {
+          text += `
+
+Note: source_list ${linkedBlocks.map((t) => `\`${t}\``).join(", ")} returned an empty \`data_content\` \u2014 the body lives behind \`data_link\`, not missing. Call get_transcript with the matching \`block\` to read it (it fetches the link).`;
+        }
+        if (linkedNotes.length) {
+          text += `
+
+Note: note_list ${linkedNotes.map((t) => `\`${t}\``).join(", ")} returned an empty \`data_content\` \u2014 the body lives behind \`data_link\`, not missing. Call get_note to read it (it fetches the link).`;
+        }
         recordToolMetric("get_file", "success", Date.now() - start, requestId, { file_id });
         logger.info({ event: "tool_call_end", tool: "get_file", duration_ms: Date.now() - start, presigned_url_present: !!file.presigned_url });
         return { content: [{ type: "text", text }] };
@@ -188,7 +222,7 @@ function registerTools(server, client, hooks) {
   server.registerTool(
     "get_note",
     {
-      description: "Fetch AI-generated notes for a Plaud recording \u2014 compact summary, action items, and key topics",
+      description: "Fetch the notes on a Plaud recording \u2014 one entry per tab in the app, so usually more than one: the AI summary (action items, key topics), any template tab, a saved Ask Plaud answer, and the highlights note when the user pressed the highlight button while recording.",
       annotations: {
         title: "Get recording notes",
         readOnlyHint: true,
@@ -203,9 +237,10 @@ function registerTools(server, client, hooks) {
       const requestId = emitToolClick("get_note", { file_id });
       try {
         const file = await client.getFile(file_id);
+        const notes = await resolveNotes(file.note_list ?? []);
         recordToolMetric("get_note", "success", Date.now() - start, requestId, { file_id });
-        logger.info({ event: "tool_call_end", tool: "get_note", duration_ms: Date.now() - start });
-        return { content: [{ type: "text", text: JSON.stringify(file.note_list ?? [], null, 2) }] };
+        logger.info({ event: "tool_call_end", tool: "get_note", duration_ms: Date.now() - start, notes: notes.length });
+        return { content: [{ type: "text", text: JSON.stringify(notes, null, 2) }] };
       } catch (err) {
         recordToolMetric("get_note", "error", Date.now() - start, requestId, { file_id }, err);
         logger.error({ event: "tool_call_error", tool: "get_note", duration_ms: Date.now() - start, error: String(err) });
@@ -216,7 +251,7 @@ function registerTools(server, client, hooks) {
   server.registerTool(
     "get_transcript",
     {
-      description: "Fetch the timestamped transcript with speaker attribution for a Plaud recording. Defaults to the `transaction` block (real speaker names + timestamps), returned one page of utterances at a time to stay within client size limits \u2014 call again with the returned `next_cursor` to fetch the next page. Set `block` to `outline` or `transaction_polish` to fetch those blocks instead.",
+      description: "Fetch the timestamped transcript with speaker attribution for a Plaud recording. Defaults to the `transaction` block (real speaker names + timestamps), returned one page of utterances at a time to stay within client size limits \u2014 call again with the returned `next_cursor` to fetch the next page. Set `block` to `outline`, `transaction_polish`, or `mark_memo` (the moments the user flagged with the device's highlight button) to fetch those blocks instead.",
       annotations: {
         title: "Get recording transcript",
         readOnlyHint: true,
@@ -226,10 +261,10 @@ function registerTools(server, client, hooks) {
       inputSchema: {
         file_id: z.string().describe("The file ID to retrieve transcript for"),
         block: z.enum(TRANSCRIPT_BLOCKS).optional().describe(
-          "Which source block to fetch: `transaction` (default; raw transcript, speaker + timestamps), `transaction_polish` (AI-cleaned transcript; same per-utterance shape, keeps speaker + timestamps), or `outline`."
+          "Which source block to fetch: `transaction` (default; raw transcript, speaker + timestamps), `transaction_polish` (AI-cleaned transcript; same per-utterance shape, keeps speaker + timestamps), `outline`, or `mark_memo` (highlights: the moments flagged by pressing the button on the device during recording; present only when the button was pressed, and returned under `marks`). Pair `mark_memo` with a `transaction` call to map each flagged moment onto what was said there."
         ),
         cursor: z.string().optional().describe("Opaque pagination cursor from a previous call's `next_cursor`. Omit to start from the first utterance."),
-        limit: z.number().int().min(1).max(500).optional().describe(`Max utterances to return in this page (default ${TRANSCRIPT_PAGE_SIZE}). Only applies to blocks returned as an utterance list.`)
+        limit: z.number().int().min(1).max(500).optional().describe(`Max items to return in this page (default ${TRANSCRIPT_PAGE_SIZE}). Only applies to list-shaped blocks.`)
       }
     },
     async ({ file_id, block, cursor, limit }) => {
@@ -267,7 +302,7 @@ function registerTools(server, client, hooks) {
         if (!segments) {
           recordToolMetric("get_transcript", "success", Date.now() - start, requestId, { file_id });
           logger.info({ event: "tool_call_end", tool: "get_transcript", duration_ms: Date.now() - start, block: blockType, paginated: false });
-          const text = content || `Block "${blockType}" has no content for this recording yet.`;
+          const text = content || (blockType === "mark_memo" ? "This recording has a highlights block, but it is empty \u2014 no highlight was recorded." : `Block "${blockType}" has no content for this recording yet.`);
           return { content: [{ type: "text", text }] };
         }
         let offset = 0;
@@ -295,7 +330,7 @@ function registerTools(server, client, hooks) {
           limit: pageSize,
           returned: page.length,
           next_cursor: hasMore ? encodeTranscriptCursor(nextOffset) : null,
-          segments: page
+          [BLOCK_ITEMS_KEY[blockType] ?? "segments"]: page
         };
         recordToolMetric("get_transcript", "success", Date.now() - start, requestId, { file_id });
         logger.info({ event: "tool_call_end", tool: "get_transcript", duration_ms: Date.now() - start, block: blockType, paginated: true, total: segments.length, offset, returned: page.length });

package/dist/index.js

@@ -8,7 +8,7 @@ import {
 import {
   normalizeMcpHost,
   registerTools
-} from "./chunk-DKOQXKKG.js";
+} from "./chunk-FSNFNJXH.js";
 import {
   capture,
   classifyError,
@@ -31,7 +31,7 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import open from "open";
 var server = new McpServer({
   name: "plaud",
-  version: "0.3.8"
+  version: "0.3.9"
 });
 var CALLBACK_PORT = 8199;
 var LOGIN_TIMEOUT_MS = 12e4;
@@ -191,7 +191,7 @@ async function main() {
     return;
   }
   if (sub === "http") {
-    const { startHttpServer } = await import("./server-VJAFEGJ6.js");
+    const { startHttpServer } = await import("./server-SYSE62NO.js");
     const { startMetricsServer } = await import("./server-NKCNUA6P.js");
     startMetricsServer();
     startHttpServer();
@@ -217,7 +217,7 @@ Usage:
   try {
     await initTelemetry({
       surface: "mcp",
-      appVersion: "0.3.8",
+      appVersion: "0.3.9",
       transport: "stdio"
     });
   } catch {

package/dist/{server-VJAFEGJ6.js → server-SYSE62NO.js}

@@ -1,7 +1,7 @@
 import {
   normalizeMcpHost,
   registerTools
-} from "./chunk-DKOQXKKG.js";
+} from "./chunk-FSNFNJXH.js";
 import {
   PlaudClient
 } from "./chunk-5NWKLF3V.js";
@@ -276,6 +276,27 @@ function subFromJwt(token) {
     return void 0;
   }
 }
+var AUTO_RECOVERED_CLIENT_NAME = "auto-recovered client";
+var REDIRECT_HOST_CLIENT_NAMES = {
+  "chatgpt.com": "chatgpt",
+  "openai.com": "chatgpt",
+  "claude.ai": "claude",
+  "claude.com": "claude"
+};
+function clientNameFromRedirectUri(redirectUri) {
+  if (!redirectUri) return void 0;
+  let host;
+  try {
+    host = new URL(redirectUri).hostname.toLowerCase().replace(/^www\./, "");
+  } catch {
+    return void 0;
+  }
+  if (!host) return void 0;
+  for (const [domain, name] of Object.entries(REDIRECT_HOST_CLIENT_NAMES)) {
+    if (host === domain || host.endsWith(`.${domain}`)) return name;
+  }
+  return host;
+}
 var DEFAULT_TOKEN_URL = "https://platform.plaud.ai/developer/api/oauth/third-party/access-token";
 var DEFAULT_REFRESH_URL = "https://platform.plaud.ai/developer/api/oauth/third-party/access-token/refresh";
 var STATELESS_CODE_PREFIX = "pc1_";
@@ -532,12 +553,25 @@ var PlaudOAuthProvider = class extends ProxyOAuthServerProvider {
       if (redirectUri && !existing.redirect_uris.includes(redirectUri)) {
         existing.redirect_uris = [...existing.redirect_uris, redirectUri];
       }
+      if (existing.client_name === AUTO_RECOVERED_CLIENT_NAME) {
+        const upgradedName = clientNameFromRedirectUri(redirectUri);
+        if (upgradedName) {
+          existing.client_name = upgradedName;
+          logger.info({
+            event: "oauth_client_name_upgraded",
+            client_id: clientId,
+            name_source: "redirect_uri",
+            mcp_host: normalizeMcpHost(upgradedName) ?? null
+          });
+        }
+      }
       return true;
     }
     if (!this.verifyClientIdSignature(clientId)) {
       return false;
     }
     const recoveredName = this.decodeClientName(clientId);
+    const derivedName = recoveredName ?? clientNameFromRedirectUri(redirectUri);
     this._registeredClients.set(clientId, {
       client_id: clientId,
       client_id_issued_at: Math.floor(Date.now() / 1e3),
@@ -545,13 +579,20 @@ var PlaudOAuthProvider = class extends ProxyOAuthServerProvider {
       grant_types: ["authorization_code", "refresh_token"],
       response_types: ["code"],
       token_endpoint_auth_method: "none",
-      client_name: recoveredName ?? "auto-recovered client"
+      client_name: derivedName ?? AUTO_RECOVERED_CLIENT_NAME
     });
     logger.info({
       event: "oauth_client_recovered",
       client_id: clientId,
       redirect_uri: redirectUri ?? null,
-      name_recovered: recoveredName != null
+      // Unchanged semantics: true only when the name came out of the client_id
+      // itself — this is the field used to verify the #72 fix in prod.
+      name_recovered: recoveredName != null,
+      name_source: recoveredName != null ? "client_id" : derivedName != null ? "redirect_uri" : null,
+      // The bucket this recovery will put on every downstream auth event. Lets us
+      // verify attribution straight from prod logs (the warehouse events are
+      // batched, so they're not a live signal), and enumerate real hosts.
+      mcp_host: normalizeMcpHost(derivedName) ?? null
     });
     return true;
   }
@@ -600,7 +641,9 @@ var PlaudOAuthProvider = class extends ProxyOAuthServerProvider {
     res.redirect(targetUrl.toString());
   }
   /**
-   * Called when Plaud redirects to our /oauth/callback.
+   * Called when Plaud redirects to our /auth/callback (CALLBACK_PATH in
+   * http/server.ts). NOT /oauth/callback — this comment said so until 2026-08-19
+   * and a downstream client registration was configured from it by mistake.
    * Looks up the original client redirect_uri and forwards the code+state to it.
    */
   handleCallback(code, state, res) {
@@ -1183,6 +1226,7 @@ var OPENAI_APPS_CHALLENGE_TOKEN = "bBlB7N7fF7YaQnONtEQNAGP7SLaqpJT3a3DS5Zv1F8s";
 var OAUTH_DEBUG_LOGS = !["0", "false", "no", "off"].includes(
   (process.env.PLAUD_OAUTH_DEBUG_LOGS ?? "").toLowerCase()
 );
+var ROOT_REDIRECT_URL = process.env.PLAUD_ROOT_REDIRECT_URL ?? "https://www.plaud.ai";
 var CIMD_ENABLED = ["1", "true", "yes", "on"].includes(
   (process.env.PLAUD_CIMD_ENABLED ?? "").toLowerCase()
 );
@@ -1239,8 +1283,8 @@ function startHttpServer() {
     common: {
       serviceName: process.env.PLAUD_WAREHOUSE_SERVICE_NAME ?? "plaudmcp",
       // matches §1.3 key label `plaudmcp:TRACKING_KEY_PLAUDMCP`; confirm exact string with David
-      serviceVersion: "0.3.8",
-      buildId: "be0dfaa",
+      serviceVersion: "0.3.9",
+      buildId: "ee2ff6d",
       // mcp tsup TODO: inject git short SHA (like CLI)
       region: process.env.PLAUD_REGION ?? "US",
       env: process.env.PLAUD_ENV ?? process.env.NODE_ENV ?? "development"
@@ -1333,6 +1377,9 @@ function startHttpServer() {
       }
     });
   });
+  app.get("/", (_req, res) => {
+    res.redirect(302, ROOT_REDIRECT_URL);
+  });
   if (process.env.PLAUD_CALLBACK_URL) {
     app.get(CALLBACK_PATH, (req, res) => {
       const code = req.query["code"];
@@ -1509,7 +1556,7 @@ function startHttpServer() {
         apiBase,
         staticToken: token
       });
-      const mcpServer = new McpServer({ name: "plaud", version: "0.3.8" });
+      const mcpServer = new McpServer({ name: "plaud", version: "0.3.9" });
       registerTools(mcpServer, client, warehouseToolHooks);
       const transport = new StreamableHTTPServerTransport({
         sessionIdGenerator: void 0,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plaud-ai/mcp",
-  "version": "0.3.8",
+  "version": "0.3.9",
   "type": "module",
   "main": "dist/index.js",
   "bin": {
@@ -8,7 +8,6 @@
   },
   "files": [
     "dist",
-    "plugin.json",
     ".mcp.json",
     "skills"
   ],
@@ -18,7 +17,7 @@
     "build": "tsup",
     "dev": "tsup --watch",
     "clean": "rm -rf dist skills",
-    "prepublishOnly": "node -e \"const fs=require('fs'),v=require('./package.json').version,p=JSON.parse(fs.readFileSync('./plugin.json','utf8'));p.version=v;fs.writeFileSync('./plugin.json',JSON.stringify(p,null,2)+'\\n');\""
+    "prepublishOnly": "node -e \"const fs=require('fs'),v=require('./package.json').version,f='../../plugin.json',p=JSON.parse(fs.readFileSync(f,'utf8'));p.version=v;fs.writeFileSync(f,JSON.stringify(p,null,2)+'\\n');\""
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.12.0",

package/skills/plaud-read/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: plaud-read
 version: 1.0.0
-description: "Read the transcript, AI summary, notes, or download audio for a specific Plaud recording. Use when the user says 'show the transcript', 'summarize this', 'what was said', 'get audio', 'the notes from', or names a specific recording to dig into. Also covers extracting structured fields from a recording."
+description: "Read the transcript, AI summary, notes, highlights, or download audio for a specific Plaud recording. Use when the user says 'show the transcript', 'summarize this', 'what was said', 'get audio', 'the notes from', 'my highlights', 'the moments I flagged', 'what I marked while recording', or names a specific recording to dig into. Also covers extracting structured fields from a recording."
 metadata:
   requires:
     bins: []
@@ -14,7 +14,7 @@ metadata:
 ## When to use
 
 - User names a specific recording (by name or ID) and wants to read its content.
-- User asks for "transcript", "summary", "action items", "audio", "who said what", or a structured extraction ("action items, decisions, attendees").
+- User asks for "transcript", "summary", "action items", "audio", "who said what", "my highlights" / "the moments I flagged", or a structured extraction ("action items, decisions, attendees").
 - If the user did **not** specify a recording, hand off to `plaud-find` (by topic) or `plaud-browse` (by recency) first.
 
 ## Tool selection matrix
@@ -23,8 +23,9 @@ metadata:
 |---|---|---|
 | AI summary, TL;DR, action items | `get_note` | Returns Markdown; usually enough — try this before `get_transcript` |
 | Verbatim quotes, full dialogue | `get_transcript` | Timestamped; paginated — follow `next_cursor` for long recordings |
+| Highlights — "the moments I flagged", "what I marked while recording" | `get_transcript` with `block: "mark_memo"` | Returned under `marks`. Exists only if the user pressed the device's highlight button; also surfaced as the `high_light` note by `get_note`. To turn marks into quotes, pair with a `transaction` call and match on the timestamps |
 | Audio download link | `get_file` then use `presigned_url` | Link expires in 24h |
-| Full metadata + availability flags | `get_file` | Check `source_list` / `note_list` populated before claiming content exists |
+| Full metadata + availability flags | `get_file` | Lists which blocks exist. **An entry with `data_content: ""` and a `data_link` is not empty** — its body is link-backed; read it with `get_transcript` / `get_note`, which resolve the link. Never report such a block as missing data |
 
 ## Structured extraction workflow
 

package/skills/plaud-shared/SKILL.md

@@ -19,15 +19,31 @@ metadata:
 
 ## Tool inventory
 
-| Tool | Purpose |
-|---|---|
-| `login` | Open browser for OAuth; blocks until callback or 2-min timeout |
-| `logout` | Revoke and clear tokens |
-| `get_current_user` | Verify who is signed in |
-| `list_files` | Browse, paginate, filter recordings (supports `query`, `date_from`, `date_to`) |
-| `get_file` | Full record incl. `presigned_url`, `source_list`, `note_list` |
-| `get_note` | AI-generated summary and action items |
-| `get_transcript` | Timestamped transcript with speaker labels |
+| Tool | Purpose | Local | Remote |
+|---|---|---|---|
+| `login` | Open browser for OAuth; blocks until callback or 2-min timeout | ✅ | — |
+| `logout` | Revoke and clear tokens | ✅ | — |
+| `get_current_user` | Verify who is signed in | ✅ | ✅ |
+| `list_files` | Browse, paginate, filter recordings (supports `query`, `date_from`, `date_to`) | ✅ | ✅ |
+| `get_file` | Full record incl. `presigned_url`, `source_list`, `note_list` | ✅ | ✅ |
+| `get_note` | AI-generated summary and action items | ✅ | ✅ |
+| `get_transcript` | Timestamped transcript with speaker labels | ✅ | ✅ |
+
+**Local** = the stdio server (`npx @plaud-ai/mcp`). **Remote** = a hosted connector
+the host dials by URL. Remote has no `login` / `logout`: authorization runs as a
+browser OAuth redirect driven by the host, not as a tool call. On a remote
+connector, treat "sign in" as something the user does in the host's UI.
+
+### Tool names may carry a host-applied prefix
+
+The names above are the canonical ones the server registers. Some hosts namespace
+them with the connector name the user chose. WorkBuddy, for example, turns a
+connector named `plaudcn` into `plaudcn_list_files`, `plaudcn_get_transcript`, and
+so on — the prefix follows the user's own config, so it is not predictable.
+
+**Always resolve tools from the list you were actually given, matching on the
+canonical suffix** (`…list_files`, `…get_transcript`). Never assume a bare name is
+callable, and never hard-code a prefix.
 
 ## Error semantics
 

package/plugin.json

@@ -1,8 +0,0 @@
-{
-  "name": "plaud",
-  "version": "0.3.8",
-  "description": "Access your Plaud recordings in Claude",
-  "author": {
-    "name": "Plaud AI"
-  }
-}