@hiai-gg/docsmint 0.6.0 → 0.6.1

package/packages/mcp-server/src/tools/update-document.ts

@@ -3,28 +3,42 @@ import { client } from "../client.js";
 import type { DocumentDetail } from "../types.js";
 
 export const definition = {
-  name: "update_document",
-  description:
-    "Update an existing document's title and/or content. The server creates a new version on each update.",
-  inputSchema: {
-    id: z.string().describe("Document ID to update."),
-    title: z.string().optional().describe("New title for the document."),
-    content: z
-      .string()
-      .optional()
-      .describe("New markdown content for the document."),
-  },
+	name: "update_document",
+	description:
+		"Update an existing document's title and/or content. The server creates a new version on each update.",
+	inputSchema: {
+		id: z.string().describe("Document ID to update."),
+		title: z.string().optional().describe("New title for the document."),
+		content: z
+			.string()
+			.optional()
+			.describe("New markdown content for the document."),
+		folderId: z
+			.string()
+			.nullable()
+			.optional()
+			.describe("Move the document to a folder."),
+		categoryId: z
+			.string()
+			.nullable()
+			.optional()
+			.describe(
+				"Move the document to a category. Category keys cannot escape their configured category.",
+			),
+	},
 } as const;
 
 export interface UpdateDocumentArgs {
-  id: string;
-  title?: string;
-  content?: string;
+	id: string;
+	title?: string;
+	content?: string;
+	folderId?: string | null;
+	categoryId?: string | null;
 }
 
 export async function handler(
-  args: UpdateDocumentArgs,
+	args: UpdateDocumentArgs,
 ): Promise<DocumentDetail> {
-  const { id, ...patch } = args;
-  return (await client.updateDocument(id, patch)) as DocumentDetail;
+	const { id, ...patch } = args;
+	return (await client.updateDocument(id, patch)) as DocumentDetail;
 }

package/skills/docsmint-document-manager/SKILL.md

@@ -0,0 +1,33 @@
+---
+name: docsmint-document-manager
+description: Manage and research DocsMint documents through its scoped MCP tools, including categories, folders, hybrid search, GraphRAG, and index refresh.
+---
+
+# DocsMint Document Manager
+
+Use this skill when an agent must create, organize, edit, or research documents in a DocsMint workspace.
+
+## Safety and access
+
+- Treat the configured API key as the complete authority boundary.
+- A workspace key may manage categories, folders, tags, and documents according to its role.
+- A category key may access only its bound category, folders and documents inside that category, and explicitly granted `read`, `edit`, or `write` operations.
+- Never attempt to manage API keys, members, billing, or workspace settings through document tools.
+- Read a document before changing it. Preserve its language and structure unless the user asks otherwise.
+
+## Retrieval workflow
+
+1. Use `search_documents` with the user's original language.
+2. Read the most relevant documents with `get_document`.
+3. Use `get_related_documents` or `search_knowledge_graph` only with authorized document IDs returned by search.
+4. Cite document IDs and distinguish retrieved facts from inference.
+
+## Document management workflow
+
+1. Inspect `list_categories`, `list_folders`, and `list_tags` before organizing content.
+2. Create categories only with a workspace-scoped key.
+3. Create folders and documents within the active scope.
+4. After an update, inspect `get_document_index_status`; use `refresh_document_index` only when indexing is stale or failed.
+5. Use snapshots before a substantial rewrite when version history is important.
+
+DocsMint owns chunking, embeddings, multilingual hybrid retrieval, entity extraction, and GraphRAG indexing. Agents must use the MCP tools and never write those persistence layers directly.