@soulcraft/brainy 0.40.0 → 0.43.0

package/dist/augmentations/serverSearchAugmentations.js

@@ -0,0 +1,531 @@
+/**
+ * Server Search Augmentations
+ *
+ * This file implements conduit and activation augmentations for browser-server search functionality.
+ * It allows Brainy to search a server-hosted instance and store results locally.
+ */
+import { AugmentationType } from '../types/augmentations.js';
+import { WebSocketConduitAugmentation } from './conduitAugmentations.js';
+/**
+ * ServerSearchConduitAugmentation
+ *
+ * A specialized conduit augmentation that provides functionality for searching
+ * a server-hosted Brainy instance and storing results locally.
+ */
+export class ServerSearchConduitAugmentation extends WebSocketConduitAugmentation {
+    constructor(name = 'server-search-conduit') {
+        super(name);
+        this.localDb = null;
+        // this.description = 'Conduit augmentation for server-hosted Brainy search'
+    }
+    /**
+     * Initialize the augmentation
+     */
+    async initialize() {
+        if (this.isInitialized) {
+            return;
+        }
+        try {
+            // Initialize the base conduit
+            await super.initialize();
+            // Local DB must be set before initialization
+            if (!this.localDb) {
+                throw new Error('Local database not set. Call setLocalDb before initializing.');
+            }
+            this.isInitialized = true;
+        }
+        catch (error) {
+            console.error(`Failed to initialize ${this.name}:`, error);
+            throw new Error(`Failed to initialize ${this.name}: ${error}`);
+        }
+    }
+    /**
+     * Set the local Brainy instance
+     * @param db The Brainy instance to use for local storage
+     */
+    setLocalDb(db) {
+        this.localDb = db;
+    }
+    /**
+     * Get the local Brainy instance
+     * @returns The local Brainy instance
+     */
+    getLocalDb() {
+        return this.localDb;
+    }
+    /**
+     * Search the server-hosted Brainy instance and store results locally
+     * @param connectionId The ID of the established connection
+     * @param query The search query
+     * @param limit Maximum number of results to return
+     * @returns Search results
+     */
+    async searchServer(connectionId, query, limit = 10) {
+        await this.ensureInitialized();
+        try {
+            // Create a search request
+            const readResult = await this.readData({
+                connectionId,
+                query: {
+                    type: 'search',
+                    query,
+                    limit
+                }
+            });
+            if (readResult.success && readResult.data) {
+                const searchResults = readResult.data;
+                // Store the results in the local Brainy instance
+                if (this.localDb) {
+                    for (const result of searchResults) {
+                        // Check if the noun already exists in the local database
+                        const existingNoun = await this.localDb.get(result.id);
+                        if (!existingNoun) {
+                            // Add the noun to the local database
+                            await this.localDb.add(result.vector, result.metadata);
+                        }
+                    }
+                }
+                return {
+                    success: true,
+                    data: searchResults
+                };
+            }
+            else {
+                return {
+                    success: false,
+                    data: null,
+                    error: readResult.error || 'Unknown error searching server'
+                };
+            }
+        }
+        catch (error) {
+            console.error('Error searching server:', error);
+            return {
+                success: false,
+                data: null,
+                error: `Error searching server: ${error}`
+            };
+        }
+    }
+    /**
+     * Search the local Brainy instance
+     * @param query The search query
+     * @param limit Maximum number of results to return
+     * @returns Search results
+     */
+    async searchLocal(query, limit = 10) {
+        await this.ensureInitialized();
+        try {
+            if (!this.localDb) {
+                return {
+                    success: false,
+                    data: null,
+                    error: 'Local database not initialized'
+                };
+            }
+            const results = await this.localDb.searchText(query, limit);
+            return {
+                success: true,
+                data: results
+            };
+        }
+        catch (error) {
+            console.error('Error searching local database:', error);
+            return {
+                success: false,
+                data: null,
+                error: `Error searching local database: ${error}`
+            };
+        }
+    }
+    /**
+     * Search both server and local instances, combine results, and store server results locally
+     * @param connectionId The ID of the established connection
+     * @param query The search query
+     * @param limit Maximum number of results to return
+     * @returns Combined search results
+     */
+    async searchCombined(connectionId, query, limit = 10) {
+        await this.ensureInitialized();
+        try {
+            // Search local first
+            const localSearchResult = await this.searchLocal(query, limit);
+            if (!localSearchResult.success) {
+                return localSearchResult;
+            }
+            const localResults = localSearchResult.data;
+            // If we have enough local results, return them
+            if (localResults.length >= limit) {
+                return localSearchResult;
+            }
+            // Otherwise, search server for additional results
+            const serverSearchResult = await this.searchServer(connectionId, query, limit - localResults.length);
+            if (!serverSearchResult.success) {
+                // If server search fails, return local results
+                return localSearchResult;
+            }
+            const serverResults = serverSearchResult.data;
+            // Combine results, removing duplicates
+            const combinedResults = [...localResults];
+            const localIds = new Set(localResults.map((r) => r.id));
+            for (const result of serverResults) {
+                if (!localIds.has(result.id)) {
+                    combinedResults.push(result);
+                }
+            }
+            return {
+                success: true,
+                data: combinedResults
+            };
+        }
+        catch (error) {
+            console.error('Error performing combined search:', error);
+            return {
+                success: false,
+                data: null,
+                error: `Error performing combined search: ${error}`
+            };
+        }
+    }
+    /**
+     * Add data to both local and server instances
+     * @param connectionId The ID of the established connection
+     * @param data Text or vector to add
+     * @param metadata Metadata for the data
+     * @returns ID of the added data
+     */
+    async addToBoth(connectionId, data, metadata = {}) {
+        await this.ensureInitialized();
+        try {
+            if (!this.localDb) {
+                return {
+                    success: false,
+                    data: '',
+                    error: 'Local database not initialized'
+                };
+            }
+            // Add to local first
+            const id = await this.localDb.add(data, metadata);
+            // Get the vector and metadata
+            const noun = (await this.localDb.get(id));
+            if (!noun) {
+                return {
+                    success: false,
+                    data: '',
+                    error: 'Failed to retrieve newly created noun'
+                };
+            }
+            // Add to server
+            const writeResult = await this.writeData({
+                connectionId,
+                data: {
+                    type: 'addNoun',
+                    vector: noun.vector,
+                    metadata: noun.metadata
+                }
+            });
+            if (!writeResult.success) {
+                return {
+                    success: true,
+                    data: id,
+                    error: `Added locally but failed to add to server: ${writeResult.error}`
+                };
+            }
+            return {
+                success: true,
+                data: id
+            };
+        }
+        catch (error) {
+            console.error('Error adding data to both:', error);
+            return {
+                success: false,
+                data: '',
+                error: `Error adding data to both: ${error}`
+            };
+        }
+    }
+}
+/**
+ * ServerSearchActivationAugmentation
+ *
+ * An activation augmentation that provides actions for server search functionality.
+ */
+export class ServerSearchActivationAugmentation {
+    constructor(name = 'server-search-activation') {
+        this.enabled = true;
+        this.isInitialized = false;
+        this.conduitAugmentation = null;
+        this.connections = new Map();
+        this.name = name;
+        this.description = 'Activation augmentation for server-hosted Brainy search';
+    }
+    getType() {
+        return AugmentationType.ACTIVATION;
+    }
+    /**
+     * Initialize the augmentation
+     */
+    async initialize() {
+        if (this.isInitialized) {
+            return;
+        }
+        this.isInitialized = true;
+    }
+    /**
+     * Shut down the augmentation
+     */
+    async shutDown() {
+        this.isInitialized = false;
+    }
+    /**
+     * Get the status of the augmentation
+     */
+    async getStatus() {
+        return this.isInitialized ? 'active' : 'inactive';
+    }
+    /**
+     * Set the conduit augmentation to use for server search
+     * @param conduit The ServerSearchConduitAugmentation to use
+     */
+    setConduitAugmentation(conduit) {
+        this.conduitAugmentation = conduit;
+    }
+    /**
+     * Store a connection for later use
+     * @param connectionId The ID to use for the connection
+     * @param connection The WebSocket connection
+     */
+    storeConnection(connectionId, connection) {
+        this.connections.set(connectionId, connection);
+    }
+    /**
+     * Get a stored connection
+     * @param connectionId The ID of the connection to retrieve
+     * @returns The WebSocket connection
+     */
+    getConnection(connectionId) {
+        return this.connections.get(connectionId);
+    }
+    /**
+     * Trigger an action based on a processed command or internal state
+     * @param actionName The name of the action to trigger
+     * @param parameters Optional parameters for the action
+     */
+    triggerAction(actionName, parameters) {
+        if (!this.conduitAugmentation) {
+            return {
+                success: false,
+                data: null,
+                error: 'Conduit augmentation not set'
+            };
+        }
+        // Handle different actions
+        switch (actionName) {
+            case 'connectToServer':
+                return this.handleConnectToServer(parameters || {});
+            case 'searchServer':
+                return this.handleSearchServer(parameters || {});
+            case 'searchLocal':
+                return this.handleSearchLocal(parameters || {});
+            case 'searchCombined':
+                return this.handleSearchCombined(parameters || {});
+            case 'addToBoth':
+                return this.handleAddToBoth(parameters || {});
+            default:
+                return {
+                    success: false,
+                    data: null,
+                    error: `Unknown action: ${actionName}`
+                };
+        }
+    }
+    /**
+     * Handle the connectToServer action
+     * @param parameters Action parameters
+     */
+    handleConnectToServer(parameters) {
+        const serverUrl = parameters.serverUrl;
+        const protocols = parameters.protocols;
+        if (!serverUrl) {
+            return {
+                success: false,
+                data: null,
+                error: 'serverUrl parameter is required'
+            };
+        }
+        // Return a promise that will be resolved when the connection is established
+        return {
+            success: true,
+            data: this.conduitAugmentation.establishConnection(serverUrl, {
+                protocols
+            })
+        };
+    }
+    /**
+     * Handle the searchServer action
+     * @param parameters Action parameters
+     */
+    handleSearchServer(parameters) {
+        const connectionId = parameters.connectionId;
+        const query = parameters.query;
+        const limit = parameters.limit || 10;
+        if (!connectionId) {
+            return {
+                success: false,
+                data: null,
+                error: 'connectionId parameter is required'
+            };
+        }
+        if (!query) {
+            return {
+                success: false,
+                data: null,
+                error: 'query parameter is required'
+            };
+        }
+        // Return a promise that will be resolved when the search is complete
+        return {
+            success: true,
+            data: this.conduitAugmentation.searchServer(connectionId, query, limit)
+        };
+    }
+    /**
+     * Handle the searchLocal action
+     * @param parameters Action parameters
+     */
+    handleSearchLocal(parameters) {
+        const query = parameters.query;
+        const limit = parameters.limit || 10;
+        if (!query) {
+            return {
+                success: false,
+                data: null,
+                error: 'query parameter is required'
+            };
+        }
+        // Return a promise that will be resolved when the search is complete
+        return {
+            success: true,
+            data: this.conduitAugmentation.searchLocal(query, limit)
+        };
+    }
+    /**
+     * Handle the searchCombined action
+     * @param parameters Action parameters
+     */
+    handleSearchCombined(parameters) {
+        const connectionId = parameters.connectionId;
+        const query = parameters.query;
+        const limit = parameters.limit || 10;
+        if (!connectionId) {
+            return {
+                success: false,
+                data: null,
+                error: 'connectionId parameter is required'
+            };
+        }
+        if (!query) {
+            return {
+                success: false,
+                data: null,
+                error: 'query parameter is required'
+            };
+        }
+        // Return a promise that will be resolved when the search is complete
+        return {
+            success: true,
+            data: this.conduitAugmentation.searchCombined(connectionId, query, limit)
+        };
+    }
+    /**
+     * Handle the addToBoth action
+     * @param parameters Action parameters
+     */
+    handleAddToBoth(parameters) {
+        const connectionId = parameters.connectionId;
+        const data = parameters.data;
+        const metadata = parameters.metadata || {};
+        if (!connectionId) {
+            return {
+                success: false,
+                data: null,
+                error: 'connectionId parameter is required'
+            };
+        }
+        if (!data) {
+            return {
+                success: false,
+                data: null,
+                error: 'data parameter is required'
+            };
+        }
+        // Return a promise that will be resolved when the add is complete
+        return {
+            success: true,
+            data: this.conduitAugmentation.addToBoth(connectionId, data, metadata)
+        };
+    }
+    /**
+     * Generates an expressive output or response from Brainy
+     * @param knowledgeId The identifier of the knowledge to express
+     * @param format The desired output format (e.g., 'text', 'json')
+     */
+    generateOutput(knowledgeId, format) {
+        // This method is not used for server search functionality
+        return {
+            success: false,
+            data: '',
+            error: 'generateOutput is not implemented for ServerSearchActivationAugmentation'
+        };
+    }
+    /**
+     * Interacts with an external system or API
+     * @param systemId The identifier of the external system
+     * @param payload The data to send to the external system
+     */
+    interactExternal(systemId, payload) {
+        // This method is not used for server search functionality
+        return {
+            success: false,
+            data: null,
+            error: 'interactExternal is not implemented for ServerSearchActivationAugmentation'
+        };
+    }
+}
+/**
+ * Factory function to create server search augmentations
+ * @param serverUrl The URL of the server to connect to
+ * @param options Additional options
+ * @returns An object containing the created augmentations
+ */
+export async function createServerSearchAugmentations(serverUrl, options = {}) {
+    // Create the conduit augmentation
+    const conduit = new ServerSearchConduitAugmentation(options.conduitName);
+    await conduit.initialize();
+    // Set the local database if provided
+    if (options.localDb) {
+        conduit.setLocalDb(options.localDb);
+    }
+    // Create the activation augmentation
+    const activation = new ServerSearchActivationAugmentation(options.activationName);
+    await activation.initialize();
+    // Link the augmentations
+    activation.setConduitAugmentation(conduit);
+    // Connect to the server
+    const connectionResult = await conduit.establishConnection(serverUrl, {
+        protocols: options.protocols
+    });
+    if (!connectionResult.success || !connectionResult.data) {
+        throw new Error(`Failed to connect to server: ${connectionResult.error}`);
+    }
+    const connection = connectionResult.data;
+    // Store the connection in the activation augmentation
+    activation.storeConnection(connection.connectionId, connection);
+    return {
+        conduit,
+        activation,
+        connection
+    };
+}
+//# sourceMappingURL=serverSearchAugmentations.js.map

package/dist/augmentations/serverSearchAugmentations.js.map

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

package/dist/browserFramework.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Browser Framework Entry Point for Brainy
+ * Optimized for modern frameworks like Angular, React, Vue, etc.
+ * Auto-detects environment and uses optimal storage (OPFS in browsers)
+ */
+import { BrainyData, BrainyDataConfig } from './brainyData.js';
+import { VerbType, NounType } from './types/graphTypes.js';
+/**
+ * Create a BrainyData instance optimized for browser frameworks
+ * Auto-detects environment and selects optimal storage and settings
+ */
+export declare function createBrowserBrainyData(config?: Partial<BrainyDataConfig>): Promise<BrainyData>;
+export { VerbType, NounType, BrainyData };
+export type { BrainyDataConfig };
+export default createBrowserBrainyData;

package/dist/demo.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Demo-specific entry point for browser environments
+ * This excludes all Node.js-specific functionality to avoid import issues
+ */
+import { MemoryStorage } from './storage/adapters/memoryStorage.js';
+import { OPFSStorage } from './storage/adapters/opfsStorage.js';
+export interface Vector extends Array<number> {
+}
+export interface SearchResult {
+    id: string;
+    score: number;
+    metadata: any;
+    text?: string;
+}
+export interface VerbData {
+    id: string;
+    source: string;
+    target: string;
+    verb: string;
+    metadata: any;
+    timestamp: number;
+}
+/**
+ * Simplified BrainyData class for demo purposes
+ * Only includes browser-compatible functionality
+ */
+export declare class DemoBrainyData {
+    private storage;
+    private embedder;
+    private initialized;
+    private vectors;
+    private metadata;
+    private verbs;
+    constructor();
+    /**
+     * Initialize the database
+     */
+    init(): Promise<void>;
+    /**
+     * Add a document to the database
+     */
+    add(text: string, metadata?: any): Promise<string>;
+    /**
+     * Search for similar documents
+     */
+    searchText(query: string, limit?: number): Promise<SearchResult[]>;
+    /**
+     * Add a relationship between two documents
+     */
+    addVerb(sourceId: string, targetId: string, verb: string, metadata?: any): Promise<string>;
+    /**
+     * Get relationships from a source document
+     */
+    getVerbsBySource(sourceId: string): Promise<VerbData[]>;
+    /**
+     * Get a document by ID
+     */
+    get(id: string): Promise<any | null>;
+    /**
+     * Delete a document
+     */
+    delete(id: string): Promise<boolean>;
+    /**
+     * Update document metadata
+     */
+    updateMetadata(id: string, newMetadata: any): Promise<boolean>;
+    /**
+     * Get the number of documents
+     */
+    size(): number;
+    /**
+     * Generate a random ID
+     */
+    private generateId;
+    /**
+     * Get storage info
+     */
+    getStorage(): MemoryStorage | OPFSStorage;
+}
+export declare const NounType: {
+    readonly Person: "Person";
+    readonly Organization: "Organization";
+    readonly Location: "Location";
+    readonly Thing: "Thing";
+    readonly Concept: "Concept";
+    readonly Event: "Event";
+    readonly Document: "Document";
+    readonly Media: "Media";
+    readonly File: "File";
+    readonly Message: "Message";
+    readonly Content: "Content";
+};
+export declare const VerbType: {
+    readonly RelatedTo: "related_to";
+    readonly Contains: "contains";
+    readonly PartOf: "part_of";
+    readonly LocatedAt: "located_at";
+    readonly References: "references";
+    readonly Owns: "owns";
+    readonly CreatedBy: "created_by";
+    readonly BelongsTo: "belongs_to";
+    readonly Likes: "likes";
+    readonly Follows: "follows";
+};
+export { DemoBrainyData as BrainyData };
+export default DemoBrainyData;