@dobbyai/mcp-external 1.1.0 → 1.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dobbyai/mcp-external",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "mcpName": "io.github.gil-dobby/dobby",
   "description": "MCP Server for Dobby AI Platform - Connect from Claude Desktop, Cursor, Windsurf, and more",
   "type": "module",
@@ -35,11 +35,12 @@
   "author": "Dobby AI Platform",
   "license": "MIT",
   "dependencies": {
+    "@dobbyai/capability-core": "^0.1.8",
     "@modelcontextprotocol/sdk": "^1.26.0",
     "commander": "^12.0.0",
     "cors": "^2.8.5",
-    "dotenv": "^16.4.0",
-    "express": "^4.21.0",
+    "dotenv": "^17.4.2",
+    "express": "^5.2.1",
     "inquirer": "^9.2.0",
     "node-fetch": "^3.3.0",
     "zod": "^3.22.0"
@@ -49,10 +50,10 @@
     "@types/express": "^5.0.0",
     "@types/inquirer": "^9.0.0",
     "@types/node": "^20.0.0",
-    "shx": "^0.3.4",
+    "shx": "^0.4.0",
     "tsx": "^4.7.0",
-    "typescript": "^5.3.0",
-    "vitest": "^1.2.0"
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.8"
   },
   "engines": {
     "node": ">=18.0.0"

package/dist/tools/knowledge-base.d.ts

@@ -1,144 +0,0 @@
-/**
- * Knowledge Base Tools
- *
- * MCP tools for searching and browsing the tenant's knowledge base.
- * Enables Claude Desktop / Cursor users to access organizational knowledge.
- *
- * Tools:
- * - search_knowledge_base: Semantic search over indexed documents
- * - list_knowledge_documents: List all indexed documents
- * - get_knowledge_document: Get document details and chunks
- */
-import { DobbyClient } from '../lib/dobby-client.js';
-export declare const knowledgeBaseTools: {
-    search_knowledge_base: {
-        name: string;
-        description: string;
-        inputSchema: {
-            type: "object";
-            properties: {
-                query: {
-                    type: string;
-                    description: string;
-                };
-                top_k: {
-                    type: string;
-                    description: string;
-                };
-                min_similarity: {
-                    type: string;
-                    description: string;
-                };
-            };
-            required: string[];
-        };
-    };
-    list_knowledge_documents: {
-        name: string;
-        description: string;
-        inputSchema: {
-            type: "object";
-            properties: {
-                status: {
-                    type: string;
-                    enum: string[];
-                    description: string;
-                };
-                limit: {
-                    type: string;
-                    description: string;
-                };
-            };
-        };
-    };
-    get_knowledge_document: {
-        name: string;
-        description: string;
-        inputSchema: {
-            type: "object";
-            properties: {
-                document_id: {
-                    type: string;
-                    description: string;
-                };
-            };
-            required: string[];
-        };
-    };
-};
-export declare function handleSearchKnowledgeBase(client: DobbyClient, args: {
-    query: string;
-    top_k?: number;
-    min_similarity?: number;
-}): Promise<{
-    error: any;
-    message?: undefined;
-    query?: undefined;
-    total_chunks_searched?: undefined;
-    results?: undefined;
-    query_id?: undefined;
-    latency_ms?: undefined;
-} | {
-    message: string;
-    query: string;
-    total_chunks_searched: any;
-    error?: undefined;
-    results?: undefined;
-    query_id?: undefined;
-    latency_ms?: undefined;
-} | {
-    results: any;
-    query_id: any;
-    latency_ms: any;
-    total_chunks_searched: any;
-    error?: undefined;
-    message?: undefined;
-    query?: undefined;
-}>;
-export declare function handleListKnowledgeDocuments(client: DobbyClient, args: {
-    status?: string;
-    limit?: number;
-}): Promise<{
-    error: any;
-    message?: undefined;
-    documents?: undefined;
-    total?: undefined;
-} | {
-    message: string;
-    error?: undefined;
-    documents?: undefined;
-    total?: undefined;
-} | {
-    documents: any;
-    total: any;
-    error?: undefined;
-    message?: undefined;
-}>;
-export declare function handleGetKnowledgeDocument(client: DobbyClient, args: {
-    document_id: string;
-}): Promise<{
-    error: any;
-    id?: undefined;
-    title?: undefined;
-    type?: undefined;
-    status?: undefined;
-    source?: undefined;
-    chunks?: undefined;
-    tokens?: undefined;
-    size_bytes?: undefined;
-    created?: undefined;
-    indexed?: undefined;
-} | {
-    id: any;
-    title: any;
-    type: any;
-    status: any;
-    source: any;
-    chunks: any;
-    tokens: any;
-    size_bytes: any;
-    created: any;
-    indexed: any;
-    error: any;
-}>;
-//# sourceMappingURL=knowledge-base.d.ts.map

package/dist/tools/knowledge-base.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"knowledge-base.d.ts","sourceRoot":"","sources":["../../src/tools/knowledge-base.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAMrD,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyD9B,CAAC;AAMF,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;;;;;;;;;;;;;;;GA2CjE;AAED,wBAAsB,4BAA4B,CAChD,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;;;;;;GA2C1C;AAED,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;;;;;;;;;;;;;;;GAiC9B"}

package/dist/tools/knowledge-base.js

@@ -1,179 +0,0 @@
-/**
- * Knowledge Base Tools
- *
- * MCP tools for searching and browsing the tenant's knowledge base.
- * Enables Claude Desktop / Cursor users to access organizational knowledge.
- *
- * Tools:
- * - search_knowledge_base: Semantic search over indexed documents
- * - list_knowledge_documents: List all indexed documents
- * - get_knowledge_document: Get document details and chunks
- */
-// ============================================
-// Tool Definitions
-// ============================================
-export const knowledgeBaseTools = {
-    search_knowledge_base: {
-        name: 'search_knowledge_base',
-        description: 'Search the organization\'s knowledge base using semantic search. Returns relevant document chunks ranked by similarity. Use this to find coding conventions, architecture decisions, security policies, or any organizational knowledge before starting a task.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                query: {
-                    type: 'string',
-                    description: 'Natural language search query (e.g., "API naming conventions", "database migration process", "security requirements")',
-                },
-                top_k: {
-                    type: 'number',
-                    description: 'Maximum results to return (default: 5, max: 20)',
-                },
-                min_similarity: {
-                    type: 'number',
-                    description: 'Minimum similarity threshold 0-1 (default: 0.7). Lower values return more results.',
-                },
-            },
-            required: ['query'],
-        },
-    },
-    list_knowledge_documents: {
-        name: 'list_knowledge_documents',
-        description: 'List all indexed documents in the organization\'s knowledge base. Shows document titles, types, status, and chunk counts.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                status: {
-                    type: 'string',
-                    enum: ['indexed', 'pending', 'processing', 'failed'],
-                    description: 'Filter by document status (default: all)',
-                },
-                limit: {
-                    type: 'number',
-                    description: 'Maximum documents to return (default: 20)',
-                },
-            },
-        },
-    },
-    get_knowledge_document: {
-        name: 'get_knowledge_document',
-        description: 'Get detailed information about a specific document in the knowledge base, including its metadata and chunk count.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                document_id: {
-                    type: 'string',
-                    description: 'The document ID (e.g., "doc_abc123...")',
-                },
-            },
-            required: ['document_id'],
-        },
-    },
-};
-// ============================================
-// Handlers
-// ============================================
-export async function handleSearchKnowledgeBase(client, args) {
-    const tenantId = client.tenantId;
-    if (!tenantId) {
-        return { error: 'No tenant context. Set tenant_id in MCP configuration.' };
-    }
-    try {
-        const response = await client.post(`/api/v1/tenants/${tenantId}/knowledge/search`, {
-            query: args.query,
-            top_k: args.top_k ?? 5,
-            min_similarity: args.min_similarity ?? 0.7,
-        });
-        if (!response.success) {
-            return { error: response.error || 'Search failed' };
-        }
-        const data = response.data;
-        const results = data.results || [];
-        if (results.length === 0) {
-            return {
-                message: 'No matching documents found.',
-                query: args.query,
-                total_chunks_searched: data.total_chunks_searched || 0,
-            };
-        }
-        return {
-            results: results.map((r) => ({
-                document: r.document_title,
-                content: r.content,
-                similarity: `${(r.similarity * 100).toFixed(1)}%`,
-                chunk_index: r.chunk_index,
-            })),
-            query_id: data.query_id,
-            latency_ms: data.latency_ms,
-            total_chunks_searched: data.total_chunks_searched,
-        };
-    }
-    catch (error) {
-        return { error: `Knowledge search failed: ${error.message}` };
-    }
-}
-export async function handleListKnowledgeDocuments(client, args) {
-    const tenantId = client.tenantId;
-    if (!tenantId) {
-        return { error: 'No tenant context. Set tenant_id in MCP configuration.' };
-    }
-    try {
-        const params = new URLSearchParams();
-        if (args.status)
-            params.set('status', args.status);
-        params.set('limit', String(args.limit ?? 20));
-        const response = await client.get(`/api/v1/tenants/${tenantId}/knowledge/documents?${params.toString()}`);
-        if (!response.success) {
-            return { error: response.error || 'Failed to list documents' };
-        }
-        const data = response.data;
-        const docs = data.documents || [];
-        if (docs.length === 0) {
-            return { message: 'No documents in knowledge base. Upload documents via the Dobby dashboard.' };
-        }
-        return {
-            documents: docs.map((d) => ({
-                id: d.document_id,
-                title: d.title,
-                type: d.mime_type,
-                status: d.status,
-                chunks: d.chunk_count,
-                tokens: d.total_tokens,
-                size: d.file_size_bytes,
-                created: d.created_at,
-            })),
-            total: data.total,
-        };
-    }
-    catch (error) {
-        return { error: `Failed to list documents: ${error.message}` };
-    }
-}
-export async function handleGetKnowledgeDocument(client, args) {
-    const tenantId = client.tenantId;
-    if (!tenantId) {
-        return { error: 'No tenant context. Set tenant_id in MCP configuration.' };
-    }
-    try {
-        const response = await client.get(`/api/v1/tenants/${tenantId}/knowledge/documents/${args.document_id}`);
-        if (!response.success) {
-            return { error: response.error || 'Document not found' };
-        }
-        const doc = response.data;
-        return {
-            id: doc.document_id,
-            title: doc.title,
-            type: doc.mime_type,
-            status: doc.status,
-            source: doc.source_type,
-            chunks: doc.chunk_count,
-            tokens: doc.total_tokens,
-            size_bytes: doc.file_size_bytes,
-            created: doc.created_at,
-            indexed: doc.indexed_at,
-            error: doc.error_message || undefined,
-        };
-    }
-    catch (error) {
-        return { error: `Failed to get document: ${error.message}` };
-    }
-}
-//# sourceMappingURL=knowledge-base.js.map

package/dist/tools/knowledge-base.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"knowledge-base.js","sourceRoot":"","sources":["../../src/tools/knowledge-base.ts"],"names":[],"mappings":"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"}