@echoes-io/mcp-server 4.1.0 → 6.0.0

package/lib/tools/search.js

@@ -0,0 +1,95 @@
+import z from 'zod';
+import { DEFAULT_DB_PATH } from '../constants.js';
+import { Database } from '../database/index.js';
+import { generateEmbedding } from '../indexer/embeddings.js';
+export const searchConfig = {
+    name: 'search',
+    description: 'Search indexed content using semantic similarity or filters.',
+    arguments: {
+        query: 'Search query text.',
+        type: 'Search type: chapters (default), entities, or relations.',
+        arc: 'Filter by arc name (optional).',
+        entityType: 'Filter entities by type: CHARACTER, LOCATION, EVENT, OBJECT, EMOTION.',
+        relationType: 'Filter relations by type.',
+        limit: 'Maximum number of results (default: 10).',
+        dbPath: `Database path (default: ${DEFAULT_DB_PATH}).`,
+    },
+};
+export const searchSchema = z.object({
+    query: z.string().describe(searchConfig.arguments.query),
+    type: z
+        .enum(['chapters', 'entities', 'relations'])
+        .default('chapters')
+        .describe(searchConfig.arguments.type),
+    arc: z.string().optional().describe(searchConfig.arguments.arc),
+    entityType: z.string().optional().describe(searchConfig.arguments.entityType),
+    relationType: z.string().optional().describe(searchConfig.arguments.relationType),
+    limit: z.number().optional().default(10).describe(searchConfig.arguments.limit),
+    dbPath: z.string().default(DEFAULT_DB_PATH).describe(searchConfig.arguments.dbPath),
+});
+export async function search(input) {
+    const { query, type, arc, entityType, relationType, limit, dbPath } = searchSchema.parse(input);
+    const db = new Database(dbPath);
+    await db.connect();
+    if (type === 'chapters') {
+        const vector = await generateEmbedding(query, db.embeddingModel);
+        const chapters = await db.searchChapters(vector, limit, arc);
+        db.close();
+        return {
+            type: 'chapters',
+            results: chapters.map((c) => ({
+                id: c.id,
+                arc: c.arc,
+                episode: c.episode,
+                chapter: c.chapter,
+                pov: c.pov,
+                title: c.title,
+                location: c.location,
+                content: c.content.slice(0, 500) + (c.content.length > 500 ? '...' : ''),
+                word_count: c.word_count,
+                /* v8 ignore next */
+                score: 1 - (c._distance ?? 0),
+            })),
+        };
+    }
+    if (type === 'entities') {
+        const vector = await generateEmbedding(query, db.embeddingModel);
+        const entities = await db.searchEntities(vector, limit, arc, entityType);
+        db.close();
+        return {
+            type: 'entities',
+            results: entities.map((e) => ({
+                id: e.id,
+                arc: e.arc,
+                name: e.name,
+                type: e.type,
+                description: e.description,
+                aliases: e.aliases,
+                chapter_count: e.chapter_count,
+                /* v8 ignore next */
+                score: 1 - (e._distance ?? 0),
+            })),
+        };
+    }
+    // type === 'relations'
+    const relations = await db.getRelations(arc, relationType);
+    db.close();
+    // Filter relations by query (simple text match on source/target/description)
+    const queryLower = query.toLowerCase();
+    const filtered = relations.filter((r) => r.source_entity.toLowerCase().includes(queryLower) ||
+        r.target_entity.toLowerCase().includes(queryLower) ||
+        r.description.toLowerCase().includes(queryLower));
+    return {
+        type: 'relations',
+        results: filtered.slice(0, limit).map((r) => ({
+            id: r.id,
+            arc: r.arc,
+            source_entity: r.source_entity,
+            target_entity: r.target_entity,
+            type: r.type,
+            description: r.description,
+            chapters: r.chapters,
+        })),
+    };
+}
+//# sourceMappingURL=search.js.map

package/lib/tools/search.js.map

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

package/lib/tools/stats.d.ts

@@ -0,0 +1,18 @@
+import z from 'zod';
+import type { ToolConfig } from '../types.js';
+export declare const statsConfig: ToolConfig;
+export declare const statsSchema: z.ZodObject<{
+    arc: z.ZodOptional<z.ZodString>;
+    pov: z.ZodOptional<z.ZodString>;
+    dbPath: z.ZodDefault<z.ZodString>;
+}, z.z.core.$strip>;
+export type StatsInput = z.infer<typeof statsSchema>;
+export interface StatsOutput {
+    totalChapters: number;
+    totalWords: number;
+    arcs: string[];
+    povs: Record<string, number>;
+    averageWordsPerChapter: number;
+}
+export declare function stats(input: StatsInput): Promise<StatsOutput>;
+//# sourceMappingURL=stats.d.ts.map

package/lib/tools/stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["stats.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,KAAK,CAAC;AAIpB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,eAAO,MAAM,WAAW,EAAE,UAQzB,CAAC;AAEF,eAAO,MAAM,WAAW;;;;mBAItB,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAErD,MAAM,WAAW,WAAW;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,sBAAsB,EAAE,MAAM,CAAC;CAChC;AAOD,wBAAsB,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,CA8CnE"}

package/lib/tools/stats.js

@@ -0,0 +1,62 @@
+import z from 'zod';
+import { DEFAULT_DB_PATH } from '../constants.js';
+import { Database } from '../database/index.js';
+export const statsConfig = {
+    name: 'stats',
+    description: 'Get aggregate statistics for indexed timeline content.',
+    arguments: {
+        arc: 'Filter by arc name(s), comma-separated (optional).',
+        pov: 'Filter by POV character(s), comma-separated (optional).',
+        dbPath: `Database path (default: ${DEFAULT_DB_PATH}).`,
+    },
+};
+export const statsSchema = z.object({
+    arc: z.string().optional().describe(statsConfig.arguments.arc),
+    pov: z.string().optional().describe(statsConfig.arguments.pov),
+    dbPath: z.string().default(DEFAULT_DB_PATH).describe(statsConfig.arguments.dbPath),
+});
+function parseFilter(value) {
+    if (!value)
+        return undefined;
+    return value.split(',').map((v) => v.trim().toLowerCase());
+}
+export async function stats(input) {
+    const { arc, pov, dbPath } = statsSchema.parse(input);
+    const arcFilter = parseFilter(arc);
+    const povFilter = parseFilter(pov);
+    const db = new Database(dbPath);
+    let chapters = await db.getChapters();
+    db.close();
+    if (chapters.length === 0) {
+        throw new Error('No indexed chapters found. Run "index" first.');
+    }
+    // Normalize POV to lowercase for comparison
+    chapters = chapters.map((c) => ({ ...c, pov: c.pov.toLowerCase() }));
+    if (arcFilter) {
+        chapters = chapters.filter((c) => arcFilter.includes(c.arc.toLowerCase()));
+        if (chapters.length === 0) {
+            throw new Error(`No chapters found for arc "${arc}".`);
+        }
+    }
+    if (povFilter) {
+        chapters = chapters.filter((c) => povFilter.includes(c.pov));
+        if (chapters.length === 0) {
+            throw new Error(`No chapters found for POV "${pov}".`);
+        }
+    }
+    const arcs = [...new Set(chapters.map((c) => c.arc))].sort();
+    const povs = {};
+    let totalWords = 0;
+    for (const chapter of chapters) {
+        totalWords += chapter.word_count;
+        povs[chapter.pov] = (povs[chapter.pov] || 0) + 1;
+    }
+    return {
+        totalChapters: chapters.length,
+        totalWords,
+        arcs,
+        povs,
+        averageWordsPerChapter: Math.round(totalWords / chapters.length),
+    };
+}
+//# sourceMappingURL=stats.js.map

package/lib/tools/stats.js.map

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

package/lib/tools/words-count.d.ts

@@ -0,0 +1,18 @@
+import z from 'zod';
+import type { ToolConfig } from '../types.js';
+export declare const wordsCountConfig: ToolConfig;
+export declare const wordsCountSchema: z.ZodObject<{
+    filePath: z.ZodString;
+    detailed: z.ZodOptional<z.ZodBoolean>;
+}, z.z.core.$strip>;
+export type WordsCountInput = z.infer<typeof wordsCountSchema>;
+export interface WordsCountOutput {
+    words: number;
+    characters: number;
+    charactersNoSpaces: number;
+    readingTimeMinutes: number;
+    sentences?: number;
+    paragraphs?: number;
+}
+export declare function wordsCount(input: WordsCountInput): WordsCountOutput;
+//# sourceMappingURL=words-count.d.ts.map

package/lib/tools/words-count.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"words-count.d.ts","sourceRoot":"","sources":["words-count.ts"],"names":[],"mappings":"AAEA,OAAO,CAAC,MAAM,KAAK,CAAC;AAEpB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAG9C,eAAO,MAAM,gBAAgB,EAAE,UAO9B,CAAC;AAEF,eAAO,MAAM,gBAAgB;;;mBAG3B,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE/D,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,gBAAgB,CAkBnE"}

package/lib/tools/words-count.js

@@ -0,0 +1,31 @@
+import { readFileSync } from 'node:fs';
+import z from 'zod';
+import { parseChapter } from '../utils.js';
+export const wordsCountConfig = {
+    name: 'words-count',
+    description: 'Counts the number of words in a given text file.',
+    arguments: {
+        filePath: 'Path to the text file to be analyzed.',
+        detailed: 'Include detailed statistics.',
+    },
+};
+export const wordsCountSchema = z.object({
+    filePath: z.string().describe(wordsCountConfig.arguments.filePath),
+    detailed: z.boolean().optional().describe(wordsCountConfig.arguments.detailed),
+});
+export function wordsCount(input) {
+    const { filePath, detailed = false } = wordsCountSchema.parse(input);
+    const { stats } = parseChapter(readFileSync(filePath, 'utf-8'));
+    const result = {
+        words: stats.wordCount,
+        characters: stats.charCountWithSpaces,
+        charactersNoSpaces: stats.charCount,
+        readingTimeMinutes: stats.readingTimeMinutes,
+    };
+    if (detailed) {
+        result.sentences = stats.sentenceCount;
+        result.paragraphs = stats.paragraphCount;
+    }
+    return result;
+}
+//# sourceMappingURL=words-count.js.map

package/lib/tools/words-count.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"words-count.js","sourceRoot":"","sources":["words-count.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,OAAO,CAAC,MAAM,KAAK,CAAC;AAGpB,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,CAAC,MAAM,gBAAgB,GAAe;IAC1C,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE,kDAAkD;IAC/D,SAAS,EAAE;QACT,QAAQ,EAAE,uCAAuC;QACjD,QAAQ,EAAE,8BAA8B;KACzC;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC,SAAS,CAAC,QAAQ,CAAC;IAClE,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC,SAAS,CAAC,QAAQ,CAAC;CAC/E,CAAC,CAAC;AAaH,MAAM,UAAU,UAAU,CAAC,KAAsB;IAC/C,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,KAAK,EAAE,GAAG,gBAAgB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAErE,MAAM,EAAE,KAAK,EAAE,GAAG,YAAY,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;IAEhE,MAAM,MAAM,GAAqB;QAC/B,KAAK,EAAE,KAAK,CAAC,SAAS;QACtB,UAAU,EAAE,KAAK,CAAC,mBAAmB;QACrC,kBAAkB,EAAE,KAAK,CAAC,SAAS;QACnC,kBAAkB,EAAE,KAAK,CAAC,kBAAkB;KAC7C,CAAC;IAEF,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,CAAC,SAAS,GAAG,KAAK,CAAC,aAAa,CAAC;QACvC,MAAM,CAAC,UAAU,GAAG,KAAK,CAAC,cAAc,CAAC;IAC3C,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/lib/types.d.ts

@@ -0,0 +1,29 @@
+export interface Package {
+    name: string;
+    description: string;
+    version: string;
+}
+export interface ToolConfig {
+    name: string;
+    description: string;
+    arguments: Record<string, string>;
+}
+export interface ChapterMetadata {
+    pov: string;
+    title: string;
+    date: string;
+    timeline: string;
+    arc: string;
+    episode: number;
+    part: number;
+    chapter: number;
+    summary: string;
+    location: string;
+    outfit?: string;
+    kink?: string;
+}
+export interface ParsedMarkdown {
+    metadata: ChapterMetadata;
+    content: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,eAAe,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/lib/types.js

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

package/lib/types.js.map

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

package/lib/utils.d.ts

@@ -0,0 +1,19 @@
+import type { ChapterMetadata, Package, ParsedMarkdown } from './types.js';
+export declare function getPackageConfig(): Package;
+export interface TextStats {
+    wordCount: number;
+    charCount: number;
+    charCountWithSpaces: number;
+    paragraphCount: number;
+    sentenceCount: number;
+    readingTimeMinutes: number;
+}
+export interface ParsedChapter {
+    metadata: ChapterMetadata;
+    content: string;
+    plainText: string;
+    stats: TextStats;
+}
+export declare function parseMarkdown(markdown: string): ParsedMarkdown;
+export declare function parseChapter(markdown: string): ParsedChapter;
+//# sourceMappingURL=utils.d.ts.map

package/lib/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["utils.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE3E,wBAAgB,gBAAgB,IAAI,OAAO,CAG1C;AAED,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,eAAe,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,SAAS,CAAC;CAClB;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CAW9D;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,CAuB5D"}

package/lib/utils.js

@@ -0,0 +1,40 @@
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import matter from 'gray-matter';
+import removeMd from 'remove-markdown';
+export function getPackageConfig() {
+    const packagePath = join(import.meta.dirname, '..', 'package.json');
+    return JSON.parse(readFileSync(packagePath, 'utf8'));
+}
+export function parseMarkdown(markdown) {
+    const { data, content } = matter(markdown);
+    if (data.date instanceof Date) {
+        data.date = data.date.toISOString().split('T')[0];
+    }
+    return {
+        metadata: data,
+        content: content.trim(),
+    };
+}
+export function parseChapter(markdown) {
+    const { metadata, content } = parseMarkdown(markdown);
+    // Strip markdown to plain text
+    const withoutHeaders = content.replace(/^#{1,6}\s+.*$/gm, '');
+    const plainText = removeMd(withoutHeaders);
+    // Compute all stats
+    const wordCount = plainText.split(/\s+/).filter((w) => w.length > 0).length;
+    return {
+        metadata,
+        content,
+        plainText,
+        stats: {
+            wordCount,
+            charCount: plainText.replace(/\s/g, '').length,
+            charCountWithSpaces: plainText.length,
+            paragraphCount: plainText.split(/\n\s*\n/).filter((p) => p.trim().length > 0).length,
+            sentenceCount: plainText.split(/[.!?]+/).filter((s) => s.trim().length > 0).length,
+            readingTimeMinutes: Math.ceil(wordCount / 200),
+        },
+    };
+}
+//# sourceMappingURL=utils.js.map

package/lib/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,QAAQ,MAAM,iBAAiB,CAAC;AAIvC,MAAM,UAAU,gBAAgB;IAC9B,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;IACpE,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAY,CAAC;AAClE,CAAC;AAkBD,MAAM,UAAU,aAAa,CAAC,QAAgB;IAC5C,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;IAE3C,IAAI,IAAI,CAAC,IAAI,YAAY,IAAI,EAAE,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACpD,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,IAAuB;QACjC,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE;KACxB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,QAAgB;IAC3C,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IAEtD,+BAA+B;IAC/B,MAAM,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;IAC9D,MAAM,SAAS,GAAG,QAAQ,CAAC,cAAc,CAAC,CAAC;IAE3C,oBAAoB;IACpB,MAAM,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;IAE5E,OAAO;QACL,QAAQ;QACR,OAAO;QACP,SAAS;QACT,KAAK,EAAE;YACL,SAAS;YACT,SAAS,EAAE,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,MAAM;YAC9C,mBAAmB,EAAE,SAAS,CAAC,MAAM;YACrC,cAAc,EAAE,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,MAAM;YACpF,aAAa,EAAE,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,MAAM;YAClF,kBAAkB,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,GAAG,GAAG,CAAC;SAC/C;KACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,57 +1,60 @@
 {
   "name": "@echoes-io/mcp-server",
+  "version": "6.0.0",
+  "description": "📚 Model Context Protocol server for AI-powered storytelling with Narrative Knowledge Graph - extract characters, locations, relationships and search your stories semantically.",
   "type": "module",
-  "version": "4.1.0",
-  "description": "Model Context Protocol server for AI integration with Echoes storytelling platform",
+  "bin": {
+    "echoes": "cli/index.js"
+  },
+  "files": [
+    "cli/**/*.js",
+    "cli/**/*.d.ts",
+    "cli/**/*.map",
+    "lib/**/*.js",
+    "lib/**/*.d.ts",
+    "lib/**/*.map",
+    "README.md",
+    "LICENSE"
+  ],
   "scripts": {
-    "dev": "tsx cli/index.ts",
-    "db:generate": "drizzle-kit generate",
-    "db:migrate": "drizzle-kit migrate",
-    "db:studio": "drizzle-kit studio",
+    "prebuild": "npm run clean",
+    "build": "tsc",
+    "pretest": "npm run clean",
+    "test": "vitest run",
+    "pretest:coverage": "npm run clean",
+    "test:coverage": "vitest run --coverage",
+    "posttest:coverage": "coverage-badge-readme",
     "prelint": "npm run build",
     "lint": "concurrently npm:lint:* --prefixColors auto",
-    "postlint": "npm run clean",
     "lint:format": "biome check --write",
+    "lint:package": "npmPkgJsonLint .",
     "lint:lockfile": "lockfile-lint --path package-lock.json",
     "lint:engines": "ls-engines",
     "lint:publish": "publint --strict",
-    "pretest": "npm run clean",
-    "test": "vitest run",
-    "pretest:coverage": "npm run clean",
-    "test:coverage": "vitest run --coverage",
-    "check": "npm run test:coverage && npm run lint",
-    "prepare": "[ \"$CI\" = \"true\" ] || [ \"$GITHUB_ACTIONS\" = \"true\" ] && echo 'Skipping husky' && exit 0 || husky",
-    "clean": "rimraf --glob ./{cli,src,test}/**/*.{d.ts,js} ./{drizzle,vitest}*.{d.ts,js}",
-    "prebuild": "npm run clean",
-    "build": "tsc",
-    "release": "semantic-release"
-  },
-  "bin": {
-    "echoes-mcp-server": "./cli/index.js"
-  },
-  "exports": {
-    ".": "./src/database/index.js"
-  },
-  "files": [
-    "cli/**/*.{d.ts,js}",
-    "lib/**/*.{d.ts,js}",
-    "src/**/*.{d.ts,js}"
-  ],
-  "engines": {
-    "node": ">= 20.3"
-  },
-  "publishConfig": {
-    "access": "public",
-    "provenance": true
+    "postlint": "npm run clean",
+    "clean": "rimraf --glob ./{cli,lib,scripts,test}/**/*.{d.ts,js,map} ./vitest*.{d.ts,js,map}",
+    "prepare": "[ \"$CI\" = \"true\" ] || [ \"$GITHUB_ACTIONS\" = \"true\" ] && echo 'Skipping husky' && exit 0 || husky"
   },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/echoes-io/mcp-server.git"
   },
   "keywords": [
-    "echoes",
+    "mcp",
+    "model-context-protocol",
     "storytelling",
-    "multi-pov"
+    "narrative",
+    "knowledge-graph",
+    "rag",
+    "semantic-search",
+    "entity-extraction",
+    "lancedb",
+    "vector-database",
+    "gemini",
+    "embeddings",
+    "typescript",
+    "ai",
+    "llm"
   ],
   "author": "Zweer <n.olivieriachille@gmail.com>",
   "license": "MIT",
@@ -59,45 +62,40 @@
     "url": "https://github.com/echoes-io/mcp-server/issues"
   },
   "homepage": "https://github.com/echoes-io/mcp-server#readme",
-  "release": {
-    "plugins": [
-      "@semantic-release/commit-analyzer",
-      "@semantic-release/release-notes-generator",
-      "@semantic-release/changelog",
-      "@semantic-release/npm",
-      "@semantic-release/github",
-      "@semantic-release/git"
-    ]
+  "engines": {
+    "node": ">=20.3"
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.3.8",
+    "@biomejs/biome": "^2.3.10",
     "@semantic-release/changelog": "^6.0.3",
     "@semantic-release/git": "^10.0.1",
     "@tsconfig/node22": "^22.0.5",
-    "@types/better-sqlite3": "^7.6.11",
-    "@types/node": "^24.10.1",
-    "@vitest/coverage-v8": "^4.0.15",
+    "@types/node": "^25.0.3",
+    "@vitest/coverage-v8": "^4.0.16",
+    "@zweer/coverage-badge-readme": "^1.2.2",
     "concurrently": "^9.2.1",
-    "drizzle-kit": "^1.0.0-beta.3-36e9b9e",
-    "fast-check": "^4.4.0",
     "husky": "^9.1.7",
     "lint-staged": "^16.2.7",
     "lockfile-lint": "^4.14.1",
-    "ls-engines": "^0.9.3",
-    "publint": "^0.3.15",
-    "rimraf": "^6.1.2",
+    "ls-engines": "^0.9.4",
+    "npm-package-json-lint": "^9.0.0",
+    "npm-package-json-lint-config-default": "^8.0.1",
+    "publint": "^0.3.16",
     "semantic-release": "^25.0.2",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",
-    "vitest": "^4.0.15"
+    "vitest": "^4.0.16"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.24.2",
-    "better-sqlite3": "^11.0.0",
-    "drizzle-orm": "^1.0.0-beta.3-36e9b9e",
+    "@commander-js/extra-typings": "^14.0.0",
+    "@google/genai": "^1.34.0",
+    "@huggingface/transformers": "^3.8.1",
+    "@lancedb/lancedb": "^0.23.0",
+    "@modelcontextprotocol/sdk": "^1.25.1",
+    "apache-arrow": "^18.1.0",
+    "commander": "^14.0.2",
     "gray-matter": "^4.0.3",
     "remove-markdown": "^0.6.2",
-    "sqlite-vec": "^0.1.7-alpha.2",
-    "zod": "^4.1.12"
+    "zod": "^4.2.1"
   }
 }