aifastdb 0.2.1

package/dist/client.d.ts

@@ -0,0 +1,140 @@
+/**
+ * High-level AiFastDb Client
+ *
+ * Provides a convenient wrapper around the native AiFastDb with:
+ * - Automatic embedding generation
+ * - OpenAI integration
+ * - Simplified API
+ */
+import type { IAiFastDb, AiFastDbConfig, MemoryInput, MemoryNode, QueryOptions, SearchResult, PreparedContext } from './native';
+import { QueryBuilder } from './query-builder';
+import { MemoryManager, MemoryManagerConfig } from './memory-manager';
+import type { EmbeddingProvider, OpenAIEmbeddingConfig } from './types';
+/**
+ * AiFastDb Client configuration
+ */
+export interface AiFastDbClientConfig extends AiFastDbConfig {
+    /** OpenAI configuration for embeddings */
+    openai?: OpenAIEmbeddingConfig;
+    /** Custom embedding provider */
+    embeddingProvider?: EmbeddingProvider;
+    /** Memory manager configuration */
+    memoryManager?: MemoryManagerConfig;
+}
+/**
+ * High-level AiFastDb Client
+ */
+export declare class AiFastDbClient {
+    private config;
+    private db;
+    private embeddingProvider?;
+    private memoryManager;
+    private initialized;
+    private initPromise?;
+    constructor(config: AiFastDbClientConfig);
+    /**
+     * Initialize the client (called automatically)
+     */
+    private initialize;
+    /**
+     * Ensure client is initialized
+     */
+    private ensureInitialized;
+    /**
+     * Get the native database instance
+     */
+    get native(): IAiFastDb;
+    /**
+     * Get the memory manager
+     */
+    get memory(): MemoryManager;
+    /**
+     * Get database size
+     */
+    get size(): number;
+    /**
+     * Store a memory with automatic embedding
+     */
+    remember(content: string, options?: Partial<MemoryInput>): Promise<MemoryNode>;
+    /**
+     * Store multiple memories
+     */
+    rememberMany(items: Array<{
+        content: string;
+        options?: Partial<MemoryInput>;
+    }>): Promise<MemoryNode[]>;
+    /**
+     * Recall memories by query
+     */
+    recall(query: string, limit?: number): Promise<MemoryNode[]>;
+    /**
+     * Advanced recall with options
+     */
+    recallAdvanced(options: QueryOptions): Promise<SearchResult[]>;
+    /**
+     * Create a query builder
+     */
+    query(): QueryBuilder;
+    /**
+     * Get a memory by ID
+     */
+    get(id: string): MemoryNode | null;
+    /**
+     * Delete a memory
+     */
+    forget(id: string): boolean;
+    /**
+     * Check if memory exists
+     */
+    has(id: string): boolean;
+    /**
+     * Get context for LLM
+     */
+    getContext(query: string, maxTokens?: number): Promise<PreparedContext>;
+    /**
+     * Find memories by tag
+     */
+    findByTag(tag: string): MemoryNode[];
+    /**
+     * Find important memories
+     */
+    findImportant(minImportance?: number): MemoryNode[];
+    /**
+     * Add an entity
+     */
+    addEntity(name: string, type: string, properties?: Record<string, unknown>): string;
+    /**
+     * Add a relation
+     */
+    addRelation(source: string, target: string, type: string, weight?: number): string;
+    /**
+     * Explore the knowledge graph
+     */
+    explore(startId: string, maxHops?: number, relationTypes?: string[]): Record<string, unknown>[];
+    /**
+     * Flush changes to disk
+     */
+    flush(): void;
+    /**
+     * Close the database
+     */
+    close(): void;
+    /**
+     * Prune old memories
+     */
+    prune(): number;
+    /**
+     * Get statistics
+     */
+    stats(): {
+        totalMemories: number;
+        avgImportance: number;
+        oldestMemory: number;
+        newestMemory: number;
+    };
+}
+/**
+ * Create a new AiFastDb client
+ */
+export declare function createAiFastDb(config: AiFastDbClientConfig): Promise<AiFastDbClient>;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../ts/client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,SAAS,EACT,cAAc,EACd,WAAW,EACX,UAAU,EACV,YAAY,EACZ,YAAY,EAEZ,eAAe,EAChB,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAExE;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,cAAc;IAC1D,0CAA0C;IAC1C,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAC/B,gCAAgC;IAChC,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,mCAAmC;IACnC,aAAa,CAAC,EAAE,mBAAmB,CAAC;CACrC;AAuCD;;GAEG;AACH,qBAAa,cAAc;IAOb,OAAO,CAAC,MAAM;IAN1B,OAAO,CAAC,EAAE,CAAY;IACtB,OAAO,CAAC,iBAAiB,CAAC,CAAoB;IAC9C,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,WAAW,CAAC,CAAgB;gBAEhB,MAAM,EAAE,oBAAoB;IAahD;;OAEG;YACW,UAAU;IAiBxB;;OAEG;YACW,iBAAiB;IAM/B;;OAEG;IACH,IAAI,MAAM,IAAI,SAAS,CAEtB;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,aAAa,CAE1B;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;IAKpF;;OAEG;IACG,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAA;KAAE,CAAC,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAK5G;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAKlE;;OAEG;IACG,cAAc,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAWpE;;OAEG;IACH,KAAK,IAAI,YAAY;IAIrB;;OAEG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAIlC;;OAEG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI3B;;OAEG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIxB;;OAEG;IACG,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAK7E;;OAEG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,EAAE;IAIpC;;OAEG;IACH,aAAa,CAAC,aAAa,GAAE,MAAY,GAAG,UAAU,EAAE;IAMxD;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;IAInF;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM;IAIlF;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE;IAM/F;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,KAAK,IAAI,MAAM;IAIf;;OAEG;IACH,KAAK;;;;;;CAGN;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,cAAc,CAAC,CAK1F"}

package/dist/client.js

@@ -0,0 +1,270 @@
+"use strict";
+/**
+ * High-level AiFastDb Client
+ *
+ * Provides a convenient wrapper around the native AiFastDb with:
+ * - Automatic embedding generation
+ * - OpenAI integration
+ * - Simplified API
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AiFastDbClient = void 0;
+exports.createAiFastDb = createAiFastDb;
+const native_1 = require("./native");
+const query_builder_1 = require("./query-builder");
+const memory_manager_1 = require("./memory-manager");
+/**
+ * Create an OpenAI embedding provider
+ */
+async function createOpenAIProvider(config) {
+    // Dynamic import to avoid requiring openai when not used
+    const { default: OpenAI } = await Promise.resolve().then(() => __importStar(require('openai')));
+    const client = new OpenAI({
+        apiKey: config.apiKey,
+        baseURL: config.baseUrl,
+    });
+    const model = config.model ?? 'text-embedding-ada-002';
+    const dimension = model.includes('3-small') ? 1536 :
+        model.includes('3-large') ? 3072 : 1536;
+    return {
+        dimension,
+        async embed(text) {
+            const response = await client.embeddings.create({
+                model,
+                input: text,
+            });
+            return response.data[0].embedding;
+        },
+        async embedBatch(texts) {
+            const response = await client.embeddings.create({
+                model,
+                input: texts,
+            });
+            return response.data.map(d => d.embedding);
+        },
+    };
+}
+/**
+ * High-level AiFastDb Client
+ */
+class AiFastDbClient {
+    constructor(config) {
+        this.config = config;
+        this.initialized = false;
+        this.db = new native_1.AiFastDb({
+            path: config.path,
+            dimension: config.dimension,
+            hnsw: config.hnsw,
+        });
+        this.memoryManager = new memory_manager_1.MemoryManager(this.db, config.memoryManager);
+        // Start async initialization
+        this.initPromise = this.initialize();
+    }
+    /**
+     * Initialize the client (called automatically)
+     */
+    async initialize() {
+        if (this.initialized)
+            return;
+        // Setup embedding provider
+        if (this.config.embeddingProvider) {
+            this.embeddingProvider = this.config.embeddingProvider;
+        }
+        else if (this.config.openai) {
+            this.embeddingProvider = await createOpenAIProvider(this.config.openai);
+        }
+        if (this.embeddingProvider) {
+            this.memoryManager.setEmbeddingProvider(this.embeddingProvider);
+        }
+        this.initialized = true;
+    }
+    /**
+     * Ensure client is initialized
+     */
+    async ensureInitialized() {
+        if (!this.initialized && this.initPromise) {
+            await this.initPromise;
+        }
+    }
+    /**
+     * Get the native database instance
+     */
+    get native() {
+        return this.db;
+    }
+    /**
+     * Get the memory manager
+     */
+    get memory() {
+        return this.memoryManager;
+    }
+    /**
+     * Get database size
+     */
+    get size() {
+        return this.db.size;
+    }
+    /**
+     * Store a memory with automatic embedding
+     */
+    async remember(content, options) {
+        await this.ensureInitialized();
+        return this.memoryManager.remember(content, options);
+    }
+    /**
+     * Store multiple memories
+     */
+    async rememberMany(items) {
+        await this.ensureInitialized();
+        return this.memoryManager.rememberMany(items);
+    }
+    /**
+     * Recall memories by query
+     */
+    async recall(query, limit) {
+        await this.ensureInitialized();
+        return this.memoryManager.recall(query, limit);
+    }
+    /**
+     * Advanced recall with options
+     */
+    async recallAdvanced(options) {
+        await this.ensureInitialized();
+        // Auto-embed query text if needed
+        if (options.query && this.embeddingProvider && !options.vector) {
+            options.vector = await this.embeddingProvider.embed(options.query);
+        }
+        return this.db.recall(options);
+    }
+    /**
+     * Create a query builder
+     */
+    query() {
+        return new query_builder_1.QueryBuilder(this.db);
+    }
+    /**
+     * Get a memory by ID
+     */
+    get(id) {
+        return this.db.get(id);
+    }
+    /**
+     * Delete a memory
+     */
+    forget(id) {
+        return this.db.forget(id);
+    }
+    /**
+     * Check if memory exists
+     */
+    has(id) {
+        return this.db.has(id);
+    }
+    /**
+     * Get context for LLM
+     */
+    async getContext(query, maxTokens) {
+        await this.ensureInitialized();
+        return this.memoryManager.getContext(query, maxTokens);
+    }
+    /**
+     * Find memories by tag
+     */
+    findByTag(tag) {
+        return this.db.findByTag(tag);
+    }
+    /**
+     * Find important memories
+     */
+    findImportant(minImportance = 0.7) {
+        return this.db.findImportant(minImportance);
+    }
+    // === Knowledge Graph ===
+    /**
+     * Add an entity
+     */
+    addEntity(name, type, properties) {
+        return this.db.addEntity(name, type, properties);
+    }
+    /**
+     * Add a relation
+     */
+    addRelation(source, target, type, weight) {
+        return this.db.addRelation(source, target, type, weight);
+    }
+    /**
+     * Explore the knowledge graph
+     */
+    explore(startId, maxHops, relationTypes) {
+        return this.db.explore(startId, maxHops, relationTypes);
+    }
+    // === Lifecycle ===
+    /**
+     * Flush changes to disk
+     */
+    flush() {
+        this.db.flush();
+    }
+    /**
+     * Close the database
+     */
+    close() {
+        this.db.close();
+    }
+    /**
+     * Prune old memories
+     */
+    prune() {
+        return this.memoryManager.prune();
+    }
+    /**
+     * Get statistics
+     */
+    stats() {
+        return this.memoryManager.stats();
+    }
+}
+exports.AiFastDbClient = AiFastDbClient;
+/**
+ * Create a new AiFastDb client
+ */
+async function createAiFastDb(config) {
+    const client = new AiFastDbClient(config);
+    // Wait for initialization
+    await client.initPromise;
+    return client;
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/connectme-adapter.d.ts

@@ -0,0 +1,76 @@
+/**
+ * ConnectMeAdapter - Data adapter for connectMeTrae2 format
+ *
+ * Provides import/export functionality between connectMeTrae2 JSON format
+ * and AiFastDb's social graph.
+ */
+import type { SocialGraph } from './social-graph';
+import type { ConnectMeData, ImportResult, ExportOptions } from './social-types';
+/**
+ * ConnectMeAdapter converts between connectMeTrae2 format and AiFastDb social graph.
+ *
+ * @example
+ * ```typescript
+ * import { AiFastDb, SocialGraph, ConnectMeAdapter } from 'aifastdb';
+ * import * as fs from 'fs';
+ *
+ * const db = new AiFastDb({ path: './data', dimension: 768 });
+ * const social = new SocialGraph(db);
+ * const adapter = new ConnectMeAdapter(social);
+ *
+ * // Import from connectMeTrae2 format
+ * const data = {
+ *   persons: JSON.parse(fs.readFileSync('persons.json', 'utf-8')),
+ *   tags: JSON.parse(fs.readFileSync('tags.json', 'utf-8')),
+ * };
+ *
+ * const result = await adapter.import(data);
+ * console.log(`Imported ${result.persons.created} persons`);
+ * ```
+ */
+export declare class ConnectMeAdapter {
+    private social;
+    constructor(social: SocialGraph);
+    /**
+     * Import data from connectMeTrae2 format
+     */
+    import(data: ConnectMeData): Promise<ImportResult>;
+    /**
+     * Import a single tag
+     */
+    private importTag;
+    /**
+     * Import a single person
+     */
+    private importPerson;
+    /**
+     * Determine tag type based on tag properties
+     */
+    private determineTagType;
+    /**
+     * Sort tags by hierarchy (parents before children)
+     */
+    private sortTagsByHierarchy;
+    /**
+     * Export data to connectMeTrae2 format
+     */
+    export(options?: ExportOptions): Promise<ConnectMeData>;
+    /**
+     * Import friend relationships from an adjacency list
+     *
+     * @param friendships Array of [personA_id, personB_id] pairs
+     */
+    importFriendships(friendships: Array<[string, string]>): Promise<{
+        created: number;
+        failed: number;
+    }>;
+    /**
+     * Validate connectMeTrae2 data format
+     */
+    validate(data: unknown): {
+        valid: boolean;
+        errors: string[];
+    };
+}
+export default ConnectMeAdapter;
+//# sourceMappingURL=connectme-adapter.d.ts.map

package/dist/connectme-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connectme-adapter.d.ts","sourceRoot":"","sources":["../ts/connectme-adapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EACV,aAAa,EAGb,YAAY,EACZ,aAAa,EAKd,MAAM,gBAAgB,CAAC;AAExB;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAc;gBAEhB,MAAM,EAAE,WAAW;IAQ/B;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IA2JxD;;OAEG;IACH,OAAO,CAAC,SAAS;IAiBjB;;OAEG;IACH,OAAO,CAAC,YAAY;IAcpB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAiCxB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAiC3B;;OAEG;IACG,MAAM,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IAyH7D;;;;OAIG;IACG,iBAAiB,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAgB3G;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;CAoC9D;AAED,eAAe,gBAAgB,CAAC"}