@papermark/mcp-server 0.0.1 → 0.2.0

package/README.md

@@ -1,11 +1,70 @@
 # @papermark/mcp-server
 
-This package name is reserved for the official [Papermark](https://www.papermark.com) Model Context Protocol server.
+Model Context Protocol server for [Papermark](https://www.papermark.com). Exposes
+your data rooms — plus documents, share links, visitors, and analytics — as
+tools any MCP-compliant client can call (Claude Desktop, Claude Code, ChatGPT,
+Cursor, Zed, Continue, Windsurf, …).
 
-The full release is coming soon. In the meantime, see:
+## Quick start — stdio mode (local)
 
-- [papermark.com](https://www.papermark.com) — the product
-- [github.com/papermark/papermark-mcp-server](https://github.com/papermark/papermark-mcp-server) — source (once published)
+1. Create an API token at `papermark.com/settings/tokens` (or via
+   `papermark login` in the CLI, which stores one to `~/Library/Preferences/papermark-nodejs/config.json` on macOS).
+2. Add this to your MCP client config. For Claude Desktop,
+   `~/Library/Application Support/Claude/claude_desktop_config.json`:
+
+   ```json
+   {
+     "mcpServers": {
+       "papermark": {
+         "command": "npx",
+         "args": ["-y", "@papermark/mcp-server"],
+         "env": { "PAPERMARK_TOKEN": "pm_live_xxx" }
+       }
+     }
+   }
+   ```
+
+3. Restart the MCP client. Ask it something like *"List my Papermark data
+   rooms"* — it'll call `list_datarooms` and stream the result back.
+
+To run locally against a dev API instead of production:
+
+```json
+{ "env": {
+  "PAPERMARK_TOKEN": "pm_live_xxx",
+  "PAPERMARK_API_URL": "http://localhost:3000/api"
+} }
+```
+
+## Smoke test
+
+```bash
+PAPERMARK_TOKEN=pm_live_xxx npm run smoke
+```
+
+Walks the stdio server through `initialize`, `tools/list`, a `tools/call`
+success, and an error path — useful for verifying a local build before
+pointing a client at it.
+
+## Tools
+
+- `list_documents`, `get_document`, `search_documents`, `upload_document`
+- `list_links`, `create_link`, `list_link_views`
+- `list_datarooms`, `search_datarooms`, `get_dataroom`, `create_dataroom`,
+  `list_dataroom_documents`
+- `list_visitors`, `list_visitor_views`
+- `get_document_analytics`, `get_link_analytics`, `get_dataroom_analytics`,
+  `get_view_analytics`
+
+## Environment
+
+- `PAPERMARK_TOKEN` — bearer token (required for stdio mode)
+- `PAPERMARK_API_URL` — override the API base (default `https://api.papermark.com`)
+
+## Remote deployment
+
+A hosted version is available at `mcp.papermark.com` using Streamable HTTP
+transport and OAuth 2.1.
 
 ## License
 

package/dist/chunk-S3ALJ4YG.js

@@ -0,0 +1,606 @@
+#!/usr/bin/env node
+
+// src/tools-contract.ts
+import { z } from "zod";
+var listDocumentsContract = {
+  name: "list_documents",
+  title: "List documents",
+  description: "List documents in the authenticated Papermark team. Returns up to `limit` results (default 25, max 100) and a `next_cursor` for pagination. Use this before any tool that takes a `document_id` \u2014 never fabricate ids. Requires scope `documents.read`.",
+  inputSchema: {
+    limit: z.number().int().min(1).max(100).optional().describe("Page size (1-100, default 25)"),
+    cursor: z.string().optional().describe("Opaque cursor from the previous page's `next_cursor`"),
+    query: z.string().optional().describe(
+      "Optional substring filter on document name \u2014 for richer search use `search_documents`"
+    )
+  }
+};
+var getDocumentContract = {
+  name: "get_document",
+  title: "Get document",
+  description: "Fetch a single document by id. `document_id` must come from `list_documents` or `search_documents` \u2014 never invent one. If the user referred to a document by name, call `search_documents` first. Requires scope `documents.read`.",
+  inputSchema: {
+    document_id: z.string().min(1).describe("Document id (e.g. `doc_abc123`)")
+  }
+};
+var searchDocumentsContract = {
+  name: "search_documents",
+  title: "Search documents",
+  description: "Substring-search document names in the authenticated team. Use this when the user refers to a document by name or topic rather than id. Requires scope `documents.read`.",
+  inputSchema: {
+    query: z.string().min(1).describe("Search string (matched against document name)"),
+    limit: z.number().int().min(1).max(50).optional().describe("Max results (default 10)")
+  }
+};
+var createLinkContract = {
+  name: "create_link",
+  title: "Create share link",
+  description: `Create a share link for a document (or dataroom). The returned \`url\` is what users share.
+
+WORKFLOW:
+(1) Resolve the target: the user may say "the Q3 deck" or "the Acme dataroom" \u2014 call \`search_documents\` (for a document) or \`search_datarooms\` (for a dataroom) first to get a real id. Set exactly one of \`document_id\` or \`dataroom_id\` on the created link.
+(2) Clarify ANY of these that the user didn't state explicitly \u2014 do NOT invent values:
+    \u2022 expiry (\`expires_at\`, ISO 8601) \u2014 confirm with the user, default is no expiry
+    \u2022 password \u2014 if the user wants password protection, either ASK them for a password OR generate a random one AND tell the user the exact value you set
+    \u2022 email gating (\`email_protected\`) \u2014 ask if unclear
+    \u2022 downloads (\`allow_download\`) \u2014 default off for external sharing
+(3) Create the link, then surface both the URL and the security settings so the user can verify.
+
+Never share a link to a document the user didn't explicitly name. Requires scope \`links.write\`.`,
+  inputSchema: {
+    document_id: z.string().optional().describe("Document id \u2014 required unless `dataroom_id` is set"),
+    dataroom_id: z.string().optional().describe("Dataroom id \u2014 alternative to document_id"),
+    name: z.string().optional().describe("Human-readable label for the link"),
+    expires_at: z.string().datetime().optional().describe("ISO 8601 timestamp after which the link stops working"),
+    password: z.string().optional().describe("Require viewers to enter this password"),
+    email_protected: z.boolean().optional().describe("Require viewers enter an email address before viewing"),
+    allow_download: z.boolean().optional().describe("Let viewers download the underlying file")
+  }
+};
+var listLinksContract = {
+  name: "list_links",
+  title: "List share links",
+  description: "List share links in the authenticated team. Optionally filter by `document_id` or `dataroom_id`. Requires scope `links.read`.",
+  inputSchema: {
+    document_id: z.string().optional().describe("Filter links for a specific document"),
+    dataroom_id: z.string().optional().describe("Filter links for a specific dataroom"),
+    limit: z.number().int().min(1).max(100).optional().describe("Page size"),
+    cursor: z.string().optional().describe("Pagination cursor")
+  }
+};
+var listLinkViewsContract = {
+  name: "list_link_views",
+  title: "List a link's view events",
+  description: "Return the raw view events for a share link, newest first. Each view includes viewer email (if captured), view timestamp, and download status. For aggregate metrics (total views, total read time), use `get_link_analytics` instead. Requires scope `analytics.read`.",
+  inputSchema: {
+    link_id: z.string().min(1).describe("Link id (e.g. `lnk_abc123`)"),
+    limit: z.number().int().min(1).max(100).optional().describe("Page size (default 25)"),
+    cursor: z.string().optional().describe("Pagination cursor")
+  }
+};
+var listDataroomsContract = {
+  name: "list_datarooms",
+  title: "List datarooms",
+  description: "List datarooms in the authenticated team. Returns up to `limit` results with a cursor. Requires scope `datarooms.read`.",
+  inputSchema: {
+    limit: z.number().int().min(1).max(100).optional(),
+    cursor: z.string().optional(),
+    query: z.string().optional().describe("Optional substring filter on dataroom name")
+  }
+};
+var searchDataroomsContract = {
+  name: "search_datarooms",
+  title: "Search datarooms",
+  description: "Substring-search dataroom names in the authenticated team. Use when the user refers to a dataroom by name (e.g. 'the Acme room') rather than id \u2014 before calling `create_link`, `get_dataroom_analytics`, or any other tool that takes a `dataroom_id`. Requires scope `datarooms.read`.",
+  inputSchema: {
+    query: z.string().min(1).describe("Search string (matched against dataroom name)"),
+    limit: z.number().int().min(1).max(50).optional().describe("Max results (default 10)")
+  }
+};
+var getDataroomContract = {
+  name: "get_dataroom",
+  title: "Get a dataroom",
+  description: "Fetch a single dataroom by its id (accepts either the internal cuid or the `dr_...` public id). Requires scope `datarooms.read`.",
+  inputSchema: {
+    dataroom_id: z.string().min(1).describe("Dataroom id or `dr_...` public id")
+  }
+};
+var createDataroomContract = {
+  name: "create_dataroom",
+  title: "Create a dataroom",
+  description: `Create a new (empty) dataroom. Documents can be added using the \`attach_dataroom_document\` tool after creating the dataroom.
+
+WORKFLOW:
+(1) Confirm with the user: exact dataroom name, optional internal_name, optional description. Do NOT invent these.
+(2) Check \`list_datarooms\` first if the user said "my Acme room" \u2014 they may already have one and not want a duplicate.
+(3) Create the dataroom; return the new dataroom id so the caller can add documents with \`attach_dataroom_document\`.
+
+Requires scope \`datarooms.write\`.`,
+  inputSchema: {
+    name: z.string().min(1).describe("Human-visible dataroom name"),
+    internal_name: z.string().optional().describe("Private alias visible only to the team"),
+    description: z.string().optional()
+  }
+};
+var listDataroomDocumentsContract = {
+  name: "list_dataroom_documents",
+  title: "List documents in a dataroom",
+  description: "Return the documents contained in a dataroom, ordered by folder and custom order. Requires scope `datarooms.read`.",
+  inputSchema: {
+    dataroom_id: z.string().min(1),
+    folder_id: z.string().optional().describe("Filter to documents inside a specific folder"),
+    limit: z.number().int().min(1).max(100).optional(),
+    cursor: z.string().optional()
+  }
+};
+var listVisitorsContract = {
+  name: "list_visitors",
+  title: "List visitors",
+  description: "Persistent visitors (Viewer rows) for the team. Use `email` to find a specific person; use `dataroom_id` to scope to visitors of a particular dataroom. For anonymous views that never tied to a Viewer row, use `list_link_views` against the relevant link. Requires scope `visitors.read`.",
+  inputSchema: {
+    email: z.string().optional().describe("Exact email match, case-insensitive"),
+    dataroom_id: z.string().optional(),
+    limit: z.number().int().min(1).max(100).optional(),
+    cursor: z.string().optional()
+  }
+};
+var listVisitorViewsContract = {
+  name: "list_visitor_views",
+  title: "List a visitor's views",
+  description: "All view events tied to a single visitor, newest first. Useful for answering questions like 'what has jane@acme.com looked at?'. Use `list_visitors` with an email filter to find the visitor id. Requires scope `visitors.read`.",
+  inputSchema: {
+    visitor_id: z.string().min(1),
+    limit: z.number().int().min(1).max(100).optional(),
+    cursor: z.string().optional()
+  }
+};
+var getDocumentAnalyticsContract = {
+  name: "get_document_analytics",
+  title: "Get document analytics",
+  description: "Aggregate analytics for a document over a time window: total views, unique viewers, total read time (seconds), and per-page average duration. Defaults to the last 30 days. Requires scope `analytics.read`. NOTE: Subject to a tighter rate limit \u2014 cache results when possible.",
+  inputSchema: {
+    document_id: z.string().min(1),
+    since: z.number().int().optional().describe("Unix milliseconds \u2014 start of window (default: 30 days ago)"),
+    until: z.number().int().optional().describe("Unix milliseconds \u2014 end of window (default: now)")
+  }
+};
+var getLinkAnalyticsContract = {
+  name: "get_link_analytics",
+  title: "Get link analytics",
+  description: "Aggregate analytics for a single share link: total views, unique viewers, total read time over the selected window. For the raw event list (one row per view), use `list_link_views`. Requires scope `analytics.read`.",
+  inputSchema: {
+    link_id: z.string().min(1),
+    since: z.number().int().optional(),
+    until: z.number().int().optional()
+  }
+};
+var getDataroomAnalyticsContract = {
+  name: "get_dataroom_analytics",
+  title: "Get dataroom analytics",
+  description: "Aggregate analytics across all documents in a dataroom: total views, unique viewers, total read time. Defaults to the last 30 days. Requires scope `analytics.read`.",
+  inputSchema: {
+    dataroom_id: z.string().min(1),
+    since: z.number().int().optional(),
+    until: z.number().int().optional()
+  }
+};
+var getViewAnalyticsContract = {
+  name: "get_view_analytics",
+  title: "Get per-view breakdown",
+  description: "For a single view event: page-by-page time spent, total duration, and the viewer's country/city/browser/os/device. Use `list_link_views` or `list_visitor_views` to discover view ids. Requires scope `analytics.read`.",
+  inputSchema: {
+    view_id: z.string().min(1)
+  }
+};
+var FolderIconEnum = z.enum([
+  "folder",
+  "folder-open",
+  "briefcase",
+  "archive",
+  "box",
+  "file",
+  "book",
+  "bookmark",
+  "star",
+  "heart",
+  "lock",
+  "shield",
+  "users",
+  "settings",
+  "tag",
+  "layers",
+  "globe",
+  "home",
+  "mail",
+  "image",
+  "video",
+  "music",
+  "palette",
+  "pen-tool",
+  "lightbulb",
+  "zap",
+  "wrench",
+  "sparkles",
+  "cloud",
+  "flag",
+  "award",
+  "flame",
+  "bell",
+  "sun",
+  "hash"
+]);
+var FolderColorEnum = z.enum([
+  "gray",
+  "red",
+  "orange",
+  "yellow",
+  "green",
+  "blue",
+  "black"
+]);
+var updateDocumentContract = {
+  name: "update_document",
+  title: "Update a document",
+  description: `Rename a document or move it to a different team-library folder. Replacing the file content is a separate operation \u2014 use \`add_document_version\`.
+
+WORKFLOW:
+(1) Resolve the document via \`search_documents\` or \`list_documents\` \u2014 never invent ids.
+(2) Confirm with the user what they want to change. Pass \`folder_id: null\` to move the document back to the library root. Pass a real folder id (resolved via \`list_folders\`) to relocate it.
+
+Requires scope \`documents.write\`.`,
+  inputSchema: {
+    document_id: z.string().min(1),
+    name: z.string().min(1).max(512).optional(),
+    folder_id: z.string().nullable().optional().describe(
+      "Target folder id, or null to move to the library root. Omit to leave the folder unchanged."
+    )
+  }
+};
+var deleteDocumentContract = {
+  name: "delete_document",
+  title: "Delete a document",
+  description: `Permanently delete a document. This is irreversible: every share link, version, and view history attached to the document goes with it.
+
+WORKFLOW:
+(1) Resolve the document via \`search_documents\` \u2014 never delete based on a guessed id.
+(2) Confirm with the user (echo the document name) before calling. Treat this like \`rm -rf\`: don't infer intent from passing references.
+
+Requires scope \`documents.write\`.`,
+  inputSchema: {
+    document_id: z.string().min(1)
+  }
+};
+var listDocumentVersionsContract = {
+  name: "list_document_versions",
+  title: "List document versions",
+  description: "List every version of a document, primary first. Use this to find a version id before promoting an older one with `promote_document_version`. Requires scope `documents.read`.",
+  inputSchema: {
+    document_id: z.string().min(1)
+  }
+};
+var getDocumentVersionContract = {
+  name: "get_document_version",
+  title: "Get a document version",
+  description: "Fetch a single version of a document by its id. Requires scope `documents.read`.",
+  inputSchema: {
+    document_id: z.string().min(1),
+    version_id: z.string().min(1)
+  }
+};
+var addDocumentVersionContract = {
+  name: "add_document_version",
+  title: "Add a new document version",
+  description: `Upload a new version of an existing document, fetched from a public HTTPS URL. The new version becomes primary by default; live links automatically serve the new file.
+
+WORKFLOW:
+(1) Resolve the target document via \`search_documents\` or \`list_documents\`.
+(2) The user must give you a public HTTPS URL the API can fetch. Don't fabricate URLs.
+(3) After creation, mention the version_number so the user can promote/rollback later.
+
+NOTE: Adding a version from a local file path is not supported by this MCP tool \u2014 for that, use the \`upload_document\` tool to create a new document, or have the user upload via the Papermark UI.
+
+Requires scope \`documents.write\`.`,
+  inputSchema: {
+    document_id: z.string().min(1),
+    source_url: z.string().url().refine((s) => s.startsWith("https://"), {
+      message: "source_url must use https://"
+    }).describe("Public HTTPS URL the server should fetch as the new version")
+  }
+};
+var promoteDocumentVersionContract = {
+  name: "promote_document_version",
+  title: "Promote a version to primary",
+  description: `Roll back (or roll forward) by making a non-primary version the active one. The previous primary is demoted in the same transaction; share links immediately serve the new primary.
+
+WORKFLOW:
+(1) Call \`list_document_versions\` to find the right version id.
+(2) Confirm with the user before promoting \u2014 this changes what every existing link serves.
+
+Requires scope \`documents.write\`.`,
+  inputSchema: {
+    document_id: z.string().min(1),
+    version_id: z.string().min(1)
+  }
+};
+var listFoldersContract = {
+  name: "list_folders",
+  title: "List folders",
+  description: `List folders in the team library. Pass \`parent_id: "root"\` to list top-level folders, a folder id to list direct children, or omit \`parent_id\` to list every folder.
+
+USE THIS when the user wants to know which folders exist, or you need a \`folder_id\` to pass to \`update_document\` / \`upload_document\` / \`create_folder\`. Requires scope \`documents.read\`.`,
+  inputSchema: {
+    parent_id: z.string().optional().describe(
+      "Restrict to direct children of this folder. Use 'root' for top-level folders. Omit for all folders."
+    ),
+    limit: z.number().int().min(1).max(100).optional(),
+    cursor: z.string().optional()
+  }
+};
+var getFolderContract = {
+  name: "get_folder",
+  title: "Get a folder",
+  description: "Fetch a single team-library folder by id. Requires scope `documents.read`.",
+  inputSchema: {
+    folder_id: z.string().min(1)
+  }
+};
+var createFolderContract = {
+  name: "create_folder",
+  title: "Create a folder",
+  description: `Create a folder in the team library. Pass an existing folder id as \`parent_id\` to nest, or omit it for the root.
+
+WORKFLOW:
+(1) Confirm name and parent with the user. Don't invent folder names.
+(2) If they referred to "the Pitches folder" but didn't give an id, call \`list_folders\` first.
+
+Requires scope \`documents.write\`.`,
+  inputSchema: {
+    name: z.string().min(1).max(256),
+    parent_id: z.string().nullable().optional().describe("Parent folder id; omit or pass null for the team-library root"),
+    icon: FolderIconEnum.optional(),
+    color: FolderColorEnum.optional()
+  }
+};
+var updateFolderContract = {
+  name: "update_folder",
+  title: "Update a folder",
+  description: "Rename a folder, change its icon or color. Pass null to clear icon/color. Use `move_folder` to change its parent. Requires scope `documents.write`.",
+  inputSchema: {
+    folder_id: z.string().min(1),
+    name: z.string().min(1).max(256).optional(),
+    icon: FolderIconEnum.nullable().optional(),
+    color: FolderColorEnum.nullable().optional()
+  }
+};
+var deleteFolderContract = {
+  name: "delete_folder",
+  title: "Delete a folder",
+  description: `Delete a folder. By default this only succeeds if the folder is empty. Pass \`cascade: true\` to also delete every nested folder and document \u2014 this is destructive and irreversible.
+
+Always confirm with the user before passing cascade. Requires scope \`documents.write\`.`,
+  inputSchema: {
+    folder_id: z.string().min(1),
+    cascade: z.boolean().optional().describe(
+      "When true, deletes the folder and every nested folder + document. Defaults to false."
+    )
+  }
+};
+var moveFolderContract = {
+  name: "move_folder",
+  title: "Move a folder",
+  description: "Move a folder under a different parent. Pass `parent_id: null` to move it to the library root. Requires scope `documents.write`.",
+  inputSchema: {
+    folder_id: z.string().min(1),
+    parent_id: z.string().nullable().describe("Target parent folder id, or null for the library root")
+  }
+};
+var getLinkContract = {
+  name: "get_link",
+  title: "Get a share link",
+  description: "Fetch a single share link by id. Use this to confirm current settings before calling `update_link` so you don't accidentally clobber other fields. Requires scope `links.read`.",
+  inputSchema: {
+    link_id: z.string().min(1)
+  }
+};
+var updateLinkContract = {
+  name: "update_link",
+  title: "Update a share link",
+  description: `Change the security settings of an existing share link. The URL stays the same \u2014 viewers don't need to be re-notified.
+
+WORKFLOW:
+(1) Get the current settings via \`get_link\` first if you're not certain. PATCH semantics: omitted fields are unchanged, but a passed value REPLACES the current one.
+(2) Pass \`expires_at: null\` or \`password: null\` to clear those fields. \`allow_list: []\` empties the list.
+(3) Confirm any change to password / expiry / email gating with the user.
+
+Requires scope \`links.write\`.`,
+  inputSchema: {
+    link_id: z.string().min(1),
+    name: z.string().optional(),
+    expires_at: z.string().datetime().nullable().optional().describe("ISO 8601 timestamp, or null to clear the expiry"),
+    password: z.string().min(1).nullable().optional().describe("New password, or null to remove password protection"),
+    email_protected: z.boolean().optional(),
+    email_authenticated: z.boolean().optional(),
+    allow_download: z.boolean().optional(),
+    allow_list: z.array(z.string()).optional().describe("Email or domain allow list (e.g. ['@acme.com', 'bob@x.com'])"),
+    deny_list: z.array(z.string()).optional(),
+    enable_watermark: z.boolean().optional(),
+    enable_screenshot_protection: z.boolean().optional()
+  }
+};
+var deleteLinkContract = {
+  name: "delete_link",
+  title: "Revoke a share link",
+  description: `Revoke a share link (soft delete). Anyone who tries to open the URL will see a "link unavailable" page. The view history is preserved for analytics.
+
+Confirm with the user before revoking \u2014 they may have already shared the URL. Requires scope \`links.write\`.`,
+  inputSchema: {
+    link_id: z.string().min(1)
+  }
+};
+var updateDataroomContract = {
+  name: "update_dataroom",
+  title: "Update a dataroom",
+  description: `Change a dataroom's name, internal alias, description, or whether viewers can bulk-download. PATCH semantics \u2014 omitted fields stay as they are.
+
+WORKFLOW:
+(1) Resolve the dataroom via \`search_datarooms\` or \`list_datarooms\`.
+(2) Confirm any toggle of \`allow_bulk_download\` with the user \u2014 it affects every link tied to this dataroom.
+
+Requires scope \`datarooms.write\`.`,
+  inputSchema: {
+    dataroom_id: z.string().min(1),
+    name: z.string().min(1).optional(),
+    internal_name: z.string().nullable().optional(),
+    description: z.string().nullable().optional(),
+    allow_bulk_download: z.boolean().optional()
+  }
+};
+var deleteDataroomContract = {
+  name: "delete_dataroom",
+  title: "Delete a dataroom",
+  description: `Permanently delete a dataroom. Every link and folder attached to it goes with it. Documents themselves stay in the team library \u2014 only their attachments to this dataroom are removed.
+
+ALWAYS confirm with the user (echo the dataroom name and how many documents it contains, via \`get_dataroom\`) before calling. This is irreversible. Requires scope \`datarooms.write\`.`,
+  inputSchema: {
+    dataroom_id: z.string().min(1)
+  }
+};
+var attachDataroomDocumentContract = {
+  name: "attach_dataroom_document",
+  title: "Attach a document to a dataroom",
+  description: `Add an existing team-library document to a dataroom. The document stays in the library; this only creates the attachment.
+
+WORKFLOW:
+(1) Resolve both ids \u2014 the dataroom via \`search_datarooms\`, the document via \`search_documents\`.
+(2) Optionally pass a dataroom \`folder_id\` (created via \`create_dataroom_folder\`) to nest the attachment under a folder.
+
+Requires scope \`datarooms.write\`.`,
+  inputSchema: {
+    dataroom_id: z.string().min(1),
+    document_id: z.string().min(1),
+    folder_id: z.string().optional().describe(
+      "Optional dataroom-folder id to place the attachment under. Folder must belong to this dataroom."
+    )
+  }
+};
+var listDataroomFoldersContract = {
+  name: "list_dataroom_folders",
+  title: "List folders in a dataroom",
+  description: `List folders inside a dataroom. Pass \`parent_id: "root"\` for top-level, a folder id for direct children, or omit for every folder in the dataroom.
+
+USE THIS when you need a dataroom \`folder_id\` for \`attach_dataroom_document\` or \`create_dataroom_folder\`. Requires scope \`datarooms.read\`.`,
+  inputSchema: {
+    dataroom_id: z.string().min(1),
+    parent_id: z.string().optional(),
+    limit: z.number().int().min(1).max(100).optional(),
+    cursor: z.string().optional()
+  }
+};
+var getDataroomFolderContract = {
+  name: "get_dataroom_folder",
+  title: "Get a dataroom folder",
+  description: "Fetch a single dataroom folder. Requires scope `datarooms.read`.",
+  inputSchema: {
+    dataroom_id: z.string().min(1),
+    folder_id: z.string().min(1)
+  }
+};
+var createDataroomFolderContract = {
+  name: "create_dataroom_folder",
+  title: "Create a folder in a dataroom",
+  description: "Create a folder inside a dataroom. Pass an existing dataroom-folder id as `parent_id` to nest, omit for the dataroom root. Folders here are scoped to a single dataroom and are separate from team-library folders. Requires scope `datarooms.write`.",
+  inputSchema: {
+    dataroom_id: z.string().min(1),
+    name: z.string().min(1).max(256),
+    parent_id: z.string().nullable().optional(),
+    icon: FolderIconEnum.optional(),
+    color: FolderColorEnum.optional()
+  }
+};
+var updateDataroomFolderContract = {
+  name: "update_dataroom_folder",
+  title: "Update a dataroom folder",
+  description: "Rename a dataroom folder, change its icon/color. Pass null to clear icon/color. Use `move_dataroom_folder` to change its parent. Requires scope `datarooms.write`.",
+  inputSchema: {
+    dataroom_id: z.string().min(1),
+    folder_id: z.string().min(1),
+    name: z.string().min(1).max(256).optional(),
+    icon: FolderIconEnum.nullable().optional(),
+    color: FolderColorEnum.nullable().optional()
+  }
+};
+var deleteDataroomFolderContract = {
+  name: "delete_dataroom_folder",
+  title: "Delete a dataroom folder",
+  description: `Delete a dataroom folder. By default this only succeeds if the folder is empty. Pass \`cascade: true\` to also delete every nested folder + dataroom-document attachment beneath it. The underlying documents in the team library are NOT deleted \u2014 only their attachments to this dataroom.
+
+Confirm with the user before passing cascade. Requires scope \`datarooms.write\`.`,
+  inputSchema: {
+    dataroom_id: z.string().min(1),
+    folder_id: z.string().min(1),
+    cascade: z.boolean().optional()
+  }
+};
+var moveDataroomFolderContract = {
+  name: "move_dataroom_folder",
+  title: "Move a dataroom folder",
+  description: "Move a folder under a different parent within the same dataroom. Pass `parent_id: null` to move to the dataroom root. Requires scope `datarooms.write`.",
+  inputSchema: {
+    dataroom_id: z.string().min(1),
+    folder_id: z.string().min(1),
+    parent_id: z.string().nullable()
+  }
+};
+var getVisitorContract = {
+  name: "get_visitor",
+  title: "Get a visitor",
+  description: "Fetch a single visitor (Viewer row) by id, including total view count and last-seen timestamp. Use `list_visitors` with an email filter to find the id. Requires scope `visitors.read`.",
+  inputSchema: {
+    visitor_id: z.string().min(1)
+  }
+};
+
+export {
+  listDocumentsContract,
+  getDocumentContract,
+  searchDocumentsContract,
+  createLinkContract,
+  listLinksContract,
+  listLinkViewsContract,
+  listDataroomsContract,
+  searchDataroomsContract,
+  getDataroomContract,
+  createDataroomContract,
+  listDataroomDocumentsContract,
+  listVisitorsContract,
+  listVisitorViewsContract,
+  getDocumentAnalyticsContract,
+  getLinkAnalyticsContract,
+  getDataroomAnalyticsContract,
+  getViewAnalyticsContract,
+  updateDocumentContract,
+  deleteDocumentContract,
+  listDocumentVersionsContract,
+  getDocumentVersionContract,
+  addDocumentVersionContract,
+  promoteDocumentVersionContract,
+  listFoldersContract,
+  getFolderContract,
+  createFolderContract,
+  updateFolderContract,
+  deleteFolderContract,
+  moveFolderContract,
+  getLinkContract,
+  updateLinkContract,
+  deleteLinkContract,
+  updateDataroomContract,
+  deleteDataroomContract,
+  attachDataroomDocumentContract,
+  listDataroomFoldersContract,
+  getDataroomFolderContract,
+  createDataroomFolderContract,
+  updateDataroomFolderContract,
+  deleteDataroomFolderContract,
+  moveDataroomFolderContract,
+  getVisitorContract
+};
+//# sourceMappingURL=chunk-S3ALJ4YG.js.map