@echoes-io/mcp-server 1.3.1 → 1.3.3

package/README.md

@@ -97,8 +97,9 @@ All tools operate on the timeline specified by the `ECHOES_TIMELINE` environment
 
 ### RAG (Semantic Search)
 - **`rag-index`** - Index chapters into vector database for semantic search
-  - Input: optional: `arc`, `episode` (to index specific content)
+  - Input: `contentPath` (path to content directory, required for full content indexing), optional: `arc`, `episode` (to index specific content)
   - Output: Number of chapters indexed
+  - Note: Requires `contentPath` to read and index actual chapter content. Without it, only metadata is indexed.
   
 - **`rag-search`** - Semantic search across timeline content
   - Input: `query`, optional: `arc`, `pov`, `maxResults`
@@ -133,7 +134,7 @@ npm run build
 npm run lint
 
 # Fix linting issues
-npm run lint:fix
+npm run lint:format
 ```
 
 ### Tech Stack

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

@@ -2,12 +2,15 @@ import type { RAGSystem } from '@echoes-io/rag';
 import type { Tracker } from '@echoes-io/tracker';
 import { z } from 'zod';
 export declare const ragIndexSchema: z.ZodObject<{
+    contentPath: z.ZodOptional<z.ZodString>;
     arc: z.ZodOptional<z.ZodString>;
     episode: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
+    contentPath?: string | undefined;
     arc?: string | undefined;
     episode?: number | undefined;
 }, {
+    contentPath?: string | undefined;
     arc?: string | undefined;
     episode?: number | undefined;
 }>;

package/lib/tools/rag-index.js

@@ -1,6 +1,10 @@
+import { readdirSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { parseMarkdown } from '@echoes-io/utils';
 import { z } from 'zod';
 import { getTimeline } from '../utils.js';
 export const ragIndexSchema = z.object({
+    contentPath: z.string().optional().describe('Path to content directory (required for indexing)'),
     arc: z.string().optional().describe('Index specific arc only'),
     episode: z.number().optional().describe('Index specific episode only (requires arc)'),
 });
@@ -30,11 +34,50 @@ export async function ragIndex(args, tracker, rag) {
             }
         }
         // Convert to embedding format and add to RAG
-        const embeddingChapters = chapters.map((ch) => ({
-            id: `${ch.timelineName}-${ch.arcName}-${ch.episodeNumber}-${ch.number}`,
-            metadata: ch,
-            content: '', // Content will be loaded by RAG system if needed
-        }));
+        const embeddingChapters = chapters
+            .map((ch) => {
+            // If contentPath is provided, read actual file content
+            if (args.contentPath) {
+                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;
+                }
+            }
+            // Fallback: no content (for tests or when contentPath not provided)
+            return {
+                id: `${ch.timelineName}-${ch.arcName}-${ch.episodeNumber}-${ch.number}`,
+                metadata: ch,
+                content: '',
+            };
+        })
+            .filter((ch) => ch !== null);
         await rag.addChapters(embeddingChapters);
         return {
             content: [

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@echoes-io/mcp-server",
   "type": "module",
-  "version": "1.3.1",
+  "version": "1.3.3",
   "description": "Model Context Protocol server for AI integration with Echoes storytelling platform",
   "scripts": {
     "dev": "tsx cli/index.ts",
     "start": "node cli/index.js",
     "lint": "concurrently npm:lint:* --prefixColors auto",
-    "lint:fix": "biome check --write",
+    "lint:format": "biome check --write",
     "lint:lockfile": "lockfile-lint --path package-lock.json",
     "lint:engines": "ls-engines",
     "lint:publish": "publint --strict",
@@ -82,8 +82,8 @@
   },
   "dependencies": {
     "@echoes-io/books-generator": "^1.0.0",
-    "@echoes-io/models": "^1.0.0",
-    "@echoes-io/rag": "^1.1.0",
+    "@echoes-io/models": "^1.0.1",
+    "@echoes-io/rag": "^1.1.2",
     "@echoes-io/tracker": "^1.0.0",
     "@echoes-io/utils": "^1.1.1",
     "@modelcontextprotocol/sdk": "^1.0.0"