@baruchiro/paperless-mcp 0.0.3 → 0.1.0

package/README.md

@@ -206,6 +206,15 @@ bulk_edit_documents({
   add_tags: [1, 2],
   remove_tags: [3, 4]
 })
+
+// Modify custom fields
+bulk_edit_documents({
+  documents: [12, 13],
+  method: "modify_custom_fields",
+  add_custom_fields: {
+    "2": "שנה"
+  }
+})
 ```
 
 #### post_document
@@ -232,7 +241,8 @@ post_document({
   correspondent: 1,
   document_type: 2,
   tags: [1, 3],
-  archive_serial_number: "2024-001"
+  archive_serial_number: "2024-001",
+  custom_fields: [1, 2]
 })
 ```
 
@@ -313,6 +323,85 @@ create_document_type({
 })
 ```
 
+### Custom Field Operations
+
+#### list_custom_fields
+Get all custom fields.
+
+```typescript
+list_custom_fields()
+```
+
+#### get_custom_field
+Get a specific custom field by ID.
+
+Parameters:
+- id: Custom field ID
+
+```typescript
+get_custom_field({
+  id: 1
+})
+```
+
+#### create_custom_field
+Create a new custom field.
+
+Parameters:
+- name: Custom field name
+- data_type: One of "string", "url", "date", "boolean", "integer", "float", "monetary", "documentlink", "select"
+- extra_data (optional): Extra data for the custom field, such as select options
+
+```typescript
+create_custom_field({
+  name: "Invoice Number",
+  data_type: "string"
+})
+```
+
+#### update_custom_field
+Update an existing custom field.
+
+Parameters:
+- id: Custom field ID
+- name (optional): New custom field name
+- data_type (optional): New data type
+- extra_data (optional): Extra data for the custom field
+
+```typescript
+update_custom_field({
+  id: 1,
+  name: "Updated Invoice Number",
+  data_type: "string"
+})
+```
+
+#### delete_custom_field
+Delete a custom field.
+
+Parameters:
+- id: Custom field ID
+
+```typescript
+delete_custom_field({
+  id: 1
+})
+```
+
+#### bulk_edit_custom_fields
+Perform bulk operations on multiple custom fields.
+
+Parameters:
+- custom_fields: Array of custom field IDs
+- operation: One of "delete"
+
+```typescript
+bulk_edit_custom_fields({
+  custom_fields: [1, 2, 3],
+  operation: "delete"
+})
+```
+
 ## Error Handling
 
 The server will show clear error messages if:
@@ -372,3 +461,42 @@ npm run start -- <baseUrl> <token> --http --port 3000
 # Credits
 
 This project is a fork of [nloui/paperless-mcp](https://github.com/nloui/paperless-mcp). Many thanks to the original author for their work. Contributions and improvements may be returned upstream.
+
+## Debugging
+
+To debug the MCP server in VS Code, use the following launch configuration:
+
+```json
+{
+    "type": "node",
+    "request": "launch",
+    "name": "Debug Paperless MCP (HTTP, ts-node ESM)",
+    "program": "${workspaceFolder}/node_modules/ts-node/dist/bin.js",
+    "args": [
+        "--esm",
+        "src/index.ts",
+        "--http",
+        "--baseUrl",
+        "http://your-paperless-instance:8000",
+        "--token",
+        "your-api-token",
+        "--port",
+        "3002"
+    ],
+    "env": {
+        "NODE_OPTIONS": "--loader ts-node/esm",
+    },
+    "console": "integratedTerminal",
+    "skipFiles": [
+        "<node_internals>/**"
+    ]
+}
+```
+
+**Important:** Before debugging, uncomment the following line in `src/index.ts` (around line 175):
+
+```typescript
+// await new Promise((resolve) => setTimeout(resolve, 1000000));
+```
+
+This prevents the server from exiting immediately and allows you to set breakpoints and debug the code.

package/build/api/PaperlessAPI.d.ts

@@ -1,13 +1,14 @@
-import { BulkEditDocumentsResult, Correspondent, Document, DocumentsResponse, DocumentType, GetCorrespondentsResponse, GetDocumentTypesResponse, GetTagsResponse, Tag } from "./types";
+import { BulkEditDocumentsResult, BulkEditParameters, Correspondent, CustomField, Document, DocumentsResponse, DocumentType, GetCorrespondentsResponse, GetCustomFieldsResponse, GetDocumentTypesResponse, GetTagsResponse, Tag } from "./types";
 export declare class PaperlessAPI {
     private readonly baseUrl;
     private readonly token;
     constructor(baseUrl: string, token: string);
     request<T = any>(path: string, options?: RequestInit): Promise<T>;
-    bulkEditDocuments(documents: number[], method: string, parameters?: {}): Promise<BulkEditDocumentsResult>;
+    bulkEditDocuments(documents: number[], method: string, parameters?: BulkEditParameters): Promise<BulkEditDocumentsResult>;
     postDocument(file: File, metadata?: Record<string, string | string[] | number | number[]>): Promise<string>;
     getDocuments(query?: string): Promise<DocumentsResponse>;
     getDocument(id: number): Promise<Document>;
+    updateDocument(id: number, data: Partial<Document>): Promise<Document>;
     searchDocuments(query: string): Promise<DocumentsResponse>;
     downloadDocument(id: number, asOriginal?: boolean): Promise<import("axios").AxiosResponse<any, any>>;
     getTags(): Promise<GetTagsResponse>;
@@ -22,5 +23,10 @@ export declare class PaperlessAPI {
     createDocumentType(data: Partial<DocumentType>): Promise<DocumentType>;
     updateDocumentType(id: number, data: Partial<DocumentType>): Promise<DocumentType>;
     deleteDocumentType(id: number): Promise<void>;
+    getCustomFields(): Promise<GetCustomFieldsResponse>;
+    getCustomField(id: number): Promise<CustomField>;
+    createCustomField(data: Partial<CustomField>): Promise<CustomField>;
+    updateCustomField(id: number, data: Partial<CustomField>): Promise<CustomField>;
+    deleteCustomField(id: number): Promise<void>;
     bulkEditObjects(objects: any, objectType: any, operation: any, parameters?: {}): Promise<any>;
 }

package/build/api/PaperlessAPI.js

@@ -25,6 +25,7 @@ class PaperlessAPI {
     }
     request(path_1) {
         return __awaiter(this, arguments, void 0, function* (path, options = {}) {
+            var _a, _b;
             const url = `${this.baseUrl}/api${path}`;
             const isJson = !options.body || typeof options.body === "string";
             const mergedHeaders = Object.assign(Object.assign({ Authorization: `Token ${this.token}`, Accept: "application/json; version=5", "Accept-Language": "en-US,en;q=0.9" }, (isJson ? { "Content-Type": "application/json" } : {})), (0, utils_1.headersToObject)(options.headers));
@@ -44,7 +45,11 @@ class PaperlessAPI {
                         status: response.status,
                         response: body,
                     });
-                    throw new Error(`HTTP error! status: ${response.status}`);
+                    const errorMessage = (body === null || body === void 0 ? void 0 : body.detail) ||
+                        (body === null || body === void 0 ? void 0 : body.error) ||
+                        (body === null || body === void 0 ? void 0 : body.message) ||
+                        `HTTP error! status: ${response.status}`;
+                    throw new Error(String(errorMessage));
                 }
                 return body;
             }
@@ -54,6 +59,8 @@ class PaperlessAPI {
                     message: error instanceof Error ? error.message : String(error),
                     url,
                     options,
+                    responseData: (_a = error === null || error === void 0 ? void 0 : error.response) === null || _a === void 0 ? void 0 : _a.data,
+                    status: (_b = error === null || error === void 0 ? void 0 : error.response) === null || _b === void 0 ? void 0 : _b.status,
                 });
                 throw error;
             }
@@ -115,6 +122,14 @@ class PaperlessAPI {
             return this.request(`/documents/${id}/`);
         });
     }
+    updateDocument(id, data) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.request(`/documents/${id}/`, {
+                method: "PATCH",
+                body: JSON.stringify(data),
+            });
+        });
+    }
     searchDocuments(query) {
         return __awaiter(this, void 0, void 0, function* () {
             const response = yield this.request(`/documents/?query=${encodeURIComponent(query)}`);
@@ -220,6 +235,40 @@ class PaperlessAPI {
             });
         });
     }
+    // Custom field operations
+    getCustomFields() {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.request("/custom_fields/");
+        });
+    }
+    getCustomField(id) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.request(`/custom_fields/${id}/`);
+        });
+    }
+    createCustomField(data) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.request("/custom_fields/", {
+                method: "POST",
+                body: JSON.stringify(data),
+            });
+        });
+    }
+    updateCustomField(id, data) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.request(`/custom_fields/${id}/`, {
+                method: "PUT",
+                body: JSON.stringify(data),
+            });
+        });
+    }
+    deleteCustomField(id) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.request(`/custom_fields/${id}/`, {
+                method: "DELETE",
+            });
+        });
+    }
     // Bulk object operations
     bulkEditObjects(objects_1, objectType_1, operation_1) {
         return __awaiter(this, arguments, void 0, function* (objects, objectType, operation, parameters = {}) {

package/build/api/documentEnhancer.d.ts

@@ -0,0 +1,21 @@
+import { CallToolResult } from "@modelcontextprotocol/sdk/types";
+import { PaperlessAPI } from "./PaperlessAPI";
+import { Document, DocumentsResponse } from "./types";
+interface NamedItem {
+    id: number;
+    name: string;
+}
+interface CustomField {
+    field: number;
+    name: string;
+    value: string | number | boolean | object | null;
+}
+export interface EnhancedDocument extends Omit<Document, "correspondent" | "document_type" | "tags" | "custom_fields"> {
+    correspondent: NamedItem | null;
+    document_type: NamedItem | null;
+    tags: NamedItem[];
+    custom_fields: CustomField[];
+}
+export declare function convertDocsWithNames(document: Document, api: PaperlessAPI): Promise<CallToolResult>;
+export declare function convertDocsWithNames(documentsResponse: DocumentsResponse, api: PaperlessAPI): Promise<CallToolResult>;
+export {};

package/build/api/documentEnhancer.js

@@ -0,0 +1,88 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.convertDocsWithNames = convertDocsWithNames;
+function convertDocsWithNames(input, api) {
+    return __awaiter(this, void 0, void 0, function* () {
+        if ("results" in input) {
+            const enhancedResults = yield enhanceDocumentsArray(input.results || [], api);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: (enhancedResults === null || enhancedResults === void 0 ? void 0 : enhancedResults.length)
+                            ? JSON.stringify(Object.assign(Object.assign({}, input), { results: enhancedResults }))
+                            : "No documents found",
+                    },
+                ],
+            };
+        }
+        if (!input) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "No document found",
+                    },
+                ],
+            };
+        }
+        const [enhanced] = yield enhanceDocumentsArray([input], api);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(enhanced),
+                },
+            ],
+        };
+    });
+}
+function enhanceDocumentsArray(documents, api) {
+    return __awaiter(this, void 0, void 0, function* () {
+        if (!(documents === null || documents === void 0 ? void 0 : documents.length)) {
+            return [];
+        }
+        const [correspondents, documentTypes, tags, customFields] = yield Promise.all([
+            api.getCorrespondents(),
+            api.getDocumentTypes(),
+            api.getTags(),
+            api.getCustomFields(),
+        ]);
+        const correspondentMap = new Map((correspondents.results || []).map((c) => [c.id, c.name]));
+        const documentTypeMap = new Map((documentTypes.results || []).map((dt) => [dt.id, dt.name]));
+        const tagMap = new Map((tags.results || []).map((tag) => [tag.id, tag.name]));
+        const customFieldMap = new Map((customFields.results || []).map((cf) => [cf.id, cf.name]));
+        return documents.map((doc) => (Object.assign(Object.assign({}, doc), { correspondent: doc.correspondent
+                ? {
+                    id: doc.correspondent,
+                    name: correspondentMap.get(doc.correspondent) ||
+                        String(doc.correspondent),
+                }
+                : null, document_type: doc.document_type
+                ? {
+                    id: doc.document_type,
+                    name: documentTypeMap.get(doc.document_type) || String(doc.document_type),
+                }
+                : null, tags: Array.isArray(doc.tags)
+                ? doc.tags.map((tagId) => ({
+                    id: tagId,
+                    name: tagMap.get(tagId) || String(tagId),
+                }))
+                : doc.tags, custom_fields: Array.isArray(doc.custom_fields)
+                ? doc.custom_fields.map((field) => ({
+                    field: field.field,
+                    name: customFieldMap.get(field.field) || String(field.field),
+                    value: field.value,
+                }))
+                : doc.custom_fields })));
+    });
+}

package/build/api/types.d.ts

@@ -12,6 +12,21 @@ export interface Tag {
     owner: number | null;
     user_can_change: boolean;
 }
+export interface CustomField {
+    id: number;
+    name: string;
+    data_type: string;
+    extra_data?: Record<string, unknown> | null;
+    document_count: number;
+}
+export interface CustomFieldInstance {
+    field: number;
+    value: string | number | boolean | object | null;
+}
+export interface CustomFieldInstanceRequest {
+    field: number;
+    value: string | number | boolean | object | null;
+}
 export interface PaginationResponse<T> {
     count: number;
     next: string | null;
@@ -21,6 +36,8 @@ export interface PaginationResponse<T> {
 }
 export interface GetTagsResponse extends PaginationResponse<Tag> {
 }
+export interface GetCustomFieldsResponse extends PaginationResponse<CustomField> {
+}
 export interface DocumentsResponse extends PaginationResponse<Document> {
 }
 export interface Document {
@@ -43,7 +60,7 @@ export interface Document {
     user_can_change: boolean;
     is_shared_by_requester: boolean;
     notes: any[];
-    custom_fields: any[];
+    custom_fields: CustomFieldInstance[];
     page_count: number;
     mime_type: string;
     __search_hit__?: SearchHit;
@@ -87,3 +104,32 @@ export interface GetDocumentTypesResponse extends PaginationResponse<DocumentTyp
 export interface BulkEditDocumentsResult {
     result: string;
 }
+export interface BulkEditParameters {
+    assign_custom_fields?: number[];
+    assign_custom_fields_values?: CustomFieldInstanceRequest[];
+    remove_custom_fields?: number[];
+    add_tags?: number[];
+    remove_tags?: number[];
+    degrees?: number;
+    pages?: string;
+    metadata_document_id?: number;
+    delete_originals?: boolean;
+    correspondent?: number;
+    document_type?: number;
+    storage_path?: number;
+    tag?: number;
+    permissions?: {
+        owner?: number | null;
+        set_permissions?: {
+            view: {
+                users: number[];
+                groups: number[];
+            };
+            change: {
+                users: number[];
+                groups: number[];
+            };
+        };
+        merge?: boolean;
+    };
+}

package/build/index.js

@@ -21,6 +21,7 @@ const express_1 = __importDefault(require("express"));
 const node_util_1 = require("node:util");
 const PaperlessAPI_1 = require("./api/PaperlessAPI");
 const correspondents_1 = require("./tools/correspondents");
+const customFields_1 = require("./tools/customFields");
 const documents_1 = require("./tools/documents");
 const documentTypes_1 = require("./tools/documentTypes");
 const tags_1 = require("./tools/tags");
@@ -51,8 +52,15 @@ function main() {
             instructions: `
 Paperless-NGX MCP Server Instructions
 
+⚠️ CRITICAL: Always differentiate between operations on specific documents vs operations on the entire system:
+
+- REMOVE operations (e.g., remove_tag in bulk_edit_documents): Affect only the specified documents, items remain in the system
+- DELETE operations (e.g., delete_tag, delete_correspondent): Permanently delete items from the entire system, affecting ALL documents that use them
+
+When a user asks to "remove" something, prefer operations that affect specific documents. Only use DELETE operations when explicitly asked to delete from the system.
+
 To view documents in your Paperless-NGX web interface, construct URLs using this pattern:
-${resolvedBaseUrl}/documents/{document_id}/
+${resolvedPublicUrl}/documents/{document_id}/
 
 Example: If your base URL is "http://localhost:8000", the web interface URL would be "http://localhost:8000/documents/123/" for document ID 123.
 
@@ -63,6 +71,7 @@ The document tools return JSON data with document IDs that you can use to constr
         (0, tags_1.registerTagTools)(server, api);
         (0, correspondents_1.registerCorrespondentTools)(server, api);
         (0, documentTypes_1.registerDocumentTypeTools)(server, api);
+        (0, customFields_1.registerCustomFieldTools)(server, api);
         if (useHttp) {
             const app = (0, express_1.default)();
             app.use(express_1.default.json());
@@ -151,11 +160,11 @@ The document tools return JSON data with document IDs that you can use to constr
             app.listen(resolvedPort, () => {
                 console.log(`MCP Stateless Streamable HTTP Server listening on port ${resolvedPort}`);
             });
+            // await new Promise((resolve) => setTimeout(resolve, 1000000));
         }
         else {
             const transport = new stdio_js_1.StdioServerTransport();
             yield server.connect(transport);
-            console.log("MCP server running with stdio transport");
         }
     });
 }

package/build/tools/correspondents.js

@@ -22,7 +22,7 @@ function registerCorrespondentTools(server, api) {
         name__iexact: zod_1.z.string().optional(),
         name__istartswith: zod_1.z.string().optional(),
         ordering: zod_1.z.string().optional(),
-    }, (0, middlewares_1.errorMiddleware)((args, extra) => __awaiter(this, void 0, void 0, function* () {
+    }, (0, middlewares_1.withErrorHandling)((args, extra) => __awaiter(this, void 0, void 0, function* () {
         if (!api)
             throw new Error("Please configure API connection first");
         const queryString = (0, queryString_1.buildQueryString)(args);
@@ -36,7 +36,7 @@ function registerCorrespondentTools(server, api) {
             ],
         };
     })));
-    server.tool("get_correspondent", { id: zod_1.z.number() }, (0, middlewares_1.errorMiddleware)((args, extra) => __awaiter(this, void 0, void 0, function* () {
+    server.tool("get_correspondent", { id: zod_1.z.number() }, (0, middlewares_1.withErrorHandling)((args, extra) => __awaiter(this, void 0, void 0, function* () {
         if (!api)
             throw new Error("Please configure API connection first");
         const response = yield api.request(`/correspondents/${args.id}/`);
@@ -50,7 +50,7 @@ function registerCorrespondentTools(server, api) {
         matching_algorithm: zod_1.z
             .enum(["any", "all", "exact", "regular expression", "fuzzy"])
             .optional(),
-    }, (0, middlewares_1.errorMiddleware)((args, extra) => __awaiter(this, void 0, void 0, function* () {
+    }, (0, middlewares_1.withErrorHandling)((args, extra) => __awaiter(this, void 0, void 0, function* () {
         if (!api)
             throw new Error("Please configure API connection first");
         const response = yield api.createCorrespondent(args);
@@ -65,7 +65,7 @@ function registerCorrespondentTools(server, api) {
         matching_algorithm: zod_1.z
             .enum(["any", "all", "exact", "regular expression", "fuzzy"])
             .optional(),
-    }, (0, middlewares_1.errorMiddleware)((args, extra) => __awaiter(this, void 0, void 0, function* () {
+    }, (0, middlewares_1.withErrorHandling)((args, extra) => __awaiter(this, void 0, void 0, function* () {
         if (!api)
             throw new Error("Please configure API connection first");
         const response = yield api.request(`/correspondents/${args.id}/`, {
@@ -76,9 +76,17 @@ function registerCorrespondentTools(server, api) {
             content: [{ type: "text", text: JSON.stringify(response) }],
         };
     })));
-    server.tool("delete_correspondent", { id: zod_1.z.number() }, (0, middlewares_1.errorMiddleware)((args, extra) => __awaiter(this, void 0, void 0, function* () {
+    server.tool("delete_correspondent", "⚠️ DESTRUCTIVE: Permanently delete a correspondent from the entire system. This will affect ALL documents that use this correspondent.", {
+        id: zod_1.z.number(),
+        confirm: zod_1.z
+            .boolean()
+            .describe("Must be true to confirm this destructive operation"),
+    }, (0, middlewares_1.withErrorHandling)((args, extra) => __awaiter(this, void 0, void 0, function* () {
         if (!api)
             throw new Error("Please configure API connection first");
+        if (!args.confirm) {
+            throw new Error("Confirmation required for destructive operation. Set confirm: true to proceed.");
+        }
         yield api.request(`/correspondents/${args.id}/`, { method: "DELETE" });
         return {
             content: [
@@ -86,9 +94,13 @@ function registerCorrespondentTools(server, api) {
             ],
         };
     })));
-    server.tool("bulk_edit_correspondents", {
+    server.tool("bulk_edit_correspondents", "Bulk edit correspondents. ⚠️ WARNING: 'delete' operation permanently removes correspondents from the entire system.", {
         correspondent_ids: zod_1.z.array(zod_1.z.number()),
         operation: zod_1.z.enum(["set_permissions", "delete"]),
+        confirm: zod_1.z
+            .boolean()
+            .optional()
+            .describe("Must be true when operation is 'delete' to confirm destructive operation"),
         owner: zod_1.z.number().optional(),
         permissions: zod_1.z
             .object({
@@ -103,9 +115,12 @@ function registerCorrespondentTools(server, api) {
         })
             .optional(),
         merge: zod_1.z.boolean().optional(),
-    }, (0, middlewares_1.errorMiddleware)((args, extra) => __awaiter(this, void 0, void 0, function* () {
+    }, (0, middlewares_1.withErrorHandling)((args, extra) => __awaiter(this, void 0, void 0, function* () {
         if (!api)
             throw new Error("Please configure API connection first");
+        if (args.operation === "delete" && !args.confirm) {
+            throw new Error("Confirmation required for destructive operation. Set confirm: true to proceed.");
+        }
         return api.bulkEditObjects(args.correspondent_ids, "correspondents", args.operation, args.operation === "set_permissions"
             ? {
                 owner: args.owner,

package/build/tools/customFields.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp";
+import { PaperlessAPI } from "../api/PaperlessAPI";
+export declare function registerCustomFieldTools(server: McpServer, api: PaperlessAPI): void;

package/build/tools/customFields.js

@@ -0,0 +1,142 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerCustomFieldTools = registerCustomFieldTools;
+const zod_1 = require("zod");
+const middlewares_1 = require("./utils/middlewares");
+const queryString_1 = require("./utils/queryString");
+function registerCustomFieldTools(server, api) {
+    server.tool("list_custom_fields", "List all custom fields. IMPORTANT: When a user query may refer to a custom field, you should fetch all custom fields up front (with a large enough page_size), cache them for the session, and search locally for matches by name before making further API calls. This reduces redundant requests and handles ambiguity efficiently.", {
+        page: zod_1.z.number().optional(),
+        page_size: zod_1.z.number().optional(),
+        name__icontains: zod_1.z.string().optional(),
+        name__iendswith: zod_1.z.string().optional(),
+        name__iexact: zod_1.z.string().optional(),
+        name__istartswith: zod_1.z.string().optional(),
+        ordering: zod_1.z.string().optional(),
+    }, (0, middlewares_1.withErrorHandling)((...args_1) => __awaiter(this, [...args_1], void 0, function* (args = {}) {
+        if (!api)
+            throw new Error("Please configure API connection first");
+        const queryString = (0, queryString_1.buildQueryString)(args);
+        const response = yield api.request(`/custom_fields/${queryString ? `?${queryString}` : ""}`);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(response),
+                },
+            ],
+        };
+    })));
+    server.tool("get_custom_field", { id: zod_1.z.number() }, (0, middlewares_1.withErrorHandling)((args, extra) => __awaiter(this, void 0, void 0, function* () {
+        if (!api)
+            throw new Error("Please configure API connection first");
+        const response = yield api.getCustomField(args.id);
+        return {
+            content: [{ type: "text", text: JSON.stringify(response) }],
+        };
+    })));
+    server.tool("create_custom_field", {
+        name: zod_1.z.string(),
+        data_type: zod_1.z.enum([
+            "string",
+            "url",
+            "date",
+            "boolean",
+            "integer",
+            "float",
+            "monetary",
+            "documentlink",
+            "select",
+        ]),
+        extra_data: zod_1.z.record(zod_1.z.unknown()).nullable().optional(),
+    }, (0, middlewares_1.withErrorHandling)((args, extra) => __awaiter(this, void 0, void 0, function* () {
+        if (!api)
+            throw new Error("Please configure API connection first");
+        const response = yield api.createCustomField(args);
+        return {
+            content: [{ type: "text", text: JSON.stringify(response) }],
+        };
+    })));
+    server.tool("update_custom_field", {
+        id: zod_1.z.number(),
+        name: zod_1.z.string().optional(),
+        data_type: zod_1.z
+            .enum([
+            "string",
+            "url",
+            "date",
+            "boolean",
+            "integer",
+            "float",
+            "monetary",
+            "documentlink",
+            "select",
+        ])
+            .optional(),
+        extra_data: zod_1.z.record(zod_1.z.unknown()).nullable().optional(),
+    }, (0, middlewares_1.withErrorHandling)((args, extra) => __awaiter(this, void 0, void 0, function* () {
+        if (!api)
+            throw new Error("Please configure API connection first");
+        const { id } = args, data = __rest(args, ["id"]);
+        const response = yield api.updateCustomField(id, data);
+        return {
+            content: [{ type: "text", text: JSON.stringify(response) }],
+        };
+    })));
+    server.tool("delete_custom_field", "⚠️ DESTRUCTIVE: Permanently delete a custom field from the entire system. This will remove the field from ALL documents that use it.", {
+        id: zod_1.z.number(),
+        confirm: zod_1.z.boolean().describe("Must be true to confirm this destructive operation"),
+    }, (0, middlewares_1.withErrorHandling)((args, extra) => __awaiter(this, void 0, void 0, function* () {
+        if (!api)
+            throw new Error("Please configure API connection first");
+        if (!args.confirm) {
+            throw new Error("Confirmation required for destructive operation. Set confirm: true to proceed.");
+        }
+        yield api.deleteCustomField(args.id);
+        return {
+            content: [
+                { type: "text", text: JSON.stringify({ status: "deleted" }) },
+            ],
+        };
+    })));
+    server.tool("bulk_edit_custom_fields", "Bulk edit custom fields. ⚠️ WARNING: 'delete' operation permanently removes custom fields from the entire system.", {
+        custom_fields: zod_1.z.array(zod_1.z.number()),
+        operation: zod_1.z.enum(["delete"]),
+        confirm: zod_1.z.boolean().optional().describe("Must be true when operation is 'delete' to confirm destructive operation"),
+    }, (0, middlewares_1.withErrorHandling)((args, extra) => __awaiter(this, void 0, void 0, function* () {
+        if (!api)
+            throw new Error("Please configure API connection first");
+        if (args.operation === "delete" && !args.confirm) {
+            throw new Error("Confirmation required for destructive operation. Set confirm: true to proceed.");
+        }
+        const response = yield api.bulkEditObjects(args.custom_fields, "custom_field", args.operation);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(response),
+                },
+            ],
+        };
+    })));
+}

package/build/tools/documentTypes.js

@@ -22,7 +22,7 @@ function registerDocumentTypeTools(server, api) {
         name__iexact: zod_1.z.string().optional(),
         name__istartswith: zod_1.z.string().optional(),
         ordering: zod_1.z.string().optional(),
-    }, (0, middlewares_1.errorMiddleware)((...args_1) => __awaiter(this, [...args_1], void 0, function* (args = {}, extra) {
+    }, (0, middlewares_1.withErrorHandling)((...args_1) => __awaiter(this, [...args_1], void 0, function* (args = {}, extra) {
         if (!api)
             throw new Error("Please configure API connection first");
         const queryString = (0, queryString_1.buildQueryString)(args);
@@ -36,7 +36,7 @@ function registerDocumentTypeTools(server, api) {
             ],
         };
     })));
-    server.tool("get_document_type", { id: zod_1.z.number() }, (0, middlewares_1.errorMiddleware)((args, extra) => __awaiter(this, void 0, void 0, function* () {
+    server.tool("get_document_type", { id: zod_1.z.number() }, (0, middlewares_1.withErrorHandling)((args, extra) => __awaiter(this, void 0, void 0, function* () {
         if (!api)
             throw new Error("Please configure API connection first");
         const response = yield api.request(`/document_types/${args.id}/`);
@@ -50,7 +50,7 @@ function registerDocumentTypeTools(server, api) {
         matching_algorithm: zod_1.z
             .enum(["any", "all", "exact", "regular expression", "fuzzy"])
             .optional(),
-    }, (0, middlewares_1.errorMiddleware)((args, extra) => __awaiter(this, void 0, void 0, function* () {
+    }, (0, middlewares_1.withErrorHandling)((args, extra) => __awaiter(this, void 0, void 0, function* () {
         if (!api)
             throw new Error("Please configure API connection first");
         const response = yield api.createDocumentType(args);
@@ -65,7 +65,7 @@ function registerDocumentTypeTools(server, api) {
         matching_algorithm: zod_1.z
             .enum(["any", "all", "exact", "regular expression", "fuzzy"])
             .optional(),
-    }, (0, middlewares_1.errorMiddleware)((args, extra) => __awaiter(this, void 0, void 0, function* () {
+    }, (0, middlewares_1.withErrorHandling)((args, extra) => __awaiter(this, void 0, void 0, function* () {
         if (!api)
             throw new Error("Please configure API connection first");
         const response = yield api.request(`/document_types/${args.id}/`, {
@@ -76,9 +76,17 @@ function registerDocumentTypeTools(server, api) {
             content: [{ type: "text", text: JSON.stringify(response) }],
         };
     })));
-    server.tool("delete_document_type", { id: zod_1.z.number() }, (0, middlewares_1.errorMiddleware)((args, extra) => __awaiter(this, void 0, void 0, function* () {
+    server.tool("delete_document_type", "⚠️ DESTRUCTIVE: Permanently delete a document type from the entire system. This will affect ALL documents that use this type.", {
+        id: zod_1.z.number(),
+        confirm: zod_1.z
+            .boolean()
+            .describe("Must be true to confirm this destructive operation"),
+    }, (0, middlewares_1.withErrorHandling)((args, extra) => __awaiter(this, void 0, void 0, function* () {
         if (!api)
             throw new Error("Please configure API connection first");
+        if (!args.confirm) {
+            throw new Error("Confirmation required for destructive operation. Set confirm: true to proceed.");
+        }
         yield api.request(`/document_types/${args.id}/`, { method: "DELETE" });
         return {
             content: [
@@ -86,9 +94,13 @@ function registerDocumentTypeTools(server, api) {
             ],
         };
     })));
-    server.tool("bulk_edit_document_types", {
+    server.tool("bulk_edit_document_types", "Bulk edit document types. ⚠️ WARNING: 'delete' operation permanently removes document types from the entire system.", {
         document_type_ids: zod_1.z.array(zod_1.z.number()),
         operation: zod_1.z.enum(["set_permissions", "delete"]),
+        confirm: zod_1.z
+            .boolean()
+            .optional()
+            .describe("Must be true when operation is 'delete' to confirm destructive operation"),
         owner: zod_1.z.number().optional(),
         permissions: zod_1.z
             .object({
@@ -103,9 +115,12 @@ function registerDocumentTypeTools(server, api) {
         })
             .optional(),
         merge: zod_1.z.boolean().optional(),
-    }, (0, middlewares_1.errorMiddleware)((args, extra) => __awaiter(this, void 0, void 0, function* () {
+    }, (0, middlewares_1.withErrorHandling)((args, extra) => __awaiter(this, void 0, void 0, function* () {
         if (!api)
             throw new Error("Please configure API connection first");
+        if (args.operation === "delete" && !args.confirm) {
+            throw new Error("Confirmation required for destructive operation. Set confirm: true to proceed.");
+        }
         return api.bulkEditObjects(args.document_type_ids, "document_types", args.operation, args.operation === "set_permissions"
             ? {
                 owner: args.owner,

package/build/tools/documents.js

@@ -22,9 +22,11 @@ var __rest = (this && this.__rest) || function (s, e) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerDocumentTools = registerDocumentTools;
 const zod_1 = require("zod");
+const documentEnhancer_1 = require("../api/documentEnhancer");
+const empty_1 = require("./utils/empty");
 const middlewares_1 = require("./utils/middlewares");
 function registerDocumentTools(server, api) {
-    server.tool("bulk_edit_documents", {
+    server.tool("bulk_edit_documents", "Perform bulk operations on multiple documents. Note: 'remove_tag' removes a tag from specific documents (tag remains in system), while 'delete_tag' permanently deletes a tag from the entire system. ⚠️ WARNING: 'delete' method permanently deletes documents and requires confirmation.", {
         documents: zod_1.z.array(zod_1.z.number()),
         method: zod_1.z.enum([
             "set_correspondent",
@@ -33,6 +35,7 @@ function registerDocumentTools(server, api) {
             "add_tag",
             "remove_tag",
             "modify_tags",
+            "modify_custom_fields",
             "delete",
             "reprocess",
             "set_permissions",
@@ -45,8 +48,19 @@ function registerDocumentTools(server, api) {
         document_type: zod_1.z.number().optional(),
         storage_path: zod_1.z.number().optional(),
         tag: zod_1.z.number().optional(),
-        add_tags: zod_1.z.array(zod_1.z.number()).optional(),
-        remove_tags: zod_1.z.array(zod_1.z.number()).optional(),
+        add_tags: zod_1.z.array(zod_1.z.number()).optional().transform(empty_1.arrayNotEmpty),
+        remove_tags: zod_1.z.array(zod_1.z.number()).optional().transform(empty_1.arrayNotEmpty),
+        add_custom_fields: zod_1.z
+            .array(zod_1.z.object({
+            field: zod_1.z.number(),
+            value: zod_1.z.union([zod_1.z.string(), zod_1.z.number(), zod_1.z.boolean(), zod_1.z.null()]),
+        }))
+            .optional()
+            .transform(empty_1.arrayNotEmpty),
+        remove_custom_fields: zod_1.z
+            .array(zod_1.z.number())
+            .optional()
+            .transform(empty_1.arrayNotEmpty),
         permissions: zod_1.z
             .object({
             owner: zod_1.z.number().nullable().optional(),
@@ -64,16 +78,30 @@ function registerDocumentTools(server, api) {
                 .optional(),
             merge: zod_1.z.boolean().optional(),
         })
-            .optional(),
+            .optional()
+            .transform(empty_1.objectNotEmpty),
         metadata_document_id: zod_1.z.number().optional(),
         delete_originals: zod_1.z.boolean().optional(),
         pages: zod_1.z.string().optional(),
         degrees: zod_1.z.number().optional(),
-    }, (0, middlewares_1.errorMiddleware)((args, extra) => __awaiter(this, void 0, void 0, function* () {
+        confirm: zod_1.z
+            .boolean()
+            .optional()
+            .describe("Must be true when method is 'delete' to confirm destructive operation"),
+    }, (0, middlewares_1.withErrorHandling)((args, extra) => __awaiter(this, void 0, void 0, function* () {
         if (!api)
             throw new Error("Please configure API connection first");
-        const { documents, method } = args, parameters = __rest(args, ["documents", "method"]);
-        const response = yield api.bulkEditDocuments(documents, method, parameters);
+        if (args.method === "delete" && !args.confirm) {
+            throw new Error("Confirmation required for destructive operation. Set confirm: true to proceed.");
+        }
+        const { documents, method, add_custom_fields } = args, parameters = __rest(args, ["documents", "method", "add_custom_fields"]);
+        // Transform add_custom_fields into the two separate API parameters
+        const apiParameters = Object.assign({}, parameters);
+        if (add_custom_fields && add_custom_fields.length > 0) {
+            apiParameters.assign_custom_fields = add_custom_fields.map((cf) => cf.field);
+            apiParameters.assign_custom_fields_values = add_custom_fields;
+        }
+        const response = yield api.bulkEditDocuments(documents, method, apiParameters);
         return {
             content: [
                 {
@@ -94,7 +122,7 @@ function registerDocumentTools(server, api) {
         tags: zod_1.z.array(zod_1.z.number()).optional(),
         archive_serial_number: zod_1.z.string().optional(),
         custom_fields: zod_1.z.array(zod_1.z.number()).optional(),
-    }, (0, middlewares_1.errorMiddleware)((args, extra) => __awaiter(this, void 0, void 0, function* () {
+    }, (0, middlewares_1.withErrorHandling)((args, extra) => __awaiter(this, void 0, void 0, function* () {
         if (!api)
             throw new Error("Please configure API connection first");
         const binaryData = Buffer.from(args.file, "base64");
@@ -126,10 +154,10 @@ function registerDocumentTools(server, api) {
         document_type: zod_1.z.number().optional(),
         tag: zod_1.z.number().optional(),
         storage_path: zod_1.z.number().optional(),
-        created__gte: zod_1.z.string().optional(),
-        created__lte: zod_1.z.string().optional(),
+        created__date__gte: zod_1.z.string().optional(),
+        created__date__lte: zod_1.z.string().optional(),
         ordering: zod_1.z.string().optional(),
-    }, (0, middlewares_1.errorMiddleware)((args, extra) => __awaiter(this, void 0, void 0, function* () {
+    }, (0, middlewares_1.withErrorHandling)((args, extra) => __awaiter(this, void 0, void 0, function* () {
         if (!api)
             throw new Error("Please configure API connection first");
         const query = new URLSearchParams();
@@ -147,29 +175,31 @@ function registerDocumentTools(server, api) {
             query.set("tags__id", args.tag.toString());
         if (args.storage_path)
             query.set("storage_path__id", args.storage_path.toString());
-        if (args.created__gte)
-            query.set("created__gte", args.created__gte);
-        if (args.created__lte)
-            query.set("created__lte", args.created__lte);
+        if (args.created__date__gte)
+            query.set("created__date__gte", args.created__date__gte);
+        if (args.created__date__lte)
+            query.set("created__date__lte", args.created__date__lte);
         if (args.ordering)
             query.set("ordering", args.ordering);
         const docsResponse = yield api.getDocuments(query.toString() ? `?${query.toString()}` : "");
-        return convertDocsWithNames(docsResponse, api);
+        return (0, documentEnhancer_1.convertDocsWithNames)(docsResponse, api);
     })));
     server.tool("get_document", {
         id: zod_1.z.number(),
-    }, (0, middlewares_1.errorMiddleware)((args, extra) => __awaiter(this, void 0, void 0, function* () {
+    }, (0, middlewares_1.withErrorHandling)((args, extra) => __awaiter(this, void 0, void 0, function* () {
         if (!api)
             throw new Error("Please configure API connection first");
         const doc = yield api.getDocument(args.id);
-        const [correspondents, documentTypes, tags] = yield Promise.all([
+        const [correspondents, documentTypes, tags, customFields] = yield Promise.all([
             api.getCorrespondents(),
             api.getDocumentTypes(),
             api.getTags(),
+            api.getCustomFields(),
         ]);
         const correspondentMap = new Map((correspondents.results || []).map((c) => [c.id, c.name]));
         const documentTypeMap = new Map((documentTypes.results || []).map((dt) => [dt.id, dt.name]));
         const tagMap = new Map((tags.results || []).map((tag) => [tag.id, tag.name]));
+        const customFieldMap = new Map((customFields.results || []).map((cf) => [cf.id, cf.name]));
         const docWithNames = Object.assign(Object.assign({}, doc), { correspondent: doc.correspondent
                 ? {
                     id: doc.correspondent,
@@ -187,7 +217,13 @@ function registerDocumentTools(server, api) {
                     id: tagId,
                     name: tagMap.get(tagId) || String(tagId),
                 }))
-                : doc.tags });
+                : doc.tags, custom_fields: Array.isArray(doc.custom_fields)
+                ? doc.custom_fields.map((field) => ({
+                    field: field.field,
+                    name: customFieldMap.get(field.field) || String(field.field),
+                    value: field.value,
+                }))
+                : doc.custom_fields });
         return {
             content: [
                 {
@@ -199,16 +235,16 @@ function registerDocumentTools(server, api) {
     })));
     server.tool("search_documents", "Full text search for documents. This tool is for searching document content, title, and metadata using a full text query. For general document listing or filtering by fields, use 'list_documents' instead.", {
         query: zod_1.z.string(),
-    }, (0, middlewares_1.errorMiddleware)((args, extra) => __awaiter(this, void 0, void 0, function* () {
+    }, (0, middlewares_1.withErrorHandling)((args, extra) => __awaiter(this, void 0, void 0, function* () {
         if (!api)
             throw new Error("Please configure API connection first");
         const docsResponse = yield api.searchDocuments(args.query);
-        return convertDocsWithNames(docsResponse, api);
+        return (0, documentEnhancer_1.convertDocsWithNames)(docsResponse, api);
     })));
     server.tool("download_document", {
         id: zod_1.z.number(),
         original: zod_1.z.boolean().optional(),
-    }, (0, middlewares_1.errorMiddleware)((args, extra) => __awaiter(this, void 0, void 0, function* () {
+    }, (0, middlewares_1.withErrorHandling)((args, extra) => __awaiter(this, void 0, void 0, function* () {
         var _a, _b;
         if (!api)
             throw new Error("Please configure API connection first");
@@ -229,53 +265,63 @@ function registerDocumentTools(server, api) {
             ],
         };
     })));
-}
-function convertDocsWithNames(docsResponse, api) {
-    return __awaiter(this, void 0, void 0, function* () {
-        var _a;
-        if (!((_a = docsResponse.results) === null || _a === void 0 ? void 0 : _a.length)) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: "No documents found",
-                    },
-                ],
-            };
-        }
-        // Fetch all related entities for name mapping
-        const [correspondents, documentTypes, tags] = yield Promise.all([
-            api.getCorrespondents(),
-            api.getDocumentTypes(),
-            api.getTags(),
-        ]);
-        const correspondentMap = new Map((correspondents.results || []).map((c) => [c.id, c.name]));
-        const documentTypeMap = new Map((documentTypes.results || []).map((dt) => [dt.id, dt.name]));
-        const tagMap = new Map((tags.results || []).map((tag) => [tag.id, tag.name]));
-        const docsWithNames = docsResponse.results.map((doc) => (Object.assign(Object.assign({}, doc), { correspondent: doc.correspondent
-                ? {
-                    id: doc.correspondent,
-                    name: correspondentMap.get(doc.correspondent) ||
-                        String(doc.correspondent),
-                }
-                : null, document_type: doc.document_type
-                ? {
-                    id: doc.document_type,
-                    name: documentTypeMap.get(doc.document_type) || String(doc.document_type),
-                }
-                : null, tags: Array.isArray(doc.tags)
-                ? doc.tags.map((tagId) => ({
-                    id: tagId,
-                    name: tagMap.get(tagId) || String(tagId),
-                }))
-                : doc.tags })));
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: JSON.stringify(docsWithNames),
-                },
-            ],
-        };
-    });
+    server.tool("update_document", "Update a specific document with new values. This tool allows you to modify any document field including title, correspondent, document type, storage path, tags, custom fields, and more. Only the fields you specify will be updated.", {
+        id: zod_1.z.number().describe("The ID of the document to update"),
+        title: zod_1.z
+            .string()
+            .max(128)
+            .optional()
+            .describe("The new title for the document (max 128 characters)"),
+        correspondent: zod_1.z
+            .number()
+            .nullable()
+            .optional()
+            .describe("The ID of the correspondent to assign"),
+        document_type: zod_1.z
+            .number()
+            .nullable()
+            .optional()
+            .describe("The ID of the document type to assign"),
+        storage_path: zod_1.z
+            .number()
+            .nullable()
+            .optional()
+            .describe("The ID of the storage path to assign"),
+        tags: zod_1.z
+            .array(zod_1.z.number())
+            .optional()
+            .describe("Array of tag IDs to assign to the document"),
+        content: zod_1.z
+            .string()
+            .optional()
+            .describe("The raw text content of the document (used for searching)"),
+        created: zod_1.z
+            .string()
+            .optional()
+            .describe("The creation date in YYYY-MM-DD format"),
+        archive_serial_number: zod_1.z
+            .number()
+            .optional()
+            .describe("The archive serial number (0-4294967295)"),
+        owner: zod_1.z
+            .number()
+            .nullable()
+            .optional()
+            .describe("The ID of the user who owns the document"),
+        custom_fields: zod_1.z
+            .array(zod_1.z.object({
+            field: zod_1.z.number().describe("The custom field ID"),
+            value: zod_1.z
+                .union([zod_1.z.string(), zod_1.z.number(), zod_1.z.boolean(), zod_1.z.null()])
+                .describe("The value for the custom field"),
+        }))
+            .optional()
+            .describe("Array of custom field values to assign"),
+    }, (0, middlewares_1.withErrorHandling)((args, extra) => __awaiter(this, void 0, void 0, function* () {
+        if (!api)
+            throw new Error("Please configure API connection first");
+        const { id } = args, updateData = __rest(args, ["id"]);
+        const response = yield api.updateDocument(id, updateData);
+        return (0, documentEnhancer_1.convertDocsWithNames)(response, api);
+    })));
 }

package/build/tools/tags.js

@@ -22,7 +22,7 @@ function registerTagTools(server, api) {
         name__iexact: zod_1.z.string().optional(),
         name__istartswith: zod_1.z.string().optional(),
         ordering: zod_1.z.string().optional(),
-    }, (0, middlewares_1.errorMiddleware)((...args_1) => __awaiter(this, [...args_1], void 0, function* (args = {}) {
+    }, (0, middlewares_1.withErrorHandling)((...args_1) => __awaiter(this, [...args_1], void 0, function* (args = {}) {
         if (!api)
             throw new Error("Please configure API connection first");
         const queryString = (0, queryString_1.buildQueryString)(args);
@@ -44,7 +44,7 @@ function registerTagTools(server, api) {
             .optional(),
         match: zod_1.z.string().optional(),
         matching_algorithm: zod_1.z.number().int().min(0).max(4).optional(),
-    }, (0, middlewares_1.errorMiddleware)((args, extra) => __awaiter(this, void 0, void 0, function* () {
+    }, (0, middlewares_1.withErrorHandling)((args, extra) => __awaiter(this, void 0, void 0, function* () {
         if (!api)
             throw new Error("Please configure API connection first");
         const tag = yield api.createTag(args);
@@ -66,7 +66,7 @@ function registerTagTools(server, api) {
             .optional(),
         match: zod_1.z.string().optional(),
         matching_algorithm: zod_1.z.number().int().min(0).max(4).optional(),
-    }, (0, middlewares_1.errorMiddleware)((args, extra) => __awaiter(this, void 0, void 0, function* () {
+    }, (0, middlewares_1.withErrorHandling)((args, extra) => __awaiter(this, void 0, void 0, function* () {
         if (!api)
             throw new Error("Please configure API connection first");
         const tag = yield api.updateTag(args.id, args);
@@ -79,11 +79,15 @@ function registerTagTools(server, api) {
             ],
         };
     })));
-    server.tool("delete_tag", {
+    server.tool("delete_tag", "⚠️ DESTRUCTIVE: Permanently delete a tag from the entire system. This will remove the tag from ALL documents that use it. Use with extreme caution.", {
         id: zod_1.z.number(),
-    }, (0, middlewares_1.errorMiddleware)((args, extra) => __awaiter(this, void 0, void 0, function* () {
+        confirm: zod_1.z.boolean().describe("Must be true to confirm this destructive operation"),
+    }, (0, middlewares_1.withErrorHandling)((args, extra) => __awaiter(this, void 0, void 0, function* () {
         if (!api)
             throw new Error("Please configure API connection first");
+        if (!args.confirm) {
+            throw new Error("Confirmation required for destructive operation. Set confirm: true to proceed.");
+        }
         yield api.deleteTag(args.id);
         return {
             content: [
@@ -94,9 +98,10 @@ function registerTagTools(server, api) {
             ],
         };
     })));
-    server.tool("bulk_edit_tags", {
+    server.tool("bulk_edit_tags", "Bulk edit tags. ⚠️ WARNING: 'delete' operation permanently removes tags from the entire system. Use with caution.", {
         tag_ids: zod_1.z.array(zod_1.z.number()),
         operation: zod_1.z.enum(["set_permissions", "delete"]),
+        confirm: zod_1.z.boolean().optional().describe("Must be true when operation is 'delete' to confirm destructive operation"),
         owner: zod_1.z.number().optional(),
         permissions: zod_1.z
             .object({
@@ -111,9 +116,12 @@ function registerTagTools(server, api) {
         })
             .optional(),
         merge: zod_1.z.boolean().optional(),
-    }, (0, middlewares_1.errorMiddleware)((args, extra) => __awaiter(this, void 0, void 0, function* () {
+    }, (0, middlewares_1.withErrorHandling)((args, extra) => __awaiter(this, void 0, void 0, function* () {
         if (!api)
             throw new Error("Please configure API connection first");
+        if (args.operation === "delete" && !args.confirm) {
+            throw new Error("Confirmation required for destructive operation. Set confirm: true to proceed.");
+        }
         return api.bulkEditObjects(args.tag_ids, "tags", args.operation, args.operation === "set_permissions"
             ? {
                 owner: args.owner,

package/build/tools/utils/empty.d.ts

@@ -0,0 +1,2 @@
+export declare const arrayNotEmpty: <T>(array: T[] | undefined) => T[] | undefined;
+export declare const objectNotEmpty: <T>(object: T) => T | undefined;

package/build/tools/utils/empty.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.objectNotEmpty = exports.arrayNotEmpty = void 0;
+const arrayNotEmpty = (array) => (array === null || array === void 0 ? void 0 : array.length) ? array : undefined;
+exports.arrayNotEmpty = arrayNotEmpty;
+const objectNotEmpty = (object) => object && Object.keys(object).length ? object : undefined;
+exports.objectNotEmpty = objectNotEmpty;

package/build/tools/utils/middlewares.d.ts

@@ -1,3 +1,3 @@
 import { ToolCallback } from "@modelcontextprotocol/sdk/server/mcp";
 import { ZodRawShape } from "zod";
-export declare const errorMiddleware: <Args extends ZodRawShape>(cb: ToolCallback<Args>) => ToolCallback<Args>;
+export declare const withErrorHandling: <Args extends ZodRawShape>(cb: ToolCallback<Args>) => ToolCallback<Args>;

package/build/tools/utils/middlewares.js

@@ -9,24 +9,23 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.errorMiddleware = void 0;
-const errorMiddleware = (cb) => {
+exports.withErrorHandling = void 0;
+const withErrorHandling = (cb) => {
     return ((args, extra) => __awaiter(void 0, void 0, void 0, function* () {
+        var _a, _b;
         try {
             return yield cb(args, extra);
         }
         catch (err) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({
-                            error: err instanceof Error ? err.message : String(err),
-                        }),
-                    },
-                ],
-            };
+            const errorMessage = err instanceof Error ? err.message : String(err);
+            const responseData = (_a = err === null || err === void 0 ? void 0 : err.response) === null || _a === void 0 ? void 0 : _a.data;
+            const status = (_b = err === null || err === void 0 ? void 0 : err.response) === null || _b === void 0 ? void 0 : _b.status;
+            throw new Error(JSON.stringify({
+                error: errorMessage,
+                responseData,
+                status,
+            }));
         }
     }));
 };
-exports.errorMiddleware = errorMiddleware;
+exports.withErrorHandling = withErrorHandling;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@baruchiro/paperless-mcp",
-  "version": "0.0.3",
+  "version": "0.1.0",
   "description": "Model Context Protocol (MCP) server for interacting with Paperless-NGX document management system. Enables AI assistants to manage documents, tags, correspondents, and document types through the Paperless-NGX API.",
   "main": "build/index.js",
   "bin": {
@@ -10,8 +10,9 @@
     "test": "echo \"Error: no test specified\" && exit 1",
     "start": "ts-node src/index.ts",
     "build": "tsc",
+    "dxt-pack": "dxt pack",
     "inspect": "npm run build && npx -y @modelcontextprotocol/inspector node build/index.js",
-    "prepublishOnly": "npm run build"
+    "prepack": "npm run build && npm run dxt-pack"
   },
   "keywords": [
     "mcp",
@@ -32,7 +33,8 @@
   "files": [
     "build",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "paperless-mcp.dxt"
   ],
   "bugs": {
     "url": "https://github.com/baruchiro/paperless-mcp/issues"
@@ -46,6 +48,7 @@
     "zod": "^3.24.1"
   },
   "devDependencies": {
+    "@anthropic-ai/dxt": "^0.2.6",
     "@changesets/cli": "^2.29.4",
     "@types/express": "^5.0.2",
     "@types/node": "^22.15.17",