@plaud-ai/mcp 0.2.4 → 0.3.1

package/dist/chunk-RUFCT6DQ.js

@@ -0,0 +1,60 @@
+// src/metrics/registry.ts
+import { Registry, Counter, Histogram, Gauge, collectDefaultMetrics } from "prom-client";
+var registry = new Registry();
+collectDefaultMetrics({ register: registry });
+var httpRequestDuration = new Histogram({
+  name: "http_request_duration_seconds",
+  help: "HTTP request latency in seconds",
+  labelNames: ["method", "handler", "status"],
+  buckets: [0.01, 0.05, 0.1, 0.25, 0.5, 1, 2.5, 5, 10],
+  registers: [registry]
+});
+var httpRequestsInProgress = new Gauge({
+  name: "http_requests_in_progress",
+  help: "Number of in-progress HTTP requests",
+  labelNames: ["method", "handler"],
+  registers: [registry]
+});
+var mcpToolCalls = new Counter({
+  name: "mcp_tool_calls_total",
+  help: "MCP tool invocation count",
+  labelNames: ["tool", "status"],
+  registers: [registry]
+});
+var mcpToolDuration = new Histogram({
+  name: "mcp_tool_duration_seconds",
+  help: "MCP tool execution latency in seconds",
+  labelNames: ["tool"],
+  buckets: [0.05, 0.1, 0.25, 0.5, 1, 2.5, 5, 10, 30],
+  registers: [registry]
+});
+var oauthTokenRefresh = new Counter({
+  name: "oauth_token_refresh_total",
+  help: "OAuth token refresh attempts grouped by outcome",
+  labelNames: ["result"],
+  registers: [registry]
+});
+var httpClientRequests = new Counter({
+  name: "http_client_requests_total",
+  help: "Outbound HTTP requests to upstream services",
+  labelNames: ["host", "endpoint", "status"],
+  registers: [registry]
+});
+var httpClientDuration = new Histogram({
+  name: "http_client_duration_seconds",
+  help: "Outbound HTTP request latency in seconds",
+  labelNames: ["host", "endpoint"],
+  buckets: [0.05, 0.1, 0.25, 0.5, 1, 2.5, 5, 10],
+  registers: [registry]
+});
+
+export {
+  registry,
+  httpRequestDuration,
+  httpRequestsInProgress,
+  mcpToolCalls,
+  mcpToolDuration,
+  oauthTokenRefresh,
+  httpClientRequests,
+  httpClientDuration
+};

package/dist/{chunk-BZOIX6WC.js → chunk-XA77WLYF.js}

@@ -1,12 +1,18 @@
-// src/logger.ts
-import pino from "pino";
-var logger = pino(
-  { level: process.env.LOG_LEVEL ?? "info" },
-  pino.destination(2)
-);
+import {
+  capture,
+  classifyError
+} from "./chunk-R5G6UXSI.js";
+import {
+  logger
+} from "./chunk-NPCCDRWQ.js";
+import {
+  mcpToolCalls,
+  mcpToolDuration
+} from "./chunk-RUFCT6DQ.js";
 
 // src/tools/index.ts
 import { z } from "zod";
+import { randomUUID } from "crypto";
 var MAX_FILTER_PAGES = 5;
 var FILTER_PAGE_SIZE = 100;
 function parseDate(s) {
@@ -15,6 +21,38 @@ function parseDate(s) {
   if (Number.isNaN(d.getTime())) return null;
   return d.getTime();
 }
+function normalizeMcpHost(name) {
+  if (!name) return void 0;
+  const n = name.trim().toLowerCase();
+  if (!n) return void 0;
+  if (n === "claude-ai" || n.includes("claude desktop") || n.includes("claude-desktop")) return "claude_desktop";
+  if (n.includes("claude code") || n.includes("claude-code")) return "claude_code";
+  if (n.includes("cursor")) return "cursor";
+  if (n.includes("windsurf")) return "windsurf";
+  if (n.includes("cline")) return "cline";
+  if (n.includes("continue")) return "continue";
+  if (n.includes("vscode") || n.includes("vs code")) return "vscode";
+  return n;
+}
+function emitToolClick(tool, props = {}) {
+  const requestId = randomUUID();
+  capture("mcp:tool:click", { tool_name: tool, request_id: requestId, passive: false, ...props });
+  return requestId;
+}
+function recordToolMetric(tool, status, durationMs, requestId, props = {}, err) {
+  mcpToolCalls.inc({ tool, status });
+  mcpToolDuration.observe({ tool }, durationMs / 1e3);
+  const event = status === "success" ? "mcp:tool:success" : "mcp:tool:error";
+  const evProps = {
+    tool_name: tool,
+    request_id: requestId,
+    passive: true,
+    ...props
+  };
+  if (status === "success") evProps.duration_ms = durationMs;
+  else evProps.error_type = classifyError(err);
+  capture(event, evProps);
+}
 function registerTools(server, client) {
   server.registerTool(
     "list_files",
@@ -38,9 +76,11 @@ function registerTools(server, client) {
       const start = Date.now();
       const hasFilter = Boolean(query || date_from || date_to);
       logger.info({ event: "tool_call", tool: "list_files", has_filter: hasFilter });
+      const requestId = emitToolClick("list_files");
       try {
         if (!hasFilter) {
           const result = await client.listFiles(page, page_size);
+          recordToolMetric("list_files", "success", Date.now() - start, requestId);
           logger.info({ event: "tool_call_end", tool: "list_files", duration_ms: Date.now() - start });
           return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
         }
@@ -68,6 +108,7 @@ function registerTools(server, client) {
           if (items.length < FILTER_PAGE_SIZE) break;
           if (p === MAX_FILTER_PAGES) truncated = true;
         }
+        recordToolMetric("list_files", "success", Date.now() - start, requestId);
         logger.info({ event: "tool_call_end", tool: "list_files", duration_ms: Date.now() - start, scanned, matched: matches.length, truncated });
         return {
           content: [{ type: "text", text: JSON.stringify({
@@ -79,6 +120,7 @@ function registerTools(server, client) {
           }, null, 2) }]
         };
       } catch (err) {
+        recordToolMetric("list_files", "error", Date.now() - start, requestId, {}, err);
         logger.error({ event: "tool_call_error", tool: "list_files", duration_ms: Date.now() - start, error: String(err) });
         return { content: [{ type: "text", text: `Failed to list files: ${err}` }], isError: true };
       }
@@ -99,11 +141,14 @@ function registerTools(server, client) {
     async ({ file_id }) => {
       const start = Date.now();
       logger.info({ event: "tool_call", tool: "get_file", file_id });
+      const requestId = emitToolClick("get_file", { file_id });
       try {
         const file = await client.getFile(file_id);
+        recordToolMetric("get_file", "success", Date.now() - start, requestId, { file_id });
         logger.info({ event: "tool_call_end", tool: "get_file", duration_ms: Date.now() - start });
         return { content: [{ type: "text", text: JSON.stringify(file, null, 2) }] };
       } catch (err) {
+        recordToolMetric("get_file", "error", Date.now() - start, requestId, { file_id }, err);
         logger.error({ event: "tool_call_error", tool: "get_file", duration_ms: Date.now() - start, error: String(err) });
         return { content: [{ type: "text", text: `Failed to get file: ${err}` }], isError: true };
       }
@@ -124,11 +169,14 @@ function registerTools(server, client) {
     async ({ file_id }) => {
       const start = Date.now();
       logger.info({ event: "tool_call", tool: "get_note", file_id });
+      const requestId = emitToolClick("get_note", { file_id });
       try {
         const file = await client.getFile(file_id);
+        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) }] };
       } 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) });
         return { content: [{ type: "text", text: `Failed to get note: ${err}` }], isError: true };
       }
@@ -149,11 +197,14 @@ function registerTools(server, client) {
     async ({ file_id }) => {
       const start = Date.now();
       logger.info({ event: "tool_call", tool: "get_transcript", file_id });
+      const requestId = emitToolClick("get_transcript", { file_id });
       try {
         const file = await client.getFile(file_id);
+        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) }] };
       } 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) });
         return { content: [{ type: "text", text: `Failed to get transcript: ${err}` }], isError: true };
       }
@@ -173,11 +224,14 @@ function registerTools(server, client) {
     async () => {
       const start = Date.now();
       logger.info({ event: "tool_call", tool: "get_current_user" });
+      const requestId = emitToolClick("get_current_user");
       try {
         const user = await client.getCurrentUser();
+        recordToolMetric("get_current_user", "success", Date.now() - start, requestId);
         logger.info({ event: "tool_call_end", tool: "get_current_user", duration_ms: Date.now() - start });
         return { content: [{ type: "text", text: JSON.stringify(user, null, 2) }] };
       } catch (err) {
+        recordToolMetric("get_current_user", "error", Date.now() - start, requestId, {}, err);
         logger.error({ event: "tool_call_error", tool: "get_current_user", duration_ms: Date.now() - start, error: String(err) });
         return { content: [{ type: "text", text: `Failed to get user info: ${err}` }], isError: true };
       }
@@ -186,6 +240,6 @@ function registerTools(server, client) {
 }
 
 export {
-  logger,
+  normalizeMcpHost,
   registerTools
 };

package/dist/index.js

@@ -1,16 +1,29 @@
 #!/usr/bin/env node
 import {
   getClient
-} from "./chunk-GZ7QPRKV.js";
+} from "./chunk-QJV4OLZI.js";
 import {
   loadSkills
 } from "./chunk-4QBEOJPX.js";
 import {
+  normalizeMcpHost,
   registerTools
-} from "./chunk-BZOIX6WC.js";
+} from "./chunk-XA77WLYF.js";
 import {
-  runOAuthCallback
-} from "./chunk-3XRFIJUG.js";
+  capture,
+  classifyError,
+  clearUser,
+  extractIdentity,
+  initTelemetry,
+  oauthCallbackErrorType,
+  runOAuthCallback,
+  setMcpHost,
+  setUser,
+  shutdown
+} from "./chunk-R5G6UXSI.js";
+import "./chunk-NPCCDRWQ.js";
+import "./chunk-RUFCT6DQ.js";
+import "./chunk-MCKGQKYU.js";
 
 // src/index.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
@@ -18,7 +31,7 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import open from "open";
 var server = new McpServer({
   name: "plaud",
-  version: "0.2.4"
+  version: "0.3.1"
 });
 var CALLBACK_PORT = 8199;
 var LOGIN_TIMEOUT_MS = 12e4;
@@ -56,8 +69,23 @@ server.registerTool("login", {
       });
     }
   });
+  if (result.status === "success") {
+    capture("auth:oauth_callback:success", { passive: true });
+  } else {
+    capture("auth:oauth_callback:error", {
+      passive: true,
+      error_type: oauthCallbackErrorType(result.status)
+    });
+  }
   switch (result.status) {
     case "success":
+      try {
+        const user = await client.getCurrentUser();
+        if (user && typeof user.id === "string") {
+          await setUser(user.id, extractIdentity(user));
+        }
+      } catch {
+      }
       return { content: [{ type: "text", text: "Successfully authenticated with Plaud!" }] };
     case "timeout":
       return {
@@ -97,10 +125,19 @@ server.registerTool("logout", {
     return { content: [{ type: "text", text: "Already logged out." }] };
   }
   try {
-    await client.revokeCurrentUser();
+    try {
+      await client.revokeCurrentUser();
+    } catch {
+    }
+    await client.auth.logout();
+    capture("auth:logout:success", { passive: true });
+  } catch (err) {
+    capture("auth:logout:error", { passive: true, error_type: classifyError(err) });
+  }
+  try {
+    await clearUser();
   } catch {
   }
-  await client.auth.logout();
   return {
     content: [{ type: "text", text: "Logged out and revoked authorization." }]
   };
@@ -117,7 +154,7 @@ async function main() {
   const sub = process.argv[2];
   const sub2 = process.argv[3];
   if (sub === "install") {
-    const { runInstall } = await import("./install-ALLWR7CL.js");
+    const { runInstall } = await import("./install-42GM4XUO.js");
     const args = process.argv.slice(3);
     const yes = args.some((a) => a === "--yes" || a === "-y");
     const noLogin = args.some((a) => a === "--no-login");
@@ -125,32 +162,34 @@ async function main() {
     return;
   }
   if (sub === "clean-plugin") {
-    const { runCleanPlugin } = await import("./setup-QXZHVVDP.js");
+    const { runCleanPlugin } = await import("./setup-GLWZYNRW.js");
     await runCleanPlugin();
     return;
   }
   if (sub === "setup" && sub2 === "codex") {
-    const { runSetupCodex } = await import("./setup-QXZHVVDP.js");
+    const { runSetupCodex } = await import("./setup-GLWZYNRW.js");
     await runSetupCodex();
     return;
   }
   if (sub === "unsetup" && sub2 === "codex") {
-    const { runUnsetupCodex } = await import("./setup-QXZHVVDP.js");
+    const { runUnsetupCodex } = await import("./setup-GLWZYNRW.js");
     await runUnsetupCodex();
     return;
   }
   if (sub === "setup") {
-    const { runSetup } = await import("./setup-QXZHVVDP.js");
+    const { runSetup } = await import("./setup-GLWZYNRW.js");
     await runSetup();
     return;
   }
   if (sub === "unsetup") {
-    const { runUnsetup } = await import("./setup-QXZHVVDP.js");
+    const { runUnsetup } = await import("./setup-GLWZYNRW.js");
     await runUnsetup();
     return;
   }
   if (sub === "http") {
-    const { startHttpServer } = await import("./server-VY7ANVCH.js");
+    const { startHttpServer } = await import("./server-KBYYESVJ.js");
+    const { startMetricsServer } = await import("./server-BOR5EZLF.js");
+    startMetricsServer();
     startHttpServer();
     return;
   }
@@ -171,8 +210,37 @@ Usage:
 `);
     return;
   }
+  try {
+    await initTelemetry({
+      surface: "mcp",
+      appVersion: "0.3.1",
+      transport: "stdio"
+    });
+  } catch {
+  }
+  const exitWithFlush = async (code) => {
+    try {
+      await shutdown();
+    } catch {
+    }
+    process.exit(code);
+  };
+  process.on("SIGINT", () => void exitWithFlush(130));
+  process.on("SIGTERM", () => void exitWithFlush(143));
   await registerSkillPrompts();
+  server.server.oninitialized = () => {
+    try {
+      setMcpHost(normalizeMcpHost(server.server.getClientVersion()?.name));
+    } catch {
+    }
+  };
   const transport = new StdioServerTransport();
-  await server.connect(transport);
+  try {
+    await server.connect(transport);
+    capture("mcp:server:success", { passive: true });
+  } catch (err) {
+    capture("mcp:server:error", { passive: true, error_type: classifyError(err) });
+    await exitWithFlush(1);
+  }
 }
 main().catch(console.error);

package/dist/{install-ALLWR7CL.js → install-42GM4XUO.js}

@@ -1,6 +1,6 @@
 import {
   getClient
-} from "./chunk-GZ7QPRKV.js";
+} from "./chunk-QJV4OLZI.js";
 import {
   copyToClipboard,
   getMcpEntry,
@@ -11,7 +11,9 @@ import {
 } from "./chunk-4QBEOJPX.js";
 import {
   runOAuthCallback
-} from "./chunk-3XRFIJUG.js";
+} from "./chunk-R5G6UXSI.js";
+import "./chunk-RUFCT6DQ.js";
+import "./chunk-MCKGQKYU.js";
 
 // src/install.ts
 import { createInterface } from "readline/promises";

package/dist/server-BOR5EZLF.js

@@ -0,0 +1,35 @@
+import {
+  logger
+} from "./chunk-NPCCDRWQ.js";
+import {
+  registry
+} from "./chunk-RUFCT6DQ.js";
+import "./chunk-MCKGQKYU.js";
+
+// src/metrics/server.ts
+import express from "express";
+var METRICS_PORT = Number(process.env.PLAUD_METRICS_PORT ?? 9080);
+var METRICS_HOST = process.env.PLAUD_METRICS_HOST ?? "0.0.0.0";
+function startMetricsServer() {
+  const app = express();
+  app.get("/metrics", async (_req, res, next) => {
+    try {
+      res.setHeader("Content-Type", registry.contentType);
+      res.end(await registry.metrics());
+    } catch (err) {
+      next(err);
+    }
+  });
+  app.get("/healthz", (_req, res) => {
+    res.status(200).send("ok");
+  });
+  const server = app.listen(METRICS_PORT, METRICS_HOST, () => {
+    logger.info({ event: "metrics_server_started", port: METRICS_PORT, host: METRICS_HOST });
+  });
+  server.on("error", (err) => {
+    logger.error({ event: "metrics_server_error", err: err.message });
+  });
+}
+export {
+  startMetricsServer
+};

package/dist/{server-VY7ANVCH.js → server-KBYYESVJ.js}

@@ -1,10 +1,18 @@
 import {
-  logger,
   registerTools
-} from "./chunk-BZOIX6WC.js";
+} from "./chunk-XA77WLYF.js";
 import {
   PlaudClient
-} from "./chunk-3XRFIJUG.js";
+} from "./chunk-R5G6UXSI.js";
+import {
+  logger
+} from "./chunk-NPCCDRWQ.js";
+import {
+  httpRequestDuration,
+  httpRequestsInProgress,
+  oauthTokenRefresh
+} from "./chunk-RUFCT6DQ.js";
+import "./chunk-MCKGQKYU.js";
 
 // src/http/server.ts
 import express from "express";
@@ -680,17 +688,21 @@ var PlaudOAuthProvider = class extends ProxyOAuthServerProvider {
       }
       logger.error({ event: "oauth_token_refresh_failed", status: fetchRes.status, body: text.slice(0, 500) });
       if (fetchRes.status >= 500) {
+        oauthTokenRefresh.inc({ result: "upstream_error" });
         throw new McpServerError(`Upstream refresh endpoint error: ${fetchRes.status} ${text.slice(0, 200)}`);
       }
+      oauthTokenRefresh.inc({ result: "invalid_grant" });
       throw new InvalidGrantError(`Plaud token refresh: ${fetchRes.status} ${text.slice(0, 200)}`);
     }
     let data;
     try {
       data = await fetchRes.json();
     } catch (err) {
+      oauthTokenRefresh.inc({ result: "parse_failed" });
       logger.error({ event: "oauth_refresh_json_parse_failed", error: String(err) });
       throw new McpServerError("Refresh endpoint returned non-JSON response");
     }
+    oauthTokenRefresh.inc({ result: "success" });
     logger.info({
       event: "oauth_token_refresh_ok",
       has_refresh_token: !!data.refresh_token,
@@ -805,6 +817,22 @@ function startHttpServer() {
   };
   const app = createMcpExpressApp({ host: HTTP_HOST });
   app.set("trust proxy", 1);
+  app.use((req, res, next) => {
+    const start = process.hrtime.bigint();
+    const method = req.method;
+    const inProgressLabels = { method, handler: req.path };
+    httpRequestsInProgress.inc(inProgressLabels);
+    res.on("finish", () => {
+      const handler = req.route?.path ?? req.path;
+      const durSec = Number(process.hrtime.bigint() - start) / 1e9;
+      httpRequestDuration.observe(
+        { method, handler, status: String(res.statusCode) },
+        durSec
+      );
+      httpRequestsInProgress.dec(inProgressLabels);
+    });
+    next();
+  });
   app.get("/.well-known/openai-apps-challenge", (_req, res) => {
     res.type("text/plain").send(OPENAI_APPS_CHALLENGE_TOKEN);
   });
@@ -982,7 +1010,7 @@ function startHttpServer() {
         apiBase,
         staticToken: token
       });
-      const mcpServer = new McpServer({ name: "plaud", version: "0.2.4" });
+      const mcpServer = new McpServer({ name: "plaud", version: "0.3.1" });
       registerTools(mcpServer, client);
       const transport = new StreamableHTTPServerTransport({
         sessionIdGenerator: void 0,

package/dist/{setup-QXZHVVDP.js → setup-GLWZYNRW.js}

@@ -7,6 +7,7 @@ import {
 import {
   skillsCombined
 } from "./chunk-4QBEOJPX.js";
+import "./chunk-MCKGQKYU.js";
 
 // src/setup.ts
 import { readFile, writeFile, mkdir, rm } from "fs/promises";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plaud-ai/mcp",
-  "version": "0.2.4",
+  "version": "0.3.1",
   "type": "module",
   "main": "dist/index.js",
   "bin": {
@@ -25,10 +25,12 @@
     "express": "^5.2.1",
     "open": "^10.2.0",
     "pino": "^10.3.1",
+    "prom-client": "^15.1.3",
     "zod": "^4.3.6"
   },
   "devDependencies": {
     "@plaud-ai/shared": "workspace:*",
+    "@plaud-ai/telemetry": "workspace:*",
     "@types/express": "^5.0.6",
     "@types/node": "^25.5.0",
     "typescript": "^5.7.0"

package/plugin.json

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