@hiai-gg/docsmint 0.6.0 → 0.6.2

package/dist/backend-account-runtime-cleanup.js

@@ -46,6 +46,7 @@ __export(exports_schema, {
   documentRelations: () => documentRelations,
   documentPipelineRuns: () => documentPipelineRuns,
   documentPipelineBatches: () => documentPipelineBatches,
+  documentKnowledgeSummaries: () => documentKnowledgeSummaries,
   documentEmbeddings: () => documentEmbeddings,
   documentEmbeddingRelations: () => documentEmbeddingRelations,
   documentCreateOperations: () => documentCreateOperations,
@@ -310,6 +311,22 @@ var documentPipelineBatches = pgTable("document_pipeline_batches", {
   index("document_pipeline_batches_stage_status_available_idx").on(table.stage, table.status, table.availableAt),
   index("document_pipeline_batches_document_id_idx").on(table.documentId)
 ]);
+var documentKnowledgeSummaries = pgTable("document_knowledge_summaries", {
+  id: uuid().primaryKey().defaultRandom(),
+  document_id: uuid().notNull().references(() => documents.id, { onDelete: "cascade" }),
+  owner_id: uuid().notNull().references(() => users.id, { onDelete: "cascade" }),
+  workspace_id: text(),
+  generation_id: uuid().notNull(),
+  revision: text().notNull(),
+  language: text().notNull(),
+  description: text().notNull(),
+  keywords: text().array().notNull().default(sql`ARRAY[]::text[]`),
+  created_at: timestamp().defaultNow().notNull(),
+  updated_at: timestamp().defaultNow().notNull()
+}, (table) => [
+  uniqueIndex("document_knowledge_summaries_document_generation_idx").on(table.document_id, table.generation_id),
+  index("document_knowledge_summaries_owner_document_idx").on(table.owner_id, table.document_id)
+]);
 var tags = pgTable("tags", {
   id: uuid("id").primaryKey().defaultRandom(),
   ownerId: uuid("owner_id").notNull().references(() => users.id, { onDelete: "cascade" }),

package/dist/backend-api-key-facade.js

@@ -46,6 +46,7 @@ __export(exports_schema, {
   documentRelations: () => documentRelations,
   documentPipelineRuns: () => documentPipelineRuns,
   documentPipelineBatches: () => documentPipelineBatches,
+  documentKnowledgeSummaries: () => documentKnowledgeSummaries,
   documentEmbeddings: () => documentEmbeddings,
   documentEmbeddingRelations: () => documentEmbeddingRelations,
   documentCreateOperations: () => documentCreateOperations,
@@ -310,6 +311,22 @@ var documentPipelineBatches = pgTable("document_pipeline_batches", {
   index("document_pipeline_batches_stage_status_available_idx").on(table.stage, table.status, table.availableAt),
   index("document_pipeline_batches_document_id_idx").on(table.documentId)
 ]);
+var documentKnowledgeSummaries = pgTable("document_knowledge_summaries", {
+  id: uuid().primaryKey().defaultRandom(),
+  document_id: uuid().notNull().references(() => documents.id, { onDelete: "cascade" }),
+  owner_id: uuid().notNull().references(() => users.id, { onDelete: "cascade" }),
+  workspace_id: text(),
+  generation_id: uuid().notNull(),
+  revision: text().notNull(),
+  language: text().notNull(),
+  description: text().notNull(),
+  keywords: text().array().notNull().default(sql`ARRAY[]::text[]`),
+  created_at: timestamp().defaultNow().notNull(),
+  updated_at: timestamp().defaultNow().notNull()
+}, (table) => [
+  uniqueIndex("document_knowledge_summaries_document_generation_idx").on(table.document_id, table.generation_id),
+  index("document_knowledge_summaries_owner_document_idx").on(table.owner_id, table.document_id)
+]);
 var tags = pgTable("tags", {
   id: uuid("id").primaryKey().defaultRandom(),
   ownerId: uuid("owner_id").notNull().references(() => users.id, { onDelete: "cascade" }),

package/dist/backend-pipeline-cancellation.js

@@ -46,6 +46,7 @@ __export(exports_schema, {
   documentRelations: () => documentRelations,
   documentPipelineRuns: () => documentPipelineRuns,
   documentPipelineBatches: () => documentPipelineBatches,
+  documentKnowledgeSummaries: () => documentKnowledgeSummaries,
   documentEmbeddings: () => documentEmbeddings,
   documentEmbeddingRelations: () => documentEmbeddingRelations,
   documentCreateOperations: () => documentCreateOperations,
@@ -310,6 +311,22 @@ var documentPipelineBatches = pgTable("document_pipeline_batches", {
   index("document_pipeline_batches_stage_status_available_idx").on(table.stage, table.status, table.availableAt),
   index("document_pipeline_batches_document_id_idx").on(table.documentId)
 ]);
+var documentKnowledgeSummaries = pgTable("document_knowledge_summaries", {
+  id: uuid().primaryKey().defaultRandom(),
+  document_id: uuid().notNull().references(() => documents.id, { onDelete: "cascade" }),
+  owner_id: uuid().notNull().references(() => users.id, { onDelete: "cascade" }),
+  workspace_id: text(),
+  generation_id: uuid().notNull(),
+  revision: text().notNull(),
+  language: text().notNull(),
+  description: text().notNull(),
+  keywords: text().array().notNull().default(sql`ARRAY[]::text[]`),
+  created_at: timestamp().defaultNow().notNull(),
+  updated_at: timestamp().defaultNow().notNull()
+}, (table) => [
+  uniqueIndex("document_knowledge_summaries_document_generation_idx").on(table.document_id, table.generation_id),
+  index("document_knowledge_summaries_owner_document_idx").on(table.owner_id, table.document_id)
+]);
 var tags = pgTable("tags", {
   id: uuid("id").primaryKey().defaultRandom(),
   ownerId: uuid("owner_id").notNull().references(() => users.id, { onDelete: "cascade" }),

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, DocsCategoryInput, DocsCategoryUpdate, DocsDocument, DocsDocumentCreateInput, DocsDocumentCursorPage, DocsDocumentListResponse, DocsDocumentPipeline, 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, DocsCategoryInput, DocsCategoryUpdate, DocsDocument, DocsDocumentCreateInput, DocsDocumentCursorPage, DocsDocumentIndexRefresh, DocsDocumentIndexStatus, DocsDocumentKnowledgeSummary, DocsDocumentListResponse, DocsDocumentPipeline, DocsDocumentUpdateInput, DocsFolder, DocsFolderCreateInput, DocsFolderUpdateInput, DocsGraphEntitiesResponse, DocsGraphRelatedResponse, DocsGraphSearchResponse, DocsHealthResponse, DocsRequestContext, DocsSearchOptions, DocsSearchResponse, DocsSearchSuggestItem, DocsSharedContent, DocsShareLink, DocsShareListResponse, DocsShareRole, DocsTag, DocsVersion, DocsVersionDiff } from "./types.js";
 export interface DocsClientConfig {
     /** Base URL of the hiai-docs API, e.g. `http://localhost:50700`. */
     baseUrl: string;
@@ -81,6 +81,9 @@ export declare class DocsClient {
     }, context?: DocsRequestContext): Promise<DocsDocumentCursorPage>;
     duplicateDoc(id: string, context?: DocsRequestContext): Promise<DocsDocument>;
     getDocumentPipeline(id: string, context?: DocsRequestContext): Promise<DocsDocumentPipeline>;
+    getDocumentKnowledgeSummary(id: string, context?: DocsRequestContext): Promise<DocsDocumentKnowledgeSummary>;
+    getDocumentIndexStatus(id: string, context?: DocsRequestContext): Promise<DocsDocumentIndexStatus>;
+    refreshDocumentIndex(id: string, context?: DocsRequestContext): Promise<DocsDocumentIndexRefresh>;
     publishDoc(id: string, context?: DocsRequestContext): Promise<DocsDocument>;
     unpublishDoc(id: string, context?: DocsRequestContext): Promise<DocsDocument>;
     /**

package/dist/client.js

@@ -123,6 +123,15 @@ export class DocsClient {
     async getDocumentPipeline(id, context) {
         return this.request("GET", `/api/documents/${encodeURIComponent(id)}/pipeline`, undefined, context);
     }
+    async getDocumentKnowledgeSummary(id, context) {
+        return this.request("GET", `/api/documents/${encodeURIComponent(id)}/knowledge-summary`, undefined, context);
+    }
+    async getDocumentIndexStatus(id, context) {
+        return this.request("GET", `/api/documents/${encodeURIComponent(id)}/index-status`, undefined, context);
+    }
+    async refreshDocumentIndex(id, context) {
+        return this.request("POST", `/api/documents/${encodeURIComponent(id)}/index/refresh`, undefined, context);
+    }
     async publishDoc(id, context) {
         return this.request("POST", `/api/documents/${encodeURIComponent(id)}/publish`, undefined, context);
     }

package/dist/lifecycle-runtime.js

@@ -252,6 +252,22 @@ var documentPipelineBatches = pgTable("document_pipeline_batches", {
   index("document_pipeline_batches_stage_status_available_idx").on(table.stage, table.status, table.availableAt),
   index("document_pipeline_batches_document_id_idx").on(table.documentId)
 ]);
+var documentKnowledgeSummaries = pgTable("document_knowledge_summaries", {
+  id: uuid().primaryKey().defaultRandom(),
+  document_id: uuid().notNull().references(() => documents.id, { onDelete: "cascade" }),
+  owner_id: uuid().notNull().references(() => users.id, { onDelete: "cascade" }),
+  workspace_id: text(),
+  generation_id: uuid().notNull(),
+  revision: text().notNull(),
+  language: text().notNull(),
+  description: text().notNull(),
+  keywords: text().array().notNull().default(sql`ARRAY[]::text[]`),
+  created_at: timestamp().defaultNow().notNull(),
+  updated_at: timestamp().defaultNow().notNull()
+}, (table) => [
+  uniqueIndex("document_knowledge_summaries_document_generation_idx").on(table.document_id, table.generation_id),
+  index("document_knowledge_summaries_owner_document_idx").on(table.owner_id, table.document_id)
+]);
 var tags = pgTable("tags", {
   id: uuid("id").primaryKey().defaultRandom(),
   ownerId: uuid("owner_id").notNull().references(() => users.id, { onDelete: "cascade" }),

package/dist/types.d.ts

@@ -356,6 +356,32 @@ export interface DocsDocumentPipeline {
     };
     updatedAt: string;
 }
+export interface DocsDocumentKnowledgeSummary {
+    documentId: string;
+    generationId: string;
+    revision: string;
+    language: string;
+    description: string;
+    keywords: string[];
+    createdAt: string;
+    updatedAt: string;
+}
+export interface DocsDocumentIndexStatus {
+    documentId: string;
+    embeddingStatus: "pending" | "processing" | "ready" | "failed" | "stale";
+    activeGenerationId: string | null;
+    pendingGenerationId: string | null;
+    embeddingProfile: string | null;
+    embeddingErrorCode: string | null;
+    embeddingUpdatedAt: string | null;
+    searchable: boolean;
+    pipeline: DocsDocumentPipeline | null;
+}
+export interface DocsDocumentIndexRefresh {
+    documentId: string;
+    generationId: string;
+    deduplicated: boolean;
+}
 export interface DocsVersion {
     id: string;
     documentId: string;

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@hiai-gg/docsmint",
-  "version": "0.6.0",
+  "mcpName": "io.github.hiai-gg/docsmint",
+  "version": "0.6.2",
   "type": "module",
   "browser": {
     "./dist/backend-launcher.js": false,
@@ -57,6 +58,10 @@
       "import": "./dist/index.js",
       "types": "./dist/index.d.ts"
     },
+    "./mcp": {
+      "import": "./packages/mcp-server/src/server.ts",
+      "types": "./packages/mcp-server/src/server.ts"
+    },
     "./lifecycle": {
       "browser": "./dist/server-only-browser-entry.js",
       "import": "./dist/lifecycle.js",
@@ -349,8 +354,12 @@
     "packages/cli/src/format.ts",
     "packages/cli/src/commands",
     "packages/mcp-server/src/client.ts",
+    "packages/mcp-server/src/index.ts",
+    "packages/mcp-server/src/server.ts",
+    "packages/mcp-server/src/capabilities.ts",
     "packages/mcp-server/src/types.ts",
     "packages/mcp-server/src/tools",
+    "skills",
     "backend/src/lib/redis-factory.ts",
     "backend/src/lib/storage-factory.ts",
     "backend/src/lib/logger.ts",
@@ -358,6 +367,7 @@
     "backend/src/lib/api-keys.ts",
     "backend/src/lib/api-key-encryption.ts",
     "backend/src/lib/lifecycle-service.ts",
+    "server.json",
     "README.md",
     "LICENSE"
   ],
@@ -376,7 +386,7 @@
     "prepublishOnly": "cd packages/sdk && bun run build"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.12.1",
+    "@modelcontextprotocol/server": "2.0.0",
     "bullmq": "^5.80.2",
     "commander": "^13.1.0",
     "ioredis": "^5.11.1",

package/packages/cli/src/index.ts

@@ -24,7 +24,7 @@ import { registerSearch } from "./commands/search.js";
 import { registerSnapshot } from "./commands/snapshot.js";
 import { registerUpdate } from "./commands/update.js";
 
-const VERSION = "0.6.0";
+const VERSION = "0.6.2";
 
 const program = new Command();
 program

package/packages/db/src/index.ts

@@ -1,14 +1,23 @@
-export * from "./schema";
-export { db, client } from "./client";
 export type { Database } from "./client";
+export { client, db } from "./client";
+export type {
+	CreateDocumentWithVersionInput,
+	UpdateDocumentWithVersionInput,
+} from "./document-writer";
 export {
-	withTenant,
-	adminTenantContext,
-	shareGuestTenantContext,
-	createActorScopedTransactionExecutor,
-} from "./with-tenant";
+	createDocumentWithVersion,
+	trashDocuments,
+	updateDocumentWithVersion,
+} from "./document-writer";
+export * from "./schema";
 export type {
 	ActorScopedTransactionExecutor,
 	TenantContext,
 	TenantTransaction,
 } from "./with-tenant";
+export {
+	adminTenantContext,
+	createActorScopedTransactionExecutor,
+	shareGuestTenantContext,
+	withTenant,
+} from "./with-tenant";

package/packages/db/src/schema.ts

@@ -354,6 +354,40 @@ export const documentPipelineBatches = pgTable(
   ],
 );
 
+// ============================================
+// document_knowledge_summaries — generation-scoped retrieval metadata
+// ============================================
+export const documentKnowledgeSummaries = pgTable(
+	"document_knowledge_summaries",
+	{
+		id: uuid().primaryKey().defaultRandom(),
+		document_id: uuid()
+			.notNull()
+			.references(() => documents.id, { onDelete: "cascade" }),
+		owner_id: uuid()
+			.notNull()
+			.references(() => users.id, { onDelete: "cascade" }),
+		workspace_id: text(),
+		generation_id: uuid().notNull(),
+		revision: text().notNull(),
+		language: text().notNull(),
+		description: text().notNull(),
+		keywords: text().array().notNull().default(sql`ARRAY[]::text[]`),
+		created_at: timestamp().defaultNow().notNull(),
+		updated_at: timestamp().defaultNow().notNull(),
+	},
+	(table) => [
+		uniqueIndex("document_knowledge_summaries_document_generation_idx").on(
+			table.document_id,
+			table.generation_id,
+		),
+		index("document_knowledge_summaries_owner_document_idx").on(
+			table.owner_id,
+			table.document_id,
+		),
+	],
+);
+
 // ============================================
 // tags — document tags
 // ============================================

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

@@ -0,0 +1,189 @@
+import type { McpServer } from '@modelcontextprotocol/server';
+import { z } from 'zod';
+
+import type { HiaiDocsClient } from './client.js';
+
+export const capabilityCatalog = {
+  tools: [
+    'search_documents',
+    'get_document',
+    'create_document',
+    'update_document',
+    'list_documents',
+    'list_folders',
+    'create_folder',
+    'create_snapshot',
+    'get_version_history',
+    'export_document',
+    'list_categories',
+    'create_category',
+    'list_tags',
+    'get_related_documents',
+    'search_knowledge_graph',
+    'get_document_index_status',
+    'refresh_document_index',
+  ] as const,
+  prompts: ['organize_workspace', 'research_workspace'] as const,
+  resources: [
+    'docsmint://guide/editor',
+    'docsmint://guide/search',
+    'docsmint://workspace/catalog',
+  ] as const,
+};
+
+type TextResult = { content: Array<{ type: 'text'; text: string }> };
+
+function jsonResult(value: unknown): TextResult {
+  return { content: [{ type: 'text', text: JSON.stringify(value, null, 2) }] };
+}
+
+export function registerExtendedCapabilities(server: McpServer, client: HiaiDocsClient): void {
+  server.registerTool(
+    'list_categories',
+    {
+      description:
+        'List categories visible to the API key. Category keys receive only their bound category.',
+      inputSchema: z.object({}),
+    },
+    async () => jsonResult(await client.listCategories())
+  );
+  server.registerTool(
+    'create_category',
+    {
+      description:
+        'Create a category. Requires a workspace key with write access; category keys cannot mutate categories.',
+      inputSchema: z.object({
+        name: z.string().min(1),
+        description: z.string().optional(),
+      }),
+    },
+    async (input) => jsonResult(await client.createCategory(input))
+  );
+  server.registerTool(
+    'list_tags',
+    {
+      description: 'List tags visible in the workspace or bound category.',
+      inputSchema: z.object({}),
+    },
+    async () => jsonResult(await client.listTags())
+  );
+  server.registerTool(
+    'get_related_documents',
+    {
+      description: 'Traverse the knowledge graph from one authorized document.',
+      inputSchema: z.object({
+        documentId: z.string().min(1),
+        limit: z.number().int().min(1).max(50).optional(),
+      }),
+    },
+    async ({ documentId, limit }) => jsonResult(await client.getRelatedDocuments(documentId, limit))
+  );
+  server.registerTool(
+    'search_knowledge_graph',
+    {
+      description:
+        'Search connected knowledge using authorized seed documents. Category keys may use only documents in their category.',
+      inputSchema: z.object({
+        query: z.string().min(1).max(1000),
+        docIds: z.array(z.string().min(1)).min(1),
+        limit: z.number().int().min(1).max(50).optional(),
+      }),
+    },
+    async (input) => jsonResult(await client.searchGraph(input))
+  );
+  server.registerTool(
+    'get_document_index_status',
+    {
+      description: 'Read the current indexing and knowledge-pipeline status of a document.',
+      inputSchema: z.object({ documentId: z.string().min(1) }),
+    },
+    async ({ documentId }) => jsonResult(await client.getDocumentIndexStatus(documentId))
+  );
+  server.registerTool(
+    'refresh_document_index',
+    {
+      description: 'Request reindexing after a document or metadata change. Requires write access.',
+      inputSchema: z.object({ documentId: z.string().min(1) }),
+    },
+    async ({ documentId }) => jsonResult(await client.refreshDocumentIndex(documentId))
+  );
+
+  server.registerPrompt(
+    'organize_workspace',
+    {
+      description: 'Plan safe document organization using DocsMint categories and folders.',
+      argsSchema: z.object({
+        objective: z.string(),
+        language: z.string().optional(),
+      }),
+    },
+    ({ objective, language }) => ({
+      messages: [
+        {
+          role: 'user',
+          content: {
+            type: 'text',
+            text: `Organize this DocsMint workspace for: ${objective}. Work in ${language ?? 'the document language'}. Inspect categories, folders, tags, and documents before proposing or applying changes. Preserve document content and obey the API key scope.`,
+          },
+        },
+      ],
+    })
+  );
+  server.registerPrompt(
+    'research_workspace',
+    {
+      description:
+        'Research a question with hybrid search and GraphRAG while citing DocsMint document IDs.',
+      argsSchema: z.object({
+        question: z.string(),
+        language: z.string().optional(),
+      }),
+    },
+    ({ question, language }) => ({
+      messages: [
+        {
+          role: 'user',
+          content: {
+            type: 'text',
+            text: `Answer this question from DocsMint: ${question}. Respond in ${language ?? 'the question language'}. Start with hybrid search, use graph traversal only from authorized result documents, and cite document IDs. Distinguish retrieved facts from inference.`,
+          },
+        },
+      ],
+    })
+  );
+
+  server.registerResource('editor-guide', 'docsmint://guide/editor', {}, async (uri) => ({
+    contents: [
+      {
+        uri: uri.href,
+        mimeType: 'text/markdown',
+        text: '# DocsMint editing rules\n\nRead a document before updating it. Preserve its language, title intent, TipTap/Markdown structure, category, folder, and tags unless the user explicitly requests a change. After content changes, verify index status and request refresh only when needed.',
+      },
+    ],
+  }));
+  server.registerResource('search-guide', 'docsmint://guide/search', {}, async (uri) => ({
+    contents: [
+      {
+        uri: uri.href,
+        mimeType: 'text/markdown',
+        text: '# DocsMint retrieval rules\n\nUse search_documents for normal retrieval. Use get_related_documents or search_knowledge_graph only with document IDs already authorized by the active API key. Keep multilingual queries in their original language and cite document IDs in answers.',
+      },
+    ],
+  }));
+  server.registerResource('workspace-catalog', 'docsmint://workspace/catalog', {}, async (uri) => {
+    const [categories, folders, tags] = await Promise.all([
+      client.listCategories(),
+      client.listFolders({}),
+      client.listTags(),
+    ]);
+    return {
+      contents: [
+        {
+          uri: uri.href,
+          mimeType: 'application/json',
+          text: JSON.stringify({ categories, folders, tags }, null, 2),
+        },
+      ],
+    };
+  });
+}