@smythos/sre 1.5.4 → 1.5.6

package/src/index.ts.bak

@@ -1,179 +1,181 @@
-//!!! This is a generated file, do not edit it directly !!!//
-
-export { version } from '../package.json';
-
+//!!! This is a generated file, do not edit it directly !!!//
 
+export { version } from '../package.json';
 
-
-export * from './config';
-export * from './constants';
-export * from './Components/AgentPlugin.class';
-export * from './Components/APIEndpoint.class';
-export * from './Components/APIOutput.class';
-export * from './Components/Async.class';
-export * from './Components/Await.class';
-export * from './Components/Classifier.class';
-export * from './Components/Component.class';
-export * from './Components/ComponentHost.class';
-export * from './Components/DataSourceCleaner.class';
-export * from './Components/DataSourceIndexer.class';
-export * from './Components/DataSourceLookup.class';
-export * from './Components/FEncDec.class';
-export * from './Components/FHash.class';
-export * from './Components/FileStore.class';
-export * from './Components/ForEach.class';
-export * from './Components/FSign.class';
-export * from './Components/FSleep.class';
-export * from './Components/FTimestamp.class';
-export * from './Components/GenAILLM.class';
-export * from './Components/GPTPlugin.class';
-export * from './Components/HuggingFace.class';
-export * from './Components/ImageGenerator.class';
-export * from './Components/index';
-export * from './Components/JSONFilter.class';
-export * from './Components/LLMAssistant.class';
-export * from './Components/LogicAND.class';
-export * from './Components/LogicAtLeast.class';
-export * from './Components/LogicAtMost.class';
-export * from './Components/LogicOR.class';
-export * from './Components/LogicXOR.class';
-export * from './Components/MCPClient.class';
-export * from './Components/PromptGenerator.class';
-export * from './Components/ScrapflyWebScrape.class';
-export * from './Components/TavilyWebSearch.class';
-export * from './Core/AgentProcess.helper';
-export * from './Core/boot';
-export * from './Core/Connector.class';
-export * from './Core/ConnectorsService';
-export * from './Core/DummyConnector';
-export * from './Core/HookService';
-export * from './Core/SmythRuntime.class';
-export * from './Core/SystemEvents';
-export * from './helpers/BinaryInput.helper';
-export * from './helpers/Conversation.helper';
-export * from './helpers/JsonContent.helper';
-export * from './helpers/LocalCache.helper';
-export * from './helpers/Log.helper';
-export * from './helpers/OpenApiParser.helper';
-export * from './helpers/S3Cache.helper';
-export * from './helpers/SmythURI.helper';
-export * from './helpers/TemplateString.helper';
-export * from './helpers/TypeChecker.helper';
-export * from './types/ACL.types';
-export * from './types/Agent.types';
-export * from './types/AgentLogger.types';
-export * from './types/AWS.types';
-export * from './types/Cache.types';
-export * from './types/Common.types';
-export * from './types/LLM.types';
-export * from './types/Redis.types';
-export * from './types/Security.types';
-export * from './types/SRE.types';
-export * from './types/Storage.types';
-export * from './types/VectorDB.types';
-export * from './Components/APICall/AccessTokenManager';
-export * from './Components/APICall/APICall.class';
-export * from './Components/APICall/ArrayBufferResponse.helper';
-export * from './Components/APICall/mimeTypeCategories';
-export * from './Components/APICall/OAuth.helper';
-export * from './Components/APICall/parseData';
-export * from './Components/APICall/parseHeaders';
-export * from './Components/APICall/parseProxy';
-export * from './Components/APICall/parseUrl';
-export * from './Components/Image/imageSettings.config';
-export * from './subsystems/AgentManager/Agent.class';
-export * from './subsystems/AgentManager/Agent.helper';
-export * from './subsystems/AgentManager/AgentLogger.class';
-export * from './subsystems/AgentManager/AgentRequest.class';
-export * from './subsystems/AgentManager/AgentRuntime.class';
-export * from './subsystems/AgentManager/AgentSettings.class';
-export * from './subsystems/AgentManager/AgentSSE.class';
-export * from './subsystems/AgentManager/EmbodimentSettings.class';
-export * from './subsystems/AgentManager/ForkedAgent.class';
-export * from './subsystems/AgentManager/OSResourceMonitor';
-export * from './subsystems/LLMManager/custom-models';
-export * from './subsystems/LLMManager/LLM.helper';
-export * from './subsystems/LLMManager/LLM.inference';
-export * from './subsystems/LLMManager/models';
-export * from './subsystems/LLMManager/paramMappings';
-export * from './subsystems/MemoryManager/LLMCache';
-export * from './subsystems/MemoryManager/LLMContext';
-export * from './subsystems/MemoryManager/RuntimeContext';
-export * from './subsystems/Security/Credentials.helper';
-export * from './subsystems/Security/SecureConnector.class';
-export * from './subsystems/AgentManager/AgentData.service/AgentDataConnector';
-export * from './subsystems/AgentManager/AgentData.service/index';
-export * from './subsystems/AgentManager/Component.service/ComponentConnector';
-export * from './subsystems/AgentManager/Component.service/index';
-export * from './subsystems/ComputeManager/Code.service/CodeConnector';
-export * from './subsystems/ComputeManager/Code.service/index';
-export * from './subsystems/IO/CLI.service/CLIConnector';
-export * from './subsystems/IO/CLI.service/index';
-export * from './subsystems/IO/Log.service/index';
-export * from './subsystems/IO/Log.service/LogConnector';
-export * from './subsystems/IO/NKV.service/index';
-export * from './subsystems/IO/NKV.service/NKVConnector';
-export * from './subsystems/IO/Router.service/index';
-export * from './subsystems/IO/Router.service/RouterConnector';
-export * from './subsystems/IO/Storage.service/index';
-export * from './subsystems/IO/Storage.service/SmythFS.class';
-export * from './subsystems/IO/Storage.service/StorageConnector';
-export * from './subsystems/IO/VectorDB.service/index';
-export * from './subsystems/IO/VectorDB.service/VectorDBConnector';
-export * from './subsystems/LLMManager/LLM.service/index';
-export * from './subsystems/LLMManager/LLM.service/LLMConnector';
-export * from './subsystems/LLMManager/LLM.service/LLMCredentials.helper';
-export * from './subsystems/LLMManager/ModelsProvider.service/index';
-export * from './subsystems/LLMManager/ModelsProvider.service/ModelsProviderConnector';
-export * from './subsystems/MemoryManager/Cache.service/CacheConnector';
-export * from './subsystems/MemoryManager/Cache.service/index';
-export * from './subsystems/Security/AccessControl/AccessCandidate.class';
-export * from './subsystems/Security/AccessControl/AccessRequest.class';
-export * from './subsystems/Security/AccessControl/ACL.class';
-export * from './subsystems/Security/Account.service/AccountConnector';
-export * from './subsystems/Security/Account.service/index';
-export * from './subsystems/Security/ManagedVault.service/index';
-export * from './subsystems/Security/ManagedVault.service/ManagedVaultConnector';
-export * from './subsystems/Security/Vault.service/index';
-export * from './subsystems/Security/Vault.service/Vault.helper';
-export * from './subsystems/Security/Vault.service/VaultConnector';
-export * from './subsystems/AgentManager/AgentData.service/connectors/CLIAgentDataConnector.class';
-export * from './subsystems/AgentManager/AgentData.service/connectors/LocalAgentDataConnector.class';
-export * from './subsystems/AgentManager/AgentData.service/connectors/NullAgentData.class';
-export * from './subsystems/AgentManager/Component.service/connectors/LocalComponentConnector.class';
-export * from './subsystems/ComputeManager/Code.service/connectors/AWSLambdaCode.class';
-export * from './subsystems/IO/Log.service/connectors/ConsoleLog.class';
-export * from './subsystems/IO/NKV.service/connectors/NKVRAM.class';
-export * from './subsystems/IO/NKV.service/connectors/NKVRedis.class';
-export * from './subsystems/IO/Router.service/connectors/ExpressRouter.class';
-export * from './subsystems/IO/Router.service/connectors/NullRouter.class';
-export * from './subsystems/IO/Storage.service/connectors/LocalStorage.class';
-export * from './subsystems/IO/Storage.service/connectors/S3Storage.class';
-export * from './subsystems/IO/VectorDB.service/connectors/MilvusVectorDB.class';
-export * from './subsystems/IO/VectorDB.service/connectors/PineconeVectorDB.class';
-export * from './subsystems/IO/VectorDB.service/connectors/RAMVecrtorDB.class';
-export * from './subsystems/IO/VectorDB.service/embed/BaseEmbedding';
-export * from './subsystems/IO/VectorDB.service/embed/index';
-export * from './subsystems/IO/VectorDB.service/embed/OpenAIEmbedding';
-export * from './subsystems/LLMManager/LLM.service/connectors/Anthropic.class';
-export * from './subsystems/LLMManager/LLM.service/connectors/Bedrock.class';
-export * from './subsystems/LLMManager/LLM.service/connectors/Echo.class';
-export * from './subsystems/LLMManager/LLM.service/connectors/GoogleAI.class';
-export * from './subsystems/LLMManager/LLM.service/connectors/Groq.class';
-export * from './subsystems/LLMManager/LLM.service/connectors/OpenAI.class';
-export * from './subsystems/LLMManager/LLM.service/connectors/Perplexity.class';
-export * from './subsystems/LLMManager/LLM.service/connectors/VertexAI.class';
-export * from './subsystems/LLMManager/ModelsProvider.service/connectors/SmythModelsProvider.class';
-export * from './subsystems/MemoryManager/Cache.service/connectors/LocalStorageCache.class';
-export * from './subsystems/MemoryManager/Cache.service/connectors/RAMCache.class';
-export * from './subsystems/MemoryManager/Cache.service/connectors/RedisCache.class';
-export * from './subsystems/MemoryManager/Cache.service/connectors/S3Cache.class';
-export * from './subsystems/Security/Account.service/connectors/AWSAccount.class';
-export * from './subsystems/Security/Account.service/connectors/DummyAccount.class';
-export * from './subsystems/Security/Account.service/connectors/JSONFileAccount.class';
-export * from './subsystems/Security/ManagedVault.service/connectors/NullManagedVault.class';
-export * from './subsystems/Security/ManagedVault.service/connectors/SecretManagerManagedVault';
-export * from './subsystems/Security/Vault.service/connectors/HashicorpVault.class';
-export * from './subsystems/Security/Vault.service/connectors/JSONFileVault.class';
-export * from './subsystems/Security/Vault.service/connectors/NullVault.class';
+
+
+
+export * from './config';
+export * from './constants';
+export * from './Components/AgentPlugin.class';
+export * from './Components/APIEndpoint.class';
+export * from './Components/APIOutput.class';
+export * from './Components/Async.class';
+export * from './Components/Await.class';
+export * from './Components/Classifier.class';
+export * from './Components/Component.class';
+export * from './Components/ComponentHost.class';
+export * from './Components/DataSourceCleaner.class';
+export * from './Components/DataSourceIndexer.class';
+export * from './Components/DataSourceLookup.class';
+export * from './Components/FEncDec.class';
+export * from './Components/FHash.class';
+export * from './Components/FileStore.class';
+export * from './Components/ForEach.class';
+export * from './Components/FSign.class';
+export * from './Components/FSleep.class';
+export * from './Components/FTimestamp.class';
+export * from './Components/GenAILLM.class';
+export * from './Components/GPTPlugin.class';
+export * from './Components/HuggingFace.class';
+export * from './Components/ImageGenerator.class';
+export * from './Components/index';
+export * from './Components/JSONFilter.class';
+export * from './Components/LLMAssistant.class';
+export * from './Components/LogicAND.class';
+export * from './Components/LogicAtLeast.class';
+export * from './Components/LogicAtMost.class';
+export * from './Components/LogicOR.class';
+export * from './Components/LogicXOR.class';
+export * from './Components/MCPClient.class';
+export * from './Components/PromptGenerator.class';
+export * from './Components/ScrapflyWebScrape.class';
+export * from './Components/TavilyWebSearch.class';
+export * from './Core/AgentProcess.helper';
+export * from './Core/boot';
+export * from './Core/Connector.class';
+export * from './Core/ConnectorsService';
+export * from './Core/DummyConnector';
+export * from './Core/HookService';
+export * from './Core/SmythRuntime.class';
+export * from './Core/SystemEvents';
+export * from './helpers/BinaryInput.helper';
+export * from './helpers/Conversation.helper';
+export * from './helpers/JsonContent.helper';
+export * from './helpers/LocalCache.helper';
+export * from './helpers/Log.helper';
+export * from './helpers/OpenApiParser.helper';
+export * from './helpers/S3Cache.helper';
+export * from './helpers/SmythURI.helper';
+export * from './helpers/Sysconfig.helper';
+export * from './helpers/TemplateString.helper';
+export * from './helpers/TypeChecker.helper';
+export * from './types/ACL.types';
+export * from './types/Agent.types';
+export * from './types/AgentLogger.types';
+export * from './types/AWS.types';
+export * from './types/Cache.types';
+export * from './types/Common.types';
+export * from './types/LLM.types';
+export * from './types/Redis.types';
+export * from './types/Security.types';
+export * from './types/SRE.types';
+export * from './types/Storage.types';
+export * from './types/VectorDB.types';
+export * from './Components/APICall/AccessTokenManager';
+export * from './Components/APICall/APICall.class';
+export * from './Components/APICall/ArrayBufferResponse.helper';
+export * from './Components/APICall/mimeTypeCategories';
+export * from './Components/APICall/OAuth.helper';
+export * from './Components/APICall/parseData';
+export * from './Components/APICall/parseHeaders';
+export * from './Components/APICall/parseProxy';
+export * from './Components/APICall/parseUrl';
+export * from './Components/Image/imageSettings.config';
+export * from './subsystems/AgentManager/Agent.class';
+export * from './subsystems/AgentManager/Agent.helper';
+export * from './subsystems/AgentManager/AgentLogger.class';
+export * from './subsystems/AgentManager/AgentRequest.class';
+export * from './subsystems/AgentManager/AgentRuntime.class';
+export * from './subsystems/AgentManager/AgentSettings.class';
+export * from './subsystems/AgentManager/AgentSSE.class';
+export * from './subsystems/AgentManager/EmbodimentSettings.class';
+export * from './subsystems/AgentManager/ForkedAgent.class';
+export * from './subsystems/AgentManager/OSResourceMonitor';
+export * from './subsystems/LLMManager/custom-models';
+export * from './subsystems/LLMManager/LLM.helper';
+export * from './subsystems/LLMManager/LLM.inference';
+export * from './subsystems/LLMManager/models';
+export * from './subsystems/LLMManager/paramMappings';
+export * from './subsystems/MemoryManager/LLMCache';
+export * from './subsystems/MemoryManager/LLMContext';
+export * from './subsystems/MemoryManager/RuntimeContext';
+export * from './subsystems/Security/Credentials.helper';
+export * from './subsystems/Security/SecureConnector.class';
+export * from './subsystems/AgentManager/AgentData.service/AgentDataConnector';
+export * from './subsystems/AgentManager/AgentData.service/index';
+export * from './subsystems/AgentManager/Component.service/ComponentConnector';
+export * from './subsystems/AgentManager/Component.service/index';
+export * from './subsystems/ComputeManager/Code.service/CodeConnector';
+export * from './subsystems/ComputeManager/Code.service/index';
+export * from './subsystems/IO/CLI.service/CLIConnector';
+export * from './subsystems/IO/CLI.service/index';
+export * from './subsystems/IO/Log.service/index';
+export * from './subsystems/IO/Log.service/LogConnector';
+export * from './subsystems/IO/NKV.service/index';
+export * from './subsystems/IO/NKV.service/NKVConnector';
+export * from './subsystems/IO/Router.service/index';
+export * from './subsystems/IO/Router.service/RouterConnector';
+export * from './subsystems/IO/Storage.service/index';
+export * from './subsystems/IO/Storage.service/SmythFS.class';
+export * from './subsystems/IO/Storage.service/StorageConnector';
+export * from './subsystems/IO/VectorDB.service/index';
+export * from './subsystems/IO/VectorDB.service/VectorDBConnector';
+export * from './subsystems/LLMManager/LLM.service/index';
+export * from './subsystems/LLMManager/LLM.service/LLMConnector';
+export * from './subsystems/LLMManager/LLM.service/LLMCredentials.helper';
+export * from './subsystems/LLMManager/ModelsProvider.service/index';
+export * from './subsystems/LLMManager/ModelsProvider.service/ModelsProviderConnector';
+export * from './subsystems/MemoryManager/Cache.service/CacheConnector';
+export * from './subsystems/MemoryManager/Cache.service/index';
+export * from './subsystems/Security/AccessControl/AccessCandidate.class';
+export * from './subsystems/Security/AccessControl/AccessRequest.class';
+export * from './subsystems/Security/AccessControl/ACL.class';
+export * from './subsystems/Security/Account.service/AccountConnector';
+export * from './subsystems/Security/Account.service/index';
+export * from './subsystems/Security/ManagedVault.service/index';
+export * from './subsystems/Security/ManagedVault.service/ManagedVaultConnector';
+export * from './subsystems/Security/Vault.service/index';
+export * from './subsystems/Security/Vault.service/Vault.helper';
+export * from './subsystems/Security/Vault.service/VaultConnector';
+export * from './subsystems/AgentManager/AgentData.service/connectors/CLIAgentDataConnector.class';
+export * from './subsystems/AgentManager/AgentData.service/connectors/LocalAgentDataConnector.class';
+export * from './subsystems/AgentManager/AgentData.service/connectors/NullAgentData.class';
+export * from './subsystems/AgentManager/Component.service/connectors/LocalComponentConnector.class';
+export * from './subsystems/ComputeManager/Code.service/connectors/AWSLambdaCode.class';
+export * from './subsystems/IO/Log.service/connectors/ConsoleLog.class';
+export * from './subsystems/IO/NKV.service/connectors/NKVLocalStorage.class';
+export * from './subsystems/IO/NKV.service/connectors/NKVRAM.class';
+export * from './subsystems/IO/NKV.service/connectors/NKVRedis.class';
+export * from './subsystems/IO/Router.service/connectors/ExpressRouter.class';
+export * from './subsystems/IO/Router.service/connectors/NullRouter.class';
+export * from './subsystems/IO/Storage.service/connectors/LocalStorage.class';
+export * from './subsystems/IO/Storage.service/connectors/S3Storage.class';
+export * from './subsystems/IO/VectorDB.service/connectors/MilvusVectorDB.class';
+export * from './subsystems/IO/VectorDB.service/connectors/PineconeVectorDB.class';
+export * from './subsystems/IO/VectorDB.service/connectors/RAMVecrtorDB.class';
+export * from './subsystems/IO/VectorDB.service/embed/BaseEmbedding';
+export * from './subsystems/IO/VectorDB.service/embed/index';
+export * from './subsystems/IO/VectorDB.service/embed/OpenAIEmbedding';
+export * from './subsystems/LLMManager/LLM.service/connectors/Anthropic.class';
+export * from './subsystems/LLMManager/LLM.service/connectors/Bedrock.class';
+export * from './subsystems/LLMManager/LLM.service/connectors/Echo.class';
+export * from './subsystems/LLMManager/LLM.service/connectors/GoogleAI.class';
+export * from './subsystems/LLMManager/LLM.service/connectors/Groq.class';
+export * from './subsystems/LLMManager/LLM.service/connectors/OpenAI.class';
+export * from './subsystems/LLMManager/LLM.service/connectors/Perplexity.class';
+export * from './subsystems/LLMManager/LLM.service/connectors/VertexAI.class';
+export * from './subsystems/LLMManager/ModelsProvider.service/connectors/SmythModelsProvider.class';
+export * from './subsystems/MemoryManager/Cache.service/connectors/LocalStorageCache.class';
+export * from './subsystems/MemoryManager/Cache.service/connectors/RAMCache.class';
+export * from './subsystems/MemoryManager/Cache.service/connectors/RedisCache.class';
+export * from './subsystems/MemoryManager/Cache.service/connectors/S3Cache.class';
+export * from './subsystems/Security/Account.service/connectors/AWSAccount.class';
+export * from './subsystems/Security/Account.service/connectors/DummyAccount.class';
+export * from './subsystems/Security/Account.service/connectors/JSONFileAccount.class';
+export * from './subsystems/Security/ManagedVault.service/connectors/NullManagedVault.class';
+export * from './subsystems/Security/ManagedVault.service/connectors/SecretManagerManagedVault';
+export * from './subsystems/Security/Vault.service/connectors/HashicorpVault.class';
+export * from './subsystems/Security/Vault.service/connectors/JSONFileVault.class';
+export * from './subsystems/Security/Vault.service/connectors/NullVault.class';
 export * from './subsystems/Security/Vault.service/connectors/SecretsManager.class';

package/src/subsystems/AgentManager/AgentLogger.class.ts

@@ -137,7 +137,7 @@ class LogTransaction {
 
     private async storeLogData(filePath: string, content: any) {
         const logConnector = ConnectorService.getLogConnector();
-        if (!logConnector.valid) return;
+        if (!logConnector.valid || logConnector.name == 'ConsoleLog') return;
 
         if (!filePath) return;
         try {

package/src/subsystems/IO/Log.service/connectors/ConsoleLog.class.ts

@@ -8,6 +8,7 @@ import { AgentCallLog } from '@sre/types/AgentLogger.types';
 const console = Logger('SmythLog');
 
 export class ConsoleLog extends LogConnector {
+    public name: string = 'ConsoleLog';
     public id: string;
     public getResourceACL(resourceId: string, candidate: IAccessCandidate): Promise<ACL> {
         return Promise.resolve(new ACL());
@@ -24,5 +25,4 @@ export class ConsoleLog extends LogConnector {
 
         return Promise.resolve();
     }
-    public name: string;
 }

package/src/subsystems/IO/NKV.service/NKVConnector.ts

@@ -16,6 +16,8 @@ export interface INKVRequest {
 
 /**
  * NKV = Namespace-Key-Value Connector
+ * The NKV Connectors are used to store and retrieve data in a namespace-key-value format.
+ * It is generally used by internal connectors to index data : for example, some vectorDB providers may use it to keep track of inserted vectors.
  */
 export abstract class NKVConnector extends SecureConnector {
     public requester(candidate: AccessCandidate): INKVRequest {

package/src/subsystems/IO/NKV.service/connectors/NKVLocalStorage.class.ts

@@ -0,0 +1,211 @@
+import { AccessRequest } from '@sre/Security/AccessControl/AccessRequest.class';
+import { NKVConnector } from '../NKVConnector';
+import { ACLAccessDeniedError, IAccessCandidate, TAccessResult } from '@sre/types/ACL.types';
+import { ACL } from '@sre/Security/AccessControl/ACL.class';
+import { CacheConnector } from '@sre/MemoryManager/Cache.service/CacheConnector';
+import { ConnectorService } from '@sre/Core/ConnectorsService';
+import { StorageData } from '@sre/types/Storage.types';
+import { AccountConnector } from '@sre/Security/Account.service/AccountConnector';
+import Joi from 'joi';
+import fs from 'fs';
+import path from 'path';
+import { findSmythPath } from '../../../../';
+import { Logger } from '@sre/helpers/Log.helper';
+
+const console = Logger('NKVLocalStorage');
+
+export type NKVLocalStorageConfig = {
+    folder?: string;
+};
+
+export class NKVLocalStorage extends NKVConnector {
+    public name = 'NKVLocalStorage';
+    private folder: string;
+    private accountConnector: AccountConnector;
+    private cacheConnector: CacheConnector;
+    private isInitialized = false;
+
+    constructor(protected _settings?: NKVLocalStorageConfig) {
+        super(_settings);
+        this.accountConnector = ConnectorService.getAccountConnector();
+        this.cacheConnector = ConnectorService.getCacheConnector('RAM');
+        this.folder = this.findStorageFolder(_settings?.folder);
+        this.initialize();
+    }
+
+    private findStorageFolder(folder?: string): string {
+        let _storageFolder = folder;
+
+        if (_storageFolder && fs.existsSync(_storageFolder)) {
+            return _storageFolder;
+        }
+
+        _storageFolder = findSmythPath('nkv');
+
+        if (fs.existsSync(_storageFolder)) {
+            console.warn('Using alternative storage folder found in : ', _storageFolder);
+            return _storageFolder;
+        }
+
+        console.warn('!!! All attempts to find an existing storage folder failed !!!');
+        console.warn('!!! I will use this folder: ', _storageFolder);
+        return _storageFolder;
+    }
+
+    private initialize() {
+        if (!this.isInitialized) {
+            if (!fs.existsSync(this.folder)) {
+                fs.mkdirSync(this.folder, { recursive: true });
+            }
+            this.isInitialized = true;
+        }
+    }
+
+    private getStoragePath(teamId: string, namespace: string, key?: string): string {
+        const parts = [`team_${teamId}`, namespace];
+        if (key) {
+            parts.push(key);
+        }
+        return path.join(this.folder, ...parts);
+    }
+
+    public key(...parts: string[]) {
+        return parts.join(':');
+    }
+
+    @NKVLocalStorage.Validate
+    @NKVLocalStorage.NamespaceAccessControl
+    protected async get(acRequest: AccessRequest, namespace: string, key: string): Promise<StorageData> {
+        const teamId = await this.accountConnector.getCandidateTeam(acRequest.candidate);
+        const filePath = this.getStoragePath(teamId, namespace, key);
+        if (!fs.existsSync(filePath)) {
+            return null;
+        }
+        try {
+            const data = fs.readFileSync(filePath, 'utf-8');
+            return JSON.parse(data);
+        } catch (error) {
+            console.error(`Error reading from NKVLocalStorage: ${error.message}`);
+            return null;
+        }
+    }
+
+    @NKVLocalStorage.Validate
+    @NKVLocalStorage.NamespaceAccessControl
+    protected async set(acRequest: AccessRequest, namespace: string, key: string, value: any): Promise<void> {
+        const teamId = await this.accountConnector.getCandidateTeam(acRequest.candidate);
+        const filePath = this.getStoragePath(teamId, namespace, key);
+        const dirPath = path.dirname(filePath);
+
+        if (!fs.existsSync(dirPath)) {
+            fs.mkdirSync(dirPath, { recursive: true });
+        }
+
+        fs.writeFileSync(filePath, JSON.stringify(value));
+    }
+
+    @NKVLocalStorage.Validate
+    @NKVLocalStorage.NamespaceAccessControl
+    protected async delete(acRequest: AccessRequest, namespace: string, key: string): Promise<void> {
+        const teamId = await this.accountConnector.getCandidateTeam(acRequest.candidate);
+        const filePath = this.getStoragePath(teamId, namespace, key);
+        if (fs.existsSync(filePath)) {
+            fs.unlinkSync(filePath);
+        }
+    }
+
+    @NKVLocalStorage.Validate
+    @NKVLocalStorage.NamespaceAccessControl
+    protected async exists(acRequest: AccessRequest, namespace: string, key: string): Promise<boolean> {
+        const teamId = await this.accountConnector.getCandidateTeam(acRequest.candidate);
+        const filePath = this.getStoragePath(teamId, namespace, key);
+        return fs.existsSync(filePath);
+    }
+
+    @NKVLocalStorage.NamespaceAccessControl
+    public async list(acRequest: AccessRequest, namespace: string): Promise<{ key: string; data: StorageData }[]> {
+        const teamId = await this.accountConnector.getCandidateTeam(acRequest.candidate);
+        const namespacePath = this.getStoragePath(teamId, namespace);
+        const results: { key: string; data: StorageData }[] = [];
+
+        if (!fs.existsSync(namespacePath)) {
+            return results;
+        }
+
+        const files = fs.readdirSync(namespacePath);
+        for (const file of files) {
+            const filePath = path.join(namespacePath, file);
+            const stat = fs.statSync(filePath);
+            if (stat.isFile()) {
+                const data = fs.readFileSync(filePath, 'utf-8');
+                results.push({
+                    key: file,
+                    data: JSON.parse(data) as StorageData,
+                });
+            }
+        }
+        return results;
+    }
+
+    @NKVLocalStorage.NamespaceAccessControl
+    public async deleteAll(acRequest: AccessRequest, namespace: string): Promise<void> {
+        const teamId = await this.accountConnector.getCandidateTeam(acRequest.candidate);
+        const namespacePath = this.getStoragePath(teamId, namespace);
+        if (fs.existsSync(namespacePath)) {
+            fs.rmSync(namespacePath, { recursive: true, force: true });
+        }
+    }
+
+    public async getResourceACL(resourceId: string, candidate: IAccessCandidate): Promise<ACL> {
+        return this.cacheConnector.getResourceACL(resourceId, candidate);
+    }
+
+    public clearAll(): void {
+        if (fs.existsSync(this.folder)) {
+            fs.rmSync(this.folder, { recursive: true, force: true });
+            this.initialize();
+        }
+    }
+
+    static NamespaceAccessControl(target: any, propertyKey: string, descriptor: PropertyDescriptor) {
+        const originalMethod = descriptor.value;
+
+        descriptor.value = async function (...args: any[]) {
+            let [acRequest, namespace, key] = args;
+            const isNamespaceSearch = key === undefined;
+
+            const teamId = await this.accountConnector.getCandidateTeam(acRequest.candidate);
+            const resourceId = isNamespaceSearch ? namespace : `${namespace}:${key}`;
+            const finalKey = this.key(`team_${teamId}`, resourceId);
+            const accessTicket = await this.getAccessTicket(finalKey, acRequest);
+
+            if (accessTicket.access !== TAccessResult.Granted) throw new ACLAccessDeniedError('Access Denied');
+
+            return originalMethod.apply(this, args);
+        };
+
+        return descriptor;
+    }
+
+    static Validate(target: any, propertyKey: string, descriptor: PropertyDescriptor) {
+        const originalMethod = descriptor.value;
+
+        descriptor.value = async function (...args: any[]) {
+            let [acRequest, namespace, key] = args;
+
+            const schemaValidator = Joi.object().keys({
+                namespace: Joi.string().min(1).required(),
+                key: Joi.string().min(1).required(),
+            });
+            const validationResult = schemaValidator.validate({ namespace, key });
+
+            if (validationResult.error) {
+                throw new Error(`Validation Error: ${validationResult.error.message}`);
+            }
+
+            return originalMethod.apply(this, args);
+        };
+
+        return descriptor;
+    }
+}

package/src/subsystems/IO/NKV.service/connectors/NKVRAM.class.ts

@@ -11,7 +11,7 @@ import { AccountConnector } from '@sre/Security/Account.service/AccountConnector
 import Joi from 'joi';
 
 export class NKVRAM extends NKVConnector {
-    public name = 'RAM';
+    public name = 'NKVRAM';
     private storage: Map<string, any> = new Map();
     private namespaces: Set<string> = new Set();
     private accountConnector: AccountConnector;