@papermark/mcp-server 0.0.1 → 0.1.0

package/dist/tools-contract.d.ts

@@ -0,0 +1,617 @@
+import { z } from 'zod';
+
+/**
+ * Single source of truth for the LLM-facing contract of each Papermark MCP
+ * tool — name, title, description, and zod input schema. Both the stdio
+ * transport (this repo) and the remote HTTP adapter (in the papermark app)
+ * import from here so descriptions and schemas can't drift.
+ *
+ * Tool *bodies* (how each transport actually fulfills the request) stay in
+ * the transport, because the environments differ — stdio can read local
+ * files and hit the public v1 API over fetch; the in-app HTTP adapter
+ * reaches the v1 routes via loopback with the caller's bearer token.
+ *
+ * `upload_document` is intentionally omitted: the stdio variant accepts a
+ * local `file_path`, which the HTTP variant can't honor. Each side defines
+ * its own upload_document contract.
+ */
+interface ToolContract<TShape extends z.ZodRawShape> {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: TShape;
+}
+declare const listDocumentsContract: {
+    readonly name: "list_documents";
+    readonly title: "List documents";
+    readonly 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` — never fabricate ids. Requires scope `documents.read`.";
+    readonly inputSchema: {
+        readonly limit: z.ZodOptional<z.ZodNumber>;
+        readonly cursor: z.ZodOptional<z.ZodString>;
+        readonly query: z.ZodOptional<z.ZodString>;
+    };
+};
+declare const getDocumentContract: {
+    readonly name: "get_document";
+    readonly title: "Get document";
+    readonly description: "Fetch a single document by id. `document_id` must come from `list_documents` or `search_documents` — never invent one. If the user referred to a document by name, call `search_documents` first. Requires scope `documents.read`.";
+    readonly inputSchema: {
+        readonly document_id: z.ZodString;
+    };
+};
+declare const searchDocumentsContract: {
+    readonly name: "search_documents";
+    readonly title: "Search documents";
+    readonly 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`.";
+    readonly inputSchema: {
+        readonly query: z.ZodString;
+        readonly limit: z.ZodOptional<z.ZodNumber>;
+    };
+};
+declare const createLinkContract: {
+    readonly name: "create_link";
+    readonly title: "Create share link";
+    readonly description: "Create a share link for a document (or dataroom). The returned `url` is what users share.\n\nWORKFLOW:\n(1) Resolve the target: the user may say \"the Q3 deck\" or \"the Acme dataroom\" — 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.\n(2) Clarify ANY of these that the user didn't state explicitly — do NOT invent values:\n    • expiry (`expires_at`, ISO 8601) — confirm with the user, default is no expiry\n    • password — 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\n    • email gating (`email_protected`) — ask if unclear\n    • downloads (`allow_download`) — default off for external sharing\n(3) Create the link, then surface both the URL and the security settings so the user can verify.\n\nNever share a link to a document the user didn't explicitly name. Requires scope `links.write`.";
+    readonly inputSchema: {
+        readonly document_id: z.ZodOptional<z.ZodString>;
+        readonly dataroom_id: z.ZodOptional<z.ZodString>;
+        readonly name: z.ZodOptional<z.ZodString>;
+        readonly expires_at: z.ZodOptional<z.ZodString>;
+        readonly password: z.ZodOptional<z.ZodString>;
+        readonly email_protected: z.ZodOptional<z.ZodBoolean>;
+        readonly allow_download: z.ZodOptional<z.ZodBoolean>;
+    };
+};
+declare const listLinksContract: {
+    readonly name: "list_links";
+    readonly title: "List share links";
+    readonly description: "List share links in the authenticated team. Optionally filter by `document_id` or `dataroom_id`. Requires scope `links.read`.";
+    readonly inputSchema: {
+        readonly document_id: z.ZodOptional<z.ZodString>;
+        readonly dataroom_id: z.ZodOptional<z.ZodString>;
+        readonly limit: z.ZodOptional<z.ZodNumber>;
+        readonly cursor: z.ZodOptional<z.ZodString>;
+    };
+};
+declare const listLinkViewsContract: {
+    readonly name: "list_link_views";
+    readonly title: "List a link's view events";
+    readonly 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`.";
+    readonly inputSchema: {
+        readonly link_id: z.ZodString;
+        readonly limit: z.ZodOptional<z.ZodNumber>;
+        readonly cursor: z.ZodOptional<z.ZodString>;
+    };
+};
+declare const listDataroomsContract: {
+    readonly name: "list_datarooms";
+    readonly title: "List datarooms";
+    readonly description: "List datarooms in the authenticated team. Returns up to `limit` results with a cursor. Requires scope `datarooms.read`.";
+    readonly inputSchema: {
+        readonly limit: z.ZodOptional<z.ZodNumber>;
+        readonly cursor: z.ZodOptional<z.ZodString>;
+        readonly query: z.ZodOptional<z.ZodString>;
+    };
+};
+declare const searchDataroomsContract: {
+    readonly name: "search_datarooms";
+    readonly title: "Search datarooms";
+    readonly 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 — before calling `create_link`, `get_dataroom_analytics`, or any other tool that takes a `dataroom_id`. Requires scope `datarooms.read`.";
+    readonly inputSchema: {
+        readonly query: z.ZodString;
+        readonly limit: z.ZodOptional<z.ZodNumber>;
+    };
+};
+declare const getDataroomContract: {
+    readonly name: "get_dataroom";
+    readonly title: "Get a dataroom";
+    readonly description: "Fetch a single dataroom by its id (accepts either the internal cuid or the `dr_...` public id). Requires scope `datarooms.read`.";
+    readonly inputSchema: {
+        readonly dataroom_id: z.ZodString;
+    };
+};
+declare const createDataroomContract: {
+    readonly name: "create_dataroom";
+    readonly title: "Create a dataroom";
+    readonly description: "Create a new (empty) dataroom. Documents can be added using the `attach_dataroom_document` tool after creating the dataroom.\n\nWORKFLOW:\n(1) Confirm with the user: exact dataroom name, optional internal_name, optional description. Do NOT invent these.\n(2) Check `list_datarooms` first if the user said \"my Acme room\" — they may already have one and not want a duplicate.\n(3) Create the dataroom; return the new dataroom id so the caller can add documents with `attach_dataroom_document`.\n\nRequires scope `datarooms.write`.";
+    readonly inputSchema: {
+        readonly name: z.ZodString;
+        readonly internal_name: z.ZodOptional<z.ZodString>;
+        readonly description: z.ZodOptional<z.ZodString>;
+    };
+};
+declare const listDataroomDocumentsContract: {
+    readonly name: "list_dataroom_documents";
+    readonly title: "List documents in a dataroom";
+    readonly description: "Return the documents contained in a dataroom, ordered by folder and custom order. Requires scope `datarooms.read`.";
+    readonly inputSchema: {
+        readonly dataroom_id: z.ZodString;
+        readonly folder_id: z.ZodOptional<z.ZodString>;
+        readonly limit: z.ZodOptional<z.ZodNumber>;
+        readonly cursor: z.ZodOptional<z.ZodString>;
+    };
+};
+declare const listVisitorsContract: {
+    readonly name: "list_visitors";
+    readonly title: "List visitors";
+    readonly 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`.";
+    readonly inputSchema: {
+        readonly email: z.ZodOptional<z.ZodString>;
+        readonly dataroom_id: z.ZodOptional<z.ZodString>;
+        readonly limit: z.ZodOptional<z.ZodNumber>;
+        readonly cursor: z.ZodOptional<z.ZodString>;
+    };
+};
+declare const listVisitorViewsContract: {
+    readonly name: "list_visitor_views";
+    readonly title: "List a visitor's views";
+    readonly 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`.";
+    readonly inputSchema: {
+        readonly visitor_id: z.ZodString;
+        readonly limit: z.ZodOptional<z.ZodNumber>;
+        readonly cursor: z.ZodOptional<z.ZodString>;
+    };
+};
+declare const getDocumentAnalyticsContract: {
+    readonly name: "get_document_analytics";
+    readonly title: "Get document analytics";
+    readonly 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 — cache results when possible.";
+    readonly inputSchema: {
+        readonly document_id: z.ZodString;
+        readonly since: z.ZodOptional<z.ZodNumber>;
+        readonly until: z.ZodOptional<z.ZodNumber>;
+    };
+};
+declare const getLinkAnalyticsContract: {
+    readonly name: "get_link_analytics";
+    readonly title: "Get link analytics";
+    readonly 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`.";
+    readonly inputSchema: {
+        readonly link_id: z.ZodString;
+        readonly since: z.ZodOptional<z.ZodNumber>;
+        readonly until: z.ZodOptional<z.ZodNumber>;
+    };
+};
+declare const getDataroomAnalyticsContract: {
+    readonly name: "get_dataroom_analytics";
+    readonly title: "Get dataroom analytics";
+    readonly 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`.";
+    readonly inputSchema: {
+        readonly dataroom_id: z.ZodString;
+        readonly since: z.ZodOptional<z.ZodNumber>;
+        readonly until: z.ZodOptional<z.ZodNumber>;
+    };
+};
+declare const getViewAnalyticsContract: {
+    readonly name: "get_view_analytics";
+    readonly title: "Get per-view breakdown";
+    readonly 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`.";
+    readonly inputSchema: {
+        readonly view_id: z.ZodString;
+    };
+};
+declare const updateDocumentContract: {
+    readonly name: "update_document";
+    readonly title: "Update a document";
+    readonly description: "Rename a document or move it to a different team-library folder. Replacing the file content is a separate operation — use `add_document_version`.\n\nWORKFLOW:\n(1) Resolve the document via `search_documents` or `list_documents` — never invent ids.\n(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.\n\nRequires scope `documents.write`.";
+    readonly inputSchema: {
+        readonly document_id: z.ZodString;
+        readonly name: z.ZodOptional<z.ZodString>;
+        readonly folder_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    };
+};
+declare const deleteDocumentContract: {
+    readonly name: "delete_document";
+    readonly title: "Delete a document";
+    readonly description: "Permanently delete a document. This is irreversible: every share link, version, and view history attached to the document goes with it.\n\nWORKFLOW:\n(1) Resolve the document via `search_documents` — never delete based on a guessed id.\n(2) Confirm with the user (echo the document name) before calling. Treat this like `rm -rf`: don't infer intent from passing references.\n\nRequires scope `documents.write`.";
+    readonly inputSchema: {
+        readonly document_id: z.ZodString;
+    };
+};
+declare const listDocumentVersionsContract: {
+    readonly name: "list_document_versions";
+    readonly title: "List document versions";
+    readonly 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`.";
+    readonly inputSchema: {
+        readonly document_id: z.ZodString;
+    };
+};
+declare const getDocumentVersionContract: {
+    readonly name: "get_document_version";
+    readonly title: "Get a document version";
+    readonly description: "Fetch a single version of a document by its id. Requires scope `documents.read`.";
+    readonly inputSchema: {
+        readonly document_id: z.ZodString;
+        readonly version_id: z.ZodString;
+    };
+};
+declare const addDocumentVersionContract: {
+    readonly name: "add_document_version";
+    readonly title: "Add a new document version";
+    readonly 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.\n\nWORKFLOW:\n(1) Resolve the target document via `search_documents` or `list_documents`.\n(2) The user must give you a public HTTPS URL the API can fetch. Don't fabricate URLs.\n(3) After creation, mention the version_number so the user can promote/rollback later.\n\nNOTE: Adding a version from a local file path is not supported by this MCP tool — for that, use the `upload_document` tool to create a new document, or have the user upload via the Papermark UI.\n\nRequires scope `documents.write`.";
+    readonly inputSchema: {
+        readonly document_id: z.ZodString;
+        readonly source_url: z.ZodString;
+    };
+};
+declare const promoteDocumentVersionContract: {
+    readonly name: "promote_document_version";
+    readonly title: "Promote a version to primary";
+    readonly 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.\n\nWORKFLOW:\n(1) Call `list_document_versions` to find the right version id.\n(2) Confirm with the user before promoting — this changes what every existing link serves.\n\nRequires scope `documents.write`.";
+    readonly inputSchema: {
+        readonly document_id: z.ZodString;
+        readonly version_id: z.ZodString;
+    };
+};
+declare const listFoldersContract: {
+    readonly name: "list_folders";
+    readonly title: "List folders";
+    readonly 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.\n\nUSE 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`.";
+    readonly inputSchema: {
+        readonly parent_id: z.ZodOptional<z.ZodString>;
+        readonly limit: z.ZodOptional<z.ZodNumber>;
+        readonly cursor: z.ZodOptional<z.ZodString>;
+    };
+};
+declare const getFolderContract: {
+    readonly name: "get_folder";
+    readonly title: "Get a folder";
+    readonly description: "Fetch a single team-library folder by id. Requires scope `documents.read`.";
+    readonly inputSchema: {
+        readonly folder_id: z.ZodString;
+    };
+};
+declare const createFolderContract: {
+    readonly name: "create_folder";
+    readonly title: "Create a folder";
+    readonly description: "Create a folder in the team library. Pass an existing folder id as `parent_id` to nest, or omit it for the root.\n\nWORKFLOW:\n(1) Confirm name and parent with the user. Don't invent folder names.\n(2) If they referred to \"the Pitches folder\" but didn't give an id, call `list_folders` first.\n\nRequires scope `documents.write`.";
+    readonly inputSchema: {
+        readonly name: z.ZodString;
+        readonly parent_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        readonly icon: z.ZodOptional<z.ZodEnum<{
+            file: "file";
+            folder: "folder";
+            "folder-open": "folder-open";
+            briefcase: "briefcase";
+            archive: "archive";
+            box: "box";
+            book: "book";
+            bookmark: "bookmark";
+            star: "star";
+            heart: "heart";
+            lock: "lock";
+            shield: "shield";
+            users: "users";
+            settings: "settings";
+            tag: "tag";
+            layers: "layers";
+            globe: "globe";
+            home: "home";
+            mail: "mail";
+            image: "image";
+            video: "video";
+            music: "music";
+            palette: "palette";
+            "pen-tool": "pen-tool";
+            lightbulb: "lightbulb";
+            zap: "zap";
+            wrench: "wrench";
+            sparkles: "sparkles";
+            cloud: "cloud";
+            flag: "flag";
+            award: "award";
+            flame: "flame";
+            bell: "bell";
+            sun: "sun";
+            hash: "hash";
+        }>>;
+        readonly color: z.ZodOptional<z.ZodEnum<{
+            gray: "gray";
+            red: "red";
+            orange: "orange";
+            yellow: "yellow";
+            green: "green";
+            blue: "blue";
+            black: "black";
+        }>>;
+    };
+};
+declare const updateFolderContract: {
+    readonly name: "update_folder";
+    readonly title: "Update a folder";
+    readonly 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`.";
+    readonly inputSchema: {
+        readonly folder_id: z.ZodString;
+        readonly name: z.ZodOptional<z.ZodString>;
+        readonly icon: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+            file: "file";
+            folder: "folder";
+            "folder-open": "folder-open";
+            briefcase: "briefcase";
+            archive: "archive";
+            box: "box";
+            book: "book";
+            bookmark: "bookmark";
+            star: "star";
+            heart: "heart";
+            lock: "lock";
+            shield: "shield";
+            users: "users";
+            settings: "settings";
+            tag: "tag";
+            layers: "layers";
+            globe: "globe";
+            home: "home";
+            mail: "mail";
+            image: "image";
+            video: "video";
+            music: "music";
+            palette: "palette";
+            "pen-tool": "pen-tool";
+            lightbulb: "lightbulb";
+            zap: "zap";
+            wrench: "wrench";
+            sparkles: "sparkles";
+            cloud: "cloud";
+            flag: "flag";
+            award: "award";
+            flame: "flame";
+            bell: "bell";
+            sun: "sun";
+            hash: "hash";
+        }>>>;
+        readonly color: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+            gray: "gray";
+            red: "red";
+            orange: "orange";
+            yellow: "yellow";
+            green: "green";
+            blue: "blue";
+            black: "black";
+        }>>>;
+    };
+};
+declare const deleteFolderContract: {
+    readonly name: "delete_folder";
+    readonly title: "Delete a folder";
+    readonly 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 — this is destructive and irreversible.\n\nAlways confirm with the user before passing cascade. Requires scope `documents.write`.";
+    readonly inputSchema: {
+        readonly folder_id: z.ZodString;
+        readonly cascade: z.ZodOptional<z.ZodBoolean>;
+    };
+};
+declare const moveFolderContract: {
+    readonly name: "move_folder";
+    readonly title: "Move a folder";
+    readonly description: "Move a folder under a different parent. Pass `parent_id: null` to move it to the library root. Requires scope `documents.write`.";
+    readonly inputSchema: {
+        readonly folder_id: z.ZodString;
+        readonly parent_id: z.ZodNullable<z.ZodString>;
+    };
+};
+declare const getLinkContract: {
+    readonly name: "get_link";
+    readonly title: "Get a share link";
+    readonly 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`.";
+    readonly inputSchema: {
+        readonly link_id: z.ZodString;
+    };
+};
+declare const updateLinkContract: {
+    readonly name: "update_link";
+    readonly title: "Update a share link";
+    readonly description: "Change the security settings of an existing share link. The URL stays the same — viewers don't need to be re-notified.\n\nWORKFLOW:\n(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.\n(2) Pass `expires_at: null` or `password: null` to clear those fields. `allow_list: []` empties the list.\n(3) Confirm any change to password / expiry / email gating with the user.\n\nRequires scope `links.write`.";
+    readonly inputSchema: {
+        readonly link_id: z.ZodString;
+        readonly name: z.ZodOptional<z.ZodString>;
+        readonly expires_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        readonly password: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        readonly email_protected: z.ZodOptional<z.ZodBoolean>;
+        readonly email_authenticated: z.ZodOptional<z.ZodBoolean>;
+        readonly allow_download: z.ZodOptional<z.ZodBoolean>;
+        readonly allow_list: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        readonly deny_list: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        readonly enable_watermark: z.ZodOptional<z.ZodBoolean>;
+        readonly enable_screenshot_protection: z.ZodOptional<z.ZodBoolean>;
+    };
+};
+declare const deleteLinkContract: {
+    readonly name: "delete_link";
+    readonly title: "Revoke a share link";
+    readonly 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.\n\nConfirm with the user before revoking — they may have already shared the URL. Requires scope `links.write`.";
+    readonly inputSchema: {
+        readonly link_id: z.ZodString;
+    };
+};
+declare const updateDataroomContract: {
+    readonly name: "update_dataroom";
+    readonly title: "Update a dataroom";
+    readonly description: "Change a dataroom's name, internal alias, description, or whether viewers can bulk-download. PATCH semantics — omitted fields stay as they are.\n\nWORKFLOW:\n(1) Resolve the dataroom via `search_datarooms` or `list_datarooms`.\n(2) Confirm any toggle of `allow_bulk_download` with the user — it affects every link tied to this dataroom.\n\nRequires scope `datarooms.write`.";
+    readonly inputSchema: {
+        readonly dataroom_id: z.ZodString;
+        readonly name: z.ZodOptional<z.ZodString>;
+        readonly internal_name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        readonly description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        readonly allow_bulk_download: z.ZodOptional<z.ZodBoolean>;
+    };
+};
+declare const deleteDataroomContract: {
+    readonly name: "delete_dataroom";
+    readonly title: "Delete a dataroom";
+    readonly description: "Permanently delete a dataroom. Every link and folder attached to it goes with it. Documents themselves stay in the team library — only their attachments to this dataroom are removed.\n\nALWAYS 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`.";
+    readonly inputSchema: {
+        readonly dataroom_id: z.ZodString;
+    };
+};
+declare const attachDataroomDocumentContract: {
+    readonly name: "attach_dataroom_document";
+    readonly title: "Attach a document to a dataroom";
+    readonly description: "Add an existing team-library document to a dataroom. The document stays in the library; this only creates the attachment.\n\nWORKFLOW:\n(1) Resolve both ids — the dataroom via `search_datarooms`, the document via `search_documents`.\n(2) Optionally pass a dataroom `folder_id` (created via `create_dataroom_folder`) to nest the attachment under a folder.\n\nRequires scope `datarooms.write`.";
+    readonly inputSchema: {
+        readonly dataroom_id: z.ZodString;
+        readonly document_id: z.ZodString;
+        readonly folder_id: z.ZodOptional<z.ZodString>;
+    };
+};
+declare const listDataroomFoldersContract: {
+    readonly name: "list_dataroom_folders";
+    readonly title: "List folders in a dataroom";
+    readonly 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.\n\nUSE THIS when you need a dataroom `folder_id` for `attach_dataroom_document` or `create_dataroom_folder`. Requires scope `datarooms.read`.";
+    readonly inputSchema: {
+        readonly dataroom_id: z.ZodString;
+        readonly parent_id: z.ZodOptional<z.ZodString>;
+        readonly limit: z.ZodOptional<z.ZodNumber>;
+        readonly cursor: z.ZodOptional<z.ZodString>;
+    };
+};
+declare const getDataroomFolderContract: {
+    readonly name: "get_dataroom_folder";
+    readonly title: "Get a dataroom folder";
+    readonly description: "Fetch a single dataroom folder. Requires scope `datarooms.read`.";
+    readonly inputSchema: {
+        readonly dataroom_id: z.ZodString;
+        readonly folder_id: z.ZodString;
+    };
+};
+declare const createDataroomFolderContract: {
+    readonly name: "create_dataroom_folder";
+    readonly title: "Create a folder in a dataroom";
+    readonly 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`.";
+    readonly inputSchema: {
+        readonly dataroom_id: z.ZodString;
+        readonly name: z.ZodString;
+        readonly parent_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        readonly icon: z.ZodOptional<z.ZodEnum<{
+            file: "file";
+            folder: "folder";
+            "folder-open": "folder-open";
+            briefcase: "briefcase";
+            archive: "archive";
+            box: "box";
+            book: "book";
+            bookmark: "bookmark";
+            star: "star";
+            heart: "heart";
+            lock: "lock";
+            shield: "shield";
+            users: "users";
+            settings: "settings";
+            tag: "tag";
+            layers: "layers";
+            globe: "globe";
+            home: "home";
+            mail: "mail";
+            image: "image";
+            video: "video";
+            music: "music";
+            palette: "palette";
+            "pen-tool": "pen-tool";
+            lightbulb: "lightbulb";
+            zap: "zap";
+            wrench: "wrench";
+            sparkles: "sparkles";
+            cloud: "cloud";
+            flag: "flag";
+            award: "award";
+            flame: "flame";
+            bell: "bell";
+            sun: "sun";
+            hash: "hash";
+        }>>;
+        readonly color: z.ZodOptional<z.ZodEnum<{
+            gray: "gray";
+            red: "red";
+            orange: "orange";
+            yellow: "yellow";
+            green: "green";
+            blue: "blue";
+            black: "black";
+        }>>;
+    };
+};
+declare const updateDataroomFolderContract: {
+    readonly name: "update_dataroom_folder";
+    readonly title: "Update a dataroom folder";
+    readonly 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`.";
+    readonly inputSchema: {
+        readonly dataroom_id: z.ZodString;
+        readonly folder_id: z.ZodString;
+        readonly name: z.ZodOptional<z.ZodString>;
+        readonly icon: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+            file: "file";
+            folder: "folder";
+            "folder-open": "folder-open";
+            briefcase: "briefcase";
+            archive: "archive";
+            box: "box";
+            book: "book";
+            bookmark: "bookmark";
+            star: "star";
+            heart: "heart";
+            lock: "lock";
+            shield: "shield";
+            users: "users";
+            settings: "settings";
+            tag: "tag";
+            layers: "layers";
+            globe: "globe";
+            home: "home";
+            mail: "mail";
+            image: "image";
+            video: "video";
+            music: "music";
+            palette: "palette";
+            "pen-tool": "pen-tool";
+            lightbulb: "lightbulb";
+            zap: "zap";
+            wrench: "wrench";
+            sparkles: "sparkles";
+            cloud: "cloud";
+            flag: "flag";
+            award: "award";
+            flame: "flame";
+            bell: "bell";
+            sun: "sun";
+            hash: "hash";
+        }>>>;
+        readonly color: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+            gray: "gray";
+            red: "red";
+            orange: "orange";
+            yellow: "yellow";
+            green: "green";
+            blue: "blue";
+            black: "black";
+        }>>>;
+    };
+};
+declare const deleteDataroomFolderContract: {
+    readonly name: "delete_dataroom_folder";
+    readonly title: "Delete a dataroom folder";
+    readonly 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 — only their attachments to this dataroom.\n\nConfirm with the user before passing cascade. Requires scope `datarooms.write`.";
+    readonly inputSchema: {
+        readonly dataroom_id: z.ZodString;
+        readonly folder_id: z.ZodString;
+        readonly cascade: z.ZodOptional<z.ZodBoolean>;
+    };
+};
+declare const moveDataroomFolderContract: {
+    readonly name: "move_dataroom_folder";
+    readonly title: "Move a dataroom folder";
+    readonly 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`.";
+    readonly inputSchema: {
+        readonly dataroom_id: z.ZodString;
+        readonly folder_id: z.ZodString;
+        readonly parent_id: z.ZodNullable<z.ZodString>;
+    };
+};
+declare const getVisitorContract: {
+    readonly name: "get_visitor";
+    readonly title: "Get a visitor";
+    readonly 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`.";
+    readonly inputSchema: {
+        readonly visitor_id: z.ZodString;
+    };
+};
+
+export { type ToolContract, addDocumentVersionContract, attachDataroomDocumentContract, createDataroomContract, createDataroomFolderContract, createFolderContract, createLinkContract, deleteDataroomContract, deleteDataroomFolderContract, deleteDocumentContract, deleteFolderContract, deleteLinkContract, getDataroomAnalyticsContract, getDataroomContract, getDataroomFolderContract, getDocumentAnalyticsContract, getDocumentContract, getDocumentVersionContract, getFolderContract, getLinkAnalyticsContract, getLinkContract, getViewAnalyticsContract, getVisitorContract, listDataroomDocumentsContract, listDataroomFoldersContract, listDataroomsContract, listDocumentVersionsContract, listDocumentsContract, listFoldersContract, listLinkViewsContract, listLinksContract, listVisitorViewsContract, listVisitorsContract, moveDataroomFolderContract, moveFolderContract, promoteDocumentVersionContract, searchDataroomsContract, searchDocumentsContract, updateDataroomContract, updateDataroomFolderContract, updateDocumentContract, updateFolderContract, updateLinkContract };