@echoes-io/mcp-server 4.1.0 → 6.0.0

package/README.md

@@ -1,245 +1,180 @@
-# mcp-server
+# Echoes MCP Server
 
-Model Context Protocol server for AI integration with Echoes storytelling platform
+[![CI](https://github.com/echoes-io/mcp-server/actions/workflows/ci.yml/badge.svg)](https://github.com/echoes-io/mcp-server/actions/workflows/ci.yml)
+[![npm](https://img.shields.io/npm/v/@echoes-io/mcp-server)](https://www.npmjs.com/package/@echoes-io/mcp-server)
+[![Node](https://img.shields.io/node/v/@echoes-io/mcp-server)](https://www.npmjs.com/package/@echoes-io/mcp-server)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+![Coverage Badge](https://img.shields.io/badge/coverage-100%25-brightgreen?style=flat)
 
-## Installation
+Model Context Protocol server for AI integration with Echoes storytelling platform.
 
-The server is distributed as an npm package and can be used without cloning the repository.
+## Features
 
-### Using with MCP Clients
+- **Narrative Knowledge Graph**: Automatically extracts characters, locations, events, and their relationships using Gemini AI
+- **Semantic Search**: Find relevant chapters using natural language queries
+- **Entity Search**: Search for characters, locations, and events
+- **Relation Search**: Explore relationships between entities
+- **Arc Isolation**: Each arc is a separate narrative universe - no cross-arc contamination
+- **Statistics**: Aggregate word counts, POV distribution, and more
+- **Dynamic Prompts**: Reusable prompt templates with placeholder substitution
 
-The server can run in three modes depending on the working directory:
+## Installation
 
-1. **Single Timeline Mode**: Run from a `timeline-*` directory to work with that specific timeline
-2. **Multi-Timeline Mode**: Run from `.github` directory to access all timelines
-3. **Test Mode**: Run from `mcp-server` directory for development
+```bash
+npm install -g @echoes-io/mcp-server
+```
 
-#### Single Timeline Configuration (Recommended for Kiro CLI)
+Or run directly with npx:
 
-```json
-{
-  "mcpServers": {
-    "echoes": {
-      "command": "npx",
-      "args": ["-y", "@echoes-io/mcp-server"],
-      "cwd": "/path/to/timeline-pulse"
-    }
-  }
-}
+```bash
+npx @echoes-io/mcp-server --help
 ```
 
-#### Multi-Timeline Configuration (Legacy/CAO)
+## Requirements
 
-```json
-{
-  "mcpServers": {
-    "echoes": {
-      "command": "npx",
-      "args": ["-y", "@echoes-io/mcp-server"],
-      "cwd": "/path/to/echoes-io/.github"
-    }
-  }
-}
-```
+- Node.js 20+
+- Gemini API key (for entity extraction)
+
+## Usage
 
-Or install globally:
+### CLI
 
 ```bash
-npm install -g @echoes-io/mcp-server
+# Count words in a markdown file
+echoes words-count ./content/arc1/ep01/ch001.md
+
+# Index timeline content
+echoes index ./content
+
+# Index only a specific arc
+echoes index ./content --arc bloom
+
+# Get statistics
+echoes stats
+echoes stats --arc arc1 --pov Alice
+
+# Search (filters by arc to avoid cross-arc contamination)
+echoes search "primo incontro" --arc bloom
+echoes search "Alice" --type entities --arc bloom
 ```
 
-Then configure:
+### MCP Server
+
+Configure in your MCP client (e.g., Claude Desktop, Kiro):
 
 ```json
 {
   "mcpServers": {
     "echoes": {
-      "command": "echoes-mcp-server",
-      "cwd": "/path/to/timeline-pulse",
+      "command": "npx",
+      "args": ["@echoes-io/mcp-server"],
+      "cwd": "/path/to/timeline",
       "env": {
-        "ECHOES_RAG_PROVIDER": "qwen3"
+        "GEMINI_API_KEY": "your_api_key"
       }
     }
   }
 }
 ```
 
-**Optional RAG Configuration:**
-- `ECHOES_RAG_PROVIDER`: Embedding provider (`qwen3`, `nomic-embed`, `bge-base`, `e5-large`, `e5-small`, or `gemini`). Default: `qwen3`
-- `ECHOES_GEMINI_API_KEY`: Required if using `gemini` provider
+## Environment Variables
 
-## Execution Modes
-
-### Single Timeline Mode (Recommended)
-Run from a timeline directory to work with that specific timeline:
-```bash
-cd timeline-pulse
-npx @echoes-io/mcp-server
-# [DEBUG] Mode: single-timeline "pulse"
-```
+| Variable | Required | Default | Description |
+|----------|----------|---------|-------------|
+| `GEMINI_API_KEY` | Yes | - | API key for Gemini entity extraction |
+| `ECHOES_GEMINI_MODEL` | No | `gemini-2.5-flash` | Gemini model for extraction |
+| `ECHOES_EMBEDDING_MODEL` | No | `Xenova/multilingual-e5-small` | HuggingFace embedding model |
+| `HF_TOKEN` | No | - | HuggingFace token for gated models |
 
-**Benefits:**
-- Simpler configuration for single-timeline workflows
-- Direct access to timeline databases
-- Perfect for Kiro CLI integration
+## Available Tools
 
-### Multi-Timeline Mode (Legacy)
-Run from `.github` directory to access all timelines:
-```bash
-cd .github
-npx @echoes-io/mcp-server
-# [DEBUG] Mode: multi-timeline (scanning /path/to/echoes-io)
-```
+| Tool | Description |
+|------|-------------|
+| `words-count` | Count words and statistics in a markdown file |
+| `index` | Index timeline content into LanceDB |
+| `search` | Search chapters, entities, or relations |
+| `stats` | Get aggregate statistics |
 
-**Benefits:**
-- Manage multiple timelines simultaneously
-- Backward compatible with CAO agents
-- Timeline repositories can be private
+## Available Prompts
 
-### Test Mode
-Run from `mcp-server` directory for development:
-```bash
-cd mcp-server
-npm run dev
-# [DEBUG] Mode: test from mcp-server (in-memory)
-```
+| Prompt | Arguments | Description |
+|--------|-----------|-------------|
+| `new-chapter` | arc, chapter | Create a new chapter |
+| `revise-chapter` | arc, chapter | Revise an existing chapter |
+| `expand-chapter` | arc, chapter, target | Expand chapter to target word count |
+| `new-character` | name | Create a new character sheet |
+| `new-episode` | arc, episode | Create a new episode outline |
+| `new-arc` | name | Create a new story arc |
+| `revise-arc` | arc | Review and fix an entire arc |
 
-## Timeline Architecture
+## Architecture
 
-Each timeline has isolated databases in its own repository:
+### Content Hierarchy
 
 ```
-echoes-io/
-  .github/              # Multi-timeline mode runs from here
-  timeline-eros/        # Private timeline repo
-    tracker.db          # Timeline-specific database
-    lancedb/            # Timeline-specific RAG vector database
-    content/...
-  timeline-other/       # Another private timeline
-    tracker.db
-    lancedb/
-    content/...
+Timeline (content directory)
+└── Arc (story universe)
+    └── Episode (story event)
+        └── Chapter (individual .md file)
 ```
 
-**Benefits:**
-- Each timeline has isolated databases in its own repository
-- Timeline repositories can be private while `.github` is public
-- No need to specify `contentPath` - auto-discovered from directory structure
-- Easy to manage access: just share/don't share specific timeline repos
+### Arc Isolation
 
+Each arc is treated as a separate narrative universe:
+- Entities are scoped to arcs: `bloom:CHARACTER:Alice` ≠ `work:CHARACTER:Alice`
+- Relations are internal to arcs
+- Searches can be filtered by arc to avoid cross-arc contamination
 
-## Available Tools
+### Data Flow
 
-All tools require a `timeline` parameter to specify which timeline to operate on.
-
-### Content Operations
-- **`words-count`** - Count words and text statistics in markdown files
-  - Input: `file` (path to markdown file)
-  
-- **`chapter-info`** - Extract chapter metadata from database
-  - Input: `arc`, `episode`, `chapter`
-  
-- **`chapter-refresh`** - Refresh chapter metadata and word counts from file
-  - Input: `file` (path to chapter file)
-  
-- **`chapter-insert`** - Insert new chapter with automatic renumbering
-  - Input: `arc`, `episode`, `after`, `pov`, `title`, optional: `summary`, `location`, `outfit`, `kink`, `file`
-  
-- **`chapter-delete`** - Delete chapter from database and optionally from filesystem
-  - Input: `arc`, `episode`, `chapter`, optional: `file` (to delete from filesystem)
-
-### Episode Operations
-- **`episode-info`** - Get episode information and list of chapters
-  - Input: `arc`, `episode`
-  
-- **`episode-update`** - Update episode metadata (description, title, slug)
-  - Input: `arc`, `episode`, optional: `description`, `title`, `slug`
-
-### Timeline Operations
-- **`timeline-sync`** - Synchronize filesystem content with database
-  - Input: `timeline` (timeline name)
-  - Note: Content path is auto-discovered from timeline directory structure
-
-### Statistics
-- **`stats`** - Get aggregate statistics with optional filters
-  - Input: `timeline`, optional: `arc`, `episode`, `pov`
-  - Output: Total words/chapters, POV distribution, arc/episode breakdown, longest/shortest chapters
-  - Examples:
-    - No filters: Overall timeline statistics
-    - `arc: "arc1"`: Statistics for specific arc
-    - `arc: "arc1", episode: 1`: Statistics for specific episode
-    - `pov: "Alice"`: Statistics for specific POV across timeline
-
-### RAG (Semantic Search)
-- **`rag-index`** - Index chapters into vector database for semantic search
-  - Input: `timeline`, optional: `arc`, `episode` (to index specific content)
-  - Output: Number of chapters indexed
-  - Note: Content path is auto-discovered from timeline directory structure
-  - Note: Automatically extracts character names using NER (Named Entity Recognition)
-  
-- **`rag-search`** - Semantic search across timeline content
-  - Input: `timeline`, `query`, optional: `arc`, `pov`, `maxResults`, `characters`, `allCharacters`
-  - Output: Relevant chapters with similarity scores, previews, and character names
-  - Character filtering:
-    - `characters`: Array of character names to filter by
-    - `allCharacters`: If true, all characters must be present (AND). If false, at least one (OR). Default: false
-  - Examples:
-    - `characters: ["Alice", "Bob"], allCharacters: true` - Find chapters where both Alice AND Bob appear
-    - `characters: ["Alice", "Bob"]` - Find chapters where Alice OR Bob appear
-  
-- **`rag-context`** - Retrieve relevant context for AI interactions
-  - Input: `timeline`, `query`, optional: `arc`, `pov`, `maxChapters`, `characters`
-  - Output: Full chapter content for AI context with character names
-  - Supports character filtering like `rag-search`
-  
-- **`rag-characters`** - Get all characters that appear in chapters with a specific character
-  - Input: `timeline`, `character` (character name)
-  - Output: List of co-occurring characters sorted alphabetically
-  - Use case: "Who does character X interact with?"
-
-### Book Generation
-- **`book-generate`** - Generate PDF book from timeline content using LaTeX
-  - Input: `timeline`, `outputPath`, optional: `episodes`, `format`
-  - Output: PDF book with Victoria Regia template
-  - Formats: `a4` (default), `a5`
-  - Requirements: pandoc, LaTeX distribution (pdflatex/xelatex/lualatex)
-  - Note: Content path is auto-discovered from timeline directory structure
+```
+┌─────────────────────────────────────────────────────────────┐
+│                     INDEXING PHASE                          │
+├─────────────────────────────────────────────────────────────┤
+│  1. Scan content/*.md (filesystem scanner)                  │
+│  2. Parse frontmatter + content (gray-matter)               │
+│  3. For each chapter:                                       │
+│     a. Extract entities/relations with Gemini API           │
+│     b. Generate embeddings (Transformers.js ONNX)           │
+│     c. Calculate word count and statistics                  │
+│  4. Save everything to LanceDB                              │
+└─────────────────────────────────────────────────────────────┘
+```
 
 ## Development
 
-### Scripts
-
 ```bash
+# Install dependencies
+npm install
+
 # Run tests
 npm test
 
 # Run tests with coverage
 npm run test:coverage
 
-# Build
-npm run build
-
 # Lint
 npm run lint
 
-# Fix linting issues
-npm run lint:format
-```
-
-### Tech Stack
-
-- **Language**: TypeScript (strict mode)
-- **Testing**: Vitest (90.71% coverage, 82 tests)
-- **Linting**: Biome (0 warnings)
-- **Build**: TypeScript compiler
+# Type check
+npm run typecheck
 
-### Architecture
+# Build
+npm run build
+```
 
-- **MCP Protocol**: Standard Model Context Protocol implementation
-- **Database**: SQLite via @echoes-io/tracker (singleton pattern)
-- **Validation**: Zod schemas for type-safe inputs
-- **Testing**: Comprehensive unit and integration tests
-- **Timeline Parameter**: All tools accept timeline as a required parameter
+## Tech Stack
+
+| Purpose | Tool |
+|---------|------|
+| Runtime | Node.js 20+ |
+| Language | TypeScript |
+| Vector DB | LanceDB |
+| Embeddings | @huggingface/transformers (ONNX) |
+| Entity Extraction | Gemini AI |
+| MCP SDK | @modelcontextprotocol/sdk |
+| Testing | Vitest |
+| Linting | Biome |
 
 ## License
 

package/cli/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/cli/index.d.ts.map

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

package/cli/index.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { program } from './program.js';
+program.parse();
+//# sourceMappingURL=index.js.map

package/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/cli/program.d.ts

@@ -0,0 +1,3 @@
+import { Command } from '@commander-js/extra-typings';
+export declare const program: Command<[], {}, {}>;
+//# sourceMappingURL=program.d.ts.map

package/cli/program.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"program.d.ts","sourceRoot":"","sources":["program.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAYtD,eAAO,MAAM,OAAO,qBAGa,CAAC"}

package/cli/program.js

@@ -0,0 +1,150 @@
+import { Command } from '@commander-js/extra-typings';
+import { DEFAULT_DB_PATH } from '../lib/constants.js';
+import { startServer } from '../lib/server.js';
+import { index, indexConfig } from '../lib/tools/index.js';
+import { search, searchConfig } from '../lib/tools/search.js';
+import { stats, statsConfig } from '../lib/tools/stats.js';
+import { wordsCount, wordsCountConfig } from '../lib/tools/words-count.js';
+import { getPackageConfig } from '../lib/utils.js';
+const packageConfig = getPackageConfig();
+export const program = new Command()
+    .name(packageConfig.name)
+    .description(packageConfig.description)
+    .version(packageConfig.version);
+program
+    .command(wordsCountConfig.name)
+    .description(wordsCountConfig.description)
+    .argument('<filePath...>', wordsCountConfig.arguments.filePath)
+    .option('-d, --detailed', wordsCountConfig.arguments.detailed)
+    .action(async (filePaths, { detailed }) => {
+    try {
+        filePaths.forEach((filePath, index) => {
+            const result = wordsCount({ filePath, detailed });
+            if (index > 0) {
+                console.log('');
+            }
+            console.log(`📄 ${filePath}\n`);
+            console.log(`   📝 Words:              ${result.words.toLocaleString()}`);
+            console.log(`   🔤 Characters:         ${result.characters.toLocaleString()}`);
+            console.log(`   🔡 Characters (no sp): ${result.charactersNoSpaces.toLocaleString()}`);
+            console.log(`   ⏱️  Reading time:       ${result.readingTimeMinutes} min`);
+            if (detailed) {
+                console.log(`   💬 Sentences:          ${result.sentences?.toLocaleString()}`);
+                console.log(`   📃 Paragraphs:         ${result.paragraphs?.toLocaleString()}`);
+            }
+        });
+    }
+    catch (error) {
+        console.error(`❌ Error: ${error.message}`);
+        process.exit(1);
+    }
+});
+program
+    .command(statsConfig.name)
+    .description(statsConfig.description)
+    .option('--db <path>', 'Database path', DEFAULT_DB_PATH)
+    .option('--arc <name>', statsConfig.arguments.arc)
+    .option('--pov <name>', statsConfig.arguments.pov)
+    .action(async ({ db, arc, pov }) => {
+    try {
+        const result = await stats({ arc, pov, dbPath: db });
+        console.log('📊 Timeline Statistics\n');
+        console.log(`   📚 Chapters:           ${result.totalChapters.toLocaleString()}`);
+        console.log(`   📝 Total words:        ${result.totalWords.toLocaleString()}`);
+        console.log(`   📈 Avg words/chapter:  ${result.averageWordsPerChapter.toLocaleString()}`);
+        console.log(`   📁 Arcs:               ${result.arcs.join(', ')}`);
+        console.log('   👤 POVs:');
+        for (const [name, count] of Object.entries(result.povs).sort((a, b) => b[1] - a[1])) {
+            console.log(`      - ${name}: ${count}`);
+        }
+    }
+    catch (error) {
+        console.error(`❌ Error: ${error.message}`);
+        process.exit(1);
+    }
+});
+program
+    .command(indexConfig.name)
+    .description(indexConfig.description)
+    .argument('<contentPath>', indexConfig.arguments.contentPath)
+    .option('--db <path>', 'Database path', DEFAULT_DB_PATH)
+    .option('--arc <name>', indexConfig.arguments.arc)
+    .option('--force', indexConfig.arguments.force)
+    .action(async (contentPath, { db, arc, force }) => {
+    try {
+        console.log('🔍 Indexing timeline...\n');
+        const result = await index({ contentPath, arc, force, dbPath: db });
+        console.log('✅ Indexing complete\n');
+        console.log(`   📖 Indexed:  ${result.indexed}`);
+        console.log(`   ⏭️  Skipped:  ${result.skipped}`);
+        console.log(`   🗑️  Deleted:  ${result.deleted}`);
+        console.log(`   👤 Entities: ${result.entities}`);
+        console.log(`   🔗 Relations: ${result.relations}`);
+    }
+    catch (error) {
+        console.error(`❌ Error: ${error.message}`);
+        process.exit(1);
+    }
+});
+program
+    .command(searchConfig.name)
+    .description(searchConfig.description)
+    .argument('<query>', searchConfig.arguments.query)
+    .option('--db <path>', 'Database path', DEFAULT_DB_PATH)
+    .option('--type <type>', searchConfig.arguments.type, 'chapters')
+    .option('--arc <name>', searchConfig.arguments.arc)
+    .option('--entity-type <type>', searchConfig.arguments.entityType)
+    .option('--relation-type <type>', searchConfig.arguments.relationType)
+    .option('--limit <n>', searchConfig.arguments.limit, '10')
+    .action(async (query, { db, type, arc, entityType, relationType, limit }) => {
+    try {
+        const result = await search({
+            query,
+            type: type,
+            arc,
+            entityType,
+            relationType,
+            limit: Number.parseInt(limit, 10),
+            dbPath: db,
+        });
+        if (result.type === 'chapters') {
+            console.log(`🔍 Found ${result.results.length} chapters\n`);
+            for (const ch of result.results) {
+                console.log(`📖 ${ch.id} - ${ch.title} (${ch.pov})`);
+                console.log(`   Score: ${ch.score.toFixed(3)} | Words: ${ch.word_count}`);
+                console.log(`   ${ch.content.slice(0, 100)}...`);
+                console.log('');
+            }
+        }
+        else if (result.type === 'entities') {
+            console.log(`🔍 Found ${result.results.length} entities\n`);
+            for (const e of result.results) {
+                console.log(`👤 ${e.name} (${e.type})`);
+                console.log(`   ${e.description}`);
+                console.log(`   Chapters: ${e.chapter_count} | Score: ${e.score.toFixed(3)}`);
+                console.log('');
+            }
+        }
+        else {
+            console.log(`🔍 Found ${result.results.length} relations\n`);
+            for (const r of result.results) {
+                console.log(`🔗 ${r.source_entity} → ${r.type} → ${r.target_entity}`);
+                console.log(`   ${r.description}`);
+                console.log('');
+            }
+        }
+    }
+    catch (error) {
+        console.error(`❌ Error: ${error.message}`);
+        process.exit(1);
+    }
+});
+/* c8 ignore start */
+program
+    .command('serve')
+    .description('Start MCP server (for AI assistant integration)')
+    .action(async () => {
+    await startServer();
+});
+/* c8 ignore stop */
+//# sourceMappingURL=program.js.map

package/cli/program.js.map

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

package/lib/constants.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Application constants
+ */
+export declare const DEFAULT_EMBEDDING_MODEL = "Xenova/e5-small-v2";
+export declare const TEST_EMBEDDING_MODEL = "Xenova/e5-small-v2";
+export declare const DEFAULT_GEMINI_MODEL = "gemini-2.5-flash";
+export declare const DEFAULT_DB_PATH = "db";
+//# sourceMappingURL=constants.d.ts.map

package/lib/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,eAAO,MAAM,uBAAuB,uBAAuB,CAAC;AAG5D,eAAO,MAAM,oBAAoB,uBAAuB,CAAC;AAGzD,eAAO,MAAM,oBAAoB,qBAAqB,CAAC;AAGvD,eAAO,MAAM,eAAe,OAAO,CAAC"}

package/lib/constants.js

@@ -0,0 +1,12 @@
+/**
+ * Application constants
+ */
+// Default embedding model for production
+export const DEFAULT_EMBEDDING_MODEL = 'Xenova/e5-small-v2';
+// Test embedding model (same as default for consistency)
+export const TEST_EMBEDDING_MODEL = 'Xenova/e5-small-v2';
+// Default Gemini model
+export const DEFAULT_GEMINI_MODEL = 'gemini-2.5-flash';
+// Default database path
+export const DEFAULT_DB_PATH = 'db';
+//# sourceMappingURL=constants.js.map

package/lib/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,yCAAyC;AACzC,MAAM,CAAC,MAAM,uBAAuB,GAAG,oBAAoB,CAAC;AAE5D,yDAAyD;AACzD,MAAM,CAAC,MAAM,oBAAoB,GAAG,oBAAoB,CAAC;AAEzD,uBAAuB;AACvB,MAAM,CAAC,MAAM,oBAAoB,GAAG,kBAAkB,CAAC;AAEvD,wBAAwB;AACxB,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC"}

package/lib/database/index.d.ts

@@ -0,0 +1,34 @@
+import { type Connection } from '@lancedb/lancedb';
+import { type ChapterRecord, type EntityRecord, type RelationRecord } from './schemas.js';
+export declare class Database {
+    readonly dbPath: string;
+    private db;
+    private tables;
+    private migrationChecked;
+    private metadata;
+    private tableConfigs;
+    private get metadataPath();
+    constructor(dbPath: string);
+    private getMetadata;
+    private getTableConfigs;
+    get embeddingModel(): string;
+    get embeddingDim(): number;
+    private getConnection;
+    private checkMigration;
+    private saveMetadata;
+    connect(): Promise<Connection>;
+    private getTable;
+    private upsert;
+    upsertChapters(records: ChapterRecord[]): Promise<number>;
+    upsertEntities(records: EntityRecord[]): Promise<number>;
+    upsertRelations(records: RelationRecord[]): Promise<number>;
+    getChapters(arc?: string): Promise<ChapterRecord[]>;
+    getChapterHashes(): Promise<Map<string, string>>;
+    deleteChaptersByPaths(paths: string[]): Promise<number>;
+    searchChapters(vector: number[], limit: number, arc?: string): Promise<ChapterRecord[]>;
+    searchEntities(vector: number[], limit: number, arc?: string, type?: string): Promise<EntityRecord[]>;
+    getEntities(arc?: string, type?: string): Promise<EntityRecord[]>;
+    getRelations(arc?: string, type?: string): Promise<RelationRecord[]>;
+    close(): void;
+}
+//# sourceMappingURL=index.d.ts.map

package/lib/database/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,UAAU,EAAuB,MAAM,kBAAkB,CAAC;AAMxE,OAAO,EACL,KAAK,aAAa,EAGlB,KAAK,YAAY,EACjB,KAAK,cAAc,EAEpB,MAAM,cAAc,CAAC;AActB,qBAAa,QAAQ;aAeS,MAAM,EAAE,MAAM;IAd1C,OAAO,CAAC,EAAE,CAA2B;IACrC,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAyB;IACzC,OAAO,CAAC,YAAY,CAIJ;IAEhB,OAAO,KAAK,YAAY,GAEvB;gBAE2B,MAAM,EAAE,MAAM;YAE5B,WAAW;YAeX,eAAe;IAc7B,IAAI,cAAc,IAAI,MAAM,CAG3B;IAED,IAAI,YAAY,IAAI,MAAM,CAGzB;YAEa,aAAa;YAKb,cAAc;IAgD5B,OAAO,CAAC,YAAY;IAQd,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC;YAKtB,QAAQ;YAeR,MAAM;IAWd,cAAc,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAKzD,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAKxD,eAAe,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAK3D,WAAW,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAgBnD,gBAAgB,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAahD,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAgBvD,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAgBvF,cAAc,CAClB,MAAM,EAAE,MAAM,EAAE,EAChB,KAAK,EAAE,MAAM,EACb,GAAG,CAAC,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,YAAY,EAAE,CAAC;IAmBpB,WAAW,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAmBjE,YAAY,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAmB1E,KAAK,IAAI,IAAI;CAId"}