@echoes-io/mcp-server 2.2.0 → 4.0.0

package/lib/tools/chapter-refresh.js

@@ -1,78 +0,0 @@
-import { readFileSync } from 'node:fs';
-import { getTextStats, parseMarkdown } from '@echoes-io/utils';
-import { z } from 'zod';
-export const chapterRefreshSchema = z.object({
-    timeline: z.string().describe('Timeline name'),
-    file: z.string().describe('Path to chapter markdown file'),
-});
-export async function chapterRefresh(args, tracker) {
-    try {
-        const content = readFileSync(args.file, 'utf-8');
-        const { metadata, content: markdownContent } = parseMarkdown(content);
-        const stats = getTextStats(markdownContent);
-        const arc = metadata.arc;
-        const episode = metadata.episode;
-        const chapter = metadata.chapter;
-        if (!arc || !episode || !chapter) {
-            throw new Error('Missing required metadata: arc, episode, or chapter');
-        }
-        const existing = await tracker.getChapter(args.timeline, arc, episode, chapter);
-        if (!existing) {
-            throw new Error(`Chapter not found in database: ${args.timeline}/${arc}/ep${episode}/ch${chapter}`);
-        }
-        const chapterData = {
-            timelineName: args.timeline,
-            arcName: arc,
-            episodeNumber: episode,
-            partNumber: metadata.part || 1,
-            number: chapter,
-            pov: metadata.pov || 'Unknown',
-            title: metadata.title || 'Untitled',
-            date: new Date(metadata.date || Date.now()).toISOString(),
-            summary: metadata.summary || '',
-            location: metadata.location || '',
-            outfit: metadata.outfit || '',
-            kink: metadata.kink || '',
-            words: stats.words,
-            characters: stats.characters,
-            charactersNoSpaces: stats.charactersNoSpaces,
-            paragraphs: stats.paragraphs,
-            sentences: stats.sentences,
-            readingTimeMinutes: Math.ceil(stats.words / 200),
-        };
-        await tracker.updateChapter(args.timeline, arc, episode, chapter, chapterData);
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: JSON.stringify({
-                        file: args.file,
-                        timeline: args.timeline,
-                        arc,
-                        episode,
-                        chapter,
-                        updated: {
-                            metadata: {
-                                pov: chapterData.pov,
-                                title: chapterData.title,
-                                date: chapterData.date,
-                                summary: chapterData.summary,
-                                location: chapterData.location,
-                            },
-                            stats: {
-                                words: stats.words,
-                                characters: stats.characters,
-                                paragraphs: stats.paragraphs,
-                                sentences: stats.sentences,
-                                readingTimeMinutes: chapterData.readingTimeMinutes,
-                            },
-                        },
-                    }, null, 2),
-                },
-            ],
-        };
-    }
-    catch (error) {
-        throw new Error(`Failed to refresh chapter: ${error instanceof Error ? error.message : 'Unknown error'}`);
-    }
-}

package/lib/tools/episode-info.d.ts

@@ -1,13 +0,0 @@
-import type { Tracker } from '@echoes-io/tracker';
-import { z } from 'zod';
-export declare const episodeInfoSchema: z.ZodObject<{
-    timeline: z.ZodString;
-    arc: z.ZodString;
-    episode: z.ZodNumber;
-}, z.core.$strip>;
-export declare function episodeInfo(args: z.infer<typeof episodeInfoSchema>, tracker: Tracker): Promise<{
-    content: {
-        type: "text";
-        text: string;
-    }[];
-}>;

package/lib/tools/episode-info.js

@@ -1,45 +0,0 @@
-import { z } from 'zod';
-export const episodeInfoSchema = z.object({
-    timeline: z.string().describe('Timeline name'),
-    arc: z.string().describe('Arc name'),
-    episode: z.number().describe('Episode number'),
-});
-export async function episodeInfo(args, tracker) {
-    try {
-        const episode = await tracker.getEpisode(args.timeline, args.arc, args.episode);
-        if (!episode) {
-            throw new Error(`Episode not found: ${args.timeline}/${args.arc}/ep${args.episode}`);
-        }
-        const chapters = await tracker.getChapters(args.timeline, args.arc, args.episode);
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: JSON.stringify({
-                        timeline: args.timeline,
-                        arc: args.arc,
-                        episodeInfo: {
-                            number: episode.number,
-                            title: episode.title,
-                            slug: episode.slug,
-                            description: episode.description,
-                        },
-                        chapters: chapters.map((ch) => ({
-                            number: ch.number,
-                            pov: ch.pov,
-                            title: ch.title,
-                            words: ch.words,
-                        })),
-                        stats: {
-                            totalChapters: chapters.length,
-                            totalWords: chapters.reduce((sum, ch) => sum + ch.words, 0),
-                        },
-                    }, null, 2),
-                },
-            ],
-        };
-    }
-    catch (error) {
-        throw new Error(`Failed to get episode info: ${error instanceof Error ? error.message : 'Unknown error'}`);
-    }
-}

package/lib/tools/episode-update.d.ts

@@ -1,16 +0,0 @@
-import type { Tracker } from '@echoes-io/tracker';
-import { z } from 'zod';
-export declare const episodeUpdateSchema: z.ZodObject<{
-    timeline: z.ZodString;
-    arc: z.ZodString;
-    episode: z.ZodNumber;
-    description: z.ZodOptional<z.ZodString>;
-    title: z.ZodOptional<z.ZodString>;
-    slug: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-export declare function episodeUpdate(args: z.infer<typeof episodeUpdateSchema>, tracker: Tracker): Promise<{
-    content: {
-        type: "text";
-        text: string;
-    }[];
-}>;

package/lib/tools/episode-update.js

@@ -1,42 +0,0 @@
-import { z } from 'zod';
-export const episodeUpdateSchema = z.object({
-    timeline: z.string().describe('Timeline name'),
-    arc: z.string().describe('Arc name'),
-    episode: z.number().describe('Episode number'),
-    description: z.string().optional().describe('Episode description'),
-    title: z.string().optional().describe('Episode title'),
-    slug: z.string().optional().describe('Episode slug'),
-});
-export async function episodeUpdate(args, tracker) {
-    try {
-        const existing = await tracker.getEpisode(args.timeline, args.arc, args.episode);
-        if (!existing) {
-            throw new Error(`Episode not found: ${args.timeline}/${args.arc}/ep${args.episode}`);
-        }
-        const updateData = {};
-        if (args.description !== undefined)
-            updateData.description = args.description;
-        if (args.title !== undefined)
-            updateData.title = args.title;
-        if (args.slug !== undefined)
-            updateData.slug = args.slug;
-        await tracker.updateEpisode(args.timeline, args.arc, args.episode, updateData);
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: JSON.stringify({
-                        timeline: args.timeline,
-                        arc: args.arc,
-                        episode: args.episode,
-                        updated: updateData,
-                        message: 'Episode successfully updated',
-                    }, null, 2),
-                },
-            ],
-        };
-    }
-    catch (error) {
-        throw new Error(`Failed to update episode: ${error instanceof Error ? error.message : 'Unknown error'}`);
-    }
-}

package/lib/tools/index.d.ts

@@ -1,14 +0,0 @@
-export { bookGenerate, bookGenerateSchema } from './book-generate.js';
-export { chapterDelete, chapterDeleteSchema } from './chapter-delete.js';
-export { chapterInfo, chapterInfoSchema } from './chapter-info.js';
-export { chapterInsert, chapterInsertSchema } from './chapter-insert.js';
-export { chapterRefresh, chapterRefreshSchema } from './chapter-refresh.js';
-export { episodeInfo, episodeInfoSchema } from './episode-info.js';
-export { episodeUpdate, episodeUpdateSchema } from './episode-update.js';
-export { ragCharacters, ragCharactersSchema } from './rag-characters.js';
-export { ragContext, ragContextSchema } from './rag-context.js';
-export { ragIndex, ragIndexSchema } from './rag-index.js';
-export { ragSearch, ragSearchSchema } from './rag-search.js';
-export { stats, statsSchema } from './stats.js';
-export { timelineSync, timelineSyncSchema } from './timeline-sync.js';
-export { wordsCount, wordsCountSchema } from './words-count.js';

package/lib/tools/index.js

@@ -1,14 +0,0 @@
-export { bookGenerate, bookGenerateSchema } from './book-generate.js';
-export { chapterDelete, chapterDeleteSchema } from './chapter-delete.js';
-export { chapterInfo, chapterInfoSchema } from './chapter-info.js';
-export { chapterInsert, chapterInsertSchema } from './chapter-insert.js';
-export { chapterRefresh, chapterRefreshSchema } from './chapter-refresh.js';
-export { episodeInfo, episodeInfoSchema } from './episode-info.js';
-export { episodeUpdate, episodeUpdateSchema } from './episode-update.js';
-export { ragCharacters, ragCharactersSchema } from './rag-characters.js';
-export { ragContext, ragContextSchema } from './rag-context.js';
-export { ragIndex, ragIndexSchema } from './rag-index.js';
-export { ragSearch, ragSearchSchema } from './rag-search.js';
-export { stats, statsSchema } from './stats.js';
-export { timelineSync, timelineSyncSchema } from './timeline-sync.js';
-export { wordsCount, wordsCountSchema } from './words-count.js';

package/lib/tools/rag-characters.d.ts

@@ -1,12 +0,0 @@
-import type { RAGSystem } from '@echoes-io/rag';
-import { z } from 'zod';
-export declare const ragCharactersSchema: z.ZodObject<{
-    timeline: z.ZodString;
-    character: z.ZodString;
-}, z.core.$strip>;
-export declare function ragCharacters(args: z.infer<typeof ragCharactersSchema>, rag: RAGSystem): Promise<{
-    content: {
-        type: "text";
-        text: string;
-    }[];
-}>;

package/lib/tools/rag-characters.js

@@ -1,26 +0,0 @@
-import { z } from 'zod';
-export const ragCharactersSchema = z.object({
-    timeline: z.string().describe('Timeline name'),
-    character: z.string().describe('Character name to find co-occurrences for'),
-});
-export async function ragCharacters(args, rag) {
-    try {
-        const characters = await rag.getCharacterMentions(args.character);
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: JSON.stringify({
-                        character: args.character,
-                        timeline: args.timeline,
-                        coOccurringCharacters: characters.filter((c) => c !== args.character).sort(),
-                        total: characters.length - 1,
-                    }, null, 2),
-                },
-            ],
-        };
-    }
-    catch (error) {
-        throw new Error(`Failed to get character mentions: ${error instanceof Error ? error.message : 'Unknown error'}`);
-    }
-}

package/lib/tools/rag-context.d.ts

@@ -1,16 +0,0 @@
-import type { RAGSystem } from '@echoes-io/rag';
-import { z } from 'zod';
-export declare const ragContextSchema: z.ZodObject<{
-    timeline: z.ZodString;
-    query: z.ZodString;
-    arc: z.ZodOptional<z.ZodString>;
-    pov: z.ZodOptional<z.ZodString>;
-    maxChapters: z.ZodOptional<z.ZodNumber>;
-    characters: z.ZodOptional<z.ZodArray<z.ZodString>>;
-}, z.core.$strip>;
-export declare function ragContext(args: z.infer<typeof ragContextSchema>, rag: RAGSystem): Promise<{
-    content: {
-        type: "text";
-        text: string;
-    }[];
-}>;

package/lib/tools/rag-context.js

@@ -1,54 +0,0 @@
-import { z } from 'zod';
-export const ragContextSchema = z.object({
-    timeline: z.string().describe('Timeline name'),
-    query: z.string().describe('Context query'),
-    arc: z.string().optional().describe('Filter by arc name'),
-    pov: z.string().optional().describe('Filter by POV character'),
-    maxChapters: z.number().optional().describe('Maximum number of chapters (default: 5)'),
-    characters: z
-        .array(z.string())
-        .optional()
-        .describe('Filter by character names present in chapter'),
-});
-export async function ragContext(args, rag) {
-    try {
-        const results = await rag.getContext({
-            query: args.query,
-            timeline: args.timeline,
-            arc: args.arc,
-            pov: args.pov,
-            maxChapters: args.maxChapters,
-            characters: args.characters,
-        });
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: JSON.stringify({
-                        query: args.query,
-                        timeline: args.timeline,
-                        filters: {
-                            arc: args.arc || null,
-                            pov: args.pov || null,
-                        },
-                        context: results.map((r) => ({
-                            chapter: {
-                                arc: r.metadata.arcName,
-                                episode: r.metadata.episodeNumber,
-                                chapter: r.metadata.number,
-                                pov: r.metadata.pov,
-                                title: r.metadata.title,
-                                characters: r.metadata.characterNames || [],
-                            },
-                            similarity: r.similarity,
-                            content: r.content,
-                        })),
-                    }, null, 2),
-                },
-            ],
-        };
-    }
-    catch (error) {
-        throw new Error(`Failed to get context: ${error instanceof Error ? error.message : 'Unknown error'}`);
-    }
-}

package/lib/tools/rag-index.d.ts

@@ -1,18 +0,0 @@
-import type { RAGSystem } from '@echoes-io/rag';
-import type { Tracker } from '@echoes-io/tracker';
-import { z } from 'zod';
-export declare const ragIndexSchema: z.ZodObject<{
-    timeline: z.ZodString;
-    arc: z.ZodOptional<z.ZodString>;
-    episode: z.ZodOptional<z.ZodNumber>;
-}, z.core.$strip>;
-type RagIndexArgs = z.infer<typeof ragIndexSchema> & {
-    contentPath: string;
-};
-export declare function ragIndex(args: RagIndexArgs, tracker: Tracker, rag: RAGSystem): Promise<{
-    content: {
-        type: "text";
-        text: string;
-    }[];
-}>;
-export {};

package/lib/tools/rag-index.js

@@ -1,89 +0,0 @@
-import { readdirSync, readFileSync } from 'node:fs';
-import { join } from 'node:path';
-import { parseMarkdown } from '@echoes-io/utils';
-import { z } from 'zod';
-export const ragIndexSchema = z.object({
-    timeline: z.string().describe('Timeline name'),
-    arc: z.string().optional().describe('Index specific arc only'),
-    episode: z.number().optional().describe('Index specific episode only (requires arc)'),
-});
-export async function ragIndex(args, tracker, rag) {
-    try {
-        let chapters = [];
-        // Get chapters based on filters
-        if (args.arc && args.episode) {
-            chapters = await tracker.getChapters(args.timeline, args.arc, args.episode);
-        }
-        else if (args.arc) {
-            const episodes = await tracker.getEpisodes(args.timeline, args.arc);
-            for (const ep of episodes) {
-                const epChapters = await tracker.getChapters(args.timeline, args.arc, ep.number);
-                chapters.push(...epChapters);
-            }
-        }
-        else {
-            const arcs = await tracker.getArcs(args.timeline);
-            for (const arc of arcs) {
-                const episodes = await tracker.getEpisodes(args.timeline, arc.name);
-                for (const ep of episodes) {
-                    const epChapters = await tracker.getChapters(args.timeline, arc.name, ep.number);
-                    chapters.push(...epChapters);
-                }
-            }
-        }
-        // Convert to embedding format and add to RAG
-        const embeddingChapters = chapters
-            .map((ch) => {
-            // Read actual file content
-            try {
-                // Find episode directory
-                const episodeDir = `ep${String(ch.episodeNumber).padStart(2, '0')}`;
-                const arcPath = join(args.contentPath, ch.arcName);
-                const episodePath = readdirSync(arcPath, { withFileTypes: true })
-                    .filter((e) => e.isDirectory() && e.name.startsWith(episodeDir))
-                    .map((e) => join(arcPath, e.name))[0];
-                if (!episodePath) {
-                    console.error(`Episode directory not found for ${ch.arcName}/ep${ch.episodeNumber}`);
-                    return null;
-                }
-                // Find chapter file by episode and chapter number (filename-agnostic for title/pov)
-                const chapterPattern = `ep${String(ch.episodeNumber).padStart(2, '0')}-ch${String(ch.number).padStart(3, '0')}-`;
-                const chapterFiles = readdirSync(episodePath).filter((f) => f.startsWith(chapterPattern) && f.endsWith('.md'));
-                if (chapterFiles.length === 0) {
-                    console.error(`Chapter file not found for ${ch.arcName}/ep${ch.episodeNumber}/ch${ch.number}`);
-                    return null;
-                }
-                const filePath = join(episodePath, chapterFiles[0]);
-                const fileContent = readFileSync(filePath, 'utf-8');
-                const { content } = parseMarkdown(fileContent);
-                return {
-                    id: `${ch.timelineName}-${ch.arcName}-${ch.episodeNumber}-${ch.number}`,
-                    metadata: ch,
-                    content,
-                };
-            }
-            catch (error) {
-                console.error(`Error reading chapter ${ch.arcName}/ep${ch.episodeNumber}/ch${ch.number}:`, error);
-                return null;
-            }
-        })
-            .filter((ch) => ch !== null);
-        await rag.addChapters(embeddingChapters);
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: JSON.stringify({
-                        indexed: embeddingChapters.length,
-                        timeline: args.timeline,
-                        arc: args.arc || 'all',
-                        episode: args.episode || 'all',
-                    }, null, 2),
-                },
-            ],
-        };
-    }
-    catch (error) {
-        throw new Error(`Failed to index chapters: ${error instanceof Error ? error.message : 'Unknown error'}`);
-    }
-}

package/lib/tools/rag-search.d.ts

@@ -1,17 +0,0 @@
-import type { RAGSystem } from '@echoes-io/rag';
-import { z } from 'zod';
-export declare const ragSearchSchema: z.ZodObject<{
-    timeline: z.ZodString;
-    query: z.ZodString;
-    arc: z.ZodOptional<z.ZodString>;
-    pov: z.ZodOptional<z.ZodString>;
-    maxResults: z.ZodOptional<z.ZodNumber>;
-    characters: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    allCharacters: z.ZodOptional<z.ZodBoolean>;
-}, z.core.$strip>;
-export declare function ragSearch(args: z.infer<typeof ragSearchSchema>, rag: RAGSystem): Promise<{
-    content: {
-        type: "text";
-        text: string;
-    }[];
-}>;

package/lib/tools/rag-search.js

@@ -1,58 +0,0 @@
-import { z } from 'zod';
-export const ragSearchSchema = z.object({
-    timeline: z.string().describe('Timeline name'),
-    query: z.string().describe('Search query'),
-    arc: z.string().optional().describe('Filter by arc name'),
-    pov: z.string().optional().describe('Filter by POV character'),
-    maxResults: z.number().optional().describe('Maximum number of results (default: 10)'),
-    characters: z
-        .array(z.string())
-        .optional()
-        .describe('Filter by character names present in chapter'),
-    allCharacters: z
-        .boolean()
-        .optional()
-        .describe('If true, all characters must be present (AND). If false, at least one (OR). Default: false'),
-});
-export async function ragSearch(args, rag) {
-    try {
-        const results = await rag.search(args.query, {
-            timeline: args.timeline,
-            arc: args.arc,
-            pov: args.pov,
-            maxResults: args.maxResults,
-            characters: args.characters,
-            allCharacters: args.allCharacters,
-        });
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: JSON.stringify({
-                        query: args.query,
-                        timeline: args.timeline,
-                        filters: {
-                            arc: args.arc || null,
-                            pov: args.pov || null,
-                        },
-                        results: results.map((r) => ({
-                            chapter: {
-                                arc: r.metadata.arcName,
-                                episode: r.metadata.episodeNumber,
-                                chapter: r.metadata.number,
-                                pov: r.metadata.pov,
-                                title: r.metadata.title,
-                                characters: r.metadata.characterNames || [],
-                            },
-                            similarity: r.similarity,
-                            preview: `${r.content.substring(0, 200)}...`,
-                        })),
-                    }, null, 2),
-                },
-            ],
-        };
-    }
-    catch (error) {
-        throw new Error(`Failed to search: ${error instanceof Error ? error.message : 'Unknown error'}`);
-    }
-}

package/lib/tools/stats.d.ts

@@ -1,14 +0,0 @@
-import type { Tracker } from '@echoes-io/tracker';
-import { z } from 'zod';
-export declare const statsSchema: z.ZodObject<{
-    timeline: z.ZodString;
-    arc: z.ZodOptional<z.ZodString>;
-    episode: z.ZodOptional<z.ZodNumber>;
-    pov: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-export declare function stats(args: z.infer<typeof statsSchema>, tracker: Tracker): Promise<{
-    content: {
-        type: "text";
-        text: string;
-    }[];
-}>;