@hiai-gg/docsmint 0.6.8 → 0.7.0

package/packages/mcp-server/src/server.ts

@@ -1,87 +0,0 @@
-import { McpServer } from '@modelcontextprotocol/server';
-import { z, type ZodRawShape } from 'zod';
-
-import { registerExtendedCapabilities } from './capabilities.js';
-import { client as defaultClient, HiaiDocsError, type HiaiDocsClient } from './client.js';
-import * as createDocument from './tools/create-document.js';
-import * as createFolder from './tools/create-folder.js';
-import * as createSnapshot from './tools/create-snapshot.js';
-import * as exportDocument from './tools/export-document.js';
-import * as getDocument from './tools/get-document.js';
-import * as listDocuments from './tools/list-documents.js';
-import * as listFolders from './tools/list-folders.js';
-import * as search from './tools/search.js';
-import * as updateDocument from './tools/update-document.js';
-import * as versionHistory from './tools/version-history.js';
-
-type ToolHandler = (args: Record<string, unknown>) => Promise<unknown>;
-interface McpToolResult {
-  content: Array<{ type: 'text'; text: string }>;
-  isError?: boolean;
-}
-
-function wrapHandler(
-  name: string,
-  handler: ToolHandler
-): (args: Record<string, unknown>) => Promise<McpToolResult> {
-  return async (args) => {
-    try {
-      return {
-        content: [{ type: 'text', text: JSON.stringify(await handler(args), null, 2) }],
-      };
-    } catch (error) {
-      const message =
-        error instanceof HiaiDocsError
-          ? `DocsMint API error (${error.status}): ${error.message}`
-          : `Tool '${name}' failed: ${error instanceof Error ? error.message : String(error)}`;
-      return { isError: true, content: [{ type: 'text', text: message }] };
-    }
-  };
-}
-
-export function registerDocsmintMcpCapabilities(server: McpServer, client: HiaiDocsClient): void {
-  const register = <Args>(
-    name: string,
-    description: string,
-    inputSchema: ZodRawShape,
-    handler: (args: Args) => Promise<unknown>
-  ): void => {
-    server.registerTool(
-      name,
-      { description, inputSchema: z.object(inputSchema) },
-      wrapHandler(name, handler as ToolHandler) as never
-    );
-  };
-
-  const tools = [
-    search,
-    getDocument,
-    createDocument,
-    updateDocument,
-    listDocuments,
-    listFolders,
-    createFolder,
-    createSnapshot,
-    versionHistory,
-    exportDocument,
-  ] as const;
-  for (const tool of tools) {
-    register(
-      tool.definition.name,
-      tool.definition.description,
-      tool.definition.inputSchema as ZodRawShape,
-      tool.createHandler(client) as ToolHandler
-    );
-  }
-  registerExtendedCapabilities(server, client);
-}
-
-export interface CreateDocsmintMcpServerOptions {
-  client?: HiaiDocsClient;
-}
-
-export function createDocsmintMcpServer(options: CreateDocsmintMcpServerOptions = {}): McpServer {
-  const server = new McpServer({ name: 'docsmint', version: '0.6.8' });
-  registerDocsmintMcpCapabilities(server, options.client ?? defaultClient);
-  return server;
-}

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

@@ -1,34 +0,0 @@
-import { z } from 'zod';
-import { client, type HiaiDocsClient } from '../client.js';
-import type { DocumentDetail } from '../types.js';
-
-export const definition = {
-  name: 'create_document',
-  description:
-    'Create a new document. Optionally provide initial markdown content and a folder ID.',
-  inputSchema: {
-    title: z.string().describe('Document title.'),
-    content: z.string().optional().describe('Initial markdown content for the document.'),
-    folderId: z.string().optional().describe('Optional folder ID to place the document in.'),
-    categoryId: z
-      .string()
-      .optional()
-      .describe(
-        'Optional category ID. Category keys are always rebound to their configured category.'
-      ),
-  },
-} as const;
-
-export interface CreateDocumentArgs {
-  title: string;
-  content?: string;
-  folderId?: string;
-  categoryId?: string;
-}
-
-export const createHandler = (api: HiaiDocsClient) =>
-  async function createDocument(args: CreateDocumentArgs): Promise<DocumentDetail> {
-    return (await api.createDocument(args)) as DocumentDetail;
-  };
-
-export const handler = createHandler(client);

package/packages/mcp-server/src/tools/create-folder.ts

@@ -1,31 +0,0 @@
-import { z } from 'zod';
-import { client, type HiaiDocsClient } from '../client.js';
-import type { Folder } from '../types.js';
-
-export const definition = {
-  name: 'create_folder',
-  description: 'Create a new folder, optionally nested under a parent folder.',
-  inputSchema: {
-    name: z.string().describe('Folder name.'),
-    parentId: z.string().optional().describe('Optional parent folder ID for nesting.'),
-    categoryId: z
-      .string()
-      .optional()
-      .describe(
-        'Optional category ID. Category keys are always rebound to their configured category.'
-      ),
-  },
-} as const;
-
-export interface CreateFolderArgs {
-  name: string;
-  parentId?: string;
-  categoryId?: string;
-}
-
-export const createHandler = (api: HiaiDocsClient) =>
-  async function createFolder(args: CreateFolderArgs): Promise<Folder> {
-    return (await api.createFolder(args)) as Folder;
-  };
-
-export const handler = createHandler(client);

package/packages/mcp-server/src/tools/create-snapshot.ts

@@ -1,27 +0,0 @@
-import { z } from 'zod';
-import { client, type HiaiDocsClient } from '../client.js';
-import type { Version } from '../types.js';
-
-export const definition = {
-  name: 'create_snapshot',
-  description: 'Create a named snapshot (labelled version) of a document from its current content.',
-  inputSchema: {
-    documentId: z.string().describe('Document ID to snapshot.'),
-    label: z.string().describe("Short label for the snapshot (e.g. 'v1.0-release')."),
-    description: z.string().optional().describe('Optional longer description of the snapshot.'),
-  },
-} as const;
-
-export interface CreateSnapshotArgs {
-  documentId: string;
-  label: string;
-  description?: string;
-}
-
-export const createHandler = (api: HiaiDocsClient) =>
-  async function createSnapshot(args: CreateSnapshotArgs): Promise<Version> {
-    const { documentId, ...input } = args;
-    return (await api.createSnapshot(documentId, input)) as Version;
-  };
-
-export const handler = createHandler(client);

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

@@ -1,22 +0,0 @@
-import { z } from 'zod';
-import { client, type HiaiDocsClient } from '../client.js';
-import type { ExportResponse } from '../types.js';
-
-export const definition = {
-  name: 'export_document',
-  description: 'Export a document as markdown. Returns the rendered markdown content.',
-  inputSchema: {
-    id: z.string().describe('Document ID to export.'),
-  },
-} as const;
-
-export interface ExportDocumentArgs {
-  id: string;
-}
-
-export const createHandler = (api: HiaiDocsClient) =>
-  async function exportDocument(args: ExportDocumentArgs): Promise<ExportResponse> {
-    return (await api.exportDocument(args.id)) as ExportResponse;
-  };
-
-export const handler = createHandler(client);

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

@@ -1,22 +0,0 @@
-import { z } from 'zod';
-import { client, type HiaiDocsClient } from '../client.js';
-import type { DocumentDetail } from '../types.js';
-
-export const definition = {
-  name: 'get_document',
-  description: 'Fetch a single document by ID. Returns full content, metadata, and tags.',
-  inputSchema: {
-    id: z.string().describe('Document ID.'),
-  },
-} as const;
-
-export interface GetDocumentArgs {
-  id: string;
-}
-
-export const createHandler = (api: HiaiDocsClient) =>
-  async function getDocument(args: GetDocumentArgs): Promise<DocumentDetail> {
-    return (await api.getDocument(args.id)) as DocumentDetail;
-  };
-
-export const handler = createHandler(client);

package/packages/mcp-server/src/tools/list-documents.ts

@@ -1,34 +0,0 @@
-import { z } from 'zod';
-import { client, type HiaiDocsClient } from '../client.js';
-import type { ListDocumentsResponse } from '../types.js';
-
-export const definition = {
-  name: 'list_documents',
-  description: 'List documents with pagination, optionally filtered by folder or tag.',
-  inputSchema: {
-    folderId: z.string().optional().describe('Optional folder ID to filter by.'),
-    tag: z.string().optional().describe('Optional tag ID to filter by.'),
-    page: z.number().int().positive().optional().describe('Page number (1-indexed, default 1).'),
-    limit: z
-      .number()
-      .int()
-      .positive()
-      .max(100)
-      .optional()
-      .describe('Items per page (default 20, max 100).'),
-  },
-} as const;
-
-export interface ListDocumentsArgs {
-  folderId?: string;
-  tag?: string;
-  page?: number;
-  limit?: number;
-}
-
-export const createHandler = (api: HiaiDocsClient) =>
-  async function listDocuments(args: ListDocumentsArgs): Promise<ListDocumentsResponse> {
-    return (await api.listDocuments(args)) as ListDocumentsResponse;
-  };
-
-export const handler = createHandler(client);

package/packages/mcp-server/src/tools/list-folders.ts

@@ -1,26 +0,0 @@
-import { z } from 'zod';
-import { client, type HiaiDocsClient } from '../client.js';
-import type { Folder } from '../types.js';
-
-export const definition = {
-  name: 'list_folders',
-  description:
-    'List folders, optionally scoped to a parent folder. Returns a flat list of immediate children.',
-  inputSchema: {
-    parentId: z
-      .string()
-      .optional()
-      .describe('Optional parent folder ID. Omit to list top-level (root) folders.'),
-  },
-} as const;
-
-export interface ListFoldersArgs {
-  parentId?: string;
-}
-
-export const createHandler = (api: HiaiDocsClient) =>
-  async function listFolders(args: ListFoldersArgs): Promise<Folder[]> {
-    return (await api.listFolders(args)) as Folder[];
-  };
-
-export const handler = createHandler(client);

package/packages/mcp-server/src/tools/search.ts

@@ -1,39 +0,0 @@
-import { z } from 'zod';
-import { client, type HiaiDocsClient } from '../client.js';
-import type { SearchResponse } from '../types.js';
-
-export const definition = {
-  name: 'search_documents',
-  description:
-    'Hybrid search across documents (full-text + semantic). Supports filtering by folder and tags.',
-  inputSchema: {
-    query: z.string().describe('Search query string.'),
-    folder: z.string().optional().describe('Optional folder ID to scope the search to.'),
-    tags: z.array(z.string()).optional().describe('Optional tag IDs to filter by.'),
-    limit: z
-      .number()
-      .int()
-      .positive()
-      .optional()
-      .describe('Maximum number of results to return (default 20).'),
-  },
-} as const;
-
-export type SearchArgs = {
-  query: string;
-  folder?: string;
-  tags?: string[];
-  limit?: number;
-};
-
-export const createHandler = (api: HiaiDocsClient) =>
-  async function searchDocuments(args: SearchArgs): Promise<SearchResponse> {
-    return (await api.search({
-      query: args.query,
-      folder: args.folder,
-      tags: args.tags,
-      limit: args.limit,
-    })) as SearchResponse;
-  };
-
-export const handler = createHandler(client);

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

@@ -1,38 +0,0 @@
-import { z } from 'zod';
-import { client, type HiaiDocsClient } 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.'),
-    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;
-  folderId?: string | null;
-  categoryId?: string | null;
-}
-
-export const createHandler = (api: HiaiDocsClient) =>
-  async function updateDocument(args: UpdateDocumentArgs): Promise<DocumentDetail> {
-    const { id, ...patch } = args;
-    return (await api.updateDocument(id, patch)) as DocumentDetail;
-  };
-
-export const handler = createHandler(client);

package/packages/mcp-server/src/tools/version-history.ts

@@ -1,27 +0,0 @@
-import { z } from 'zod';
-import { client, type HiaiDocsClient } from '../client.js';
-import type { Version } from '../types.js';
-
-export const definition = {
-  name: 'get_version_history',
-  description: 'List the version history for a document. Optionally restrict to named snapshots.',
-  inputSchema: {
-    documentId: z.string().describe('Document ID whose versions should be listed.'),
-    onlySnapshots: z
-      .boolean()
-      .optional()
-      .describe('When true, only return named snapshots (skip auto-saved revisions).'),
-  },
-} as const;
-
-export interface VersionHistoryArgs {
-  documentId: string;
-  onlySnapshots?: boolean;
-}
-
-export const createHandler = (api: HiaiDocsClient) =>
-  async function getVersionHistory(args: VersionHistoryArgs): Promise<Version[]> {
-    return (await api.getVersionHistory(args.documentId, args.onlySnapshots)) as Version[];
-  };
-
-export const handler = createHandler(client);

package/packages/mcp-server/src/types.ts

@@ -1,126 +0,0 @@
-/**
- * Shared TypeScript types for hiai-docs REST API responses.
- * Keep these minimal — only the fields consumed by MCP tools.
- */
-
-export interface Tag {
-  id: string;
-  name: string;
-  color: string | null;
-}
-
-export interface DocumentSummary {
-  id: string;
-  title: string;
-  content?: string;
-  folderId: string | null;
-  createdAt: string;
-  updatedAt: string;
-  tags?: Tag[];
-}
-
-export interface DocumentDetail {
-  id: string;
-  ownerId: string;
-  folderId: string | null;
-  folderName?: string | null;
-  title: string;
-  content: string;
-  contentJson?: unknown;
-  createdAt: string;
-  updatedAt: string;
-  tags?: Tag[];
-}
-
-export interface SearchResultItem {
-  id: string;
-  title: string;
-  snippet: string;
-  score: number;
-  folder_id: string | null;
-  folder_name: string | null;
-  created_at: string;
-  updated_at: string;
-  tags?: Tag[];
-}
-
-export interface SearchResponse {
-  items: SearchResultItem[];
-  total: number;
-  page: number;
-  limit: number;
-}
-
-export interface ListDocumentsResponse {
-  items: DocumentSummary[];
-  total: number;
-  page: number;
-  limit: number;
-}
-
-export interface Folder {
-  id: string;
-  name: string;
-  parentId: string | null;
-  ownerId: string;
-  createdAt: string;
-  updatedAt: string;
-}
-
-export interface Version {
-  id: string;
-  documentId: string;
-  content: string;
-  contentJson?: unknown;
-  createdBy: string;
-  createdAt: string;
-}
-
-export interface ExportResponse {
-  markdown: string;
-  filename?: string;
-}
-
-export interface CreateDocumentInput {
-  title: string;
-  content?: string;
-  folderId?: string;
-}
-
-export interface UpdateDocumentInput {
-  title?: string;
-  content?: string;
-}
-
-export interface CreateSnapshotInput {
-  label: string;
-  description?: string;
-}
-
-export interface CreateFolderInput {
-  name: string;
-  parentId?: string;
-}
-
-export interface SearchInput {
-  query: string;
-  folder?: string;
-  tags?: string[];
-  limit?: number;
-}
-
-export interface ListDocumentsInput {
-  folderId?: string;
-  tag?: string;
-  page?: number;
-  limit?: number;
-}
-
-export interface ListFoldersInput {
-  parentId?: string;
-}
-
-export interface VersionHistoryInput {
-  documentId: string;
-  onlySnapshots?: boolean;
-}