@terronex-dev/aifbin-recall 0.1.0

package/dist/search.js

@@ -0,0 +1,159 @@
+"use strict";
+/**
+ * Search functionality for AIF-BIN Recall
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SearchEngine = void 0;
+exports.cosineSimilarity = cosineSimilarity;
+const types_js_1 = require("./types.js");
+/**
+ * Calculate cosine similarity between two vectors
+ */
+function cosineSimilarity(a, b) {
+    if (a.length !== b.length) {
+        throw new Error(`Vector dimension mismatch: ${a.length} vs ${b.length}`);
+    }
+    let dotProduct = 0;
+    let normA = 0;
+    let normB = 0;
+    for (let i = 0; i < a.length; i++) {
+        dotProduct += a[i] * b[i];
+        normA += a[i] * a[i];
+        normB += b[i] * b[i];
+    }
+    const magnitude = Math.sqrt(normA) * Math.sqrt(normB);
+    if (magnitude === 0)
+        return 0;
+    return dotProduct / magnitude;
+}
+/**
+ * Normalize BM25 scores to 0-1 range
+ */
+function normalizeBM25Scores(scores) {
+    if (scores.length === 0)
+        return new Map();
+    // BM25 scores are negative in SQLite FTS5 (lower is better)
+    const minScore = Math.min(...scores.map(s => s.score));
+    const maxScore = Math.max(...scores.map(s => s.score));
+    const range = maxScore - minScore || 1;
+    const normalized = new Map();
+    for (const { id, score } of scores) {
+        // Invert and normalize: best match (lowest BM25) becomes highest score
+        normalized.set(id, 1 - (score - minScore) / range);
+    }
+    return normalized;
+}
+class SearchEngine {
+    db;
+    config;
+    constructor(db, config) {
+        this.db = db;
+        this.config = { ...types_js_1.DEFAULT_CONFIG.search, ...config };
+    }
+    /**
+     * Perform semantic search using query embedding
+     */
+    async search(queryEmbedding, options = {}) {
+        const { collection, limit = this.config.defaultLimit, threshold = 0.0, hybridWeight = this.config.hybridWeight, } = options;
+        // Get collection ID if name provided
+        let collectionId;
+        if (collection) {
+            const col = this.db.getCollection(collection);
+            if (!col) {
+                throw new Error(`Collection not found: ${collection}`);
+            }
+            collectionId = col.id;
+        }
+        // Get all chunks with embeddings
+        const chunks = this.db.getAllChunksWithEmbeddings(collectionId);
+        if (chunks.length === 0) {
+            return [];
+        }
+        // Calculate vector similarity scores
+        const vectorScores = [];
+        for (const chunk of chunks) {
+            const score = cosineSimilarity(queryEmbedding, chunk.embedding);
+            if (score >= threshold) {
+                vectorScores.push({ chunk, score });
+            }
+        }
+        // Sort by vector score
+        vectorScores.sort((a, b) => b.score - a.score);
+        // If pure vector search (hybridWeight = 1), return top results
+        if (hybridWeight >= 1.0) {
+            return vectorScores.slice(0, limit).map(({ chunk, score }) => ({
+                chunk,
+                score,
+                vectorScore: score,
+            }));
+        }
+        // For hybrid search, we need the query text (not available here)
+        // This will be handled at a higher level
+        return vectorScores.slice(0, limit).map(({ chunk, score }) => ({
+            chunk,
+            score,
+            vectorScore: score,
+        }));
+    }
+    /**
+     * Perform hybrid search combining vector similarity and keyword matching
+     */
+    async hybridSearch(queryEmbedding, queryText, options = {}) {
+        const { collection, limit = this.config.defaultLimit, threshold = 0.0, hybridWeight = this.config.hybridWeight, } = options;
+        // Get collection ID
+        let collectionId;
+        if (collection) {
+            const col = this.db.getCollection(collection);
+            if (!col) {
+                throw new Error(`Collection not found: ${collection}`);
+            }
+            collectionId = col.id;
+        }
+        // Get all chunks
+        const chunks = this.db.getAllChunksWithEmbeddings(collectionId);
+        if (chunks.length === 0)
+            return [];
+        // Calculate vector scores
+        const vectorScoreMap = new Map();
+        for (const chunk of chunks) {
+            const score = cosineSimilarity(queryEmbedding, chunk.embedding);
+            vectorScoreMap.set(chunk.id, score);
+        }
+        // Get keyword scores (BM25)
+        const keywordResults = this.db.keywordSearch(queryText, collectionId, limit * 3);
+        const keywordScoreMap = normalizeBM25Scores(keywordResults);
+        // Combine scores
+        const results = [];
+        const chunkMap = new Map(chunks.map(c => [c.id, c]));
+        // Score all chunks that have either vector or keyword hits
+        const allIds = new Set([...vectorScoreMap.keys(), ...keywordScoreMap.keys()]);
+        for (const id of allIds) {
+            const chunk = chunkMap.get(id);
+            if (!chunk)
+                continue;
+            const vectorScore = vectorScoreMap.get(id) || 0;
+            const keywordScore = keywordScoreMap.get(id) || 0;
+            // Weighted combination
+            const combinedScore = hybridWeight * vectorScore + (1 - hybridWeight) * keywordScore;
+            if (combinedScore >= threshold) {
+                results.push({
+                    chunk,
+                    score: combinedScore,
+                    vectorScore,
+                    keywordScore,
+                });
+            }
+        }
+        // Sort by combined score and limit
+        results.sort((a, b) => b.score - a.score);
+        return results.slice(0, limit);
+    }
+    /**
+     * Recall a specific chunk by ID
+     */
+    recall(id) {
+        return this.db.getChunk(id);
+    }
+}
+exports.SearchEngine = SearchEngine;
+//# sourceMappingURL=search.js.map

package/dist/search.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,13 @@
+/**
+ * HTTP server for AIF-BIN Recall
+ */
+import express from 'express';
+import type { ServerConfig } from './types.js';
+import { EngramDB } from './db.js';
+export interface ServerOptions {
+    db: EngramDB;
+    config?: Partial<ServerConfig>;
+}
+export declare function createServer(options: ServerOptions): express.Application;
+export declare function startServer(options: ServerOptions): void;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,OAA4C,MAAM,SAAS,CAAC;AAEnE,OAAO,KAAK,EAAE,YAAY,EAAiB,MAAM,YAAY,CAAC;AAE9D,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAKnC,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,QAAQ,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;CAChC;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CA0OxE;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAexD"}

package/dist/server.js

@@ -0,0 +1,250 @@
+"use strict";
+/**
+ * HTTP server for AIF-BIN Recall
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createServer = createServer;
+exports.startServer = startServer;
+const express_1 = __importDefault(require("express"));
+const cors_1 = __importDefault(require("cors"));
+const types_js_1 = require("./types.js");
+const search_js_1 = require("./search.js");
+const indexer_js_1 = require("./indexer.js");
+const embedder_js_1 = require("./embedder.js");
+function createServer(options) {
+    const { db, config } = options;
+    const serverConfig = { ...types_js_1.DEFAULT_CONFIG.server, ...config };
+    const app = (0, express_1.default)();
+    const search = new search_js_1.SearchEngine(db);
+    const indexer = new indexer_js_1.Indexer(db);
+    // Middleware
+    app.use((0, cors_1.default)());
+    app.use(express_1.default.json({ limit: '10mb' }));
+    // Health check
+    app.get('/health', (_req, res) => {
+        res.json({ status: 'ok', version: '0.1.0' });
+    });
+    // List collections
+    app.get('/collections', (_req, res) => {
+        try {
+            const collections = db.listCollections();
+            res.json({ collections });
+        }
+        catch (err) {
+            res.status(500).json({ error: String(err) });
+        }
+    });
+    // Get collection
+    app.get('/collections/:name', (req, res) => {
+        try {
+            const collection = db.getCollection(req.params.name);
+            if (!collection) {
+                res.status(404).json({ error: 'Collection not found' });
+                return;
+            }
+            res.json(collection);
+        }
+        catch (err) {
+            res.status(500).json({ error: String(err) });
+        }
+    });
+    // Create collection
+    app.post('/collections/:name', (req, res) => {
+        try {
+            const { description } = req.body || {};
+            const existing = db.getCollection(req.params.name);
+            if (existing) {
+                res.json(existing);
+                return;
+            }
+            const collection = db.createCollection(req.params.name, description);
+            res.status(201).json(collection);
+        }
+        catch (err) {
+            res.status(500).json({ error: String(err) });
+        }
+    });
+    // Delete collection
+    app.delete('/collections/:name', (req, res) => {
+        try {
+            const deleted = db.deleteCollection(req.params.name);
+            if (!deleted) {
+                res.status(404).json({ error: 'Collection not found' });
+                return;
+            }
+            res.json({ deleted: true });
+        }
+        catch (err) {
+            res.status(500).json({ error: String(err) });
+        }
+    });
+    // Lazy-loaded embedder for text queries
+    let embedder = null;
+    async function getEmbedder(model) {
+        if (!embedder) {
+            embedder = new embedder_js_1.Embedder(model || 'minilm');
+            await embedder.init();
+        }
+        return embedder;
+    }
+    // Search - accepts either embedding array OR text query (will embed automatically)
+    app.post('/search', async (req, res) => {
+        try {
+            const { embedding, query, text, collection, limit, threshold, hybridWeight, model } = req.body;
+            // Use 'query' or 'text' for the search text
+            const queryText = query || text;
+            // Get or generate embedding
+            let queryEmbedding;
+            if (embedding && Array.isArray(embedding)) {
+                queryEmbedding = embedding;
+            }
+            else if (queryText) {
+                // Auto-embed the query text
+                const emb = await getEmbedder(model);
+                queryEmbedding = await emb.embed(queryText);
+            }
+            else {
+                res.status(400).json({
+                    error: 'Either "query" (text) or "embedding" (array) required',
+                    hint: 'Send { "query": "your search text" } for automatic embedding',
+                });
+                return;
+            }
+            const options = {
+                collection,
+                limit: limit || 10,
+                threshold: threshold || 0,
+                hybridWeight: hybridWeight ?? 0.7,
+            };
+            let results;
+            if (queryText && (hybridWeight ?? 0.7) < 1.0) {
+                results = await search.hybridSearch(queryEmbedding, queryText, options);
+            }
+            else {
+                results = await search.search(queryEmbedding, options);
+            }
+            res.json({
+                results: results.map(r => ({
+                    id: r.chunk.id,
+                    text: r.chunk.text,
+                    score: r.score,
+                    vectorScore: r.vectorScore,
+                    keywordScore: r.keywordScore,
+                    sourceFile: r.chunk.sourceFile,
+                    chunkIndex: r.chunk.chunkIndex,
+                    metadata: r.chunk.metadata,
+                })),
+            });
+        }
+        catch (err) {
+            res.status(500).json({ error: String(err) });
+        }
+    });
+    // GET search - simple text query
+    app.get('/search', async (req, res) => {
+        try {
+            const { q, query, collection, limit } = req.query;
+            const queryText = (q || query);
+            if (!queryText) {
+                res.status(400).json({
+                    error: 'Query parameter "q" or "query" required',
+                    example: '/search?q=your+search+text&collection=myproject',
+                });
+                return;
+            }
+            // Embed the query
+            const emb = await getEmbedder();
+            const queryEmbedding = await emb.embed(queryText);
+            const options = {
+                collection: collection,
+                limit: limit ? parseInt(limit, 10) : 10,
+            };
+            const results = await search.hybridSearch(queryEmbedding, queryText, options);
+            res.json({
+                query: queryText,
+                results: results.map(r => ({
+                    id: r.chunk.id,
+                    text: r.chunk.text,
+                    score: r.score,
+                    vectorScore: r.vectorScore,
+                    keywordScore: r.keywordScore,
+                    sourceFile: r.chunk.sourceFile,
+                    chunkIndex: r.chunk.chunkIndex,
+                    metadata: r.chunk.metadata,
+                })),
+            });
+        }
+        catch (err) {
+            res.status(500).json({ error: String(err) });
+        }
+    });
+    // Recall specific chunk
+    app.get('/recall/:id', (req, res) => {
+        try {
+            const chunk = search.recall(req.params.id);
+            if (!chunk) {
+                res.status(404).json({ error: 'Chunk not found' });
+                return;
+            }
+            res.json({
+                id: chunk.id,
+                text: chunk.text,
+                sourceFile: chunk.sourceFile,
+                chunkIndex: chunk.chunkIndex,
+                metadata: chunk.metadata,
+                createdAt: chunk.createdAt,
+                updatedAt: chunk.updatedAt,
+            });
+        }
+        catch (err) {
+            res.status(500).json({ error: String(err) });
+        }
+    });
+    // Index a directory
+    app.post('/index', (req, res) => {
+        try {
+            const { path: dirPath, collection, recursive } = req.body;
+            if (!dirPath || !collection) {
+                res.status(400).json({ error: 'path and collection required' });
+                return;
+            }
+            const result = indexer.indexDirectory(dirPath, {
+                collection,
+                recursive: recursive !== false,
+            });
+            res.json({
+                indexed: true,
+                files: result.files,
+                chunks: result.chunks,
+            });
+        }
+        catch (err) {
+            res.status(500).json({ error: String(err) });
+        }
+    });
+    // Error handler
+    app.use((err, _req, res, _next) => {
+        console.error('Server error:', err);
+        res.status(500).json({ error: 'Internal server error' });
+    });
+    return app;
+}
+function startServer(options) {
+    const config = { ...types_js_1.DEFAULT_CONFIG.server, ...options.config };
+    const app = createServer(options);
+    app.listen(config.port, config.host, () => {
+        console.log(`AIF-BIN Recall server running at http://${config.host}:${config.port}`);
+        console.log('');
+        console.log('Endpoints:');
+        console.log('  GET  /health          - Health check');
+        console.log('  GET  /collections     - List collections');
+        console.log('  POST /collections/:n  - Create collection');
+        console.log('  POST /search          - Semantic search');
+        console.log('  GET  /recall/:id      - Retrieve chunk');
+        console.log('  POST /index           - Index directory');
+    });
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Core types for AIF-BIN Recall memory server
+ */
+export interface MemoryChunk {
+    id: string;
+    collectionId: string;
+    sourceFile: string;
+    chunkIndex: number;
+    text: string;
+    embedding: number[];
+    metadata: Record<string, unknown>;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export interface Collection {
+    id: string;
+    name: string;
+    description?: string;
+    fileCount: number;
+    chunkCount: number;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export interface SearchResult {
+    chunk: MemoryChunk;
+    score: number;
+    vectorScore: number;
+    keywordScore?: number;
+}
+export interface SearchOptions {
+    collection?: string;
+    limit?: number;
+    threshold?: number;
+    hybridWeight?: number;
+    filters?: Record<string, unknown>;
+}
+export interface IndexOptions {
+    collection: string;
+    recursive?: boolean;
+    watch?: boolean;
+}
+export interface ServerConfig {
+    port: number;
+    host: string;
+}
+export interface IndexConfig {
+    path: string;
+}
+export interface SearchConfig {
+    defaultLimit: number;
+    hybridWeight: number;
+}
+export interface EngramConfig {
+    server: ServerConfig;
+    index: IndexConfig;
+    search: SearchConfig;
+}
+export declare const DEFAULT_CONFIG: EngramConfig;
+export interface AifBinHeader {
+    magic: Uint8Array;
+    version: number;
+    flags: number;
+    chunkCount: number;
+    embeddingDim: number;
+    createdAt: number;
+    modifiedAt: number;
+}
+export interface AifBinChunk {
+    id: string;
+    text: string;
+    embedding: number[];
+    metadata: Record<string, unknown>;
+}
+export interface AifBinFile {
+    header: AifBinHeader;
+    chunks: AifBinChunk[];
+    sourcePath: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,YAAY,CAAC;IACrB,KAAK,EAAE,WAAW,CAAC;IACnB,MAAM,EAAE,YAAY,CAAC;CACtB;AAED,eAAO,MAAM,cAAc,EAAE,YAY5B,CAAC;AAEF,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,UAAU,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/dist/types.js

@@ -0,0 +1,20 @@
+"use strict";
+/**
+ * Core types for AIF-BIN Recall memory server
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_CONFIG = void 0;
+exports.DEFAULT_CONFIG = {
+    server: {
+        port: 3847,
+        host: 'localhost',
+    },
+    index: {
+        path: '~/.aifbin-recall/index.db',
+    },
+    search: {
+        defaultLimit: 10,
+        hybridWeight: 0.7,
+    },
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAiEU,QAAA,cAAc,GAAiB;IAC1C,MAAM,EAAE;QACN,IAAI,EAAE,IAAI;QACV,IAAI,EAAE,WAAW;KAClB;IACD,KAAK,EAAE;QACL,IAAI,EAAE,2BAA2B;KAClC;IACD,MAAM,EAAE;QACN,YAAY,EAAE,EAAE;QAChB,YAAY,EAAE,GAAG;KAClB;CACF,CAAC"}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@terronex-dev/aifbin-recall",
+  "version": "0.1.0",
+  "description": "Local-first memory server for AI agents. Query AIF-BIN semantic memory files via HTTP/MCP.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "aifbin-recall": "./dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx watch src/cli.ts",
+    "start": "node dist/cli.js",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "lint": "eslint src/",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "ai",
+    "memory",
+    "semantic-search",
+    "vector-database",
+    "rag",
+    "mcp",
+    "aif-bin",
+    "embeddings",
+    "local-first"
+  ],
+  "author": "Terronex <terronex.dev@gmail.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/terronexdev/aifbin-recall.git"
+  },
+  "homepage": "https://github.com/Terronex-dev/aifbin-recall#readme",
+  "bugs": {
+    "url": "https://github.com/Terronex-dev/aifbin-recall/issues"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.30.0",
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "@xenova/transformers": "^2.17.0",
+    "better-sqlite3": "^11.0.0",
+    "commander": "^12.0.0",
+    "cors": "^2.8.5",
+    "express": "^4.18.2",
+    "msgpackr": "^1.10.0",
+    "yaml": "^2.3.4"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.8",
+    "@types/cors": "^2.8.17",
+    "@types/express": "^4.17.21",
+    "@types/node": "^20.10.0",
+    "eslint": "^8.56.0",
+    "tsx": "^4.7.0",
+    "typescript": "^5.3.3",
+    "vitest": "^2.0.0"
+  }
+}