@vdpeijl/kb-mcp 0.1.2

package/dist/src/sync/index.js

@@ -0,0 +1,180 @@
+import { fetchAllArticles, fetchSections, fetchCategories } from './zendesk.js';
+import { parseHTMLStructured } from './parser.js';
+import { chunkText } from './chunker.js';
+import { generateEmbeddingsBatch } from '../search/embeddings.js';
+import { upsertArticle, getStaleArticleIds, deleteArticle } from '../db/articles.js';
+import { deleteChunksByArticle, insertChunksBatch } from '../db/chunks.js';
+import { updateLastSynced } from '../db/sources.js';
+/**
+ * Sync a single source
+ */
+export async function syncSource(db, source, config, onProgress, fullResync = false) {
+    const startTime = Date.now();
+    // Phase 1: Fetch articles
+    onProgress?.({
+        phase: 'fetching',
+        current: 0,
+        total: 0,
+        message: `Fetching articles from ${source.name}...`,
+    });
+    const articles = await fetchAllArticles(source, (fetched) => {
+        onProgress?.({
+            phase: 'fetching',
+            current: fetched,
+            total: fetched,
+            message: `Fetched ${fetched} articles from ${source.name}...`,
+        });
+    });
+    // Fetch sections and categories for metadata
+    const [sections, categories] = await Promise.all([
+        fetchSections(source),
+        fetchCategories(source),
+    ]);
+    // Phase 2: Determine which articles need processing
+    const articleSummaries = articles.map(a => ({ id: a.id, updated_at: a.updated_at }));
+    const staleIds = fullResync
+        ? new Set(articles.map(a => a.id))
+        : getStaleArticleIds(db, source.id, articleSummaries);
+    const articlesToProcess = articles.filter(a => staleIds.has(a.id));
+    if (articlesToProcess.length === 0) {
+        onProgress?.({
+            phase: 'storing',
+            current: articles.length,
+            total: articles.length,
+            message: 'All articles are up to date.',
+        });
+        return {
+            source: source.name,
+            articlesProcessed: 0,
+            articlesFetched: articles.length,
+            chunksCreated: 0,
+            timeElapsed: Date.now() - startTime,
+        };
+    }
+    // Phase 3: Parse, chunk, and prepare for embedding
+    onProgress?.({
+        phase: 'parsing',
+        current: 0,
+        total: articlesToProcess.length,
+        message: `Processing ${articlesToProcess.length} articles...`,
+    });
+    const allArticleChunks = [];
+    for (let i = 0; i < articlesToProcess.length; i++) {
+        const article = articlesToProcess[i];
+        // Parse HTML
+        const cleanText = parseHTMLStructured(article.body);
+        // Chunk text
+        const chunks = chunkText(cleanText, article.title, config.sync.chunkSize, config.sync.chunkOverlap);
+        allArticleChunks.push({
+            articleId: article.id,
+            title: article.title,
+            url: article.html_url,
+            sectionName: sections.get(article.section_id),
+            categoryName: categories.get(article.section_id),
+            updatedAt: new Date(article.updated_at),
+            chunks,
+        });
+        onProgress?.({
+            phase: 'parsing',
+            current: i + 1,
+            total: articlesToProcess.length,
+            message: `Parsed ${i + 1}/${articlesToProcess.length} articles...`,
+        });
+    }
+    // Phase 4: Generate embeddings
+    const allChunkTexts = allArticleChunks.flatMap(ac => ac.chunks.map(c => c.text));
+    const totalChunks = allChunkTexts.length;
+    onProgress?.({
+        phase: 'embedding',
+        current: 0,
+        total: totalChunks,
+        message: `Generating embeddings for ${totalChunks} chunks...`,
+    });
+    const embeddings = await generateEmbeddingsBatch(allChunkTexts, config.ollama, 5, (completed, total) => {
+        onProgress?.({
+            phase: 'embedding',
+            current: completed,
+            total,
+            message: `Generated ${completed}/${total} embeddings...`,
+        });
+    });
+    // Phase 5: Store in database
+    onProgress?.({
+        phase: 'storing',
+        current: 0,
+        total: articlesToProcess.length,
+        message: 'Storing articles and chunks...',
+    });
+    // Use a transaction for all database operations
+    const storeTransaction = db.transaction(() => {
+        let embeddingIndex = 0;
+        for (let i = 0; i < allArticleChunks.length; i++) {
+            const articleChunks = allArticleChunks[i];
+            // Delete old chunks for this article
+            deleteChunksByArticle(db, articleChunks.articleId, source.id);
+            // Upsert article
+            upsertArticle(db, {
+                id: articleChunks.articleId,
+                sourceId: source.id,
+                title: articleChunks.title,
+                url: articleChunks.url,
+                sectionName: articleChunks.sectionName,
+                categoryName: articleChunks.categoryName,
+                updatedAt: articleChunks.updatedAt,
+            });
+            // Prepare chunks with embeddings
+            const chunksWithEmbeddings = articleChunks.chunks.map(chunk => ({
+                articleId: articleChunks.articleId,
+                sourceId: source.id,
+                chunkIndex: chunk.index,
+                text: chunk.text,
+                tokenCount: chunk.tokenCount,
+                embedding: embeddings[embeddingIndex++],
+            }));
+            // Insert chunks
+            insertChunksBatch(db, chunksWithEmbeddings);
+            onProgress?.({
+                phase: 'storing',
+                current: i + 1,
+                total: articlesToProcess.length,
+                message: `Stored ${i + 1}/${articlesToProcess.length} articles...`,
+            });
+        }
+        // Delete articles that no longer exist in Zendesk
+        const validArticleIds = articles.map(a => a.id);
+        const currentArticleIds = db
+            .prepare('SELECT id FROM articles WHERE source_id = ?')
+            .all(source.id);
+        for (const { id } of currentArticleIds) {
+            if (!validArticleIds.includes(id)) {
+                deleteArticle(db, id, source.id);
+            }
+        }
+        // Update last synced timestamp
+        updateLastSynced(db, source.id);
+    });
+    storeTransaction();
+    const timeElapsed = Date.now() - startTime;
+    return {
+        source: source.name,
+        articlesProcessed: articlesToProcess.length,
+        articlesFetched: articles.length,
+        chunksCreated: totalChunks,
+        timeElapsed,
+    };
+}
+/**
+ * Sync all enabled sources
+ */
+export async function syncAllSources(db, sources, config, onProgress, fullResync = false) {
+    const results = [];
+    for (const source of sources) {
+        if (!source.enabled) {
+            continue;
+        }
+        const result = await syncSource(db, source, config, (progress) => onProgress?.(source.name, progress), fullResync);
+        results.push(result);
+    }
+    return results;
+}
+//# sourceMappingURL=index.js.map

package/dist/src/sync/index.js.map

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

package/dist/src/sync/parser.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Strip HTML and extract clean text from article body
+ */
+export declare function parseHTML(html: string): string;
+/**
+ * Parse HTML with better handling of lists and structure
+ */
+export declare function parseHTMLStructured(html: string): string;
+//# sourceMappingURL=parser.d.ts.map

package/dist/src/sync/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../src/sync/parser.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAqB9C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA2ExD"}

package/dist/src/sync/parser.js

@@ -0,0 +1,91 @@
+import * as cheerio from 'cheerio';
+/**
+ * Strip HTML and extract clean text from article body
+ */
+export function parseHTML(html) {
+    // Handle cases where html is not a string (null, undefined, etc.)
+    if (!html || typeof html !== 'string') {
+        return '';
+    }
+    const $ = cheerio.load(html);
+    // Remove script and style tags
+    $('script, style').remove();
+    // Get text content
+    let text = $.text();
+    // Clean up whitespace
+    text = text
+        .replace(/\s+/g, ' ') // Replace multiple spaces with single space
+        .replace(/\n\s*\n/g, '\n\n') // Replace multiple newlines with double newline
+        .trim();
+    return text;
+}
+/**
+ * Parse HTML with better handling of lists and structure
+ */
+export function parseHTMLStructured(html) {
+    // Handle cases where html is not a string (null, undefined, etc.)
+    if (!html || typeof html !== 'string') {
+        return '';
+    }
+    const $ = cheerio.load(html);
+    // Remove unwanted elements
+    $('script, style, noscript, iframe').remove();
+    // Process the DOM to extract structured text
+    function extractText(element) {
+        const $el = $(element);
+        const tagName = element.tagName?.toLowerCase();
+        // Handle different elements
+        if (tagName === 'ul' || tagName === 'ol') {
+            const items = $el.find('> li')
+                .map((_, li) => {
+                const text = extractText(li).trim();
+                return text ? `• ${text}` : '';
+            })
+                .get()
+                .filter(Boolean);
+            return items.length > 0 ? items.join('\n') + '\n' : '';
+        }
+        if (tagName === 'li') {
+            // Get direct text content and nested lists
+            let text = '';
+            $el.contents().each((_, node) => {
+                if (node.type === 'text') {
+                    text += $(node).text();
+                }
+                else if (node.type === 'tag') {
+                    text += extractText(node);
+                }
+            });
+            return text.trim();
+        }
+        if (tagName === 'p' || tagName === 'div' || tagName === 'section') {
+            let text = '';
+            $el.contents().each((_, node) => {
+                if (node.type === 'text') {
+                    text += $(node).text();
+                }
+                else if (node.type === 'tag') {
+                    text += extractText(node);
+                }
+            });
+            const trimmed = text.trim();
+            return trimmed ? trimmed + '\n\n' : '';
+        }
+        if (tagName === 'br') {
+            return '\n';
+        }
+        if (tagName === 'table') {
+            // Simple table handling - extract all text
+            return $el.text().trim() + '\n\n';
+        }
+        // Default: get all text content
+        return $el.text();
+    }
+    const text = extractText($('body')[0] || $.root()[0]);
+    // Clean up whitespace
+    return text
+        .replace(/\n{3,}/g, '\n\n') // Max 2 consecutive newlines
+        .replace(/  +/g, ' ') // Replace multiple spaces with single space
+        .trim();
+}
+//# sourceMappingURL=parser.js.map

package/dist/src/sync/parser.js.map

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

package/dist/src/sync/zendesk.d.ts

@@ -0,0 +1,45 @@
+import type { Source } from '../config/schema.js';
+export interface ZendeskArticle {
+    id: number;
+    title: string;
+    body: string;
+    section_id: number;
+    updated_at: string;
+    html_url: string;
+    draft: boolean;
+    promoted: boolean;
+}
+export interface ZendeskArticlesResponse {
+    articles: ZendeskArticle[];
+    next_page: string | null;
+    count: number;
+    page: number;
+    per_page: number;
+    page_count: number;
+}
+export interface ZendeskSection {
+    id: number;
+    name: string;
+    category_id: number;
+}
+export interface ZendeskCategory {
+    id: number;
+    name: string;
+}
+/**
+ * Fetch all articles from a Zendesk Help Center
+ */
+export declare function fetchAllArticles(source: Source, onProgress?: (fetched: number) => void): Promise<ZendeskArticle[]>;
+/**
+ * Fetch sections from a Zendesk Help Center
+ */
+export declare function fetchSections(source: Source): Promise<Map<number, string>>;
+/**
+ * Fetch categories from a Zendesk Help Center
+ */
+export declare function fetchCategories(source: Source): Promise<Map<number, string>>;
+/**
+ * Test connection to a Zendesk Help Center
+ */
+export declare function testConnection(source: Source): Promise<boolean>;
+//# sourceMappingURL=zendesk.d.ts.map

package/dist/src/sync/zendesk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zendesk.d.ts","sourceRoot":"","sources":["../../../src/sync/zendesk.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAElD,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AA4ED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GACrC,OAAO,CAAC,cAAc,EAAE,CAAC,CA0C3B;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CA+BhF;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CA+BlF;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQrE"}

package/dist/src/sync/zendesk.js

@@ -0,0 +1,161 @@
+const DEFAULT_RETRY_OPTIONS = {
+    maxRetries: 5,
+    initialDelay: 1000,
+    maxDelay: 60000,
+};
+/**
+ * Sleep for a specified number of milliseconds
+ */
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+/**
+ * Fetch with retry logic and exponential backoff
+ */
+async function fetchWithRetry(url, options = DEFAULT_RETRY_OPTIONS) {
+    let lastError = null;
+    let delay = options.initialDelay;
+    for (let attempt = 0; attempt <= options.maxRetries; attempt++) {
+        try {
+            const response = await fetch(url);
+            // Handle rate limiting (429)
+            if (response.status === 429) {
+                const retryAfter = response.headers.get('Retry-After');
+                const waitTime = retryAfter
+                    ? parseInt(retryAfter, 10) * 1000
+                    : Math.min(delay * Math.pow(2, attempt), options.maxDelay);
+                if (attempt < options.maxRetries) {
+                    console.error(`⚠ Rate limited by Zendesk, waiting ${Math.round(waitTime / 1000)}s... (retry ${attempt + 1}/${options.maxRetries})`);
+                    await sleep(waitTime);
+                    continue;
+                }
+                throw new Error('Rate limit exceeded. Please try again later.');
+            }
+            // Success or non-retryable error
+            if (response.ok || response.status < 500) {
+                return response;
+            }
+            // Server error (5xx) - retry
+            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+        }
+        catch (error) {
+            lastError = error;
+            // Don't retry on network errors if we've exhausted retries
+            if (attempt >= options.maxRetries) {
+                break;
+            }
+            // Wait before retrying
+            const waitTime = Math.min(delay * Math.pow(2, attempt), options.maxDelay);
+            console.error(`⚠ Request failed, retrying in ${Math.round(waitTime / 1000)}s... (attempt ${attempt + 1}/${options.maxRetries})`);
+            await sleep(waitTime);
+        }
+    }
+    throw lastError || new Error('Request failed after retries');
+}
+/**
+ * Fetch all articles from a Zendesk Help Center
+ */
+export async function fetchAllArticles(source, onProgress) {
+    const articles = [];
+    let nextPage = `${source.baseUrl}/api/v2/help_center/${source.locale}/articles.json?per_page=100`;
+    while (nextPage) {
+        try {
+            const response = await fetchWithRetry(nextPage);
+            if (!response.ok) {
+                throw new Error(`Failed to fetch articles from ${source.baseUrl}: HTTP ${response.status}\n\n` +
+                    `Make sure the URL is correct and the Help Center is publicly accessible.`);
+            }
+            const data = (await response.json());
+            // Filter out drafts
+            const publishedArticles = data.articles.filter(a => !a.draft);
+            articles.push(...publishedArticles);
+            if (onProgress) {
+                onProgress(articles.length);
+            }
+            nextPage = data.next_page;
+            // Small delay between pages to be nice to Zendesk
+            if (nextPage) {
+                await sleep(100);
+            }
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                throw new Error(`Failed to fetch articles from ${source.name}:\n${error.message}`);
+            }
+            throw error;
+        }
+    }
+    return articles;
+}
+/**
+ * Fetch sections from a Zendesk Help Center
+ */
+export async function fetchSections(source) {
+    const sectionMap = new Map();
+    let nextPage = `${source.baseUrl}/api/v2/help_center/${source.locale}/sections.json?per_page=100`;
+    while (nextPage) {
+        try {
+            const response = await fetchWithRetry(nextPage);
+            if (!response.ok) {
+                // Sections are optional, just return empty map
+                return sectionMap;
+            }
+            const data = (await response.json());
+            for (const section of data.sections) {
+                sectionMap.set(section.id, section.name);
+            }
+            nextPage = data.next_page;
+            if (nextPage) {
+                await sleep(100);
+            }
+        }
+        catch (error) {
+            // Sections are optional, just return what we have
+            return sectionMap;
+        }
+    }
+    return sectionMap;
+}
+/**
+ * Fetch categories from a Zendesk Help Center
+ */
+export async function fetchCategories(source) {
+    const categoryMap = new Map();
+    let nextPage = `${source.baseUrl}/api/v2/help_center/${source.locale}/categories.json?per_page=100`;
+    while (nextPage) {
+        try {
+            const response = await fetchWithRetry(nextPage);
+            if (!response.ok) {
+                // Categories are optional, just return empty map
+                return categoryMap;
+            }
+            const data = (await response.json());
+            for (const category of data.categories) {
+                categoryMap.set(category.id, category.name);
+            }
+            nextPage = data.next_page;
+            if (nextPage) {
+                await sleep(100);
+            }
+        }
+        catch (error) {
+            // Categories are optional, just return what we have
+            return categoryMap;
+        }
+    }
+    return categoryMap;
+}
+/**
+ * Test connection to a Zendesk Help Center
+ */
+export async function testConnection(source) {
+    try {
+        const url = `${source.baseUrl}/api/v2/help_center/${source.locale}/articles.json?per_page=1`;
+        const response = await fetch(url);
+        return response.ok;
+    }
+    catch (error) {
+        return false;
+    }
+}
+//# sourceMappingURL=zendesk.js.map

package/dist/src/sync/zendesk.js.map

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

package/dist/src/utils/errors.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Base error class for kb-mcp
+ */
+export declare class KBMCPError extends Error {
+    constructor(message: string);
+}
+/**
+ * Configuration error
+ */
+export declare class ConfigError extends KBMCPError {
+    constructor(message: string);
+}
+/**
+ * Database error
+ */
+export declare class DatabaseError extends KBMCPError {
+    constructor(message: string);
+}
+/**
+ * Ollama error
+ */
+export declare class OllamaError extends KBMCPError {
+    constructor(message: string);
+}
+/**
+ * Zendesk error
+ */
+export declare class ZendeskError extends KBMCPError {
+    constructor(message: string);
+}
+/**
+ * Format an error for display to the user
+ */
+export declare function formatError(error: unknown): string;
+/**
+ * Exit with an error message
+ */
+export declare function exitWithError(error: unknown): never;
+//# sourceMappingURL=errors.d.ts.map

package/dist/src/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,UAAW,SAAQ,KAAK;gBACvB,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,UAAU;gBAC7B,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,UAAU;gBAC/B,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,UAAU;gBAC7B,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,UAAU;gBAC9B,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAMlD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAGnD"}

package/dist/src/utils/errors.js

@@ -0,0 +1,62 @@
+/**
+ * Base error class for kb-mcp
+ */
+export class KBMCPError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'KBMCPError';
+    }
+}
+/**
+ * Configuration error
+ */
+export class ConfigError extends KBMCPError {
+    constructor(message) {
+        super(message);
+        this.name = 'ConfigError';
+    }
+}
+/**
+ * Database error
+ */
+export class DatabaseError extends KBMCPError {
+    constructor(message) {
+        super(message);
+        this.name = 'DatabaseError';
+    }
+}
+/**
+ * Ollama error
+ */
+export class OllamaError extends KBMCPError {
+    constructor(message) {
+        super(message);
+        this.name = 'OllamaError';
+    }
+}
+/**
+ * Zendesk error
+ */
+export class ZendeskError extends KBMCPError {
+    constructor(message) {
+        super(message);
+        this.name = 'ZendeskError';
+    }
+}
+/**
+ * Format an error for display to the user
+ */
+export function formatError(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return String(error);
+}
+/**
+ * Exit with an error message
+ */
+export function exitWithError(error) {
+    console.error(`\n✗ Error: ${formatError(error)}\n`);
+    process.exit(1);
+}
+//# sourceMappingURL=errors.js.map

package/dist/src/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,UAAW,SAAQ,KAAK;IACnC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,WAAY,SAAQ,UAAU;IACzC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,aAAc,SAAQ,UAAU;IAC3C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,WAAY,SAAQ,UAAU;IACzC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,YAAa,SAAQ,UAAU;IAC1C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC,OAAO,CAAC;IACvB,CAAC;IAED,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,CAAC,KAAK,CAAC,cAAc,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACpD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC"}

package/dist/src/utils/logger.d.ts

@@ -0,0 +1,21 @@
+import debug from 'debug';
+/**
+ * Create namespaced loggers using the debug package
+ */
+export declare const loggers: {
+    sync: debug.Debugger;
+    embed: debug.Debugger;
+    search: debug.Debugger;
+    mcp: debug.Debugger;
+    db: debug.Debugger;
+    cli: debug.Debugger;
+};
+/**
+ * Enable all kb-mcp loggers
+ */
+export declare function enableAllLoggers(): void;
+/**
+ * Check if debug logging is enabled
+ */
+export declare function isDebugEnabled(): boolean;
+//# sourceMappingURL=logger.d.ts.map

package/dist/src/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B;;GAEG;AACH,eAAO,MAAM,OAAO;;;;;;;CAOnB,CAAC;AAEF;;GAEG;AACH,wBAAgB,gBAAgB,SAE/B;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAExC"}