@hiai-gg/docsmint 0.9.2 → 0.9.4

package/README.md

@@ -14,32 +14,36 @@ Apache-2.0 application on your own infrastructure.
 [![Release](https://img.shields.io/github/v/release/hiai-gg/docsmint?sort=semver)](https://github.com/hiai-gg/docsmint/releases)
 [![npm](https://img.shields.io/npm/v/@hiai-gg/docsmint?logo=npm)](https://www.npmjs.com/package/@hiai-gg/docsmint)
 [![Docker Pulls](https://img.shields.io/docker/pulls/vgalibov/docsmint?logo=docker)](https://hub.docker.com/r/vgalibov/docsmint)
-[![Stars](https://img.shields.io/github/stars/hiai-gg/docsmint)](https://github.com/hiai-gg/docsmint/stargazers)
 [![CI](https://github.com/hiai-gg/docsmint/actions/workflows/ci.yml/badge.svg)](https://github.com/hiai-gg/docsmint/actions/workflows/ci.yml)
+
+[![DocsMint MCP server](https://glama.ai/mcp/servers/HiAi-gg/docsmint/badges/score.svg)](https://glama.ai/mcp/servers/HiAi-gg/docsmint)
+[![MCP Badge](https://lobehub.com/badge/mcp/hiai-gg-docsmint)](https://lobehub.com/mcp/hiai-gg-docsmint)
+[![MCP Registry](https://img.shields.io/badge/MCP_Registry-Listed-0891b2)](https://registry.modelcontextprotocol.io/v0.1/servers/io.github.HiAi-gg%2Fdocsmint/versions/latest)
+[![DocsMint Cloud](https://img.shields.io/badge/DocsMint_Cloud-Connect-16a34a)](https://docsmint.com/mcp/connect?source=github_mcp)
+
 [![Bun](https://img.shields.io/badge/Runtime-Bun_1.4-black?logo=bun&logoColor=white)](https://bun.sh)
 [![TypeScript](https://img.shields.io/badge/TypeScript-6.x-3178C6?logo=typescript&logoColor=white)](https://www.typescriptlang.org)
 [![Svelte](https://img.shields.io/badge/Svelte-5.x-FF3E00?logo=svelte&logoColor=white)](https://svelte.dev)
 [![Elysia](https://img.shields.io/badge/Elysia-1.4-lightgrey?logo=elysia&logoColor=white)](https://elysiajs.com)
 [![Tailwind_CSS](https://img.shields.io/badge/Tailwind_CSS-v4-06B6D4?logo=tailwindcss&logoColor=white)](https://tailwindcss.com)
 [![Drizzle_ORM](https://img.shields.io/badge/Drizzle_ORM-0.45-C5F74F?logo=drizzle&logoColor=black)](https://orm.drizzle.team)
+[![Stars](https://img.shields.io/github/stars/hiai-gg/docsmint)](https://github.com/hiai-gg/docsmint/stargazers)
 [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)
-[![MCP Badge](https://lobehub.com/badge/mcp/hiai-gg-docsmint)](https://lobehub.com/mcp/hiai-gg-docsmint)
-[![DocsMint Cloud](https://img.shields.io/badge/DocsMint_Cloud-Connect-16a34a)](https://docsmint.com/mcp/connect?source=github_mcp)
-[![MCP Registry](https://img.shields.io/badge/MCP_Registry-Listed-0891b2)](https://registry.modelcontextprotocol.io/v0.1/servers/io.github.HiAi-gg%2Fdocsmint/versions/latest)
 
 <img width="1920" height="974" alt="DocsMint installable document workspace" src="https://github.com/user-attachments/assets/94701d01-a361-4ca1-b16d-de2a0c64d684" />
 
 ## Connect your AI agent
 
-Connect DocsMint Cloud instantly or use your own self-hosted deployment. Search,
-read, create, organize and update persistent knowledge through MCP with hybrid
-retrieval, reranking and GraphRAG.
+Connect DocsMint Cloud instantly or run the self-hosted stdio bridge against
+your own DocsMint API. Both paths give agents access to persistent knowledge;
+the self-hosted bridge exposes 31 tools, 2 prompts, and 3 resources.
 
 **Recommended: [DocsMint Cloud setup](https://docsmint.com/mcp/connect?source=github_mcp).**
 No server installation is required. Sign up or log in, choose your workspace,
-create an MCP/API credential in the authenticated browser UI, follow your client's
-instructions, and verify the connection. Hosted MCP follows your plan and
-workspace permissions. Prefer workspace-bound or category-scoped credentials.
+and follow your client's connection instructions. OAuth-capable clients use
+browser consent; API-key clients create an MCP/API credential in the authenticated
+browser UI. Hosted MCP follows your plan and workspace permissions. Prefer
+workspace-bound or category-scoped credentials.
 
 The Cloud endpoint is `https://docsmint.com/mcp` (Streamable HTTP). OAuth-capable
 clients discover the hosted resource and authorization-server metadata; current
@@ -53,11 +57,13 @@ management belongs to the signed-in browser session.
 
 **Self-hosted alternative:** run [DocsMint with Docker](#quickstart), create an API
 key in its browser UI, and configure `HIAI_DOCS_URL` and `HIAI_DOCS_API_KEY` for
-`npx --yes --package @hiai-gg/docsmint docsmint-mcp`. The npm package is a stdio
-bridge to your own API, not a server installer or hosted OAuth server. See the
-[MCP guide](https://github.com/HiAi-gg/docsmint/blob/main/packages/mcp-server/README.md) for client configuration.
-The open-source [Glama Server directory](https://glama.ai/mcp/servers) uses this
-stdio bridge; the hosted DocsMint Cloud Connector is a separate listing.
+`npx --yes --package @hiai-gg/docsmint docsmint-mcp`. Install Bun 1.3.14 or
+later to execute the published binary. The npm package is a stdio bridge to
+your own API; it does not install the DocsMint application or Cloud OAuth server.
+See the [MCP guide](https://github.com/HiAi-gg/docsmint/blob/main/packages/mcp-server/README.md)
+for client configuration. The [Glama OSS Server listing](https://glama.ai/mcp/servers/HiAi-gg/docsmint)
+describes this bridge; the hosted [DocsMint Cloud Connector](https://glama.ai/mcp/connectors/io.github.HiAi-gg/docsmint)
+is a separate listing.
 
 ## Why DocsMint?
 
@@ -74,15 +80,14 @@ stdio bridge; the hosted DocsMint Cloud Connector is a separate listing.
 - **Choose how you run it.** Use [managed DocsMint](https://docsmint.com) or
   self-host the application, database, search, queues, and files.
 
-## What's new in 0.9.2?
+## What's new in 0.9.4?
 
-- Prepare the open-source MCP stdio bridge for a separate Glama Server listing
-  with a schema-valid organization maintainer claim.
-- Clarify that Glama-hosted stdio needs a reachable self-hosted DocsMint API
-  and an API key; DocsMint Cloud remains a separate hosted Connector.
-- Keep the existing 21 tools, 2 prompts, 3 resources, and API-key behavior.
+- Expand the self-hosted MCP bridge to 31 tools, adding tag management,
+  folder and category updates, and document trash recovery or permanent purge.
+- Keep workspace and category permissions enforced by the existing DocsMint API.
+- Preserve the separate DocsMint Cloud Connector and the self-hosted API-key bridge.
 
-This release adds no database migration. See the [release notes](https://github.com/HiAi-gg/docsmint/releases/tag/v0.9.2)
+This release adds no database migration. See the [release notes](https://github.com/HiAi-gg/docsmint/releases/tag/v0.9.4)
 and [changelog](https://github.com/HiAi-gg/docsmint/blob/main/CHANGELOG.md).
 
 ## Install with an AI agent
@@ -135,7 +140,7 @@ docker pull vgalibov/docsmint:web-latest
 docker pull vgalibov/docsmint:caddy-latest
 ```
 
-Use versioned tags `api-v0.9.2`, `web-v0.9.2`, and `caddy-v0.9.2` for
+Use versioned tags `api-v0.9.4`, `web-v0.9.4`, and `caddy-v0.9.4` for
 reproducible deploys. Caddy is the supporting reverse proxy with rate limiting;
 it is separate from the API and web application. The quickstart still builds the Compose stack from this repository so PostgreSQL,
 Redis, and SeaweedFS start together with the application.

package/dist/backend/index.js

@@ -238460,7 +238460,7 @@ var swaggerConfig = {
     },
     info: {
       title: "DocsMint API",
-      version: "0.9.2",
+      version: "0.9.4",
       description: "Self-hosted AI-native knowledge workspace and installable PWA with hybrid search, GraphRAG, REST, SDK, CLI, and MCP access for people and AI agents.",
       contact: { name: "HiAi-gg", url: "https://github.com/HiAi-gg/docsmint" },
       license: {

package/dist/client.d.ts

@@ -7,7 +7,7 @@
  * failures (502 / 503 / 504 / timeout / network reset) are retried
  * with exponential backoff up to `config.retries` attempts.
  */
-import type { DocsApiKeyCreated, DocsApiKeyListResponse, DocsAttachment, DocsAttachmentConfirmInput, DocsAttachmentListResponse, DocsAttachmentPresignInput, DocsAttachmentPresignResponse, DocsCategory, DocsCategoryListItem, DocsCategoryInput, DocsCategoryUpdate, DocsDocument, DocsDocumentCreateInput, DocsDocumentCursorPage, DocsDocumentIndexRefresh, DocsDocumentIndexStatus, DocsDocumentKnowledgeSummary, DocsDocumentListResponse, DocsDocumentPipeline, DocsPipelineWarningRetry, DocsDocumentUpdateInput, DocsFolder, DocsFolderCreateInput, DocsFolderUpdateInput, DocsGraphEntitiesResponse, DocsGraphRelatedResponse, DocsGraphSearchResponse, DocsHealthResponse, DocsRequestContext, DocsSearchOptions, DocsSearchResponse, DocsSearchSuggestItem, DocsSharedContent, DocsShareLink, DocsShareListResponse, DocsShareRole, DocsTag, DocsVersion, DocsVersionDiff } from "./types.js";
+import type { DocsApiKeyCreated, DocsApiKeyListResponse, DocsAttachment, DocsAttachmentConfirmInput, DocsAttachmentListResponse, DocsAttachmentPresignInput, DocsAttachmentPresignResponse, DocsCategory, DocsCategoryListItem, DocsCategoryInput, DocsCategoryUpdate, DocsDocument, DocsDocumentCreateInput, DocsDocumentCursorPage, DocsDocumentIndexRefresh, DocsDocumentIndexStatus, DocsDocumentKnowledgeSummary, DocsDocumentListResponse, DocsDocumentPipeline, DocsPipelineWarningRetry, DocsDocumentUpdateInput, DocsFolder, DocsFolderCreateInput, DocsFolderUpdateInput, DocsGraphEntitiesResponse, DocsGraphRelatedResponse, DocsGraphSearchResponse, DocsHealthResponse, DocsRequestContext, DocsSearchOptions, DocsSearchResponse, DocsSearchSuggestItem, DocsSharedContent, DocsShareLink, DocsShareListResponse, DocsShareRole, DocsTag, DocsTrashResponse, DocsVersion, DocsVersionDiff } from "./types.js";
 export interface DocsClientConfig {
     /** Base URL of the DocsMint API, e.g. `http://localhost:50700`. */
     baseUrl: string;
@@ -124,6 +124,13 @@ export declare class DocsClient {
         color?: string;
     }, context?: DocsRequestContext): Promise<DocsTag>;
     deleteTag(id: string, context?: DocsRequestContext): Promise<void>;
+    listTrash(context?: DocsRequestContext): Promise<DocsTrashResponse>;
+    restoreTrashedDocument(id: string, context?: DocsRequestContext): Promise<{
+        success: true;
+    }>;
+    permanentlyDeleteDocument(id: string, context?: DocsRequestContext): Promise<{
+        success: true;
+    }>;
     addTagToDoc(documentId: string, tagId: string, context?: DocsRequestContext): Promise<void>;
     removeTagFromDoc(documentId: string, tagId: string, context?: DocsRequestContext): Promise<void>;
     listCategories(context?: DocsRequestContext): Promise<DocsCategoryListItem[]>;

package/dist/client.js

@@ -222,6 +222,15 @@ export class DocsClient {
     async deleteTag(id, context) {
         await this.request("DELETE", `/api/tags/${encodeURIComponent(id)}`, undefined, context);
     }
+    async listTrash(context) {
+        return this.request("GET", "/api/trash", undefined, context);
+    }
+    async restoreTrashedDocument(id, context) {
+        return this.request("POST", `/api/trash/documents/${encodeURIComponent(id)}/restore`, undefined, context);
+    }
+    async permanentlyDeleteDocument(id, context) {
+        return this.request("DELETE", `/api/trash/documents/${encodeURIComponent(id)}`, undefined, context);
+    }
     async addTagToDoc(documentId, tagId, context) {
         await this.request("POST", `/api/documents/${encodeURIComponent(documentId)}/tags`, { json: { tagId } }, context);
     }

package/dist/mcp-cli.js

@@ -20,7 +20,7 @@ import { serveStdio } from "@modelcontextprotocol/server/stdio";
 
 // ../mcp-server/src/server.ts
 import { McpServer } from "@modelcontextprotocol/server";
-import { z as z14 } from "zod";
+import { z as z15 } from "zod";
 
 // dist/client.js
 var docsApiErrorBrand = Symbol.for("io.github.hiai-gg.docsmint.DocsApiError");
@@ -199,6 +199,15 @@ class DocsClient {
   async deleteTag(id, context) {
     await this.request("DELETE", `/api/tags/${encodeURIComponent(id)}`, undefined, context);
   }
+  async listTrash(context) {
+    return this.request("GET", "/api/trash", undefined, context);
+  }
+  async restoreTrashedDocument(id, context) {
+    return this.request("POST", `/api/trash/documents/${encodeURIComponent(id)}/restore`, undefined, context);
+  }
+  async permanentlyDeleteDocument(id, context) {
+    return this.request("DELETE", `/api/trash/documents/${encodeURIComponent(id)}`, undefined, context);
+  }
   async addTagToDoc(documentId, tagId, context) {
     await this.request("POST", `/api/documents/${encodeURIComponent(documentId)}/tags`, { json: { tagId } }, context);
   }
@@ -799,7 +808,17 @@ var toolOutputSchemas = {
   delete_document: deleteAcknowledgmentSchema,
   delete_folder: deleteAcknowledgmentSchema,
   delete_category: deleteAcknowledgmentSchema,
-  restore_document_version: documentSchema
+  restore_document_version: documentSchema,
+  create_tag: tagSchema,
+  update_tag: tagSchema,
+  delete_tag: deleteAcknowledgmentSchema,
+  add_tag_to_document: z.looseObject({ documentId: z.string().uuid(), tagId: z.string().uuid(), assigned: z.literal(true) }),
+  remove_tag_from_document: z.looseObject({ documentId: z.string().uuid(), tagId: z.string().uuid(), removed: z.literal(true) }),
+  update_folder: folderSchema,
+  update_category: categorySchema,
+  list_trash: z.looseObject({ documents: z.array(z.looseObject({ id: z.string().uuid(), title: z.string(), deletedAt: z.string(), purgeAfter: z.string().nullable() })), folders: z.array(z.unknown()) }),
+  restore_trashed_document: z.looseObject({ success: z.literal(true) }),
+  permanently_delete_document: deleteAcknowledgmentSchema
 };
 
 // ../mcp-server/src/lifecycle.ts
@@ -850,8 +869,101 @@ function registerLifecycleCapabilities(server, client, wrap) {
   }, wrap("restore_document_version", async ({ documentId, versionId }) => client.restoreDocumentVersion ? client.restoreDocumentVersion(documentId, versionId) : unsupported("restore_document_version")));
 }
 
-// ../mcp-server/src/capabilities.ts
+// ../mcp-server/src/management.ts
 import { z as z3 } from "zod";
+var uuid = z3.string().uuid().describe("UUID of the target object, obtained from the corresponding list tool.");
+var write = { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false };
+var update = { ...write, destructiveHint: true };
+var read = { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false };
+var purge = { ...write, destructiveHint: true };
+function unsupported2(name) {
+  throw new Error(`The injected legacy MCP client does not support ${name}; use a public DocsClient.`);
+}
+function registerManagementCapabilities(server, client, wrap) {
+  server.registerTool("create_tag", {
+    description: "Create a tag in the active workspace. Requires full workspace write access; category-scoped credentials cannot manage tags. Use add_tag_to_document to assign it.",
+    annotations: write,
+    inputSchema: z3.object({ name: z3.string().min(1).max(100).describe("New tag name, up to 100 characters."), color: z3.string().max(20).optional().describe("Optional display color for the new tag, up to 20 characters.") }),
+    outputSchema: toolOutputSchemas.create_tag
+  }, wrap("create_tag", async (input) => client.createTag ? client.createTag(input) : unsupported2("create_tag")));
+  server.registerTool("update_tag", {
+    description: "Rename or recolor an existing tag. Requires full workspace write access; category-scoped credentials cannot manage tags. Affected documents are reindexed by the API.",
+    annotations: update,
+    inputSchema: z3.object({ id: uuid, name: z3.string().min(1).max(100).optional().describe("Replacement tag name; omit to keep the current name."), color: z3.string().max(20).optional().describe("Replacement display color; omit to keep the current color.") }).refine((value) => value.name !== undefined || value.color !== undefined),
+    outputSchema: toolOutputSchemas.update_tag
+  }, wrap("update_tag", async ({ id, ...input }) => client.updateTag ? client.updateTag(id, input) : unsupported2("update_tag")));
+  server.registerTool("delete_tag", {
+    description: "Delete a tag in the active workspace and remove its document assignments. Requires full workspace write access; category-scoped credentials cannot manage tags.",
+    annotations: purge,
+    inputSchema: z3.object({ id: uuid }),
+    outputSchema: toolOutputSchemas.delete_tag
+  }, wrap("delete_tag", async ({ id }) => {
+    if (!client.deleteTag)
+      return unsupported2("delete_tag");
+    await client.deleteTag(id);
+    return { id, deleted: true };
+  }));
+  server.registerTool("add_tag_to_document", {
+    description: "Assign a tag from list_tags to an existing document. Requires edit access to the document and permission to use the tag.",
+    annotations: write,
+    inputSchema: z3.object({ documentId: uuid.describe("UUID of the document to tag."), tagId: uuid.describe("UUID of the tag returned by list_tags.") }),
+    outputSchema: toolOutputSchemas.add_tag_to_document
+  }, wrap("add_tag_to_document", async ({ documentId, tagId }) => {
+    if (!client.addTagToDocument)
+      return unsupported2("add_tag_to_document");
+    await client.addTagToDocument(documentId, tagId);
+    return { documentId, tagId, assigned: true };
+  }));
+  server.registerTool("remove_tag_from_document", {
+    description: "Remove a tag assignment from a document. Requires edit access; the tag itself is preserved.",
+    annotations: update,
+    inputSchema: z3.object({ documentId: uuid.describe("UUID of the document whose tag assignment changes."), tagId: uuid.describe("UUID of the assigned tag to remove.") }),
+    outputSchema: toolOutputSchemas.remove_tag_from_document
+  }, wrap("remove_tag_from_document", async ({ documentId, tagId }) => {
+    if (!client.removeTagFromDocument)
+      return unsupported2("remove_tag_from_document");
+    await client.removeTagFromDocument(documentId, tagId);
+    return { documentId, tagId, removed: true };
+  }));
+  server.registerTool("update_folder", {
+    description: "Rename or move a folder; changes to category or parent follow API scope rules and trigger reindexing. Requires write access.",
+    annotations: update,
+    inputSchema: z3.object({ id: uuid, name: z3.string().min(1).max(255).optional().describe("Replacement folder name; omit to preserve the name."), parentId: uuid.nullable().optional().describe("New parent folder UUID, or null for a root folder."), categoryId: uuid.nullable().optional().describe("New category UUID, or null to clear the category."), order: z3.number().int().nonnegative().optional().describe("New non-negative order within the containing folder.") }).refine((value) => value.name !== undefined || value.parentId !== undefined || value.categoryId !== undefined || value.order !== undefined),
+    outputSchema: toolOutputSchemas.update_folder
+  }, wrap("update_folder", async ({ id, ...input }) => client.updateFolder ? client.updateFolder(id, input) : unsupported2("update_folder")));
+  server.registerTool("update_category", {
+    description: "Rename or reorder a category. Requires full workspace write access; category-scoped credentials cannot modify categories.",
+    annotations: update,
+    inputSchema: z3.object({ id: uuid, name: z3.string().min(1).max(255).optional().describe("New category name, up to 255 characters."), order: z3.number().int().nonnegative().optional().describe("New non-negative category order.") }).refine((value) => value.name !== undefined || value.order !== undefined),
+    outputSchema: toolOutputSchemas.update_category
+  }, wrap("update_category", async ({ id, ...input }) => client.updateCategory ? client.updateCategory(id, input) : unsupported2("update_category")));
+  server.registerTool("list_trash", {
+    description: "List soft-deleted documents visible to the active workspace/category. Requires read access.",
+    annotations: read,
+    inputSchema: z3.object({}),
+    outputSchema: toolOutputSchemas.list_trash
+  }, wrap("list_trash", async () => client.listTrash ? client.listTrash() : unsupported2("list_trash")));
+  server.registerTool("restore_trashed_document", {
+    description: "Restore a soft-deleted document from list_trash. Requires write access. This is different from restoring a content version.",
+    annotations: write,
+    inputSchema: z3.object({ id: uuid }),
+    outputSchema: toolOutputSchemas.restore_trashed_document
+  }, wrap("restore_trashed_document", async ({ id }) => client.restoreTrashedDocument ? client.restoreTrashedDocument(id) : unsupported2("restore_trashed_document")));
+  server.registerTool("permanently_delete_document", {
+    description: "Irreversibly purge a document already in trash, including its content and version history. Requires write access. Use only on explicit user request after checking list_trash.",
+    annotations: purge,
+    inputSchema: z3.object({ id: uuid }),
+    outputSchema: toolOutputSchemas.permanently_delete_document
+  }, wrap("permanently_delete_document", async ({ id }) => {
+    if (!client.permanentlyDeleteDocument)
+      return unsupported2("permanently_delete_document");
+    await client.permanentlyDeleteDocument(id);
+    return { id, deleted: true };
+  }));
+}
+
+// ../mcp-server/src/capabilities.ts
+import { z as z4 } from "zod";
 function registerExtendedCapabilities(server, client, wrapHandler) {
   server.registerTool("list_categories", {
     annotations: {
@@ -861,7 +973,7 @@ function registerExtendedCapabilities(server, client, wrapHandler) {
       openWorldHint: false
     },
     description: "List categories visible in the active workspace or category scope. Requires read access; a category-scoped credential sees only its configured category. Use this before create_document or create_folder when you need an existing category ID.",
-    inputSchema: z3.object({}),
+    inputSchema: z4.object({}),
     outputSchema: toolOutputSchemas.list_categories
   }, wrapHandler("list_categories", async () => client.listCategories()));
   server.registerTool("create_category", {
@@ -872,8 +984,8 @@ function registerExtendedCapabilities(server, client, wrapHandler) {
       openWorldHint: false
     },
     description: "Create a new category for the active workspace. Requires workspace-level write access; category-scoped credentials cannot create categories. Returns the created category. Use list_categories to inspect existing categories.",
-    inputSchema: z3.object({
-      name: z3.string().trim().min(1).max(255).describe("Non-empty display name, up to 255 characters, for example Project notes.")
+    inputSchema: z4.object({
+      name: z4.string().trim().min(1).max(255).describe("Non-empty display name, up to 255 characters, for example Project notes.")
     }),
     outputSchema: toolOutputSchemas.create_category
   }, wrapHandler("create_category", async (input) => client.createCategory(input)));
@@ -885,7 +997,7 @@ function registerExtendedCapabilities(server, client, wrapHandler) {
       openWorldHint: false
     },
     description: "List tags visible in the active workspace or configured category scope. Requires read access; use returned tag IDs to filter list_documents and returned tag names to filter search_documents.",
-    inputSchema: z3.object({}),
+    inputSchema: z4.object({}),
     outputSchema: toolOutputSchemas.list_tags
   }, wrapHandler("list_tags", async () => client.listTags()));
   server.registerTool("get_related_documents", {
@@ -896,9 +1008,9 @@ function registerExtendedCapabilities(server, client, wrapHandler) {
       openWorldHint: false
     },
     description: "Traverse graph relations from one readable document without a text query. Requires read access and returns related document IDs plus relation metadata. Use search_knowledge_graph to rank graph neighbors with query text, or search_documents for normal hybrid retrieval. Results stay in the active scope and may be empty when graph data is unavailable.",
-    inputSchema: z3.object({
-      documentId: z3.string().min(1).describe("Document ID returned by search_documents or list_documents; it must be readable in the active scope."),
-      limit: z3.number().int().min(1).max(100).optional().describe("Maximum related documents to return, from 1 to 100. Omit to use the server default.")
+    inputSchema: z4.object({
+      documentId: z4.string().min(1).describe("Document ID returned by search_documents or list_documents; it must be readable in the active scope."),
+      limit: z4.number().int().min(1).max(100).optional().describe("Maximum related documents to return, from 1 to 100. Omit to use the server default.")
     }),
     outputSchema: toolOutputSchemas.get_related_documents
   }, wrapHandler("get_related_documents", async ({ documentId, limit }) => client.getRelatedDocuments(documentId, limit)));
@@ -910,10 +1022,10 @@ function registerExtendedCapabilities(server, client, wrapHandler) {
       openWorldHint: false
     },
     description: "Search graph relations from one or more readable seed documents, optionally using query text to filter and rank related documents. Requires read access and returns seed entities plus relatedDocs. Use search_documents first to obtain authorized seed IDs; use get_related_documents for one-seed neighbors without graph search. Results stay in the active scope and graph data may be empty when unavailable.",
-    inputSchema: z3.object({
-      query: z3.string().max(2000).optional().describe("Optional search text up to 2,000 characters to filter and rank graph-related documents; omit it to inspect relations without query filtering."),
-      docIds: z3.array(z3.string().min(1)).min(1).max(50).describe("Between 1 and 50 document IDs returned by search_documents or list_documents; each seed must be readable in the active scope."),
-      limit: z3.number().int().min(1).max(100).optional().describe("Maximum related documents to return, from 1 to 100. Omit to use the server default.")
+    inputSchema: z4.object({
+      query: z4.string().max(2000).optional().describe("Optional search text up to 2,000 characters to filter and rank graph-related documents; omit it to inspect relations without query filtering."),
+      docIds: z4.array(z4.string().min(1)).min(1).max(50).describe("Between 1 and 50 document IDs returned by search_documents or list_documents; each seed must be readable in the active scope."),
+      limit: z4.number().int().min(1).max(100).optional().describe("Maximum related documents to return, from 1 to 100. Omit to use the server default.")
     }),
     outputSchema: toolOutputSchemas.search_knowledge_graph
   }, wrapHandler("search_knowledge_graph", async (input) => client.searchGraph(input)));
@@ -925,8 +1037,8 @@ function registerExtendedCapabilities(server, client, wrapHandler) {
       openWorldHint: false
     },
     description: "Read indexing and knowledge-pipeline status for an existing document without starting work. Requires read access. Use after a save or refresh_document_index to check progress or failures.",
-    inputSchema: z3.object({
-      documentId: z3.string().uuid().describe("UUID of a document returned by search_documents or list_documents; it must be readable in the active scope.")
+    inputSchema: z4.object({
+      documentId: z4.string().uuid().describe("UUID of a document returned by search_documents or list_documents; it must be readable in the active scope.")
     }),
     outputSchema: toolOutputSchemas.get_document_index_status
   }, wrapHandler("get_document_index_status", async ({ documentId }) => client.getDocumentIndexStatus(documentId)));
@@ -938,16 +1050,16 @@ function registerExtendedCapabilities(server, client, wrapHandler) {
       openWorldHint: false
     },
     description: "Queue an explicit reindex for an existing document; processing is asynchronous and the response acknowledges the generation. Requires write access. Normal content and placement changes schedule indexing when needed, so use get_document_index_status first and refresh only when a retry is intended.",
-    inputSchema: z3.object({
-      documentId: z3.string().uuid().describe("UUID of the document to refresh, obtained from search_documents or list_documents and visible in the active scope.")
+    inputSchema: z4.object({
+      documentId: z4.string().uuid().describe("UUID of the document to refresh, obtained from search_documents or list_documents and visible in the active scope.")
     }),
     outputSchema: toolOutputSchemas.refresh_document_index
   }, wrapHandler("refresh_document_index", async ({ documentId }) => client.refreshDocumentIndex(documentId)));
   server.registerPrompt("organize_workspace", {
     description: "Plan safe document organization using DocsMint categories and folders.",
-    argsSchema: z3.object({
-      objective: z3.string(),
-      language: z3.string().optional()
+    argsSchema: z4.object({
+      objective: z4.string(),
+      language: z4.string().optional()
     })
   }, ({ objective, language }) => ({
     messages: [
@@ -962,9 +1074,9 @@ function registerExtendedCapabilities(server, client, wrapHandler) {
   }));
   server.registerPrompt("research_workspace", {
     description: "Research a question with hybrid search and GraphRAG while citing DocsMint document IDs.",
-    argsSchema: z3.object({
-      question: z3.string(),
-      language: z3.string().optional()
+    argsSchema: z4.object({
+      question: z4.string(),
+      language: z4.string().optional()
     })
   }, ({ question, language }) => ({
     messages: [
@@ -1055,6 +1167,16 @@ function sanitizeMcpRequestContext(context) {
 function createMcpDocsClient(docsClient, requestContext) {
   const context = sanitizeMcpRequestContext(requestContext);
   return {
+    createTag: (input) => docsClient.createTag(input, context),
+    updateTag: (id, input) => docsClient.updateTag(id, input, context),
+    deleteTag: (id) => docsClient.deleteTag(id, context),
+    addTagToDocument: (documentId, tagId) => docsClient.addTagToDoc(documentId, tagId, context),
+    removeTagFromDocument: (documentId, tagId) => docsClient.removeTagFromDoc(documentId, tagId, context),
+    updateFolder: (id, input) => docsClient.updateFolder(id, input, context),
+    updateCategory: (id, input) => docsClient.updateCategory(id, input, context),
+    listTrash: () => docsClient.listTrash(context),
+    restoreTrashedDocument: (id) => docsClient.restoreTrashedDocument(id, context),
+    permanentlyDeleteDocument: (id) => docsClient.permanentlyDeleteDocument(id, context),
     deleteDocument: (id) => docsClient.deleteDoc(id, context),
     deleteFolder: (id) => docsClient.deleteFolder(id, context),
     deleteCategory: (id) => docsClient.deleteCategory(id, context),
@@ -1105,15 +1227,15 @@ __export(exports_create_document, {
   definition: () => definition,
   handler: () => handler
 });
-import { z as z4 } from "zod";
+import { z as z5 } from "zod";
 var definition = {
   name: "create_document",
   description: "Create a new DocsMint document when no existing document should be modified. Optionally set a title, initial Markdown content, and folder or category placement; an omitted title defaults to \u201CUntitled\u201D. Requires write access in the target scope. A category-scoped credential must create inside its configured category, by selecting that category or a folder within it. Normal creation schedules indexing asynchronously and returns the created document. Use update_document for an existing document.",
   inputSchema: {
-    title: z4.string().min(1).max(500).optional().describe("Optional title from 1 to 500 characters; omit to use the API default \u201CUntitled\u201D."),
-    content: z4.string().optional().describe("Optional initial Markdown content; omit to create an empty document."),
-    folderId: z4.string().uuid().optional().describe("Optional folder UUID from list_folders; the folder must be writable in the active workspace or category."),
-    categoryId: z4.string().uuid().nullable().optional().describe("Optional category UUID from list_categories; omit or pass null to leave the explicit category unset. A categorized folder still supplies the document\u2019s effective category; without one the document remains uncategorized. Category-scoped credentials stay bound to their configured category.")
+    title: z5.string().min(1).max(500).optional().describe("Optional title from 1 to 500 characters; omit to use the API default \u201CUntitled\u201D."),
+    content: z5.string().optional().describe("Optional initial Markdown content; omit to create an empty document."),
+    folderId: z5.string().uuid().optional().describe("Optional folder UUID from list_folders; the folder must be writable in the active workspace or category."),
+    categoryId: z5.string().uuid().nullable().optional().describe("Optional category UUID from list_categories; omit or pass null to leave the explicit category unset. A categorized folder still supplies the document\u2019s effective category; without one the document remains uncategorized. Category-scoped credentials stay bound to their configured category.")
   }
 };
 var createHandler = (api) => async function createDocument(args) {
@@ -1128,14 +1250,14 @@ __export(exports_create_folder, {
   definition: () => definition2,
   handler: () => handler2
 });
-import { z as z5 } from "zod";
+import { z as z6 } from "zod";
 var definition2 = {
   name: "create_folder",
   description: "Create a new folder in the active workspace or category scope. Requires write access and returns the created folder. A nested folder inherits its parent category; for a root folder, pass categoryId when using a category-scoped credential. Category-scoped credentials cannot create outside their configured category.",
   inputSchema: {
-    name: z5.string().min(1).max(255).describe("Non-empty folder name up to 255 characters."),
-    parentId: z5.string().uuid().nullable().optional().describe("Optional parent folder UUID from list_folders; omit or pass null to create a root-level folder."),
-    categoryId: z5.string().uuid().nullable().optional().describe("Optional category UUID from list_categories for a root-level folder. A nested folder inherits its parent category; category-scoped credentials cannot escape their configured category.")
+    name: z6.string().min(1).max(255).describe("Non-empty folder name up to 255 characters."),
+    parentId: z6.string().uuid().nullable().optional().describe("Optional parent folder UUID from list_folders; omit or pass null to create a root-level folder."),
+    categoryId: z6.string().uuid().nullable().optional().describe("Optional category UUID from list_categories for a root-level folder. A nested folder inherits its parent category; category-scoped credentials cannot escape their configured category.")
   }
 };
 var createHandler2 = (api) => async function createFolder(args) {
@@ -1150,14 +1272,14 @@ __export(exports_create_snapshot, {
   definition: () => definition3,
   handler: () => handler3
 });
-import { z as z6 } from "zod";
+import { z as z7 } from "zod";
 var definition3 = {
   name: "create_snapshot",
   description: "Save a named, retained snapshot of an existing document\u2019s current content before a planned change. Requires edit access and adds an entry to get_version_history without changing the document itself. Use restore_document_version with the returned version ID to restore its content later.",
   inputSchema: {
-    documentId: z6.string().uuid().describe("UUID of the existing document, obtained from search_documents or list_documents and visible in the active scope."),
-    label: z6.string().min(1).max(200).describe("Non-empty snapshot label up to 200 characters, for example 'v1.0-release'."),
-    description: z6.string().max(1000).optional().describe("Optional snapshot note up to 1,000 characters; omit if not needed.")
+    documentId: z7.string().uuid().describe("UUID of the existing document, obtained from search_documents or list_documents and visible in the active scope."),
+    label: z7.string().min(1).max(200).describe("Non-empty snapshot label up to 200 characters, for example 'v1.0-release'."),
+    description: z7.string().max(1000).optional().describe("Optional snapshot note up to 1,000 characters; omit if not needed.")
   }
 };
 var createHandler3 = (api) => async function createSnapshot(args) {
@@ -1173,12 +1295,12 @@ __export(exports_export_document, {
   definition: () => definition4,
   handler: () => handler4
 });
-import { z as z7 } from "zod";
+import { z as z8 } from "zod";
 var definition4 = {
   name: "export_document",
   description: "Render one readable document as portable Markdown and return a markdown string in the response object. Does not modify the document or include its complete metadata; use get_document to inspect the editable document.",
   inputSchema: {
-    id: z7.string().uuid().describe("UUID of the readable document to export, obtained from search_documents or list_documents.")
+    id: z8.string().uuid().describe("UUID of the readable document to export, obtained from search_documents or list_documents.")
   }
 };
 var createHandler4 = (api) => async function exportDocument(args) {
@@ -1193,12 +1315,12 @@ __export(exports_get_document, {
   definition: () => definition5,
   handler: () => handler5
 });
-import { z as z8 } from "zod";
+import { z as z9 } from "zod";
 var definition5 = {
   name: "get_document",
   description: "Read an existing document by UUID with its content, metadata, and tags before editing or citing it. Requires read access in the active workspace/category. Use export_document when you only need the portable Markdown body.",
   inputSchema: {
-    id: z8.string().uuid().describe("UUID of the document, obtained from search_documents or list_documents, and visible in the active scope.")
+    id: z9.string().uuid().describe("UUID of the document, obtained from search_documents or list_documents, and visible in the active scope.")
   }
 };
 var createHandler5 = (api) => async function getDocument(args) {
@@ -1213,15 +1335,15 @@ __export(exports_list_documents, {
   definition: () => definition6,
   handler: () => handler6
 });
-import { z as z9 } from "zod";
+import { z as z10 } from "zod";
 var definition6 = {
   name: "list_documents",
   description: "List readable documents in the active workspace or category with page-based results. Optionally filter by folder or tag; page defaults to 1 and limit to 20 (maximum 1,000). Use search_documents for text or semantic retrieval.",
   inputSchema: {
-    folderId: z9.string().uuid().optional().describe("Optional folder UUID from list_folders to limit the listing."),
-    tag: z9.string().uuid().optional().describe("Optional tag UUID from list_tags to filter the documents."),
-    page: z9.number().int().min(1).optional().describe("1-indexed result page; defaults to 1."),
-    limit: z9.number().int().min(1).max(1000).optional().describe("Number of documents per page, from 1 to 1,000; defaults to 20.")
+    folderId: z10.string().uuid().optional().describe("Optional folder UUID from list_folders to limit the listing."),
+    tag: z10.string().uuid().optional().describe("Optional tag UUID from list_tags to filter the documents."),
+    page: z10.number().int().min(1).optional().describe("1-indexed result page; defaults to 1."),
+    limit: z10.number().int().min(1).max(1000).optional().describe("Number of documents per page, from 1 to 1,000; defaults to 20.")
   }
 };
 var createHandler6 = (api) => async function listDocuments(args) {
@@ -1236,12 +1358,12 @@ __export(exports_list_folders, {
   definition: () => definition7,
   handler: () => handler7
 });
-import { z as z10 } from "zod";
+import { z as z11 } from "zod";
 var definition7 = {
   name: "list_folders",
   description: "List folders readable in the active workspace/category. Omit parentId to list root folders, or supply a parent UUID to list its immediate children as a flat list. Use create_folder to add a folder.",
   inputSchema: {
-    parentId: z10.string().uuid().optional().describe("Optional parent folder UUID from list_folders; omit to list root folders.")
+    parentId: z11.string().uuid().optional().describe("Optional parent folder UUID from list_folders; omit to list root folders.")
   }
 };
 var createHandler7 = (api) => async function listFolders(args) {
@@ -1256,15 +1378,15 @@ __export(exports_search, {
   definition: () => definition8,
   handler: () => handler8
 });
-import { z as z11 } from "zod";
+import { z as z12 } from "zod";
 var definition8 = {
   name: "search_documents",
   description: "Search readable DocsMint documents with hybrid full-text and semantic retrieval, optionally filtered by folder and tag names. Requires read access and stays within the active workspace/category. Use search_knowledge_graph for graph relations from seed documents or get_related_documents for neighbors without a text query.",
   inputSchema: {
-    query: z11.string().describe("Text to search for; preserve the language and terms relevant to the user request."),
-    folder: z11.string().optional().describe("Optional folder UUID from list_folders to scope retrieval."),
-    tags: z11.array(z11.string()).optional().describe("Optional tag names as shown by list_tags; documents match when they have any supplied tag name."),
-    limit: z11.number().int().positive().max(100).optional().describe("Maximum result count, from 1 to 100; defaults to 20.")
+    query: z12.string().describe("Text to search for; preserve the language and terms relevant to the user request."),
+    folder: z12.string().optional().describe("Optional folder UUID from list_folders to scope retrieval."),
+    tags: z12.array(z12.string()).optional().describe("Optional tag names as shown by list_tags; documents match when they have any supplied tag name."),
+    limit: z12.number().int().positive().max(100).optional().describe("Maximum result count, from 1 to 100; defaults to 20.")
   }
 };
 var createHandler8 = (api) => async function searchDocuments(args) {
@@ -1284,16 +1406,16 @@ __export(exports_update_document, {
   definition: () => definition9,
   handler: () => handler9
 });
-import { z as z12 } from "zod";
+import { z as z13 } from "zod";
 var definition9 = {
   name: "update_document",
   description: "Modify an existing document by UUID after reading its current state. Omitted fields remain unchanged; null folderId removes folder placement and null categoryId clears the explicit category, while a categorized folder can still supply the effective category. Changing title or Markdown content requires edit access, while moving placement requires write access in the active workspace/category. The server stores the prior content in version history and queues indexing when content or placement changes. Returns the updated document. Use create_document for new content.",
   inputSchema: {
-    id: z12.string().uuid().describe("UUID of the existing document, obtained from search_documents, list_documents, or get_document."),
-    title: z12.string().min(1).max(500).optional().describe("Optional replacement title, 1 to 500 characters; omit to leave the current title unchanged."),
-    content: z12.string().optional().describe("New markdown content for the document."),
-    folderId: z12.string().uuid().nullable().optional().describe("Optional destination folder UUID from list_folders; omit to keep current placement or pass null to remove folder placement."),
-    categoryId: z12.string().uuid().nullable().optional().describe("Optional destination category UUID from list_categories; omit to keep the explicit category or pass null to clear it. A categorized folder may still supply the effective category. Category-scoped credentials cannot move outside their configured category.")
+    id: z13.string().uuid().describe("UUID of the existing document, obtained from search_documents, list_documents, or get_document."),
+    title: z13.string().min(1).max(500).optional().describe("Optional replacement title, 1 to 500 characters; omit to leave the current title unchanged."),
+    content: z13.string().optional().describe("New markdown content for the document."),
+    folderId: z13.string().uuid().nullable().optional().describe("Optional destination folder UUID from list_folders; omit to keep current placement or pass null to remove folder placement."),
+    categoryId: z13.string().uuid().nullable().optional().describe("Optional destination category UUID from list_categories; omit to keep the explicit category or pass null to clear it. A categorized folder may still supply the effective category. Category-scoped credentials cannot move outside their configured category.")
   }
 };
 var createHandler9 = (api) => async function updateDocument(args) {
@@ -1309,13 +1431,13 @@ __export(exports_version_history, {
   definition: () => definition10,
   handler: () => handler10
 });
-import { z as z13 } from "zod";
+import { z as z14 } from "zod";
 var definition10 = {
   name: "get_version_history",
   description: "Read versions for an existing document, including saved snapshots. Requires read access and returns version IDs with content and timestamps; pass a version ID to restore_document_version when the user asks to restore content. This is read-only and does not change the document.",
   inputSchema: {
-    documentId: z13.string().uuid().describe("UUID of the readable document whose version history you need; obtain it from search_documents or list_documents."),
-    onlySnapshots: z13.boolean().optional().describe("When true, return only named snapshots and omit auto-saved revisions; omit or use false for the full history.")
+    documentId: z14.string().uuid().describe("UUID of the readable document whose version history you need; obtain it from search_documents or list_documents."),
+    onlySnapshots: z14.boolean().optional().describe("When true, return only named snapshots and omit auto-saved revisions; omit or use false for the full history.")
   }
 };
 var createHandler10 = (api) => async function getVersionHistory(args) {
@@ -1365,7 +1487,7 @@ function registerDocsmintMcpCapabilities(server, client2) {
   const register = (name, description, inputSchema, handler11) => {
     server.registerTool(name, {
       description,
-      inputSchema: z14.object(inputSchema),
+      inputSchema: z15.object(inputSchema),
       annotations: {
         readOnlyHint: ![
           "create_document",
@@ -1402,9 +1524,10 @@ function registerDocsmintMcpCapabilities(server, client2) {
   }
   registerExtendedCapabilities(server, client2, (name, handler11) => wrapHandler(name, handler11, toolOutputSchemas[name]));
   registerLifecycleCapabilities(server, client2, (name, handler11) => wrapHandler(name, handler11, toolOutputSchemas[name]));
+  registerManagementCapabilities(server, client2, (name, handler11) => wrapHandler(name, handler11, toolOutputSchemas[name]));
 }
 function createDocsmintMcpServer(options = {}) {
-  const server = new McpServer({ name: "docsmint", version: "0.9.2" });
+  const server = new McpServer({ name: "docsmint", version: "0.9.4" });
   const client2 = options.docsClient ? createMcpDocsClient(options.docsClient, options.requestContext) : options.client ?? createMcpDocsClient(createDefaultDocsClient(), options.requestContext);
   registerDocsmintMcpCapabilities(server, client2);
   return server;

package/dist/mcp-server.js

@@ -16,7 +16,7 @@ var __export = (target, all) => {
 
 // ../mcp-server/src/server.ts
 import { McpServer } from "@modelcontextprotocol/server";
-import { z as z14 } from "zod";
+import { z as z15 } from "zod";
 
 // dist/client.js
 var docsApiErrorBrand = Symbol.for("io.github.hiai-gg.docsmint.DocsApiError");
@@ -195,6 +195,15 @@ class DocsClient {
   async deleteTag(id, context) {
     await this.request("DELETE", `/api/tags/${encodeURIComponent(id)}`, undefined, context);
   }
+  async listTrash(context) {
+    return this.request("GET", "/api/trash", undefined, context);
+  }
+  async restoreTrashedDocument(id, context) {
+    return this.request("POST", `/api/trash/documents/${encodeURIComponent(id)}/restore`, undefined, context);
+  }
+  async permanentlyDeleteDocument(id, context) {
+    return this.request("DELETE", `/api/trash/documents/${encodeURIComponent(id)}`, undefined, context);
+  }
   async addTagToDoc(documentId, tagId, context) {
     await this.request("POST", `/api/documents/${encodeURIComponent(documentId)}/tags`, { json: { tagId } }, context);
   }
@@ -795,7 +804,17 @@ var toolOutputSchemas = {
   delete_document: deleteAcknowledgmentSchema,
   delete_folder: deleteAcknowledgmentSchema,
   delete_category: deleteAcknowledgmentSchema,
-  restore_document_version: documentSchema
+  restore_document_version: documentSchema,
+  create_tag: tagSchema,
+  update_tag: tagSchema,
+  delete_tag: deleteAcknowledgmentSchema,
+  add_tag_to_document: z.looseObject({ documentId: z.string().uuid(), tagId: z.string().uuid(), assigned: z.literal(true) }),
+  remove_tag_from_document: z.looseObject({ documentId: z.string().uuid(), tagId: z.string().uuid(), removed: z.literal(true) }),
+  update_folder: folderSchema,
+  update_category: categorySchema,
+  list_trash: z.looseObject({ documents: z.array(z.looseObject({ id: z.string().uuid(), title: z.string(), deletedAt: z.string(), purgeAfter: z.string().nullable() })), folders: z.array(z.unknown()) }),
+  restore_trashed_document: z.looseObject({ success: z.literal(true) }),
+  permanently_delete_document: deleteAcknowledgmentSchema
 };
 
 // ../mcp-server/src/lifecycle.ts
@@ -846,8 +865,101 @@ function registerLifecycleCapabilities(server, client, wrap) {
   }, wrap("restore_document_version", async ({ documentId, versionId }) => client.restoreDocumentVersion ? client.restoreDocumentVersion(documentId, versionId) : unsupported("restore_document_version")));
 }
 
-// ../mcp-server/src/capabilities.ts
+// ../mcp-server/src/management.ts
 import { z as z3 } from "zod";
+var uuid = z3.string().uuid().describe("UUID of the target object, obtained from the corresponding list tool.");
+var write = { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false };
+var update = { ...write, destructiveHint: true };
+var read = { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false };
+var purge = { ...write, destructiveHint: true };
+function unsupported2(name) {
+  throw new Error(`The injected legacy MCP client does not support ${name}; use a public DocsClient.`);
+}
+function registerManagementCapabilities(server, client, wrap) {
+  server.registerTool("create_tag", {
+    description: "Create a tag in the active workspace. Requires full workspace write access; category-scoped credentials cannot manage tags. Use add_tag_to_document to assign it.",
+    annotations: write,
+    inputSchema: z3.object({ name: z3.string().min(1).max(100).describe("New tag name, up to 100 characters."), color: z3.string().max(20).optional().describe("Optional display color for the new tag, up to 20 characters.") }),
+    outputSchema: toolOutputSchemas.create_tag
+  }, wrap("create_tag", async (input) => client.createTag ? client.createTag(input) : unsupported2("create_tag")));
+  server.registerTool("update_tag", {
+    description: "Rename or recolor an existing tag. Requires full workspace write access; category-scoped credentials cannot manage tags. Affected documents are reindexed by the API.",
+    annotations: update,
+    inputSchema: z3.object({ id: uuid, name: z3.string().min(1).max(100).optional().describe("Replacement tag name; omit to keep the current name."), color: z3.string().max(20).optional().describe("Replacement display color; omit to keep the current color.") }).refine((value) => value.name !== undefined || value.color !== undefined),
+    outputSchema: toolOutputSchemas.update_tag
+  }, wrap("update_tag", async ({ id, ...input }) => client.updateTag ? client.updateTag(id, input) : unsupported2("update_tag")));
+  server.registerTool("delete_tag", {
+    description: "Delete a tag in the active workspace and remove its document assignments. Requires full workspace write access; category-scoped credentials cannot manage tags.",
+    annotations: purge,
+    inputSchema: z3.object({ id: uuid }),
+    outputSchema: toolOutputSchemas.delete_tag
+  }, wrap("delete_tag", async ({ id }) => {
+    if (!client.deleteTag)
+      return unsupported2("delete_tag");
+    await client.deleteTag(id);
+    return { id, deleted: true };
+  }));
+  server.registerTool("add_tag_to_document", {
+    description: "Assign a tag from list_tags to an existing document. Requires edit access to the document and permission to use the tag.",
+    annotations: write,
+    inputSchema: z3.object({ documentId: uuid.describe("UUID of the document to tag."), tagId: uuid.describe("UUID of the tag returned by list_tags.") }),
+    outputSchema: toolOutputSchemas.add_tag_to_document
+  }, wrap("add_tag_to_document", async ({ documentId, tagId }) => {
+    if (!client.addTagToDocument)
+      return unsupported2("add_tag_to_document");
+    await client.addTagToDocument(documentId, tagId);
+    return { documentId, tagId, assigned: true };
+  }));
+  server.registerTool("remove_tag_from_document", {
+    description: "Remove a tag assignment from a document. Requires edit access; the tag itself is preserved.",
+    annotations: update,
+    inputSchema: z3.object({ documentId: uuid.describe("UUID of the document whose tag assignment changes."), tagId: uuid.describe("UUID of the assigned tag to remove.") }),
+    outputSchema: toolOutputSchemas.remove_tag_from_document
+  }, wrap("remove_tag_from_document", async ({ documentId, tagId }) => {
+    if (!client.removeTagFromDocument)
+      return unsupported2("remove_tag_from_document");
+    await client.removeTagFromDocument(documentId, tagId);
+    return { documentId, tagId, removed: true };
+  }));
+  server.registerTool("update_folder", {
+    description: "Rename or move a folder; changes to category or parent follow API scope rules and trigger reindexing. Requires write access.",
+    annotations: update,
+    inputSchema: z3.object({ id: uuid, name: z3.string().min(1).max(255).optional().describe("Replacement folder name; omit to preserve the name."), parentId: uuid.nullable().optional().describe("New parent folder UUID, or null for a root folder."), categoryId: uuid.nullable().optional().describe("New category UUID, or null to clear the category."), order: z3.number().int().nonnegative().optional().describe("New non-negative order within the containing folder.") }).refine((value) => value.name !== undefined || value.parentId !== undefined || value.categoryId !== undefined || value.order !== undefined),
+    outputSchema: toolOutputSchemas.update_folder
+  }, wrap("update_folder", async ({ id, ...input }) => client.updateFolder ? client.updateFolder(id, input) : unsupported2("update_folder")));
+  server.registerTool("update_category", {
+    description: "Rename or reorder a category. Requires full workspace write access; category-scoped credentials cannot modify categories.",
+    annotations: update,
+    inputSchema: z3.object({ id: uuid, name: z3.string().min(1).max(255).optional().describe("New category name, up to 255 characters."), order: z3.number().int().nonnegative().optional().describe("New non-negative category order.") }).refine((value) => value.name !== undefined || value.order !== undefined),
+    outputSchema: toolOutputSchemas.update_category
+  }, wrap("update_category", async ({ id, ...input }) => client.updateCategory ? client.updateCategory(id, input) : unsupported2("update_category")));
+  server.registerTool("list_trash", {
+    description: "List soft-deleted documents visible to the active workspace/category. Requires read access.",
+    annotations: read,
+    inputSchema: z3.object({}),
+    outputSchema: toolOutputSchemas.list_trash
+  }, wrap("list_trash", async () => client.listTrash ? client.listTrash() : unsupported2("list_trash")));
+  server.registerTool("restore_trashed_document", {
+    description: "Restore a soft-deleted document from list_trash. Requires write access. This is different from restoring a content version.",
+    annotations: write,
+    inputSchema: z3.object({ id: uuid }),
+    outputSchema: toolOutputSchemas.restore_trashed_document
+  }, wrap("restore_trashed_document", async ({ id }) => client.restoreTrashedDocument ? client.restoreTrashedDocument(id) : unsupported2("restore_trashed_document")));
+  server.registerTool("permanently_delete_document", {
+    description: "Irreversibly purge a document already in trash, including its content and version history. Requires write access. Use only on explicit user request after checking list_trash.",
+    annotations: purge,
+    inputSchema: z3.object({ id: uuid }),
+    outputSchema: toolOutputSchemas.permanently_delete_document
+  }, wrap("permanently_delete_document", async ({ id }) => {
+    if (!client.permanentlyDeleteDocument)
+      return unsupported2("permanently_delete_document");
+    await client.permanentlyDeleteDocument(id);
+    return { id, deleted: true };
+  }));
+}
+
+// ../mcp-server/src/capabilities.ts
+import { z as z4 } from "zod";
 var capabilityCatalog = {
   tools: [
     "search_documents",
@@ -870,7 +982,17 @@ var capabilityCatalog = {
     "delete_document",
     "delete_folder",
     "delete_category",
-    "restore_document_version"
+    "restore_document_version",
+    "create_tag",
+    "update_tag",
+    "delete_tag",
+    "add_tag_to_document",
+    "remove_tag_from_document",
+    "update_folder",
+    "update_category",
+    "list_trash",
+    "restore_trashed_document",
+    "permanently_delete_document"
   ],
   prompts: ["organize_workspace", "research_workspace"],
   resources: [
@@ -888,7 +1010,7 @@ function registerExtendedCapabilities(server, client, wrapHandler) {
       openWorldHint: false
     },
     description: "List categories visible in the active workspace or category scope. Requires read access; a category-scoped credential sees only its configured category. Use this before create_document or create_folder when you need an existing category ID.",
-    inputSchema: z3.object({}),
+    inputSchema: z4.object({}),
     outputSchema: toolOutputSchemas.list_categories
   }, wrapHandler("list_categories", async () => client.listCategories()));
   server.registerTool("create_category", {
@@ -899,8 +1021,8 @@ function registerExtendedCapabilities(server, client, wrapHandler) {
       openWorldHint: false
     },
     description: "Create a new category for the active workspace. Requires workspace-level write access; category-scoped credentials cannot create categories. Returns the created category. Use list_categories to inspect existing categories.",
-    inputSchema: z3.object({
-      name: z3.string().trim().min(1).max(255).describe("Non-empty display name, up to 255 characters, for example Project notes.")
+    inputSchema: z4.object({
+      name: z4.string().trim().min(1).max(255).describe("Non-empty display name, up to 255 characters, for example Project notes.")
     }),
     outputSchema: toolOutputSchemas.create_category
   }, wrapHandler("create_category", async (input) => client.createCategory(input)));
@@ -912,7 +1034,7 @@ function registerExtendedCapabilities(server, client, wrapHandler) {
       openWorldHint: false
     },
     description: "List tags visible in the active workspace or configured category scope. Requires read access; use returned tag IDs to filter list_documents and returned tag names to filter search_documents.",
-    inputSchema: z3.object({}),
+    inputSchema: z4.object({}),
     outputSchema: toolOutputSchemas.list_tags
   }, wrapHandler("list_tags", async () => client.listTags()));
   server.registerTool("get_related_documents", {
@@ -923,9 +1045,9 @@ function registerExtendedCapabilities(server, client, wrapHandler) {
       openWorldHint: false
     },
     description: "Traverse graph relations from one readable document without a text query. Requires read access and returns related document IDs plus relation metadata. Use search_knowledge_graph to rank graph neighbors with query text, or search_documents for normal hybrid retrieval. Results stay in the active scope and may be empty when graph data is unavailable.",
-    inputSchema: z3.object({
-      documentId: z3.string().min(1).describe("Document ID returned by search_documents or list_documents; it must be readable in the active scope."),
-      limit: z3.number().int().min(1).max(100).optional().describe("Maximum related documents to return, from 1 to 100. Omit to use the server default.")
+    inputSchema: z4.object({
+      documentId: z4.string().min(1).describe("Document ID returned by search_documents or list_documents; it must be readable in the active scope."),
+      limit: z4.number().int().min(1).max(100).optional().describe("Maximum related documents to return, from 1 to 100. Omit to use the server default.")
     }),
     outputSchema: toolOutputSchemas.get_related_documents
   }, wrapHandler("get_related_documents", async ({ documentId, limit }) => client.getRelatedDocuments(documentId, limit)));
@@ -937,10 +1059,10 @@ function registerExtendedCapabilities(server, client, wrapHandler) {
       openWorldHint: false
     },
     description: "Search graph relations from one or more readable seed documents, optionally using query text to filter and rank related documents. Requires read access and returns seed entities plus relatedDocs. Use search_documents first to obtain authorized seed IDs; use get_related_documents for one-seed neighbors without graph search. Results stay in the active scope and graph data may be empty when unavailable.",
-    inputSchema: z3.object({
-      query: z3.string().max(2000).optional().describe("Optional search text up to 2,000 characters to filter and rank graph-related documents; omit it to inspect relations without query filtering."),
-      docIds: z3.array(z3.string().min(1)).min(1).max(50).describe("Between 1 and 50 document IDs returned by search_documents or list_documents; each seed must be readable in the active scope."),
-      limit: z3.number().int().min(1).max(100).optional().describe("Maximum related documents to return, from 1 to 100. Omit to use the server default.")
+    inputSchema: z4.object({
+      query: z4.string().max(2000).optional().describe("Optional search text up to 2,000 characters to filter and rank graph-related documents; omit it to inspect relations without query filtering."),
+      docIds: z4.array(z4.string().min(1)).min(1).max(50).describe("Between 1 and 50 document IDs returned by search_documents or list_documents; each seed must be readable in the active scope."),
+      limit: z4.number().int().min(1).max(100).optional().describe("Maximum related documents to return, from 1 to 100. Omit to use the server default.")
     }),
     outputSchema: toolOutputSchemas.search_knowledge_graph
   }, wrapHandler("search_knowledge_graph", async (input) => client.searchGraph(input)));
@@ -952,8 +1074,8 @@ function registerExtendedCapabilities(server, client, wrapHandler) {
       openWorldHint: false
     },
     description: "Read indexing and knowledge-pipeline status for an existing document without starting work. Requires read access. Use after a save or refresh_document_index to check progress or failures.",
-    inputSchema: z3.object({
-      documentId: z3.string().uuid().describe("UUID of a document returned by search_documents or list_documents; it must be readable in the active scope.")
+    inputSchema: z4.object({
+      documentId: z4.string().uuid().describe("UUID of a document returned by search_documents or list_documents; it must be readable in the active scope.")
     }),
     outputSchema: toolOutputSchemas.get_document_index_status
   }, wrapHandler("get_document_index_status", async ({ documentId }) => client.getDocumentIndexStatus(documentId)));
@@ -965,16 +1087,16 @@ function registerExtendedCapabilities(server, client, wrapHandler) {
       openWorldHint: false
     },
     description: "Queue an explicit reindex for an existing document; processing is asynchronous and the response acknowledges the generation. Requires write access. Normal content and placement changes schedule indexing when needed, so use get_document_index_status first and refresh only when a retry is intended.",
-    inputSchema: z3.object({
-      documentId: z3.string().uuid().describe("UUID of the document to refresh, obtained from search_documents or list_documents and visible in the active scope.")
+    inputSchema: z4.object({
+      documentId: z4.string().uuid().describe("UUID of the document to refresh, obtained from search_documents or list_documents and visible in the active scope.")
     }),
     outputSchema: toolOutputSchemas.refresh_document_index
   }, wrapHandler("refresh_document_index", async ({ documentId }) => client.refreshDocumentIndex(documentId)));
   server.registerPrompt("organize_workspace", {
     description: "Plan safe document organization using DocsMint categories and folders.",
-    argsSchema: z3.object({
-      objective: z3.string(),
-      language: z3.string().optional()
+    argsSchema: z4.object({
+      objective: z4.string(),
+      language: z4.string().optional()
     })
   }, ({ objective, language }) => ({
     messages: [
@@ -989,9 +1111,9 @@ function registerExtendedCapabilities(server, client, wrapHandler) {
   }));
   server.registerPrompt("research_workspace", {
     description: "Research a question with hybrid search and GraphRAG while citing DocsMint document IDs.",
-    argsSchema: z3.object({
-      question: z3.string(),
-      language: z3.string().optional()
+    argsSchema: z4.object({
+      question: z4.string(),
+      language: z4.string().optional()
     })
   }, ({ question, language }) => ({
     messages: [
@@ -1082,6 +1204,16 @@ function sanitizeMcpRequestContext(context) {
 function createMcpDocsClient(docsClient, requestContext) {
   const context = sanitizeMcpRequestContext(requestContext);
   return {
+    createTag: (input) => docsClient.createTag(input, context),
+    updateTag: (id, input) => docsClient.updateTag(id, input, context),
+    deleteTag: (id) => docsClient.deleteTag(id, context),
+    addTagToDocument: (documentId, tagId) => docsClient.addTagToDoc(documentId, tagId, context),
+    removeTagFromDocument: (documentId, tagId) => docsClient.removeTagFromDoc(documentId, tagId, context),
+    updateFolder: (id, input) => docsClient.updateFolder(id, input, context),
+    updateCategory: (id, input) => docsClient.updateCategory(id, input, context),
+    listTrash: () => docsClient.listTrash(context),
+    restoreTrashedDocument: (id) => docsClient.restoreTrashedDocument(id, context),
+    permanentlyDeleteDocument: (id) => docsClient.permanentlyDeleteDocument(id, context),
     deleteDocument: (id) => docsClient.deleteDoc(id, context),
     deleteFolder: (id) => docsClient.deleteFolder(id, context),
     deleteCategory: (id) => docsClient.deleteCategory(id, context),
@@ -1132,15 +1264,15 @@ __export(exports_create_document, {
   definition: () => definition,
   handler: () => handler
 });
-import { z as z4 } from "zod";
+import { z as z5 } from "zod";
 var definition = {
   name: "create_document",
   description: "Create a new DocsMint document when no existing document should be modified. Optionally set a title, initial Markdown content, and folder or category placement; an omitted title defaults to \u201CUntitled\u201D. Requires write access in the target scope. A category-scoped credential must create inside its configured category, by selecting that category or a folder within it. Normal creation schedules indexing asynchronously and returns the created document. Use update_document for an existing document.",
   inputSchema: {
-    title: z4.string().min(1).max(500).optional().describe("Optional title from 1 to 500 characters; omit to use the API default \u201CUntitled\u201D."),
-    content: z4.string().optional().describe("Optional initial Markdown content; omit to create an empty document."),
-    folderId: z4.string().uuid().optional().describe("Optional folder UUID from list_folders; the folder must be writable in the active workspace or category."),
-    categoryId: z4.string().uuid().nullable().optional().describe("Optional category UUID from list_categories; omit or pass null to leave the explicit category unset. A categorized folder still supplies the document\u2019s effective category; without one the document remains uncategorized. Category-scoped credentials stay bound to their configured category.")
+    title: z5.string().min(1).max(500).optional().describe("Optional title from 1 to 500 characters; omit to use the API default \u201CUntitled\u201D."),
+    content: z5.string().optional().describe("Optional initial Markdown content; omit to create an empty document."),
+    folderId: z5.string().uuid().optional().describe("Optional folder UUID from list_folders; the folder must be writable in the active workspace or category."),
+    categoryId: z5.string().uuid().nullable().optional().describe("Optional category UUID from list_categories; omit or pass null to leave the explicit category unset. A categorized folder still supplies the document\u2019s effective category; without one the document remains uncategorized. Category-scoped credentials stay bound to their configured category.")
   }
 };
 var createHandler = (api) => async function createDocument(args) {
@@ -1155,14 +1287,14 @@ __export(exports_create_folder, {
   definition: () => definition2,
   handler: () => handler2
 });
-import { z as z5 } from "zod";
+import { z as z6 } from "zod";
 var definition2 = {
   name: "create_folder",
   description: "Create a new folder in the active workspace or category scope. Requires write access and returns the created folder. A nested folder inherits its parent category; for a root folder, pass categoryId when using a category-scoped credential. Category-scoped credentials cannot create outside their configured category.",
   inputSchema: {
-    name: z5.string().min(1).max(255).describe("Non-empty folder name up to 255 characters."),
-    parentId: z5.string().uuid().nullable().optional().describe("Optional parent folder UUID from list_folders; omit or pass null to create a root-level folder."),
-    categoryId: z5.string().uuid().nullable().optional().describe("Optional category UUID from list_categories for a root-level folder. A nested folder inherits its parent category; category-scoped credentials cannot escape their configured category.")
+    name: z6.string().min(1).max(255).describe("Non-empty folder name up to 255 characters."),
+    parentId: z6.string().uuid().nullable().optional().describe("Optional parent folder UUID from list_folders; omit or pass null to create a root-level folder."),
+    categoryId: z6.string().uuid().nullable().optional().describe("Optional category UUID from list_categories for a root-level folder. A nested folder inherits its parent category; category-scoped credentials cannot escape their configured category.")
   }
 };
 var createHandler2 = (api) => async function createFolder(args) {
@@ -1177,14 +1309,14 @@ __export(exports_create_snapshot, {
   definition: () => definition3,
   handler: () => handler3
 });
-import { z as z6 } from "zod";
+import { z as z7 } from "zod";
 var definition3 = {
   name: "create_snapshot",
   description: "Save a named, retained snapshot of an existing document\u2019s current content before a planned change. Requires edit access and adds an entry to get_version_history without changing the document itself. Use restore_document_version with the returned version ID to restore its content later.",
   inputSchema: {
-    documentId: z6.string().uuid().describe("UUID of the existing document, obtained from search_documents or list_documents and visible in the active scope."),
-    label: z6.string().min(1).max(200).describe("Non-empty snapshot label up to 200 characters, for example 'v1.0-release'."),
-    description: z6.string().max(1000).optional().describe("Optional snapshot note up to 1,000 characters; omit if not needed.")
+    documentId: z7.string().uuid().describe("UUID of the existing document, obtained from search_documents or list_documents and visible in the active scope."),
+    label: z7.string().min(1).max(200).describe("Non-empty snapshot label up to 200 characters, for example 'v1.0-release'."),
+    description: z7.string().max(1000).optional().describe("Optional snapshot note up to 1,000 characters; omit if not needed.")
   }
 };
 var createHandler3 = (api) => async function createSnapshot(args) {
@@ -1200,12 +1332,12 @@ __export(exports_export_document, {
   definition: () => definition4,
   handler: () => handler4
 });
-import { z as z7 } from "zod";
+import { z as z8 } from "zod";
 var definition4 = {
   name: "export_document",
   description: "Render one readable document as portable Markdown and return a markdown string in the response object. Does not modify the document or include its complete metadata; use get_document to inspect the editable document.",
   inputSchema: {
-    id: z7.string().uuid().describe("UUID of the readable document to export, obtained from search_documents or list_documents.")
+    id: z8.string().uuid().describe("UUID of the readable document to export, obtained from search_documents or list_documents.")
   }
 };
 var createHandler4 = (api) => async function exportDocument(args) {
@@ -1220,12 +1352,12 @@ __export(exports_get_document, {
   definition: () => definition5,
   handler: () => handler5
 });
-import { z as z8 } from "zod";
+import { z as z9 } from "zod";
 var definition5 = {
   name: "get_document",
   description: "Read an existing document by UUID with its content, metadata, and tags before editing or citing it. Requires read access in the active workspace/category. Use export_document when you only need the portable Markdown body.",
   inputSchema: {
-    id: z8.string().uuid().describe("UUID of the document, obtained from search_documents or list_documents, and visible in the active scope.")
+    id: z9.string().uuid().describe("UUID of the document, obtained from search_documents or list_documents, and visible in the active scope.")
   }
 };
 var createHandler5 = (api) => async function getDocument(args) {
@@ -1240,15 +1372,15 @@ __export(exports_list_documents, {
   definition: () => definition6,
   handler: () => handler6
 });
-import { z as z9 } from "zod";
+import { z as z10 } from "zod";
 var definition6 = {
   name: "list_documents",
   description: "List readable documents in the active workspace or category with page-based results. Optionally filter by folder or tag; page defaults to 1 and limit to 20 (maximum 1,000). Use search_documents for text or semantic retrieval.",
   inputSchema: {
-    folderId: z9.string().uuid().optional().describe("Optional folder UUID from list_folders to limit the listing."),
-    tag: z9.string().uuid().optional().describe("Optional tag UUID from list_tags to filter the documents."),
-    page: z9.number().int().min(1).optional().describe("1-indexed result page; defaults to 1."),
-    limit: z9.number().int().min(1).max(1000).optional().describe("Number of documents per page, from 1 to 1,000; defaults to 20.")
+    folderId: z10.string().uuid().optional().describe("Optional folder UUID from list_folders to limit the listing."),
+    tag: z10.string().uuid().optional().describe("Optional tag UUID from list_tags to filter the documents."),
+    page: z10.number().int().min(1).optional().describe("1-indexed result page; defaults to 1."),
+    limit: z10.number().int().min(1).max(1000).optional().describe("Number of documents per page, from 1 to 1,000; defaults to 20.")
   }
 };
 var createHandler6 = (api) => async function listDocuments(args) {
@@ -1263,12 +1395,12 @@ __export(exports_list_folders, {
   definition: () => definition7,
   handler: () => handler7
 });
-import { z as z10 } from "zod";
+import { z as z11 } from "zod";
 var definition7 = {
   name: "list_folders",
   description: "List folders readable in the active workspace/category. Omit parentId to list root folders, or supply a parent UUID to list its immediate children as a flat list. Use create_folder to add a folder.",
   inputSchema: {
-    parentId: z10.string().uuid().optional().describe("Optional parent folder UUID from list_folders; omit to list root folders.")
+    parentId: z11.string().uuid().optional().describe("Optional parent folder UUID from list_folders; omit to list root folders.")
   }
 };
 var createHandler7 = (api) => async function listFolders(args) {
@@ -1283,15 +1415,15 @@ __export(exports_search, {
   definition: () => definition8,
   handler: () => handler8
 });
-import { z as z11 } from "zod";
+import { z as z12 } from "zod";
 var definition8 = {
   name: "search_documents",
   description: "Search readable DocsMint documents with hybrid full-text and semantic retrieval, optionally filtered by folder and tag names. Requires read access and stays within the active workspace/category. Use search_knowledge_graph for graph relations from seed documents or get_related_documents for neighbors without a text query.",
   inputSchema: {
-    query: z11.string().describe("Text to search for; preserve the language and terms relevant to the user request."),
-    folder: z11.string().optional().describe("Optional folder UUID from list_folders to scope retrieval."),
-    tags: z11.array(z11.string()).optional().describe("Optional tag names as shown by list_tags; documents match when they have any supplied tag name."),
-    limit: z11.number().int().positive().max(100).optional().describe("Maximum result count, from 1 to 100; defaults to 20.")
+    query: z12.string().describe("Text to search for; preserve the language and terms relevant to the user request."),
+    folder: z12.string().optional().describe("Optional folder UUID from list_folders to scope retrieval."),
+    tags: z12.array(z12.string()).optional().describe("Optional tag names as shown by list_tags; documents match when they have any supplied tag name."),
+    limit: z12.number().int().positive().max(100).optional().describe("Maximum result count, from 1 to 100; defaults to 20.")
   }
 };
 var createHandler8 = (api) => async function searchDocuments(args) {
@@ -1311,16 +1443,16 @@ __export(exports_update_document, {
   definition: () => definition9,
   handler: () => handler9
 });
-import { z as z12 } from "zod";
+import { z as z13 } from "zod";
 var definition9 = {
   name: "update_document",
   description: "Modify an existing document by UUID after reading its current state. Omitted fields remain unchanged; null folderId removes folder placement and null categoryId clears the explicit category, while a categorized folder can still supply the effective category. Changing title or Markdown content requires edit access, while moving placement requires write access in the active workspace/category. The server stores the prior content in version history and queues indexing when content or placement changes. Returns the updated document. Use create_document for new content.",
   inputSchema: {
-    id: z12.string().uuid().describe("UUID of the existing document, obtained from search_documents, list_documents, or get_document."),
-    title: z12.string().min(1).max(500).optional().describe("Optional replacement title, 1 to 500 characters; omit to leave the current title unchanged."),
-    content: z12.string().optional().describe("New markdown content for the document."),
-    folderId: z12.string().uuid().nullable().optional().describe("Optional destination folder UUID from list_folders; omit to keep current placement or pass null to remove folder placement."),
-    categoryId: z12.string().uuid().nullable().optional().describe("Optional destination category UUID from list_categories; omit to keep the explicit category or pass null to clear it. A categorized folder may still supply the effective category. Category-scoped credentials cannot move outside their configured category.")
+    id: z13.string().uuid().describe("UUID of the existing document, obtained from search_documents, list_documents, or get_document."),
+    title: z13.string().min(1).max(500).optional().describe("Optional replacement title, 1 to 500 characters; omit to leave the current title unchanged."),
+    content: z13.string().optional().describe("New markdown content for the document."),
+    folderId: z13.string().uuid().nullable().optional().describe("Optional destination folder UUID from list_folders; omit to keep current placement or pass null to remove folder placement."),
+    categoryId: z13.string().uuid().nullable().optional().describe("Optional destination category UUID from list_categories; omit to keep the explicit category or pass null to clear it. A categorized folder may still supply the effective category. Category-scoped credentials cannot move outside their configured category.")
   }
 };
 var createHandler9 = (api) => async function updateDocument(args) {
@@ -1336,13 +1468,13 @@ __export(exports_version_history, {
   definition: () => definition10,
   handler: () => handler10
 });
-import { z as z13 } from "zod";
+import { z as z14 } from "zod";
 var definition10 = {
   name: "get_version_history",
   description: "Read versions for an existing document, including saved snapshots. Requires read access and returns version IDs with content and timestamps; pass a version ID to restore_document_version when the user asks to restore content. This is read-only and does not change the document.",
   inputSchema: {
-    documentId: z13.string().uuid().describe("UUID of the readable document whose version history you need; obtain it from search_documents or list_documents."),
-    onlySnapshots: z13.boolean().optional().describe("When true, return only named snapshots and omit auto-saved revisions; omit or use false for the full history.")
+    documentId: z14.string().uuid().describe("UUID of the readable document whose version history you need; obtain it from search_documents or list_documents."),
+    onlySnapshots: z14.boolean().optional().describe("When true, return only named snapshots and omit auto-saved revisions; omit or use false for the full history.")
   }
 };
 var createHandler10 = (api) => async function getVersionHistory(args) {
@@ -1392,7 +1524,7 @@ function registerDocsmintMcpCapabilities(server, client2) {
   const register = (name, description, inputSchema, handler11) => {
     server.registerTool(name, {
       description,
-      inputSchema: z14.object(inputSchema),
+      inputSchema: z15.object(inputSchema),
       annotations: {
         readOnlyHint: ![
           "create_document",
@@ -1429,9 +1561,10 @@ function registerDocsmintMcpCapabilities(server, client2) {
   }
   registerExtendedCapabilities(server, client2, (name, handler11) => wrapHandler(name, handler11, toolOutputSchemas[name]));
   registerLifecycleCapabilities(server, client2, (name, handler11) => wrapHandler(name, handler11, toolOutputSchemas[name]));
+  registerManagementCapabilities(server, client2, (name, handler11) => wrapHandler(name, handler11, toolOutputSchemas[name]));
 }
 function createDocsmintMcpServer(options = {}) {
-  const server = new McpServer({ name: "docsmint", version: "0.9.2" });
+  const server = new McpServer({ name: "docsmint", version: "0.9.4" });
   const client2 = options.docsClient ? createMcpDocsClient(options.docsClient, options.requestContext) : options.client ?? createMcpDocsClient(createDefaultDocsClient(), options.requestContext);
   registerDocsmintMcpCapabilities(server, client2);
   return server;

package/dist/types.d.ts

@@ -141,6 +141,15 @@ export interface DocsTag {
     createdAt?: string;
     documentCount?: number;
 }
+export interface DocsTrashResponse {
+    documents: Array<{
+        id: string;
+        title: string;
+        deletedAt: string;
+        purgeAfter: string | null;
+    }>;
+    folders: [];
+}
 /**
  * Search hit as returned by `GET /api/search`. The backend uses
  * snake_case in the JSON payload — we mirror that exactly here so

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@hiai-gg/docsmint",
   "mcpName": "io.github.HiAi-gg/docsmint",
-  "version": "0.9.2",
+  "version": "0.9.4",
   "type": "module",
   "browser": {
     "./dist/backend-launcher.js": false,

package/packages/cli/src/index.ts

@@ -25,7 +25,7 @@ import { registerSearch } from './commands/search.js';
 import { registerSnapshot } from './commands/snapshot.js';
 import { registerUpdate } from './commands/update.js';
 
-const VERSION = '0.9.2';
+const VERSION = '0.9.4';
 
 const program = new Command();
 program.name('docsmint').description('CLI for the DocsMint knowledge workspace').version(VERSION);

package/server.json

@@ -10,7 +10,7 @@
     "id": "1249550690",
     "subfolder": "packages/mcp-server"
   },
-  "version": "0.9.2",
+  "version": "0.9.4",
   "icons": [
     {
       "src": "https://raw.githubusercontent.com/HiAi-gg/docsmint/main/frontend/static/logo-dark.png",
@@ -34,7 +34,7 @@
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@hiai-gg/docsmint",
-      "version": "0.9.2",
+      "version": "0.9.4",
       "runtimeHint": "npx",
       "transport": {
         "type": "stdio"
@@ -87,7 +87,7 @@
       "licenseFile": "https://github.com/HiAi-gg/docsmint/blob/main/LICENSE",
       "documentationUrl": "https://docsmint.com/mcp/connect?source=mcp_registry",
       "catalog": {
-        "tools": 21,
+        "tools": 31,
         "prompts": 2,
         "resources": 3
       }