@plaud-ai/mcp 0.3.4 → 0.3.6

package/dist/{chunk-LOGKF7DL.js → chunk-3K3M2X74.js}

@@ -1,7 +1,7 @@
 import {
   PlaudClient,
   capture
-} from "./chunk-D2JZW2TW.js";
+} from "./chunk-OYI4PXYP.js";
 import {
   httpClientDuration,
   httpClientRequests

package/dist/{chunk-D2JZW2TW.js → chunk-OYI4PXYP.js}

@@ -82,6 +82,16 @@ var TokenStore = class {
 };
 
 // ../shared/dist/oauth.js
+function clientUserIdFromAccessToken(token) {
+  if (!token)
+    return void 0;
+  try {
+    const payload = JSON.parse(Buffer.from(token.split(".")[1], "base64url").toString());
+    return typeof payload.sub === "string" && payload.sub.length > 0 ? payload.sub : void 0;
+  } catch {
+    return void 0;
+  }
+}
 var DEFAULT_AUTHORIZATION_URL = "https://web.plaud.ai/platform/oauth";
 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";
@@ -419,6 +429,23 @@ function runOAuthCallback(opts) {
   });
 }
 
+// ../shared/dist/source-block.js
+async function loadBlockContent(block) {
+  if (!block)
+    return "";
+  const inline = block.data_content;
+  if (typeof inline === "string" && inline.length > 0)
+    return inline;
+  const link = block.data_link;
+  if (typeof link === "string" && link.length > 0) {
+    const res = await fetch(link);
+    if (!res.ok)
+      throw new Error(`Failed to fetch block content from data_link (HTTP ${res.status})`);
+    return await res.text();
+  }
+  return "";
+}
+
 // ../telemetry/dist/client.js
 import { PostHog } from "posthog-node";
 
@@ -497,6 +524,8 @@ var EMAIL_REGEX = /[\w.+-]+@[\w-]+\.[\w.-]+/;
 var ALLOWED_PROPERTIES = /* @__PURE__ */ new Set([
   // Global common properties (Plaud Common Event Properties + Spec §2)
   "user_id",
+  "client_user_id",
+  // per-OAuth-client user id (JWT sub, `client_user_…`); DA common param across web/CLI/stdio/HTTP (Mirela 2026-06-29)
   "member_id",
   // fill-if-present; OAuth /users/current doesn't return it yet (Q16)
   "workspace_id",
@@ -696,6 +725,7 @@ var state = {
   memberId: null,
   workspaceId: null,
   role: null,
+  clientUserId: null,
   mcpHost: null
 };
 async function initTelemetry(options) {
@@ -716,6 +746,7 @@ async function initTelemetry(options) {
   state.memberId = identity?.memberId ?? null;
   state.workspaceId = identity?.workspaceId ?? null;
   state.role = identity?.role ?? null;
+  state.clientUserId = identity?.clientUserId ?? null;
   state.currentDistinctId = identity?.idHash || userId || await getAnonymousId();
   state.initialised = true;
 }
@@ -727,6 +758,7 @@ async function setUser(userId, identity) {
   state.memberId = identity?.memberId ?? null;
   state.workspaceId = identity?.workspaceId ?? null;
   state.role = identity?.role ?? null;
+  state.clientUserId = identity?.clientUserId ?? null;
   if (state.surface) {
     try {
       await saveUserIdentity(state.surface, userId, identity);
@@ -752,6 +784,7 @@ async function clearUser() {
   state.memberId = null;
   state.workspaceId = null;
   state.role = null;
+  state.clientUserId = null;
   if (state.surface) {
     try {
       await clearUserIdentity(state.surface);
@@ -797,6 +830,8 @@ function buildCommonProperties() {
     out.transport = state.transport;
   if (state.currentUserId)
     out.user_id = state.currentUserId;
+  if (state.clientUserId)
+    out.client_user_id = state.clientUserId;
   if (state.memberId)
     out.member_id = state.memberId;
   if (state.workspaceId)
@@ -820,8 +855,10 @@ function extractIdentity(user) {
 export {
   classifyError,
   oauthCallbackErrorType,
+  clientUserIdFromAccessToken,
   PlaudClient,
   runOAuthCallback,
+  loadBlockContent,
   shutdown,
   initTelemetry,
   setUser,

package/dist/{chunk-XWDA3G2U.js → chunk-YOMRLHNX.js}

@@ -1,7 +1,8 @@
 import {
   capture,
-  classifyError
-} from "./chunk-D2JZW2TW.js";
+  classifyError,
+  loadBlockContent
+} from "./chunk-OYI4PXYP.js";
 import {
   logger
 } from "./chunk-NPCCDRWQ.js";
@@ -16,6 +17,22 @@ import { randomUUID } from "crypto";
 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"];
+function encodeTranscriptCursor(offset) {
+  return Buffer.from(JSON.stringify({ o: offset }), "utf8").toString("base64url");
+}
+function decodeTranscriptCursor(cursor) {
+  try {
+    const parsed = JSON.parse(Buffer.from(cursor, "base64url").toString("utf8"));
+    if (typeof parsed?.o === "number" && Number.isInteger(parsed.o) && parsed.o >= 0) {
+      return parsed.o;
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}
 function parseDate(s) {
   if (!s) return null;
   const d = new Date(s);
@@ -198,24 +215,90 @@ function registerTools(server, client, hooks) {
   server.registerTool(
     "get_transcript",
     {
-      description: "Fetch the full timestamped transcript with speaker attribution for a Plaud recording",
+      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.",
       annotations: {
         title: "Get recording transcript",
         readOnlyHint: true,
         destructiveHint: false,
         openWorldHint: true
       },
-      inputSchema: { file_id: z.string().describe("The file ID to retrieve transcript for") }
+      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`."
+        ),
+        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.`)
+      }
     },
-    async ({ file_id }) => {
+    async ({ file_id, block, cursor, limit }) => {
       const start = Date.now();
-      logger.info({ event: "tool_call", tool: "get_transcript", file_id });
+      const blockType = block ?? "transaction";
+      logger.info({ event: "tool_call", tool: "get_transcript", file_id, block: blockType });
       const requestId = emitToolClick("get_transcript", { file_id });
       try {
         const file = await client.getFile(file_id);
+        const sourceList = file.source_list ?? [];
+        if (sourceList.length === 0) {
+          recordToolMetric("get_transcript", "success", Date.now() - start, requestId, { file_id });
+          logger.info({ event: "tool_call_end", tool: "get_transcript", duration_ms: Date.now() - start, paginated: false });
+          return { content: [{ type: "text", text: JSON.stringify(file.source_list ?? [], null, 2) }] };
+        }
+        const selected = sourceList.find((s) => s.data_type === blockType);
+        if (!selected) {
+          const available = sourceList.map((s) => s.data_type).filter(Boolean).join(", ") || "(none)";
+          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, found: false });
+          return {
+            content: [{ type: "text", text: `Block "${blockType}" not available for this recording. Available blocks: ${available}.` }]
+          };
+        }
+        const content = await loadBlockContent(selected);
+        let segments = null;
+        if (content) {
+          try {
+            const parsed = JSON.parse(content);
+            if (Array.isArray(parsed)) segments = parsed;
+          } catch {
+            segments = null;
+          }
+        }
+        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.`;
+          return { content: [{ type: "text", text }] };
+        }
+        let offset = 0;
+        if (cursor !== void 0) {
+          const decoded = decodeTranscriptCursor(cursor);
+          if (decoded === null) {
+            recordToolMetric("get_transcript", "error", Date.now() - start, requestId, { file_id }, new Error("invalid_cursor"));
+            logger.warn({ event: "tool_call_end", tool: "get_transcript", duration_ms: Date.now() - start, error: "invalid_cursor" });
+            return {
+              content: [{ type: "text", text: "Invalid cursor. Omit `cursor` to start from the first utterance." }],
+              isError: true
+            };
+          }
+          offset = decoded;
+        }
+        const pageSize = limit ?? TRANSCRIPT_PAGE_SIZE;
+        const page = segments.slice(offset, offset + pageSize);
+        const nextOffset = offset + page.length;
+        const hasMore = nextOffset < segments.length;
+        const payload = {
+          file_id,
+          block: blockType,
+          total: segments.length,
+          offset,
+          limit: pageSize,
+          returned: page.length,
+          next_cursor: hasMore ? encodeTranscriptCursor(nextOffset) : null,
+          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 });
-        return { content: [{ type: "text", text: JSON.stringify(file.source_list ?? [], null, 2) }] };
+        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 });
+        return { content: [{ type: "text", text: JSON.stringify(payload, null, 2) }] };
       } catch (err) {
         recordToolMetric("get_transcript", "error", Date.now() - start, requestId, { file_id }, err);
         logger.error({ event: "tool_call_error", tool: "get_transcript", duration_ms: Date.now() - start, error: String(err) });

package/dist/index.js

@@ -1,18 +1,19 @@
 #!/usr/bin/env node
 import {
   getClient
-} from "./chunk-LOGKF7DL.js";
+} from "./chunk-3K3M2X74.js";
 import {
   loadSkills
 } from "./chunk-242FRP4P.js";
 import {
   normalizeMcpHost,
   registerTools
-} from "./chunk-XWDA3G2U.js";
+} from "./chunk-YOMRLHNX.js";
 import {
   capture,
   classifyError,
   clearUser,
+  clientUserIdFromAccessToken,
   extractIdentity,
   initTelemetry,
   oauthCallbackErrorType,
@@ -20,7 +21,7 @@ import {
   setMcpHost,
   setUser,
   shutdown
-} from "./chunk-D2JZW2TW.js";
+} from "./chunk-OYI4PXYP.js";
 import "./chunk-NPCCDRWQ.js";
 import "./chunk-RUFCT6DQ.js";
 
@@ -30,7 +31,7 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import open from "open";
 var server = new McpServer({
   name: "plaud",
-  version: "0.3.4"
+  version: "0.3.6"
 });
 var CALLBACK_PORT = 8199;
 var LOGIN_TIMEOUT_MS = 12e4;
@@ -81,7 +82,11 @@ server.registerTool("login", {
       try {
         const user = await client.getCurrentUser();
         if (user && typeof user.id === "string") {
-          await setUser(user.id, extractIdentity(user));
+          const token = await client.auth.getAccessToken();
+          await setUser(user.id, {
+            ...extractIdentity(user),
+            clientUserId: clientUserIdFromAccessToken(token)
+          });
         }
       } catch {
       }
@@ -153,7 +158,7 @@ async function main() {
   const sub = process.argv[2];
   const sub2 = process.argv[3];
   if (sub === "install") {
-    const { runInstall } = await import("./install-ETBOS6SA.js");
+    const { runInstall } = await import("./install-3E63G6QX.js");
     const args = process.argv.slice(3);
     const yes = args.some((a) => a === "--yes" || a === "-y");
     const noLogin = args.some((a) => a === "--no-login");
@@ -186,7 +191,7 @@ async function main() {
     return;
   }
   if (sub === "http") {
-    const { startHttpServer } = await import("./server-VVQEILKC.js");
+    const { startHttpServer } = await import("./server-PJTOHPPJ.js");
     const { startMetricsServer } = await import("./server-NKCNUA6P.js");
     startMetricsServer();
     startHttpServer();
@@ -212,7 +217,7 @@ Usage:
   try {
     await initTelemetry({
       surface: "mcp",
-      appVersion: "0.3.4",
+      appVersion: "0.3.6",
       transport: "stdio"
     });
   } catch {

package/dist/{install-ETBOS6SA.js → install-3E63G6QX.js}

@@ -1,6 +1,6 @@
 import {
   getClient
-} from "./chunk-LOGKF7DL.js";
+} from "./chunk-3K3M2X74.js";
 import {
   commandPathIsStale,
   copyToClipboard,
@@ -12,7 +12,7 @@ import {
 } from "./chunk-242FRP4P.js";
 import {
   runOAuthCallback
-} from "./chunk-D2JZW2TW.js";
+} from "./chunk-OYI4PXYP.js";
 import "./chunk-RUFCT6DQ.js";
 
 // src/install.ts

package/dist/{server-VVQEILKC.js → server-PJTOHPPJ.js}

@@ -1,10 +1,10 @@
 import {
   normalizeMcpHost,
   registerTools
-} from "./chunk-XWDA3G2U.js";
+} from "./chunk-YOMRLHNX.js";
 import {
   PlaudClient
-} from "./chunk-D2JZW2TW.js";
+} from "./chunk-OYI4PXYP.js";
 import {
   logger
 } from "./chunk-NPCCDRWQ.js";
@@ -610,31 +610,6 @@ var PlaudOAuthProvider = class extends ProxyOAuthServerProvider {
     });
     res.redirect(target.toString());
   }
-  /**
-   * Resolve the REAL Plaud user_id (the `/users/current` `id` field) from a fresh
-   * access token — the same id the CLI/stdio telemetry and the Plaud app use, so
-   * warehouse auth.* events join with tool events, subscription and frontend data.
-   * The JWT `sub` is only an OAuth pseudo-id (`client_user_…`), so we resolve via
-   * the API. Best-effort: on any failure fall back to the JWT sub, so the event
-   * still carries a stable id and the auth flow is never blocked.
-   */
-  async resolveRealUserId(accessToken) {
-    if (!accessToken) return void 0;
-    try {
-      const client = new PlaudClient({
-        clientId: this._plaudClientId,
-        clientSecret: "",
-        redirectUri: "",
-        apiBase: this._plaudApiBase,
-        staticToken: accessToken
-      });
-      const user = await client.getCurrentUser();
-      const id = typeof user?.id === "string" ? user.id : void 0;
-      return id ?? subFromJwt(accessToken);
-    } catch {
-      return subFromJwt(accessToken);
-    }
-  }
   // Override to use PKCE public-client flow — no Basic auth, client_id sent in body.
   async exchangeAuthorizationCode(client, authorizationCode, codeVerifier, _redirectUri, resource) {
     const failedAuth = (failureKind) => {
@@ -710,7 +685,7 @@ var PlaudOAuthProvider = class extends ProxyOAuthServerProvider {
       throw new McpServerError("Token endpoint returned non-JSON response");
     }
     logger.info({ event: "oauth_token_exchange_ok", has_refresh_token: !!data.refresh_token });
-    const authorizedUserId = await this.resolveRealUserId(data.access_token);
+    const authorizedUserId = subFromJwt(data.access_token);
     this._tracker?.track({
       name: "auth.oauth_callback_success",
       actorType: "user",
@@ -782,12 +757,11 @@ var PlaudOAuthProvider = class extends ProxyOAuthServerProvider {
       throw new McpServerError("Refresh endpoint returned non-JSON response");
     }
     oauthTokenRefresh.inc({ result: "success" });
-    const refreshedUserId = await this.resolveRealUserId(data.access_token);
     this._tracker?.track({
       name: "auth.token_refresh_success",
       actorType: "user",
-      userId: refreshedUserId,
-      distinctId: refreshedUserId ?? client.client_id
+      userId: subFromJwt(data.access_token),
+      distinctId: subFromJwt(data.access_token) ?? client.client_id
     });
     logger.info({
       event: "oauth_token_refresh_ok",
@@ -1231,8 +1205,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.4",
-      buildId: "ce4457b",
+      serviceVersion: "0.3.6",
+      buildId: "3c993f6",
       // 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"
@@ -1473,7 +1447,7 @@ function startHttpServer() {
         apiBase,
         staticToken: token
       });
-      const mcpServer = new McpServer({ name: "plaud", version: "0.3.4" });
+      const mcpServer = new McpServer({ name: "plaud", version: "0.3.6" });
       registerTools(mcpServer, client, warehouseToolHooks);
       const transport = new StreamableHTTPServerTransport({
         sessionIdGenerator: void 0,
@@ -1481,7 +1455,8 @@ function startHttpServer() {
         enableDnsRebindingProtection: true,
         allowedOrigins: ALLOWED_ORIGINS
       });
-      const ctxUserId = req.auth.clientId && req.auth.clientId !== "unknown" ? req.auth.clientId : void 0;
+      const fallbackClientId = req.auth.clientId && req.auth.clientId !== "unknown" ? req.auth.clientId : void 0;
+      const ctxUserId = subFromJwt(token) ?? fallbackClientId;
       const telemetryCtx = {
         userId: ctxUserId,
         requestId: reqId,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plaud-ai/mcp",
-  "version": "0.3.4",
+  "version": "0.3.6",
   "type": "module",
   "main": "dist/index.js",
   "bin": {

package/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "plaud",
-  "version": "0.3.4",
+  "version": "0.3.6",
   "description": "Access your Plaud recordings in Claude",
   "author": {
     "name": "Plaud AI"

package/skills/plaud-read/SKILL.md

@@ -22,7 +22,7 @@ metadata:
 | User wants | Tool | Notes |
 |---|---|---|
 | AI summary, TL;DR, action items | `get_note` | Returns Markdown; usually enough — try this before `get_transcript` |
-| Verbatim quotes, full dialogue | `get_transcript` | Timestamped; larger |
+| Verbatim quotes, full dialogue | `get_transcript` | Timestamped; paginated — follow `next_cursor` for long recordings |
 | 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 |
 
@@ -47,5 +47,5 @@ Common schemas:
 
 ## Anti-patterns
 
-- Do not call `get_transcript` speculatively — it's the largest payload.
+- Do not call `get_transcript` speculatively — it's the largest payload (paged; a long recording needs several `next_cursor` calls).
 - Do not paraphrase the AI summary unless the user asked; quote it verbatim.