agentvault 1.0.2 → 1.0.5

package/dist/src/wiki/mcp-tools.js

@@ -0,0 +1,353 @@
+/**
+ * Wiki MCP Tools
+ *
+ * Exposes the wiki as an MCP tool server so any MCP-compatible agent
+ * can read, write, query, and lint the knowledge base.
+ *
+ * Tools:
+ *   wiki_init       — Initialize a new wiki with a schema
+ *   wiki_ingest     — Add a raw source to the wiki
+ *   wiki_query      — Ask a question, get a synthesized answer
+ *   wiki_read       — Read a specific wiki page by slug
+ *   wiki_update     — Update a page's content
+ *   wiki_list       — List all pages (with optional filters)
+ *   wiki_lint       — Run a health check
+ *   wiki_log        — View the activity log
+ *   wiki_backlinks  — Find pages that reference a given page
+ *   wiki_index      — Rebuild the wiki index
+ */
+import { WikiIngestService } from './ingest.js';
+import { WikiQueryService } from './query.js';
+import { WikiLintService } from './lint.js';
+/** Returns the list of MCP tool definitions for the wiki */
+export function getWikiToolDefinitions() {
+    return [
+        {
+            name: 'wiki_init',
+            description: 'Initialize a new wiki with a name and optional schema',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    name: { type: 'string', description: 'Wiki name' },
+                    description: { type: 'string', description: 'Wiki description' },
+                    categories: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: 'Custom categories beyond defaults',
+                    },
+                    ingestPrompt: { type: 'string', description: 'Custom prompt for ingest synthesis' },
+                    queryPrompt: { type: 'string', description: 'Custom prompt for query synthesis' },
+                    lintPrompt: { type: 'string', description: 'Custom prompt for lint checks' },
+                },
+                required: ['name'],
+            },
+        },
+        {
+            name: 'wiki_ingest',
+            description: 'Ingest a raw source into the wiki (file, URL, or text)',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    name: { type: 'string', description: 'Source name/title' },
+                    type: { type: 'string', enum: ['file', 'url', 'text'], description: 'Source type' },
+                    content: { type: 'string', description: 'Source content (text or file path)' },
+                    mimeType: { type: 'string', description: 'MIME type of the source' },
+                },
+                required: ['name', 'type', 'content'],
+            },
+        },
+        {
+            name: 'wiki_query',
+            description: 'Query the wiki — ask a question, get a synthesized answer with citations',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    question: { type: 'string', description: 'The question to answer' },
+                    fileExploration: {
+                        type: 'boolean',
+                        description: 'If true, file the answer back as an exploration page',
+                    },
+                },
+                required: ['question'],
+            },
+        },
+        {
+            name: 'wiki_read',
+            description: 'Read a specific wiki page by slug',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    slug: { type: 'string', description: 'Page slug identifier' },
+                },
+                required: ['slug'],
+            },
+        },
+        {
+            name: 'wiki_update',
+            description: 'Update an existing wiki page',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    slug: { type: 'string', description: 'Page slug to update' },
+                    content: { type: 'string', description: 'New content (replaces existing)' },
+                    title: { type: 'string', description: 'New title' },
+                    crossRefs: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: 'Updated cross-references',
+                    },
+                    tags: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: 'Updated tags',
+                    },
+                },
+                required: ['slug'],
+            },
+        },
+        {
+            name: 'wiki_list',
+            description: 'List wiki pages with optional filters',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    category: { type: 'string', description: 'Filter by category' },
+                    status: { type: 'string', description: 'Filter by status' },
+                    staleness: { type: 'string', enum: ['fresh', 'stale', 'needs-review'] },
+                    search: { type: 'string', description: 'Full-text search term' },
+                },
+            },
+        },
+        {
+            name: 'wiki_lint',
+            description: 'Run a health check on the wiki — find contradictions, orphans, stale pages',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    autoFix: {
+                        type: 'boolean',
+                        description: 'Automatically fix simple structural issues',
+                    },
+                },
+            },
+        },
+        {
+            name: 'wiki_log',
+            description: 'View the wiki activity log',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    limit: { type: 'number', description: 'Number of log entries to return (default: 50)' },
+                },
+            },
+        },
+        {
+            name: 'wiki_backlinks',
+            description: 'Find all pages that reference a given page',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    slug: { type: 'string', description: 'Page slug to find backlinks for' },
+                },
+                required: ['slug'],
+            },
+        },
+        {
+            name: 'wiki_index',
+            description: 'Rebuild the wiki index page',
+            inputSchema: {
+                type: 'object',
+                properties: {},
+            },
+        },
+    ];
+}
+/** Handle an MCP tool call for the wiki */
+export async function handleWikiToolCall(config, toolName, args) {
+    const { wikiId, store } = config;
+    try {
+        switch (toolName) {
+            case 'wiki_init': {
+                const schema = {
+                    name: args.name,
+                    description: args.description ?? '',
+                    categories: args.categories ?? [],
+                    ingestPrompt: args.ingestPrompt,
+                    queryPrompt: args.queryPrompt,
+                    lintPrompt: args.lintPrompt,
+                };
+                await store.setSchema(wikiId, schema);
+                return {
+                    content: [{ type: 'text', text: `Wiki "${schema.name}" initialized successfully.` }],
+                };
+            }
+            case 'wiki_ingest': {
+                if (!config.ingestLLM) {
+                    return {
+                        content: [{ type: 'text', text: 'No LLM adapter configured for ingest.' }],
+                        isError: true,
+                    };
+                }
+                const source = {
+                    name: args.name,
+                    type: args.type,
+                    content: args.content,
+                    mimeType: args.mimeType,
+                };
+                const ingestService = new WikiIngestService(store, config.ingestLLM, wikiId);
+                const result = await ingestService.ingest(source);
+                return {
+                    content: [{
+                            type: 'text',
+                            text: `Ingested "${source.name}": created ${result.pagesCreated.length} pages, updated ${result.pagesUpdated.length} pages, added ${result.crossRefsAdded} cross-refs.`,
+                        }],
+                };
+            }
+            case 'wiki_query': {
+                if (!config.queryLLM) {
+                    return {
+                        content: [{ type: 'text', text: 'No LLM adapter configured for query.' }],
+                        isError: true,
+                    };
+                }
+                const queryService = new WikiQueryService(store, config.queryLLM, wikiId);
+                const question = args.question;
+                const result = await queryService.query(question);
+                if (args.fileExploration) {
+                    await queryService.fileExploration(question, result);
+                }
+                return {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify(result, null, 2),
+                        }],
+                };
+            }
+            case 'wiki_read': {
+                const page = await store.getPage(wikiId, args.slug);
+                if (!page) {
+                    return {
+                        content: [{ type: 'text', text: `Page "${args.slug}" not found.` }],
+                        isError: true,
+                    };
+                }
+                return {
+                    content: [{ type: 'text', text: JSON.stringify(page, null, 2) }],
+                };
+            }
+            case 'wiki_update': {
+                const slug = args.slug;
+                const updates = {};
+                if (args.content)
+                    updates.content = args.content;
+                if (args.title)
+                    updates.title = args.title;
+                if (args.crossRefs)
+                    updates.crossRefs = args.crossRefs;
+                if (args.tags)
+                    updates.tags = args.tags;
+                const updated = await store.updatePage(wikiId, slug, updates);
+                if (!updated) {
+                    return {
+                        content: [{ type: 'text', text: `Page "${slug}" not found.` }],
+                        isError: true,
+                    };
+                }
+                await store.appendLog(wikiId, {
+                    timestamp: new Date().toISOString(),
+                    operation: 'update',
+                    summary: `Updated page "${slug}"`,
+                    pagesSlugs: [slug],
+                });
+                return {
+                    content: [{ type: 'text', text: `Page "${slug}" updated (v${updated.version}).` }],
+                };
+            }
+            case 'wiki_list': {
+                const filters = {};
+                if (args.category)
+                    filters.category = args.category;
+                if (args.status)
+                    filters.status = args.status;
+                if (args.staleness)
+                    filters.staleness = args.staleness;
+                if (args.search)
+                    filters.search = args.search;
+                const pages = await store.listPages(wikiId, filters);
+                const summary = pages.map((p) => ({
+                    slug: p.slug,
+                    title: p.title,
+                    category: p.category,
+                    status: p.status,
+                    staleness: p.staleness,
+                    version: p.version,
+                    crossRefs: p.crossRefs.length,
+                }));
+                return {
+                    content: [{ type: 'text', text: JSON.stringify(summary, null, 2) }],
+                };
+            }
+            case 'wiki_lint': {
+                const lintService = new WikiLintService(store, wikiId, config.lintLLM);
+                const report = await lintService.lint();
+                if (args.autoFix) {
+                    const fixes = await lintService.autoFix(report);
+                    report.issues.push({
+                        type: 'orphan',
+                        severity: 'info',
+                        pageSlug: '_system',
+                        description: `Auto-fix applied ${fixes} corrections`,
+                    });
+                }
+                return {
+                    content: [{ type: 'text', text: JSON.stringify(report, null, 2) }],
+                };
+            }
+            case 'wiki_log': {
+                const limit = args.limit ?? 50;
+                const log = await store.getLog(wikiId, limit);
+                return {
+                    content: [{ type: 'text', text: JSON.stringify(log, null, 2) }],
+                };
+            }
+            case 'wiki_backlinks': {
+                const backlinks = await store.getBacklinks(wikiId, args.slug);
+                const summary = backlinks.map((p) => ({
+                    slug: p.slug,
+                    title: p.title,
+                }));
+                return {
+                    content: [{ type: 'text', text: JSON.stringify(summary, null, 2) }],
+                };
+            }
+            case 'wiki_index': {
+                if (!config.ingestLLM) {
+                    return {
+                        content: [{ type: 'text', text: 'No LLM adapter configured for index rebuild.' }],
+                        isError: true,
+                    };
+                }
+                const ingestService = new WikiIngestService(store, config.ingestLLM, wikiId);
+                const indexPage = await ingestService.rebuildIndex();
+                return {
+                    content: [{ type: 'text', text: indexPage.content }],
+                };
+            }
+            default:
+                return {
+                    content: [{ type: 'text', text: `Unknown wiki tool: ${toolName}` }],
+                    isError: true,
+                };
+        }
+    }
+    catch (error) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Wiki tool error: ${error instanceof Error ? error.message : 'Unknown error'}`,
+                }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=mcp-tools.js.map

package/dist/src/wiki/mcp-tools.js.map

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

package/dist/src/wiki/query.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Wiki Query Service
+ *
+ * Implements Karpathy's "Query" operation: search the wiki for relevant pages,
+ * synthesize an answer with citations, and optionally file the exploration
+ * back into the wiki as a new page.
+ */
+import type { WikiPage, WikiQueryResult } from '../backbone/types.js';
+import type { WikiStore } from './wiki-store.js';
+/** LLM adapter for query synthesis */
+export interface WikiQueryLLMAdapter {
+    /**
+     * Given a question and relevant wiki pages, produce a synthesized answer
+     * with citations back to source pages.
+     */
+    answerQuery(question: string, relevantPages: WikiPage[], schemaPrompt?: string): Promise<WikiQueryResult>;
+}
+export declare class WikiQueryService {
+    private store;
+    private llm;
+    private wikiId;
+    constructor(store: WikiStore, llm: WikiQueryLLMAdapter, wikiId: string);
+    /**
+     * Query the wiki: find relevant pages, synthesize an answer.
+     */
+    query(question: string): Promise<WikiQueryResult>;
+    /**
+     * File a query result back into the wiki as an exploration page.
+     * This is what makes the wiki compound — valuable queries become pages.
+     */
+    fileExploration(question: string, result: WikiQueryResult): Promise<WikiPage>;
+    /**
+     * Simple relevance ranking using keyword overlap.
+     * In production, this would use embeddings or the LLM for semantic search.
+     */
+    private rankRelevance;
+}
+//# sourceMappingURL=query.d.ts.map

package/dist/src/wiki/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/wiki/query.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,sCAAsC;AACtC,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,WAAW,CACT,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,QAAQ,EAAE,EACzB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,eAAe,CAAC,CAAC;CAC7B;AAED,qBAAa,gBAAgB;IAEzB,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,GAAG;IACX,OAAO,CAAC,MAAM;gBAFN,KAAK,EAAE,SAAS,EAChB,GAAG,EAAE,mBAAmB,EACxB,MAAM,EAAE,MAAM;IAGxB;;OAEG;IACG,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IA0BvD;;;OAGG;IACG,eAAe,CACnB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,QAAQ,CAAC;IAkDpB;;;OAGG;IACH,OAAO,CAAC,aAAa;CA0BtB"}

package/dist/src/wiki/query.js

@@ -0,0 +1,117 @@
+/**
+ * Wiki Query Service
+ *
+ * Implements Karpathy's "Query" operation: search the wiki for relevant pages,
+ * synthesize an answer with citations, and optionally file the exploration
+ * back into the wiki as a new page.
+ */
+import { randomUUID } from 'node:crypto';
+export class WikiQueryService {
+    store;
+    llm;
+    wikiId;
+    constructor(store, llm, wikiId) {
+        this.store = store;
+        this.llm = llm;
+        this.wikiId = wikiId;
+    }
+    /**
+     * Query the wiki: find relevant pages, synthesize an answer.
+     */
+    async query(question) {
+        // 1. Search for relevant pages
+        const allPages = await this.store.listPages(this.wikiId);
+        const relevantPages = this.rankRelevance(question, allPages);
+        // 2. Get schema for query prompt customization
+        const schema = await this.store.getSchema(this.wikiId);
+        // 3. LLM synthesis
+        const result = await this.llm.answerQuery(question, relevantPages, schema?.queryPrompt);
+        // 4. Log the query
+        await this.store.appendLog(this.wikiId, {
+            timestamp: new Date().toISOString(),
+            operation: 'query',
+            summary: `Query: "${question}" — consulted ${result.pagesConsulted.length} pages`,
+            pagesSlugs: result.pagesConsulted,
+        });
+        return result;
+    }
+    /**
+     * File a query result back into the wiki as an exploration page.
+     * This is what makes the wiki compound — valuable queries become pages.
+     */
+    async fileExploration(question, result) {
+        const slug = `exploration-${Date.now()}`;
+        const now = new Date().toISOString();
+        // Build citation section
+        const citations = result.citations
+            .map((c) => `- [[${c.slug}]] — ${c.title}: "${c.excerpt}"`)
+            .join('\n');
+        const content = [
+            `# ${question}`,
+            '',
+            result.answer,
+            '',
+            '## Sources',
+            '',
+            citations,
+            '',
+            `*Filed automatically on ${now}*`,
+        ].join('\n');
+        const page = {
+            id: randomUUID(),
+            companyId: this.wikiId,
+            title: question,
+            content,
+            category: 'exploration',
+            status: 'draft',
+            version: 1,
+            createdBy: 'wiki-query',
+            slug,
+            crossRefs: result.citations.map((c) => c.slug),
+            sourceRefs: [],
+            staleness: 'fresh',
+            createdAt: now,
+            updatedAt: now,
+        };
+        await this.store.createPage(page);
+        await this.store.appendLog(this.wikiId, {
+            timestamp: now,
+            operation: 'ingest',
+            summary: `Filed exploration: "${question}"`,
+            pagesSlugs: [slug],
+        });
+        return page;
+    }
+    /**
+     * Simple relevance ranking using keyword overlap.
+     * In production, this would use embeddings or the LLM for semantic search.
+     */
+    rankRelevance(question, pages) {
+        const queryTerms = question
+            .toLowerCase()
+            .split(/\s+/)
+            .filter((t) => t.length > 2);
+        const scored = pages
+            .filter((p) => p.category !== 'log')
+            .map((page) => {
+            const text = `${page.title} ${page.content} ${(page.tags ?? []).join(' ')}`.toLowerCase();
+            let score = 0;
+            for (const term of queryTerms) {
+                if (text.includes(term))
+                    score++;
+                // Boost title matches
+                if (page.title.toLowerCase().includes(term))
+                    score += 2;
+                // Boost tag matches
+                if ((page.tags ?? []).some((t) => t.toLowerCase().includes(term)))
+                    score += 1;
+            }
+            return { page, score };
+        })
+            .filter((s) => s.score > 0)
+            .sort((a, b) => b.score - a.score);
+        // Return top 20 most relevant pages
+        return scored.slice(0, 20).map((s) => s.page);
+    }
+}
+//# sourceMappingURL=query.js.map

package/dist/src/wiki/query.js.map

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

package/dist/src/wiki/wiki-store.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Wiki Store
+ *
+ * Storage adapter for wiki pages. Extends the KnowledgeStore pattern
+ * with wiki-specific operations (slug lookup, cross-ref queries, etc.).
+ *
+ * Default implementation is in-memory; consumers can inject a
+ * canister-backed or file-system adapter.
+ */
+import type { WikiPage, WikiStaleness, WikiLogEntry, WikiSchema } from '../backbone/types.js';
+import type { KnowledgeCategory, KnowledgeStatus } from '../backbone/constants.js';
+export interface WikiListFilters {
+    category?: KnowledgeCategory;
+    status?: KnowledgeStatus;
+    staleness?: WikiStaleness;
+    search?: string;
+    tags?: string[];
+}
+/** Storage adapter interface for wiki pages */
+export interface WikiStore {
+    listPages(wikiId: string, filters?: WikiListFilters): Promise<WikiPage[]>;
+    getPage(wikiId: string, slug: string): Promise<WikiPage | null>;
+    getPageById(id: string): Promise<WikiPage | null>;
+    createPage(page: WikiPage): Promise<WikiPage>;
+    updatePage(wikiId: string, slug: string, partial: Partial<WikiPage>): Promise<WikiPage | null>;
+    deletePage(wikiId: string, slug: string): Promise<boolean>;
+    getBacklinks(wikiId: string, slug: string): Promise<WikiPage[]>;
+    getOrphans(wikiId: string): Promise<WikiPage[]>;
+    appendLog(wikiId: string, entry: WikiLogEntry): Promise<void>;
+    getLog(wikiId: string, limit?: number): Promise<WikiLogEntry[]>;
+    getSchema(wikiId: string): Promise<WikiSchema | null>;
+    setSchema(wikiId: string, schema: WikiSchema): Promise<void>;
+}
+/** In-memory implementation of WikiStore */
+export declare class InMemoryWikiStore implements WikiStore {
+    private pages;
+    private logs;
+    private schemas;
+    private makeKey;
+    listPages(wikiId: string, filters?: WikiListFilters): Promise<WikiPage[]>;
+    getPage(wikiId: string, slug: string): Promise<WikiPage | null>;
+    getPageById(id: string): Promise<WikiPage | null>;
+    createPage(page: WikiPage): Promise<WikiPage>;
+    updatePage(wikiId: string, slug: string, partial: Partial<WikiPage>): Promise<WikiPage | null>;
+    deletePage(wikiId: string, slug: string): Promise<boolean>;
+    getBacklinks(wikiId: string, slug: string): Promise<WikiPage[]>;
+    getOrphans(wikiId: string): Promise<WikiPage[]>;
+    appendLog(wikiId: string, entry: WikiLogEntry): Promise<void>;
+    getLog(wikiId: string, limit?: number): Promise<WikiLogEntry[]>;
+    getSchema(wikiId: string): Promise<WikiSchema | null>;
+    setSchema(wikiId: string, schema: WikiSchema): Promise<void>;
+}
+//# sourceMappingURL=wiki-store.d.ts.map

package/dist/src/wiki/wiki-store.d.ts.map

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