chore: recovery checkpoint - v3.0 API successfully recovered

CRITICAL CHECKPOINT - DO NOT PUSH TO GITHUB

Recovery Status:
- Successfully recovered brainy.ts from compiled JavaScript
- All core v3.0 API methods functional (add, get, update, delete, relate, find, etc.)
- Neural subsystem intact (562KB embedded patterns, NLP working)
- Augmentation pipeline operational (20+ augmentations)
- HNSW clustering system complete
- Triple Intelligence compiled (needs constructor fix)
- Test suite validates functionality

Changes preserved:
- 898 files with changes from last 3 days
- 144,475 insertions
- All augmentation improvements
- All test coverage enhancements
- Complete v3.0 feature set

This is a LOCAL checkpoint only - contains recovered work after corruption incident.
Created backup in .backups/brainy-full-20250910-151314.tar.gz

Branch: recovery-checkpoint-20250910-151433
Date: Wed Sep 10 03:18:04 PM PDT 2025

.recovery-workspace/dist-backup-20250910-141917/mcp/brainyMCPService.d.ts

@@ -0,0 +1,98 @@
+/**
+ * BrainyMCPService
+ *
+ * This class provides a unified service for accessing Brainy data and augmentations
+ * through the Model Control Protocol (MCP). It integrates the BrainyMCPAdapter and
+ * MCPAugmentationToolset classes and provides WebSocket and REST server implementations
+ * for external model access.
+ */
+import { BrainyInterface } from '../types/brainyDataInterface.js';
+import { MCPRequest, MCPResponse, MCPServiceOptions } from '../types/mcpTypes.js';
+export declare class BrainyMCPService {
+    private dataAdapter;
+    private toolset;
+    private options;
+    private authTokens;
+    private rateLimits;
+    /**
+     * Creates a new BrainyMCPService
+     * @param brainyData The Brainy instance to wrap
+     * @param options Configuration options for the service
+     */
+    constructor(brainyData: BrainyInterface, options?: MCPServiceOptions);
+    /**
+     * Handles an MCP request
+     * @param request The MCP request
+     * @returns An MCP response
+     */
+    handleRequest(request: MCPRequest): Promise<MCPResponse>;
+    /**
+     * Handles a system info request
+     * @param request The MCP request
+     * @returns An MCP response
+     */
+    private handleSystemInfoRequest;
+    /**
+     * Handles an authentication request
+     * @param request The MCP request
+     * @returns An MCP response
+     */
+    private handleAuthenticationRequest;
+    /**
+     * Checks if a request is valid
+     * @param request The request to check
+     * @returns Whether the request is valid
+     */
+    private isValidRequest;
+    /**
+     * Checks if a request is authenticated
+     * @param request The request to check
+     * @returns Whether the request is authenticated
+     */
+    private isAuthenticated;
+    /**
+     * Checks if a token is valid
+     * @param token The token to check
+     * @returns Whether the token is valid
+     */
+    private isValidToken;
+    /**
+     * Generates an authentication token
+     * @param userId The user ID to associate with the token
+     * @returns The generated token
+     */
+    private generateAuthToken;
+    /**
+     * Checks if a client has exceeded the rate limit
+     * @param clientId The client ID to check
+     * @returns Whether the client is within the rate limit
+     */
+    private checkRateLimit;
+    /**
+     * Creates a success response
+     * @param requestId The request ID
+     * @param data The response data
+     * @returns An MCP response
+     */
+    private createSuccessResponse;
+    /**
+     * Creates an error response
+     * @param requestId The request ID
+     * @param code The error code
+     * @param message The error message
+     * @param details Optional error details
+     * @returns An MCP response
+     */
+    private createErrorResponse;
+    /**
+     * Creates a new request ID
+     * @returns A new UUID
+     */
+    generateRequestId(): string;
+    /**
+     * Handles an MCP request directly (for in-process models)
+     * @param request The MCP request
+     * @returns An MCP response
+     */
+    handleMCPRequest(request: MCPRequest): Promise<MCPResponse>;
+}