@terronex/aifbin-recall 0.1.0

package/CONTRIBUTING.md

@@ -0,0 +1,65 @@
+# Contributing to AIF-BIN Recall
+
+Thank you for your interest in contributing to AIF-BIN Recall!
+
+## How to Contribute
+
+### Reporting Bugs
+
+- Check existing issues first to avoid duplicates
+- Use the bug report template
+- Include reproduction steps, expected vs actual behavior
+- Include your environment (OS, Node.js version, etc.)
+
+### Suggesting Features
+
+- Open an issue with the feature request template
+- Explain the use case and why it would be valuable
+- Be open to discussion and iteration
+
+### Pull Requests
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/my-feature`)
+3. Make your changes
+4. Run tests (`npm test`)
+5. Commit with clear messages (`git commit -m "feat: add new feature"`)
+6. Push to your fork (`git push origin feature/my-feature`)
+7. Open a pull request
+
+### Commit Message Format
+
+We follow [Conventional Commits](https://www.conventionalcommits.org/):
+
+- `feat:` — New feature
+- `fix:` — Bug fix
+- `docs:` — Documentation changes
+- `test:` — Adding or updating tests
+- `refactor:` — Code changes that neither fix bugs nor add features
+- `perf:` — Performance improvements
+- `chore:` — Maintenance tasks
+
+### Code Style
+
+- Use TypeScript
+- Follow existing code patterns
+- Add types for all public APIs
+- Write tests for new functionality
+
+## Development Setup
+
+```bash
+git clone https://github.com/Terronex-dev/aifbin-recall.git
+cd aifbin-recall
+npm install
+npm run build
+npm test
+```
+
+## Questions?
+
+Open an issue or reach out via the project discussions.
+
+## License
+
+By contributing, you agree that your contributions will be licensed under the MIT License.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Terronex
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/NOTICE

@@ -0,0 +1,36 @@
+AIF-BIN Recall
+Copyright 2026 Terronex
+
+This product includes software developed by Terronex.
+https://github.com/Terronex-dev
+
+TRADEMARKS
+----------
+"AIF-BIN", "AIF-BIN Recall", "AIF-BIN Pro", and the Terronex name and logo 
+are trademarks of Terronex. Use of these trademarks without prior written 
+permission from Terronex is prohibited.
+
+The MIT license granted herein does not include any license to use 
+Terronex trademarks. You may not use the Terronex name, logo, or 
+AIF-BIN trademarks to endorse or promote products derived from this 
+software without specific prior written permission.
+
+THIRD-PARTY COMPONENTS
+----------------------
+This software includes the following third-party components:
+
+- @xenova/transformers (Apache 2.0) - Local ML model inference
+- better-sqlite3 (MIT) - SQLite bindings
+- express (MIT) - HTTP server
+- msgpackr (MIT) - MessagePack encoding
+- commander (MIT) - CLI framework
+- @modelcontextprotocol/sdk (MIT) - MCP server
+
+See package.json for complete dependency list.
+
+ATTRIBUTION
+-----------
+When redistributing this software or derivative works, you must:
+1. Include this NOTICE file
+2. Include the LICENSE file
+3. Not use Terronex trademarks without permission

package/README.md

@@ -0,0 +1,250 @@
+# AIF-BIN Recall
+
+**Local-first memory server for AI agents.**
+
+AIF-BIN Recall indexes collections of [AIF-BIN](https://github.com/Terronex-dev/aifbin) semantic memory files and provides fast retrieval via HTTP API and MCP (Model Context Protocol) for AI agent integration.
+
+## Features
+
+- **Semantic Search** — Query memories by meaning using embedded vectors
+- **Hybrid Retrieval** — Combine vector similarity with keyword matching
+- **MCP Server** — Native integration with AI agents (Claude, OpenClaw, etc.)
+- **HTTP API** — RESTful endpoints for any client
+- **Zero Cloud** — Fully local, no external services required
+- **Collection Management** — Organize memories into logical groups
+
+## Requirements
+
+- Node.js 18+ or Bun 1.0+
+- npm, yarn, or pnpm
+
+## Installation
+
+### Linux / macOS
+
+```bash
+# Using npm (recommended)
+npm install -g @terronex/aifbin-recall
+
+# Using Bun
+bun install -g @terronex/aifbin-recall
+
+# Using yarn
+yarn global add @terronex/aifbin-recall
+
+# Using pnpm
+pnpm add -g @terronex/aifbin-recall
+```
+
+### Windows
+
+```powershell
+# Using npm (recommended)
+npm install -g @terronex/aifbin-recall
+
+# Using yarn
+yarn global add @terronex/aifbin-recall
+
+# Using pnpm
+pnpm add -g @terronex/aifbin-recall
+```
+
+### From Source
+
+```bash
+git clone https://github.com/Terronex-dev/aifbin-recall.git
+cd aifbin-recall
+npm install
+npm run build
+npm link
+```
+
+### Verify Installation
+
+```bash
+aifbin-recall --version
+# Output: 0.1.0
+```
+
+## Quick Start
+
+```bash
+# Index a directory of .aif-bin files
+aifbin-recall index ./memories --collection my-project
+
+# Start the server
+aifbin-recall serve
+
+# Search via CLI
+aifbin-recall search "what decisions did we make about the API?"
+
+# Or query the HTTP API
+curl "http://localhost:3847/search?q=API+decisions&collection=my-project"
+```
+
+## CLI Reference
+
+| Command | Description |
+|---------|-------------|
+| `aifbin-recall index <dir>` | Index .aif-bin files from a directory |
+| `aifbin-recall serve` | Start the HTTP server |
+| `aifbin-recall mcp` | Start the MCP server for AI agents |
+| `aifbin-recall search <query>` | Search memories via CLI |
+| `aifbin-recall collections` | List all collections |
+| `aifbin-recall info` | Show database information |
+
+### Index Options
+
+```bash
+aifbin-recall index ./memories \
+  --collection my-project \
+  --recursive \
+  --db ~/.aifbin-recall/custom.db
+```
+
+### Serve Options
+
+```bash
+aifbin-recall serve \
+  --port 3847 \
+  --host 0.0.0.0
+```
+
+### Search Options
+
+```bash
+aifbin-recall search "your query" \
+  --collection my-project \
+  --limit 10 \
+  --model minilm
+```
+
+## MCP Integration
+
+Add AIF-BIN Recall to your AI agent's MCP config:
+
+```json
+{
+  "mcpServers": {
+    "aifbin-recall": {
+      "command": "aifbin-recall",
+      "args": ["mcp"]
+    }
+  }
+}
+```
+
+Available MCP tools:
+
+| Tool | Description |
+|------|-------------|
+| `recall_search` | Semantic search across collections |
+| `recall_get` | Retrieve specific memories by ID |
+| `recall_collections` | List available collections |
+| `recall_index` | Add new files to a collection |
+
+## HTTP API
+
+| Endpoint | Method | Description |
+|----------|--------|-------------|
+| `/search` | GET/POST | Semantic search with optional filters |
+| `/recall/:id` | GET | Retrieve specific memory chunk |
+| `/collections` | GET | List all collections |
+| `/collections/:name` | POST | Create/update collection |
+| `/index` | POST | Index directory of .aif-bin files |
+| `/health` | GET | Server health check |
+
+### Search Request
+
+```bash
+# GET request
+curl "http://localhost:3847/search?q=your+query&collection=my-project&limit=10"
+
+# POST request with options
+curl -X POST http://localhost:3847/search \
+  -H "Content-Type: application/json" \
+  -d '{"query": "your query", "collection": "my-project", "limit": 10}'
+```
+
+### Search Response
+
+```json
+{
+  "results": [
+    {
+      "id": "chunk-uuid",
+      "text": "The matched text content...",
+      "score": 0.89,
+      "vectorScore": 0.92,
+      "keywordScore": 0.85,
+      "sourceFile": "/path/to/file.aif-bin",
+      "chunkIndex": 0,
+      "metadata": {}
+    }
+  ]
+}
+```
+
+## Configuration
+
+Configuration file location: `~/.aifbin-recall/config.yaml`
+
+```yaml
+server:
+  port: 3847
+  host: localhost
+
+index:
+  path: ~/.aifbin-recall/index.db
+  
+search:
+  default_limit: 10
+  hybrid_weight: 0.7  # 0 = keywords only, 1 = vectors only
+
+embedding:
+  model: minilm  # Options: minilm, mpnet, bge-small, bge-base, e5-small
+```
+
+## Embedding Models
+
+AIF-BIN Recall uses local sentence-transformer models for query embedding:
+
+| Model | Dimensions | Speed | Quality |
+|-------|-----------|-------|---------|
+| `minilm` | 384 | Fastest | Good (default) |
+| `mpnet` | 768 | Medium | Better |
+| `bge-small` | 384 | Fast | Good |
+| `bge-base` | 768 | Slower | Best |
+| `e5-small` | 384 | Fast | Good |
+
+Models are downloaded automatically on first use and cached locally.
+
+## How It Works
+
+1. **Indexing**: AIF-BIN Recall reads `.aif-bin` files (created by [AIF-BIN Pro](https://github.com/Terronex-dev/aifbin-pro)) and extracts their embedded vectors and text chunks into a local SQLite database.
+
+2. **Search**: Queries are embedded using the same model, then matched against indexed vectors using cosine similarity. Optional BM25 keyword matching provides hybrid retrieval.
+
+3. **Retrieval**: Results include the original text, metadata, source file, and similarity scores — ready for RAG pipelines or direct AI consumption.
+
+## Part of the AIF-BIN Ecosystem
+
+| Product | Description |
+|---------|-------------|
+| [AIF-BIN](https://github.com/Terronex-dev/aifbin) | Core specification and SDKs (Python, TypeScript, Rust, Go, C#, Java, Swift, Kotlin) |
+| [AIF-BIN Lite](https://github.com/Terronex-dev/aifbin-lite) | Free CLI for basic .aif-bin file operations |
+| [AIF-BIN Pro](https://github.com/Terronex-dev/aifbin-pro) | Professional CLI with AI extraction and batch processing |
+| [AIF-BIN Recall](https://github.com/Terronex-dev/aifbin-recall) | Memory server for querying collections (you are here) |
+| [Bot-BIN](https://github.com/Terronex-dev/bot-bin) | Persistent memory for AI chatbots |
+
+## Contributing
+
+Contributions are welcome! Please read our [Contributing Guidelines](CONTRIBUTING.md) before submitting a pull request.
+
+## License
+
+MIT © 2026 Terronex
+
+## Trademarks
+
+"AIF-BIN", "AIF-BIN Recall", "AIF-BIN Pro", and the Terronex name are trademarks of Terronex. The MIT license does not grant permission to use these trademarks. See NOTICE file for details.

package/dist/cli.d.ts

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+/**
+ * AIF-BIN Recall CLI - Local-first memory server for AI agents
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;GAEG"}

package/dist/cli.js

@@ -0,0 +1,182 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * AIF-BIN Recall CLI - Local-first memory server for AI agents
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const path_1 = __importDefault(require("path"));
+const os_1 = __importDefault(require("os"));
+const fs_1 = __importDefault(require("fs"));
+const db_js_1 = require("./db.js");
+const search_js_1 = require("./search.js");
+const indexer_js_1 = require("./indexer.js");
+const server_js_1 = require("./server.js");
+const mcp_js_1 = require("./mcp.js");
+const types_js_1 = require("./types.js");
+const embedder_js_1 = require("./embedder.js");
+const program = new commander_1.Command();
+// Resolve default DB path
+function getDefaultDbPath() {
+    const configDir = path_1.default.join(os_1.default.homedir(), '.aifbin-recall');
+    if (!fs_1.default.existsSync(configDir)) {
+        fs_1.default.mkdirSync(configDir, { recursive: true });
+    }
+    return path_1.default.join(configDir, 'index.db');
+}
+program
+    .name('aifbin-recall')
+    .description('Local-first memory server for AI agents')
+    .version('0.1.0')
+    .option('-d, --db <path>', 'Database path', getDefaultDbPath());
+// Index command
+program
+    .command('index <directory>')
+    .description('Index AIF-BIN files from a directory')
+    .option('-c, --collection <name>', 'Collection name', 'default')
+    .option('-r, --recursive', 'Search subdirectories', true)
+    .option('--no-recursive', 'Do not search subdirectories')
+    .action((directory, options) => {
+    const dbPath = program.opts().db;
+    const db = new db_js_1.EngramDB(dbPath);
+    const indexer = new indexer_js_1.Indexer(db);
+    console.log(`Indexing ${directory} into collection "${options.collection}"...`);
+    const result = indexer.indexDirectory(path_1.default.resolve(directory), {
+        collection: options.collection,
+        recursive: options.recursive,
+    });
+    console.log(`\n✅ Indexed ${result.files} files (${result.chunks} chunks)`);
+    db.close();
+});
+// Serve command
+program
+    .command('serve')
+    .description('Start the HTTP server')
+    .option('-p, --port <port>', 'Server port', String(types_js_1.DEFAULT_CONFIG.server.port))
+    .option('-h, --host <host>', 'Server host', types_js_1.DEFAULT_CONFIG.server.host)
+    .action((options) => {
+    const dbPath = program.opts().db;
+    const db = new db_js_1.EngramDB(dbPath);
+    (0, server_js_1.startServer)({
+        db,
+        config: {
+            port: parseInt(options.port, 10),
+            host: options.host,
+        },
+    });
+});
+// MCP command
+program
+    .command('mcp')
+    .description('Start the MCP server for AI agent integration')
+    .action(async () => {
+    const dbPath = program.opts().db;
+    const db = new db_js_1.EngramDB(dbPath);
+    await (0, mcp_js_1.startMcpServer)(db);
+});
+// Collections command
+program
+    .command('collections')
+    .description('List all collections')
+    .action(() => {
+    const dbPath = program.opts().db;
+    const db = new db_js_1.EngramDB(dbPath);
+    const collections = db.listCollections();
+    if (collections.length === 0) {
+        console.log('No collections found. Use "aifbin-recall index" to create one.');
+    }
+    else {
+        console.log('Collections:\n');
+        for (const col of collections) {
+            console.log(`  ${col.name}`);
+            console.log(`    Files: ${col.fileCount}`);
+            console.log(`    Chunks: ${col.chunkCount}`);
+            if (col.description) {
+                console.log(`    Description: ${col.description}`);
+            }
+            console.log('');
+        }
+    }
+    db.close();
+});
+// Search command - now with built-in embedding!
+program
+    .command('search <query>')
+    .description('Search memories using natural language')
+    .option('-c, --collection <name>', 'Collection to search')
+    .option('-n, --limit <count>', 'Number of results', '10')
+    .option('-m, --model <model>', 'Embedding model (minilm, mpnet, bge-small, bge-base, e5-small)', 'minilm')
+    .option('-e, --embedding <file>', 'JSON file containing pre-computed query embedding (optional)')
+    .action(async (query, options) => {
+    const dbPath = program.opts().db;
+    const db = new db_js_1.EngramDB(dbPath);
+    const search = new search_js_1.SearchEngine(db);
+    try {
+        let embedding;
+        if (options.embedding) {
+            // Use provided embedding file
+            const embeddingData = JSON.parse(fs_1.default.readFileSync(options.embedding, 'utf-8'));
+            embedding = embeddingData.embedding || embeddingData;
+            if (!Array.isArray(embedding)) {
+                console.error('Error: embedding must be an array');
+                db.close();
+                return;
+            }
+        }
+        else {
+            // Generate embedding locally
+            console.log(`Embedding query with ${options.model}...`);
+            const embedder = new embedder_js_1.Embedder(options.model);
+            embedding = await embedder.embed(query);
+            console.log(`Embedding generated (${embedding.length} dims)\n`);
+        }
+        const results = await search.hybridSearch(embedding, query, {
+            collection: options.collection,
+            limit: parseInt(options.limit, 10),
+        });
+        if (results.length === 0) {
+            console.log('No results found.');
+        }
+        else {
+            console.log(`Found ${results.length} results:\n`);
+            for (const [i, r] of results.entries()) {
+                console.log(`[${i + 1}] Score: ${r.score.toFixed(4)} (vector: ${r.vectorScore.toFixed(4)}, keyword: ${r.keywordScore?.toFixed(4) || 'n/a'})`);
+                console.log(`    Source: ${path_1.default.basename(r.chunk.sourceFile)}`);
+                console.log(`    Text: ${r.chunk.text.slice(0, 200)}${r.chunk.text.length > 200 ? '...' : ''}`);
+                console.log('');
+            }
+        }
+    }
+    catch (err) {
+        console.error('Error:', err);
+    }
+    db.close();
+});
+// Info command
+program
+    .command('info')
+    .description('Show database information')
+    .action(() => {
+    const dbPath = program.opts().db;
+    console.log(`AIF-BIN Recall v0.1.0`);
+    console.log(`Database: ${dbPath}`);
+    console.log('');
+    if (fs_1.default.existsSync(dbPath)) {
+        const db = new db_js_1.EngramDB(dbPath);
+        const collections = db.listCollections();
+        const totalChunks = collections.reduce((sum, c) => sum + c.chunkCount, 0);
+        const totalFiles = collections.reduce((sum, c) => sum + c.fileCount, 0);
+        console.log(`Collections: ${collections.length}`);
+        console.log(`Total files: ${totalFiles}`);
+        console.log(`Total chunks: ${totalChunks}`);
+        db.close();
+    }
+    else {
+        console.log('Database not found. Run "aifbin-recall index" to create one.');
+    }
+});
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/db.d.ts

@@ -0,0 +1,29 @@
+/**
+ * SQLite database management for AIF-BIN Recall
+ */
+import { type Collection, type MemoryChunk } from './types.js';
+export declare class EngramDB {
+    private db;
+    constructor(dbPath?: string);
+    private resolvePath;
+    private init;
+    createCollection(name: string, description?: string): Collection;
+    getCollection(name: string): Collection | null;
+    getCollectionById(id: string): Collection | null;
+    listCollections(): Collection[];
+    deleteCollection(name: string): boolean;
+    insertChunk(chunk: Omit<MemoryChunk, 'createdAt' | 'updatedAt'>): void;
+    insertChunks(chunks: Omit<MemoryChunk, 'createdAt' | 'updatedAt'>[]): void;
+    getChunk(id: string): MemoryChunk | null;
+    getChunksByCollection(collectionId: string): MemoryChunk[];
+    deleteChunksBySource(sourceFile: string): number;
+    getAllChunksWithEmbeddings(collectionId?: string): MemoryChunk[];
+    keywordSearch(query: string, collectionId?: string, limit?: number): {
+        id: string;
+        score: number;
+    }[];
+    updateCollectionStats(collectionId: string): void;
+    private rowToChunk;
+    close(): void;
+}
+//# sourceMappingURL=db.d.ts.map

package/dist/db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../src/db.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,EAAkB,KAAK,UAAU,EAAE,KAAK,WAAW,EAAqB,MAAM,YAAY,CAAC;AAElG,qBAAa,QAAQ;IACnB,OAAO,CAAC,EAAE,CAAoB;gBAElB,MAAM,CAAC,EAAE,MAAM;IAa3B,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,IAAI;IAoEZ,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,UAAU;IAUhE,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAe9C,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAehD,eAAe,IAAI,UAAU,EAAE;IAc/B,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAOvC,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,WAAW,GAAG,WAAW,CAAC,GAAG,IAAI;IAoBtE,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,WAAW,GAAG,WAAW,CAAC,EAAE,GAAG,IAAI;IAwB1E,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAOxC,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,WAAW,EAAE;IAM1D,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAOhD,0BAA0B,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,WAAW,EAAE;IAWhE,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,GAAG;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE;IAyBxG,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAWjD,OAAO,CAAC,UAAU;IAkBlB,KAAK,IAAI,IAAI;CAGd"}