@indra.ai/deva 1.56.4 → 1.59.0

package/config/index.js

@@ -20,6 +20,7 @@ export default {
 	timeout: {
 		ask: 30000
 	},
+	hashes: ['md5', 'sha256', 'sha512'],
 	container: {
 		begin: '::BEGIN',
 		end: '::END',

package/index.js

@@ -18,6 +18,7 @@ class Deva {
     this._id = opts.id || randomUUID(); // the unique id assigned to the agent at load
     this._info = opts.info || false; // the deva information from the package file.
     this._config = opts.config || {}; // local Config Object
+    this._config.hashes = config.hashes; // set hashes array from config for stamping.
     this._config.ready_hash = config.ready_hash; // items to hash at ready
     this._config.timeout = {...config.timeout, ...this._config.timeout}; // add timeout values to _config.
     
@@ -282,7 +283,7 @@ class Deva {
     const client = this.client() || false;
     const {meta, params} = packet.q;
     const text = `${this._messages.method_not_found} ${agent.key} ${meta.method}`
-    packet.a = {
+    const packet_answer = {
       id,
       agent,
       client,
@@ -293,22 +294,11 @@ class Deva {
       },
       created: Date.now(),
     };
+    // set packet into packet.a after stamping it.
+    packet.a = this._stamp(packet_answer); 
     
-    this.action('hash', `md5:${packet.a.id.uid}`);
-    packet.a.md5 = this.hash(packet.a, 'md5');
-    this.action('hash', `sha256:${packet.a.id.uid}`);
-    packet.a.sha256 = this.hash(packet.a, 'sha256');
-    this.action('hash', `sha512:${packet.a.id.uid}`);
-    packet.a.sha512 = this.hash(packet.a, 'sha512');
-
-    delete packet.md5;
-    delete packet.sha256;
-    delete packet.sha512;
-    
-    packet.md5 = this.hash(packet, 'md5');
-    packet.sha256 = this.hash(packet, 'sha256');
-    packet.sha512 = this.hash(packet, 'sha512');
-    
+    // stamp the packet before return
+    const packet_stamped = this._stamp(this._unstamp(packet), `methodNotFound:${meta.method}`, packet.id.uid);    
     this.state('invalid', `${meta.method}:${packet.id.uid}`);
     return packet;
   }
@@ -354,28 +344,12 @@ class Deva {
     this.zone(key, data.id.uid);
     this.action(key, data.id.uid);
     this.state(key, data.id.uid);
-  
-    this.action('delete', `${key}:md5:${data.id.uid}`);
-    delete data.md5;
-    
-    this.action('delete', `${key}:sha256:${data.id.uid}`);
-    delete data.sha256;
-  
-    this.action('delete', `${key}:sha512:${data.id.uid}`);
-    delete data.sha512;
-  
+
     this.state('data', `${key}:date:${data.id.uid}`);
     data[key] = Date.now();// set the complete date on the whole data.
   
-    this.action('hash', `${key}:md5:${data.id.uid}`);
-    data.md5 = this.hash(data, 'md5');
-  
-    this.action('hash', `${key}:sha256:${data.id.uid}`)
-    data.sha256 = this.hash(data, 'sha256');
+    const data_stamped = this._stamp(this._unstamp(data), key, data.id.uid);  
   
-    this.action('hash', `${key}:sha512:${data.id.uid}`)
-    data.sha512 = this.hash(data, 'sha512');
-        
     // setup the complete talk event
     this.action('talk', `${this._events[key]}:${data.id.uid}`); // action talk for the event.
     this.talk(this._events[key], this.lib.copy(data)); // talk the complete event
@@ -405,6 +379,37 @@ class Deva {
     return next_key ? this[next_key](data, resolve) : resolve(data);
   }
   
+  /**************
+  func: _stamp
+  params:
+  - data: the data to stamp
+  - label: the label for the hash action.
+  describe: the stamp function will take a data object and apply the hashes from the this._config.hashes array.
+  usage: this._stamp(data, 'value')
+  ***************/
+  _stamp(data, label='', uid='') {
+    for (const algo of this._config.hashes) {
+      if (label) this.action('hash', `${label}:${algo}:${uid}`);
+      data[algo] = this.hash(data, algo);
+    }
+    return data;
+  }
+  
+  /**************
+  func: _unstamp
+  params:
+  - data: the data to unstamp
+  describe: the unstamp function will take a data object and remove the hashes over the this._hashes array.
+  usage: this._unstamp(data)
+  ***************/
+  _unstamp(data) {
+    for (const algo of this._config.hashes) {
+      this.action('delete', `${algo}:${data.id.uid}`);
+      delete data[algo]
+    };
+    return data;
+  }  
+
   /**************
   func: Client
   params: client - client provided data.
@@ -845,16 +850,8 @@ class Deva {
           created: Date.now(), // timestamp the question
         }
 
-        // hash the question
-
-        this.action('hash', `${method}:md5:${id.uid}`);
-        packet.q.md5 = this.hash(packet.q, 'md5');
-        
-        this.action('hash', `${method}:sha256:${id.uid}`)
-        packet.q.sha256 = this.hash(packet.q, 'sha256');
-        
-        this.action('hash', `${method}:sha512:${id.uid}`)
-        packet.q.sha512 = this.hash(packet.q, 'sha512');
+        // stamp the question
+        packet.q = this._stamp(packet.q, method, id.uid);
 
         this.action('talk', `${this._events.question}:${id.uid}`);
         this.intent('good', `${this._events.question}:${id.uid}`);
@@ -988,18 +985,8 @@ class Deva {
           data, // set the answer data
           created: Date.now(), // set the created date for the answer
         };
-        // create a hash for the answer and insert into answer meta.
-        this.action('hash', `${key}:${method}:${subkey}:md5:${id.uid}`);
-        packet_answer.md5 = this.hash(packet_answer, 'md5');
-
-        this.action('hash', `${key}:${method}:${subkey}:sha256:${id.uid}`);
-        packet_answer.sha256 = this.hash(packet_answer, 'sha256');
-
-        this.action('hash', `${key}:${method}:${subkey}:sha512:${id.uid}`);
-        packet_answer.sha512 = this.hash(packet_answer, 'sha512');
-
-        this.state('set', `${key}:${method}:${subkey}:${id.uid}`);
-        packet.a = packet_answer; // set the packet.a to the packet_answer
+        // stamp the packet_answer into packet.a
+        packet.a = this._stamp(packet_answer, `${key}:${method}:${subkey}`, id.uid); // set the packet.a to the packet_answer
 
         this.action('talk', `${this._events.answer}:${id.uid}`);
         this.talk(this._events.answer, this.lib.copy(packet)); // global talk event
@@ -1087,46 +1074,26 @@ class Deva {
           this.state('set', `${key}:${method}:${sub_key}:result:${packet.id.uid}`);
           packet_answer.text = result;
         }
-
-        // delete previous hashes before creating new ones.
-        this.action('delete', `${key}:${method}:packet:md5:${packet.id.uid}`);
-        delete packet.md5;
-        this.action('delete', `${key}:${method}:packet:sha256:${packet.id.uid}`);
-        delete packet.sha256;
-        this.action('delete', `${key}:${method}:packet:sha512:${packet.id.uid}`);
-        delete packet.sha512;
         
-        this.action('hash', `${key}:${method}:${sub_key}:md5:${packet.id.uid}`);
-        packet_answer.md5 = this.hash(packet_answer, 'md5'); // md5 the answer.
-        this.action('hash', `${key}:${method}:${sub_key}:sha256:${packet.id.uid}`);
-        packet_answer.sha256 = this.hash(packet_answer, 'sha256'); // sha256 the answer.
-        this.action('hash', `${key}:${method}:${sub_key}:sha512:${packet.id.uid}`);
-        packet_answer.sha512 = this.hash(packet_answer, 'sha512'); // sha512 the answer
+        // stamp the packet_answer and set it into packet.a.
+        this.state('set', `${key}:${method}:packet:a:${packet.id.uid}`);
+        packet.a = this._stamp(packet_answer, `${key}:${method}:packet:a`, packet.id.uid); // set the packet answer.
 
         this.state('set', `${key}:${method}:packet:q:agent:${packet.id.uid}`);
         packet.q.agent = agent; // set the question agent as the ask agent.
-
-        this.state('set', `${key}:${method}:packet:a:${packet.id.uid}`);
-        packet.a = packet_answer; // set the packet answer.
                 
         // create new hashes for the packet before return.
-        // delete previous hashes before creating new ones.
-        this.action('hash', `${key}:${method}:packet:md5:${packet.id.uid}`);
-        packet.md5 = this.hash(packet, 'md5');
-        this.action('hash', `${key}:${method}:packet:sha256:${packet.id.uid}`);
-        packet.sha256 = this.hash(packet, 'sha256');
-        this.action('hash', `${key}:${method}:packet:sha512:${packet.id.uid}`);
-        packet.sha512 = this.hash(packet, 'sha512');
-        
+        const packet_stamped = this._stamp(this._unstamp(packet), `${key}:${method}:packet`, packet.id.uid);
+                
         this.action('talk', `${this._events.answer}:${key}:${method}:${packet.id.uid}`);
         this.state('valid', `${this._events.answer}:${key}:${method}:${packet.id.uid}`);
         this.intent('good', `${this._events.answer}:${key}:${method}:${packet.id.uid}`);
-        this.talk(this._events.answer, this.lib.copy(packet)); // global talk event
+        this.talk(this._events.answer, this.lib.copy(packet_stamped)); // global talk event
 
         this.action('talk', `${agent.key}:${key}:${method}:${packet.id.uid}`);
         this.state('valid', `${agent.key}:${key}:${method}:${packet.id.uid}`);
         this.intent('good', `${agent.key}:${key}:${method}:${packet.id.uid}`);
-        this.talk(`${agent.key}:ask:${packet.id.uid}`, packet);
+        this.talk(`${agent.key}:ask:${packet.id.uid}`, packet_stamped);
       }).catch(err => {
         this.action('talk', `${agent.key}:${key}:${method}:err:${packet.id.uid}`);
         this.state('catch', `${agent.key}:${key}:${method}:${packet.id.uid}`);
@@ -1550,12 +1517,10 @@ class Deva {
         created: Date.now(),
       };
   
-      data.md5 = this.hash(data, 'md5');
-      data.sha256 = this.hash(data, 'sha256');
-      data.sha512 = this.hash(data, 'sha512');
-  
-      this.talk(this._events.context, this.lib.copy(data));
-      return data;
+      const data_stamped = this._stamp(data, `context`, id.uid);
+      
+      this.talk(this._events.context, this.lib.copy(data_stamped));
+      return data_stamped;
     } catch (e) {
       this.state('catch', `context:${value}:${id.uid}`);
       return this.err(e, value);
@@ -1578,15 +1543,8 @@ class Deva {
       created: Date.now(),      
     };
   
-    this.action('hash', `${data.key}:md5:${data.id.uid}`);
-    data.md5 = this.hash(data, 'md5');
-    this.action('hash', `${data.key}:sha256:${data.id.uid}`);
-    data.sha256 = this.hash(data, 'sha256');    
-    this.action('hash', `${data.key}:sha512:${data.id.uid}`);
-    data.sha512 = this.hash(data, 'sha512');
-  
-    this.state('return', `${data.key}:${id.uid}`);
-    return data;
+    this.state('return', `${key}:${id.uid}`);
+    return this._stamp(data, key, id.uid);
   }
 
   /**************
@@ -1645,7 +1603,7 @@ class Deva {
   describe: Returns a list of available actions in the system.
   ***************/
   actions() {
-    this._workflowItems('actions');
+    return this._workflowItems('actions');
   }
 
   /**************
@@ -1702,7 +1660,7 @@ class Deva {
   describe: returns the available beliefs values.
   ***************/
   beliefs() {
-    return this._workflowItems('intents');
+    return this._workflowItems('beliefs');
   }
 
   /**************
@@ -1731,11 +1689,12 @@ class Deva {
         client: this.client(), // set the client
         created: Date.now(), // set the data created date.
       };
-  
+
+      // manual hashing to avoid _stamp conflict at load.
       data.md5 = this.hash(data, 'md5');
       data.sha256 = this.hash(data, 'sha256');
       data.sha512 = this.hash(data, 'sha512');
-  
+
       this.talk(this._events[key], this.lib.copy(data)); // broadcast the state event
       return data;
     } catch (e) { // catch any errors
@@ -1752,7 +1711,7 @@ class Deva {
     if (!this._active) return this._messages.offline;
     const id = this.uid(); // set the current uid
     this.action(key, id.uid); // set the action to the passed key
-    const value = this[_key]; // get the _keys value 
+    const value = this[`_${key}`]; // get the _keys value 
     // set the data packet for the states
     this.state('data', `${key}:${id.uid}`);
     const data = {
@@ -1764,15 +1723,8 @@ class Deva {
       created: Date.now(),      
     }
   
-    this.action('hash', `${data.key}:md5:${data.id.uid}`);
-    data.md5 = this.hash(data, 'md5');
-    this.action('hash', `${data.key}:sha256:${data.id.uid}`);
-    data.sha256 = this.hash(data, 'sha256');    
-    this.action('hash', `${data.key}:sha512:${data.id.uid}`);
-    data.sha512 = this.hash(data, 'sha512');
-  
     this.action('return', `${data.key}:${id.uid}`);
-    return data;
+    return this._stamp(data, data.key, id.uid);
   }
 
   /**************
@@ -1784,6 +1736,7 @@ class Deva {
   client() {
     if (!this._active) return this._messages.offline; // check the active status
     const data = this.lib.copy(this._client); // create a copy of the client data        
+    // manual hashing here to prevent stack overflow with this._stamp.
     data.md5 = this.hash(data, 'md5');
     data.sha256 = this.hash(data, 'sha256');
     data.sha512 = this.hash(data, 'sha512');
@@ -1799,6 +1752,7 @@ class Deva {
   agent() {
     if (!this._active) return this._messages.offline; // check the active status
     const data = this.lib.copy(this._agent); // create a copy of the agent data.
+    // manual hashing here to prevent stack overflow with this._stamp.
     data.md5 = this.hash(data, 'md5');
     data.sha256 = this.hash(data, 'sha256');
     data.sha512 = this.hash(data, 'sha512');
@@ -2064,20 +2018,15 @@ class Deva {
       created: Date.now(),
     }
     
-    this.action('hash', `${key}:${value}:md5:${data.id.uid}`);    
-    data.md5 = this.hash(data, 'md5'); // md5 the data packet
-
-    this.action('hash', `${key}:${value}:sha256:${data.id.uid}`);
-    data.sha256 = this.hash(data, 'sha256'); // sha256 the data packet
-
-    this.action('hash', `${key}:${value}:sha512:${data.id.uid}`);
-    data.sha512 = this.hash(data, 'sha512'); // sha512 the data packet
+    // stamp the data
+    const data_stamped = this._stamp(data, `${key}:${value}`, data.id.uid);
     
+    // talk the prompt event to anyone listening
     this.action('talk', `${key}:${value}:${id.uid}`);
-    this.talk(this._events.prompt, data);
+    this.talk(this._events.prompt, data_stamped);
     
     this.action('return', `${key}:${value}:${id.uid}`);
-    return data;
+    return data_stamped;
   }
 
   /**************
@@ -2094,18 +2043,10 @@ class Deva {
     const data = this.lib.copy(this._core);
     data.id = id;
     data.created = Date.now();
-
-    delete data.md5; // delete old md5 hash
-    delete data.sha256; // delete old sha256 hash
-    delete data.sha512; // delete old sha512 hash
-
-    data.md5 = this.hash(data, 'md5');
-    data.sha256 = this.hash(data, 'sha256');
-    data.sha512 = this.hash(data, 'sha512');
     
     this.action('return', `core:${id.uid}`);
     this.intent('good', `core:${id.uid}`);
-    return data;
+    return this._stamp(this._unstamp(data), 'core', data.id.uid);
   }
 
   // machine returns the sha256 machine fingerprint 
@@ -2124,6 +2065,7 @@ class Deva {
       cpus: os.cpus(),
       created: Date.now(),
     };
+    // machine has to do manual hashing to prevent stack overflow.
     data.md5 = this.hash(data, 'md5');
     data.sha256 = this.hash(data, 'sha256');
     data.sha512 = this.hash(data, 'sha512');
@@ -2140,16 +2082,9 @@ class Deva {
     const data = this.lib.copy(this._info);
     data.created = Date.now();
     
-    this.action('hash', `info:md5:${data.id}`);    
-    data.md5 = this.hash(data, 'md5');
-    this.action('hash', `info:sha256:${data.id}`);    
-    data.sha256 = this.hash(data, 'sha256');
-    this.action('hash', `info:sha512:${data.id}`);    
-    data.sha512 = this.hash(data, 'sha512');
-
     this.action('return', `info:${data.id}`);
     this.intent('good', `info:${data.id}`);
-    return data;
+    return this._stamp(data, 'info', data.id);
   }
 
   /**************
@@ -2288,21 +2223,13 @@ class Deva {
       },
       packet,
       created: Date.now(),
-    }
-    
-    this.action('hash', `${data.key}:${data.value}:md5:${data.id.uid}`);    
-    data.md5 = this.hash(data, 'md5'); // md5 the data packet
-    
-    this.action('hash', `${data.key}:${data.value}:sha256:${data.id.uid}`);
-    data.sha256 = this.hash(data, 'sha256'); // sha256 the data packet
-    
-    
-    this.action('hash', `${data.key}:${data.value}:sha512:${data.id.uid}`);
-    data.sha512 = this.hash(data, 'sha512'); // sha512 the data packet
+    };
+    // stamp the data before return
+    const data_stamped = this._stamp(data, `${data.key}:${data.value}`, data.id.uid);
   
     // set the action to talk and emit the talk error.
     this.action('talk', `${this._events.error}:${data.id.uid}`);
-    this.talk(this._events.error, this.lib.copy(data));
+    this.talk(this._events.error, this.lib.copy(data_stamped));
   
     const hasOnError = this.onError && typeof this.onError === 'function' ? true : false;
     // if block handles returning the onError and setting the state to hasOnError
@@ -2401,6 +2328,7 @@ class Deva {
       const uid = `${begin_random}${end_random}`; // set uid to local constant
       data.uid = uid; // set base data object.
     }
+    // manual hashing to prevent overflow on stack calls.
     data.md5 = this.hash(data, 'md5'); // md5 the uid and created. 
     data.sha256 = this.hash(data, 'sha256'); // sha256 the uid, created, md5
     data.sha512 = this.hash(data, 'sha512'); // sha512 the uid, created, md5, sha256.
@@ -2478,18 +2406,9 @@ class Deva {
       copyright,
     };
     
-    this.action('hash', `${data.key}:sign:md5:${data.id.uid}`);
-    data.md5 = this.hash(data, 'md5'); // hash data packet into md5 and inert into data.
-    
-    this.action('hash', `${data.key}:sign:sha256:${data.id.uid}`);
-    data.sha256 = this.hash(data, 'sha256'); // hash data into sha 256 then set in data.
-    
-    this.action('hash', `${data.key}:sign:sha512:${data.id.uid}`);
-    data.sha512 = this.hash(data, 'sha512'); // hash data into sha 512 then set in data.
-
     this.action('return', `${data.key}:sign:${data.id.uid}`);
     this.intent('good', `${data.key}:sign:${data.id.uid}`);
-    return data;
+    return this._stamp(data, 'sign', data.id.uid);
   }
 
   /**************
@@ -2529,13 +2448,10 @@ class Deva {
       personal: personalVLA_hash,
       package: packageVLA_hash,
     };
-    approved.md5 = this.hash(approved, 'md5');
-    approved.sha256 = this.hash(approved, 'sha256');
-    approved.sha512 = this.hash(approved, 'sha512');
 
     this.state('return', `license:${packageVLA.uid}`);
     this.intent('good', `license:${packageVLA.uid}`);
-    return approved;
+    return this._stamp(approved, 'license_check', packageVLA.uid);
   }
 
   /**************

package/package.json

@@ -1,7 +1,7 @@
 {
   "id": "23221940810208468106",
   "name": "@indra.ai/deva",
-  "version": "1.56.4",
+  "version": "1.59.0",
   "description": "Deva Core a Vedic-inspired Event Based Context Aware Feature, Zone, Action, and State Machine integrated Artificial Intelligence Framework",
   "main": "index.js",
   "license": "VLA:23221940810208468106 LICENSE.md",