@papermark/mcp-server 0.2.0 → 0.4.0

package/dist/index.js

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 import {
+  SHARED_TOOL_OUTPUT_SCHEMAS,
   addDocumentVersionContract,
   attachDataroomDocumentContract,
   createDataroomContract,
@@ -11,6 +12,7 @@ import {
   deleteDocumentContract,
   deleteFolderContract,
   deleteLinkContract,
+  documentOutputSchema,
   getDataroomAnalyticsContract,
   getDataroomContract,
   getDataroomFolderContract,
@@ -42,7 +44,7 @@ import {
   updateDocumentContract,
   updateFolderContract,
   updateLinkContract
-} from "./chunk-S3ALJ4YG.js";
+} from "./chunk-IMW5GZSO.js";
 
 // src/index.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
@@ -298,10 +300,74 @@ var api = {
 };
 
 // src/tools.ts
+var readTool = (openWorldHint = false) => ({ readOnlyHint: true, destructiveHint: false, openWorldHint });
+var writeTool = (openWorldHint = false) => ({ readOnlyHint: false, destructiveHint: false, openWorldHint });
+var destructiveTool = (openWorldHint = false) => ({ readOnlyHint: false, destructiveHint: true, openWorldHint });
+var TOOL_ANNOTATIONS = {
+  list_documents: readTool(),
+  get_document: readTool(),
+  search_documents: readTool(),
+  upload_document: writeTool(true),
+  create_link: writeTool(),
+  list_links: readTool(),
+  list_link_views: readTool(),
+  list_datarooms: readTool(),
+  search_datarooms: readTool(),
+  get_dataroom: readTool(),
+  create_dataroom: writeTool(),
+  list_dataroom_documents: readTool(),
+  list_visitors: readTool(),
+  list_visitor_views: readTool(),
+  get_document_analytics: readTool(),
+  get_link_analytics: readTool(),
+  get_dataroom_analytics: readTool(),
+  get_view_analytics: readTool(),
+  update_document: destructiveTool(),
+  delete_document: destructiveTool(),
+  list_document_versions: readTool(),
+  get_document_version: readTool(),
+  add_document_version: destructiveTool(true),
+  promote_document_version: destructiveTool(),
+  list_folders: readTool(),
+  get_folder: readTool(),
+  create_folder: writeTool(),
+  update_folder: destructiveTool(),
+  delete_folder: destructiveTool(),
+  move_folder: destructiveTool(),
+  get_link: readTool(),
+  update_link: destructiveTool(),
+  delete_link: destructiveTool(),
+  update_dataroom: destructiveTool(),
+  delete_dataroom: destructiveTool(),
+  attach_dataroom_document: writeTool(),
+  list_dataroom_folders: readTool(),
+  get_dataroom_folder: readTool(),
+  create_dataroom_folder: writeTool(),
+  update_dataroom_folder: destructiveTool(),
+  delete_dataroom_folder: destructiveTool(),
+  move_dataroom_folder: destructiveTool(),
+  get_visitor: readTool()
+};
+var TOOL_OUTPUT_SCHEMAS = {
+  ...SHARED_TOOL_OUTPUT_SCHEMAS,
+  upload_document: documentOutputSchema
+};
+function toStructuredContent(result) {
+  if (result && typeof result === "object" && !Array.isArray(result)) {
+    return result;
+  }
+  return { result };
+}
 async function run(fn, label) {
   try {
     const result = await fn();
-    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    const structuredContent = toStructuredContent(result);
+    return {
+      structuredContent,
+      content: [
+        { type: "text", text: JSON.stringify(structuredContent, null, 2) }
+      ]
+    };
   } catch (err) {
     if (err instanceof ApiError) {
       const detail = err.details !== void 0 && err.details !== null ? `
@@ -330,7 +396,10 @@ Docs: ${err.docUrl}` : "";
     return {
       isError: true,
       content: [
-        { type: "text", text: `${label} failed: ${err instanceof Error ? err.message : String(err)}` }
+        {
+          type: "text",
+          text: `${label} failed: ${err instanceof Error ? err.message : String(err)}`
+        }
       ]
     };
   }
@@ -348,41 +417,27 @@ function filenameFromUrl(rawUrl) {
     return "document";
   }
 }
-function summarizeDocument(d) {
-  return {
-    id: d.id,
-    object: d.object,
-    name: d.name,
-    content_type: d.content_type,
-    num_pages: d.num_pages,
-    created: d.created
-  };
-}
-function summarizeLink(l) {
-  return {
-    id: l.id,
-    object: l.object,
-    url: l.url,
-    name: l.name,
-    target_type: l.target_type,
-    document_id: l.document_id,
-    dataroom_id: l.dataroom_id,
-    expires_at: l.expires_at,
-    is_password_protected: l.is_password_protected,
-    email_protected: l.email_protected,
-    allow_download: l.allow_download
-  };
-}
-function summarizeView(v) {
-  return {
-    id: v.id,
-    link_id: v.link_id,
-    viewer_email: v.viewer_email,
-    viewed_at: v.viewed_at,
-    downloaded_at: v.downloaded_at
-  };
-}
 function registerTools(server) {
+  const baseRegisterTool = server.registerTool.bind(server);
+  server.registerTool = ((name, config, cb) => {
+    const annotations = TOOL_ANNOTATIONS[name];
+    if (!annotations) {
+      throw new Error(`MCP tool "${name}" has no annotations entry`);
+    }
+    const outputSchema = TOOL_OUTPUT_SCHEMAS[name];
+    if (!outputSchema) {
+      throw new Error(`MCP tool "${name}" has no output schema entry`);
+    }
+    return baseRegisterTool(
+      name,
+      {
+        ...config,
+        annotations: { ...annotations, ...config.annotations },
+        outputSchema: config.outputSchema ?? outputSchema
+      },
+      cb
+    );
+  });
   server.registerTool(
     listDocumentsContract.name,
     {
@@ -397,7 +452,7 @@ function registerTools(server) {
         query: args.query
       });
       return {
-        documents: list.data.map(summarizeDocument),
+        documents: list.data,
         next_cursor: list.next_cursor
       };
     }, "list_documents")
@@ -420,7 +475,10 @@ function registerTools(server) {
     },
     async (args) => run(async () => {
       const list = await api.searchDocuments(args.query, args.limit);
-      return { documents: list.data.map(summarizeDocument), next_cursor: list.next_cursor };
+      return {
+        documents: list.data,
+        next_cursor: list.next_cursor
+      };
     }, "search_documents")
   );
   server.registerTool(
@@ -441,7 +499,9 @@ Don't upload any file the user didn't explicitly point at. Requires scope \`docu
         ),
         source_url: z.string().url().refine((s) => s.startsWith("https://"), {
           message: "source_url must use https:// (http is rejected by the API)"
-        }).optional().describe("Public HTTPS URL the server should fetch (alternative to file_path)"),
+        }).optional().describe(
+          "Public HTTPS URL the server should fetch (alternative to file_path)"
+        ),
         name: z.string().optional().describe("Display name; defaults to the filename"),
         content_type: z.string().optional().describe("MIME type; inferred from extension when omitted"),
         folder_id: z.string().optional().describe(
@@ -452,7 +512,9 @@ Don't upload any file the user didn't explicitly point at. Requires scope \`docu
     },
     async (args) => run(async () => {
       if (!args.file_path && !args.source_url) {
-        throw new Error("Provide either file_path (local) or source_url (remote).");
+        throw new Error(
+          "Provide either file_path (local) or source_url (remote)."
+        );
       }
       if (args.file_path && args.source_url) {
         throw new Error("Provide only one of file_path or source_url.");
@@ -465,7 +527,7 @@ Don't upload any file the user didn't explicitly point at. Requires scope \`docu
           folder_id: args.folder_id,
           create_link: args.create_link
         });
-        return { document: summarizeDocument(doc2) };
+        return { document: doc2 };
       }
       const filePath = args.file_path;
       const stats = await stat(filePath);
@@ -473,9 +535,9 @@ Don't upload any file the user didn't explicitly point at. Requires scope \`docu
       const contentType = args.content_type ?? guessContentType(fileName);
       const body = await readFile(filePath);
       const presigned = await api.uploadUrl({
-        fileName,
-        contentType,
-        contentLength: stats.size
+        file_name: fileName,
+        content_type: contentType,
+        content_length: stats.size
       });
       const putController = new AbortController();
       const putTimer = setTimeout(() => putController.abort(), 5 * 6e4);
@@ -498,7 +560,9 @@ Don't upload any file the user didn't explicitly point at. Requires scope \`docu
         clearTimeout(putTimer);
       }
       if (!put.ok) {
-        throw new Error(`Storage PUT failed: HTTP ${put.status} ${put.statusText}`);
+        throw new Error(
+          `Storage PUT failed: HTTP ${put.status} ${put.statusText}`
+        );
       }
       const doc = await api.createDocument({
         name: args.name ?? fileName,
@@ -506,7 +570,7 @@ Don't upload any file the user didn't explicitly point at. Requires scope \`docu
         folder_id: args.folder_id,
         create_link: args.create_link
       });
-      return { document: summarizeDocument(doc) };
+      return { document: doc };
     }, "upload_document")
   );
   server.registerTool(
@@ -528,7 +592,7 @@ Don't upload any file the user didn't explicitly point at. Requires scope \`docu
         );
       }
       const link = await api.createLink(args);
-      return { link: summarizeLink(link) };
+      return { link };
     }, "create_link")
   );
   server.registerTool(
@@ -540,7 +604,10 @@ Don't upload any file the user didn't explicitly point at. Requires scope \`docu
     },
     async (args) => run(async () => {
       const list = await api.listLinks(args);
-      return { links: list.data.map(summarizeLink), next_cursor: list.next_cursor };
+      return {
+        links: list.data,
+        next_cursor: list.next_cursor
+      };
     }, "list_links")
   );
   server.registerTool(
@@ -555,7 +622,10 @@ Don't upload any file the user didn't explicitly point at. Requires scope \`docu
         limit: args.limit,
         cursor: args.cursor
       });
-      return { views: list.data.map(summarizeView), next_cursor: list.next_cursor };
+      return {
+        views: list.data,
+        next_cursor: list.next_cursor
+      };
     }, "list_link_views")
   );
   server.registerTool(
@@ -718,7 +788,7 @@ Don't upload any file the user didn't explicitly point at. Requires scope \`docu
         throw new Error("Provide at least one of `name` or `folder_id`.");
       }
       const doc = await api.updateDocument(args.document_id, body);
-      return { document: summarizeDocument(doc) };
+      return { document: doc };
     }, "update_document")
   );
   server.registerTool(
@@ -873,7 +943,7 @@ Don't upload any file the user didn't explicitly point at. Requires scope \`docu
     },
     async (args) => run(async () => {
       const link = await api.getLink(args.link_id);
-      return { link: summarizeLink(link) };
+      return { link };
     }, "get_link")
   );
   server.registerTool(
@@ -889,7 +959,7 @@ Don't upload any file the user didn't explicitly point at. Requires scope \`docu
         throw new Error("Provide at least one field to update.");
       }
       const link = await api.updateLink(link_id, rest);
-      return { link: summarizeLink(link) };
+      return { link };
     }, "update_link")
   );
   server.registerTool(