@contiva/sapbtp-docs-mcp 1.0.1

package/build/tools/list-topics.js

@@ -0,0 +1,63 @@
+/**
+ * List topics tool handler
+ */
+export class ListTopicsTool {
+    topicIndex;
+    constructor(topicIndex) {
+        this.topicIndex = topicIndex;
+    }
+    /**
+     * Lists documentation topics in hierarchical structure
+     */
+    async execute(input) {
+        const { area, depth = 2, parentPath } = input;
+        if (parentPath) {
+            // Get topics under specific parent
+            const topics = this.topicIndex.getTopicsUnderPath(area, parentPath);
+            return {
+                area,
+                topics,
+                totalTopics: topics.length,
+            };
+        }
+        // Get topics with depth limit
+        const topics = this.topicIndex.getTopicsWithDepth(area, depth);
+        return {
+            area,
+            topics,
+            totalTopics: this.topicIndex.getHierarchy(area)?.totalTopics || 0,
+        };
+    }
+    /**
+     * Gets the tool schema for MCP
+     */
+    static getSchema() {
+        return {
+            name: 'list_topics',
+            description: 'List documentation topics in a hierarchical structure. Can show the entire TOC or a specific section.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    area: {
+                        type: 'string',
+                        enum: ['ISuite', 'apim'],
+                        description: 'Documentation area to list topics for (ci area does not have an index)'
+                    },
+                    depth: {
+                        type: 'number',
+                        description: 'How many levels deep to show (1-5)',
+                        default: 2,
+                        minimum: 1,
+                        maximum: 5
+                    },
+                    parentPath: {
+                        type: 'string',
+                        description: 'Show topics under this parent path only (optional)'
+                    }
+                },
+                required: ['area']
+            }
+        };
+    }
+}
+//# sourceMappingURL=list-topics.js.map

package/build/tools/list-topics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-topics.js","sourceRoot":"","sources":["../../src/tools/list-topics.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,OAAO,cAAc;IACL;IAApB,YAAoB,UAAsB;QAAtB,eAAU,GAAV,UAAU,CAAY;IAAG,CAAC;IAE9C;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,KAAsB;QAClC,MAAM,EAAE,IAAI,EAAE,KAAK,GAAG,CAAC,EAAE,UAAU,EAAE,GAAG,KAAK,CAAC;QAE9C,IAAI,UAAU,EAAE,CAAC;YACf,mCAAmC;YACnC,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,kBAAkB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;YAEpE,OAAO;gBACL,IAAI;gBACJ,MAAM;gBACN,WAAW,EAAE,MAAM,CAAC,MAAM;aAC3B,CAAC;QACJ,CAAC;QAED,8BAA8B;QAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,kBAAkB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAE/D,OAAO;YACL,IAAI;YACJ,MAAM;YACN,WAAW,EAAE,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,WAAW,IAAI,CAAC;SAClE,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,SAAS;QACd,OAAO;YACL,IAAI,EAAE,aAAa;YACnB,WAAW,EAAE,uGAAuG;YACpH,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,IAAI,EAAE;wBACJ,IAAI,EAAE,QAAQ;wBACd,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC;wBACxB,WAAW,EAAE,wEAAwE;qBACtF;oBACD,KAAK,EAAE;wBACL,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,oCAAoC;wBACjD,OAAO,EAAE,CAAC;wBACV,OAAO,EAAE,CAAC;wBACV,OAAO,EAAE,CAAC;qBACX;oBACD,UAAU,EAAE;wBACV,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,oDAAoD;qBAClE;iBACF;gBACD,QAAQ,EAAE,CAAC,MAAM,CAAC;aACnB;SACF,CAAC;IACJ,CAAC;CACF"}

package/build/tools/read-article.d.ts

@@ -0,0 +1,42 @@
+import type { ReadArticleInput, ReadArticleOutput } from '../types/index.js';
+import { FileRegistry } from '../indexing/file-registry.js';
+import { FileCache } from '../cache/file-cache.js';
+/**
+ * Read article tool handler
+ */
+export declare class ReadArticleTool {
+    private registry;
+    private fileCache;
+    constructor(registry: FileRegistry, fileCache: FileCache);
+    /**
+     * Reads an article by file path or LOIO ID
+     */
+    execute(input: ReadArticleInput): Promise<ReadArticleOutput>;
+    /**
+     * Resolves identifier (path or LOIO ID) to file path
+     */
+    private resolveIdentifier;
+    /**
+     * Gets the tool schema for MCP
+     */
+    static getSchema(): {
+        name: string;
+        description: string;
+        inputSchema: {
+            type: string;
+            properties: {
+                identifier: {
+                    type: string;
+                    description: string;
+                };
+                resolveLinks: {
+                    type: string;
+                    description: string;
+                    default: boolean;
+                };
+            };
+            required: string[];
+        };
+    };
+}
+//# sourceMappingURL=read-article.d.ts.map

package/build/tools/read-article.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-article.d.ts","sourceRoot":"","sources":["../../src/tools/read-article.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC7E,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAInD;;GAEG;AACH,qBAAa,eAAe;IAExB,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,SAAS;gBADT,QAAQ,EAAE,YAAY,EACtB,SAAS,EAAE,SAAS;IAG9B;;OAEG;IACG,OAAO,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAwClE;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAiBzB;;OAEG;IACH,MAAM,CAAC,SAAS;;;;;;;;;;;;;;;;;;;CAqBjB"}

package/build/tools/read-article.js

@@ -0,0 +1,89 @@
+import { resolveLinksInContent, extractRelatedLinks } from '../parsers/links.js';
+import { existsSync } from 'fs';
+/**
+ * Read article tool handler
+ */
+export class ReadArticleTool {
+    registry;
+    fileCache;
+    constructor(registry, fileCache) {
+        this.registry = registry;
+        this.fileCache = fileCache;
+    }
+    /**
+     * Reads an article by file path or LOIO ID
+     */
+    async execute(input) {
+        const { identifier, resolveLinks = true } = input;
+        // Determine if identifier is a path or LOIO ID
+        const filePath = this.resolveIdentifier(identifier);
+        if (!filePath) {
+            throw new Error(`Article not found: ${identifier}`);
+        }
+        if (!existsSync(filePath)) {
+            throw new Error(`Article file does not exist: ${filePath}`);
+        }
+        // Get parsed document
+        const doc = await this.fileCache.get(filePath);
+        // Process content
+        let content = doc.content;
+        if (resolveLinks) {
+            content = resolveLinksInContent(content, filePath);
+        }
+        // Extract related links
+        const relatedLinksParsed = extractRelatedLinks(doc.content, filePath);
+        const relatedLinks = relatedLinksParsed.map(link => link.absolutePath);
+        return {
+            title: doc.title,
+            filePath: doc.metadata.filePath,
+            loioId: doc.loioId,
+            content,
+            metadata: {
+                area: doc.metadata.area,
+                relatedLinks,
+            },
+        };
+    }
+    /**
+     * Resolves identifier (path or LOIO ID) to file path
+     */
+    resolveIdentifier(identifier) {
+        // Check if it's a LOIO ID
+        if (identifier.startsWith('loio')) {
+            const entry = this.registry.getByLoioId(identifier);
+            return entry ? entry.filePath : null;
+        }
+        // Check if it's a direct file path
+        if (existsSync(identifier)) {
+            return identifier;
+        }
+        // Try to find in registry
+        const entry = this.registry.getByPath(identifier);
+        return entry ? entry.filePath : null;
+    }
+    /**
+     * Gets the tool schema for MCP
+     */
+    static getSchema() {
+        return {
+            name: 'read_article',
+            description: 'Read the full content of a documentation article by file path or LOIO ID. Returns formatted markdown content with resolved links.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    identifier: {
+                        type: 'string',
+                        description: 'Either the file path (e.g., "docs/ISuite/what-is-sap-integration-suite-5cc6987.md") or LOIO ID (e.g., "loio5cc6987511104c418b7cb4c25f3d9cb0")'
+                    },
+                    resolveLinks: {
+                        type: 'boolean',
+                        description: 'Convert relative links to absolute paths',
+                        default: true
+                    }
+                },
+                required: ['identifier']
+            }
+        };
+    }
+}
+//# sourceMappingURL=read-article.js.map

package/build/tools/read-article.js.map

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

package/build/tools/search.d.ts

@@ -0,0 +1,57 @@
+import type { SearchToolInput, CombinedSearchResults } from '../types/index.js';
+import { FullTextSearch } from '../search/fulltext.js';
+import { TitleSearch } from '../search/title.js';
+import { SemanticSearch } from '../search/semantic.js';
+import { SearchCache } from '../cache/search-cache.js';
+/**
+ * Search documentation tool handler
+ */
+export declare class SearchTool {
+    private fulltextSearch;
+    private titleSearch;
+    private semanticSearch;
+    private searchCache;
+    private ranking;
+    constructor(fulltextSearch: FullTextSearch, titleSearch: TitleSearch, semanticSearch: SemanticSearch, searchCache: SearchCache);
+    /**
+     * Executes search based on input parameters
+     */
+    execute(input: SearchToolInput): Promise<CombinedSearchResults>;
+    /**
+     * Gets the tool schema for MCP
+     */
+    static getSchema(): {
+        name: string;
+        description: string;
+        inputSchema: {
+            type: string;
+            properties: {
+                query: {
+                    type: string;
+                    description: string;
+                };
+                searchType: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                    default: string;
+                };
+                area: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                    default: string;
+                };
+                limit: {
+                    type: string;
+                    description: string;
+                    default: number;
+                    minimum: number;
+                    maximum: number;
+                };
+            };
+            required: string[];
+        };
+    };
+}
+//# sourceMappingURL=search.d.ts.map

package/build/tools/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAChF,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEvD;;GAEG;AACH,qBAAa,UAAU;IAInB,OAAO,CAAC,cAAc;IACtB,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,cAAc;IACtB,OAAO,CAAC,WAAW;IANrB,OAAO,CAAC,OAAO,CAAgB;gBAGrB,cAAc,EAAE,cAAc,EAC9B,WAAW,EAAE,WAAW,EACxB,cAAc,EAAE,cAAc,EAC9B,WAAW,EAAE,WAAW;IAKlC;;OAEG;IACG,OAAO,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAiErE;;OAEG;IACH,MAAM,CAAC,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmCjB"}

package/build/tools/search.js

@@ -0,0 +1,109 @@
+import { SearchRanking } from '../search/ranking.js';
+/**
+ * Search documentation tool handler
+ */
+export class SearchTool {
+    fulltextSearch;
+    titleSearch;
+    semanticSearch;
+    searchCache;
+    ranking;
+    constructor(fulltextSearch, titleSearch, semanticSearch, searchCache) {
+        this.fulltextSearch = fulltextSearch;
+        this.titleSearch = titleSearch;
+        this.semanticSearch = semanticSearch;
+        this.searchCache = searchCache;
+        this.ranking = new SearchRanking();
+    }
+    /**
+     * Executes search based on input parameters
+     */
+    async execute(input) {
+        const { query, searchType = 'all', area = 'all', limit = 20 } = input;
+        const startTime = Date.now();
+        // Check cache first
+        const cached = this.searchCache.get(query, searchType, area);
+        if (cached) {
+            return {
+                results: cached.slice(0, limit),
+                totalResults: cached.length,
+                searchType,
+                queryTime: Date.now() - startTime,
+            };
+        }
+        // Perform search based on type
+        let results;
+        if (searchType === 'fulltext') {
+            results = await this.fulltextSearch.search({ query, area, limit });
+        }
+        else if (searchType === 'title') {
+            results = await this.titleSearch.search({ query, area, limit });
+        }
+        else if (searchType === 'semantic') {
+            results = await this.semanticSearch.search({ query, area, limit });
+        }
+        else if (searchType === 'all') {
+            // Run all three searches in parallel
+            const [fulltextResults, titleResults, semanticResults] = await Promise.all([
+                this.fulltextSearch.search({ query, area, limit: limit * 2 }),
+                this.titleSearch.search({ query, area, limit: limit * 2 }),
+                this.semanticSearch.search({ query, area, limit: limit * 2 }).catch(() => []), // Fallback if semantic search not initialized
+            ]);
+            // Combine results
+            results = this.ranking.combineResults(fulltextResults, titleResults, semanticResults);
+            // Limit final results
+            results = results.slice(0, limit);
+        }
+        else {
+            throw new Error(`Invalid search type: ${searchType}`);
+        }
+        // Cache results
+        this.searchCache.set(query, searchType, area, results);
+        const queryTime = Date.now() - startTime;
+        return {
+            results,
+            totalResults: results.length,
+            searchType,
+            queryTime,
+        };
+    }
+    /**
+     * Gets the tool schema for MCP
+     */
+    static getSchema() {
+        return {
+            name: 'search_documentation',
+            description: 'Search SAP Business Technology Platform documentation using full-text, title-based, or semantic search. Returns relevant documentation articles with snippets.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    query: {
+                        type: 'string',
+                        description: 'Search query string'
+                    },
+                    searchType: {
+                        type: 'string',
+                        enum: ['fulltext', 'title', 'semantic', 'all'],
+                        description: 'Type of search: fulltext (content search), title (title matching), semantic (AI-based), all (combined)',
+                        default: 'all'
+                    },
+                    area: {
+                        type: 'string',
+                        enum: ['ISuite', 'ci', 'apim', 'all'],
+                        description: 'Limit search to specific documentation area. ISuite = main Integration Suite, ci = Cloud Integration, apim = API Management',
+                        default: 'all'
+                    },
+                    limit: {
+                        type: 'number',
+                        description: 'Maximum number of results to return (1-50)',
+                        default: 20,
+                        minimum: 1,
+                        maximum: 50
+                    }
+                },
+                required: ['query']
+            }
+        };
+    }
+}
+//# sourceMappingURL=search.js.map

package/build/tools/search.js.map

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

package/build/types/index.d.ts

@@ -0,0 +1,179 @@
+export type DocumentArea = 'ISuite' | 'ci' | 'apim';
+export type SearchType = 'fulltext' | 'title' | 'semantic' | 'all';
+export type MatchType = 'fulltext' | 'title' | 'semantic' | 'combined';
+export type RelationshipType = 'explicit_link' | 'semantic' | 'combined';
+export type EmbeddingProvider = 'local' | 'voyage' | 'openai';
+export interface DocumentMetadata {
+    loioId: string;
+    title: string;
+    area: DocumentArea;
+    filePath: string;
+    relativePath: string;
+    lastModified: Date;
+    size: number;
+}
+export interface ParsedDocument {
+    title: string;
+    loioId: string;
+    content: string;
+    cleanText: string;
+    links: ParsedLink[];
+    headings: Heading[];
+    images: string[];
+    metadata: DocumentMetadata;
+}
+export interface ParsedLink {
+    text: string;
+    href: string;
+    absolutePath: string;
+    isExternal: boolean;
+    anchor?: string;
+}
+export interface Heading {
+    level: number;
+    text: string;
+    anchor: string;
+}
+export interface SearchOptions {
+    query: string;
+    searchType?: SearchType;
+    area?: DocumentArea | 'all';
+    limit?: number;
+}
+export interface FullTextSearchOptions {
+    query: string;
+    area?: DocumentArea | 'all';
+    limit?: number;
+}
+export interface TitleSearchOptions {
+    query: string;
+    area?: DocumentArea | 'all';
+    limit?: number;
+}
+export interface SemanticSearchOptions {
+    query: string;
+    area?: DocumentArea | 'all';
+    limit?: number;
+}
+export interface SearchResult {
+    filePath: string;
+    relativePath: string;
+    title: string;
+    loioId: string;
+    snippet: string;
+    score: number;
+    matchType: MatchType;
+    area: DocumentArea;
+}
+export interface CombinedSearchResults {
+    results: SearchResult[];
+    totalResults: number;
+    searchType: SearchType;
+    queryTime: number;
+}
+export interface Topic {
+    title: string;
+    path: string;
+    level: number;
+    children: Topic[];
+    loioId?: string;
+}
+export interface TopicHierarchy {
+    area: DocumentArea;
+    topics: Topic[];
+    totalTopics: number;
+}
+export interface FileRegistryEntry {
+    filePath: string;
+    relativePath: string;
+    title: string;
+    loioId: string;
+    area: DocumentArea;
+}
+export interface CacheEntry<T> {
+    data: T;
+    timestamp: number;
+    mtime?: number;
+}
+export interface CacheStats {
+    hits: number;
+    misses: number;
+    size: number;
+    maxSize: number;
+}
+export interface EmbeddingCacheData {
+    version: string;
+    model: string;
+    provider: EmbeddingProvider;
+    createdAt: string;
+    embeddings: EmbeddingEntry[];
+}
+export interface EmbeddingEntry {
+    filePath: string;
+    title: string;
+    loioId: string;
+    chunkIndex: number;
+    text: string;
+    embedding: number[];
+}
+export interface TextChunk {
+    text: string;
+    chunkIndex: number;
+    startOffset: number;
+    endOffset: number;
+}
+export interface SearchToolInput {
+    query: string;
+    searchType?: SearchType;
+    area?: DocumentArea | 'all';
+    limit?: number;
+}
+export interface ReadArticleInput {
+    identifier: string;
+    resolveLinks?: boolean;
+}
+export interface ReadArticleOutput {
+    title: string;
+    filePath: string;
+    loioId: string;
+    content: string;
+    metadata: {
+        area: DocumentArea;
+        relatedLinks: string[];
+    };
+}
+export interface ListTopicsInput {
+    area: DocumentArea;
+    depth?: number;
+    parentPath?: string;
+}
+export interface GetRelatedArticlesInput {
+    identifier: string;
+    method?: 'links' | 'semantic' | 'both';
+    limit?: number;
+}
+export interface RelatedArticle {
+    title: string;
+    filePath: string;
+    relationshipType: RelationshipType;
+    score: number;
+    loioId?: string;
+}
+export interface GetRelatedArticlesOutput {
+    sourceArticle: {
+        title: string;
+        filePath: string;
+        loioId: string;
+    };
+    relatedArticles: RelatedArticle[];
+}
+export interface ServerConfig {
+    docsPath: string;
+    cacheDir: string;
+    fileCacheSize: number;
+    searchCacheTTL: number;
+    embeddingProvider: EmbeddingProvider;
+    voyageApiKey?: string;
+    openaiApiKey?: string;
+}
+//# sourceMappingURL=index.d.ts.map

package/build/types/index.d.ts.map

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

package/build/types/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/build/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":""}

package/build/utils/docs-downloader.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Checks if documentation exists and downloads it if necessary
+ */
+export declare function ensureDocsAvailable(docsPath: string): Promise<boolean>;
+/**
+ * Gets the size of the docs directory in MB
+ */
+export declare function getDocsSize(docsPath: string): Promise<number>;
+//# sourceMappingURL=docs-downloader.d.ts.map

package/build/utils/docs-downloader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-downloader.d.ts","sourceRoot":"","sources":["../../src/utils/docs-downloader.ts"],"names":[],"mappings":"AAaA;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CA6B5E;AAmCD;;GAEG;AACH,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAWnE"}