@indra.ai/deva 1.2.19 → 1.2.21

package/index.js

@@ -10,7 +10,7 @@ const { createHash, randomUUID, createCipheriv, createDecipheriv, randomBytes }
 const config = require('./config.json').DATA // load the deva core configuration data.
 class Deva {
   constructor(opts) {
-    opts = opts || {};
+    opts = opts || {}; // set opts to provided opts or an empty object.
     this._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
@@ -20,17 +20,9 @@ class Deva {
     this._security = false; // inherited Security features.
     this._support = false; // inherited Support features.
     this._services = false; // inherited Service features.
-    this.os = require('os'); // It is used to provide basic operating system related utility functions.
-    this.fs = require('fs'); // this is so file system functions are in the core.
-    this.path = require('path'); // this is so we can get path in the system.
-    this.crypto = require('crypto'); // It is used to support cryptography for encryption and decryption.
-    this.zlib = require('zlib'); // provides compression functionality using Gzip, Deflate/Inflate, and Brotli.
-    this.dns = require('dns'); // It is used to lookup and resolve on domain names.
-    this.net = require('net'); // It used to create TCP server/client communicate using TCP protocol.
-    this.http = require('http'); // It is used to create Http server and Http client.
-    this.https = require('https'); // It is used to create Http server and Http client.
-    this.url = require('url'); // It is used for URL resolution and parsing.
-    this.assert = require('assert'); // It is used for testing itself.
+    this.os = os; // It is used to provide basic operating system related utility functions.
+    this.fs = fs; // this is so file system functions are in the core.
+    this.path = path; // this is so we can get path in the system.
     this.events = opts.events || new EventEmitter({}); // Event Bus
     this.libs = opts.libs || {}; // used for loading library functions
     this.utils = opts.utils || {}; // parse function
@@ -109,7 +101,6 @@ class Deva {
     return new Promise((resolve, reject) => {
       try {
         // set the default listeners for the states of the agent.
-
         for (let state in this._states) {
           if (typeof this[state] === 'function') {
             this.events.on(`${this._agent.key}:${state}`, packet => {
@@ -119,15 +110,17 @@ class Deva {
         }
 
         // set the assigned listeners for the agent.
-        for (let listener in this.listeners) {
-          this.events.on(listener, packet => {
-            return this.listeners[listener](packet);
+        for (let listener in this.listeners) { // loop over the liteners
+          this.events.on(listener, packet => { // set the event listener
+            return this.listeners[listener](packet); // return the listener function
           })
         }
-        return resolve();
       }
       catch (e) {
-        return this.error(e, false, reject);
+        return this.error(e, false, reject); // pass errors to this.error
+      }
+      finally {
+        return resolve(); // resolve the function after everything is done.
       }
     });
   }
@@ -326,7 +319,6 @@ class Deva {
       try {
         delete this._client.features; // delete the features key when done.
         this.state('ready');
-        this.action('wait');
         return resolve(client); // resolve an empty pr
       } catch (e) {
         return this.error(e, false, reject);
@@ -351,9 +343,9 @@ class Deva {
   /**************
   func: listen
   params:
-    - evt:      The vent label to listen for
+    - evt: The vent label to listen for
     - callback: The callback function to run when the event fires.
-  describe:
+  describe: setup a new event listener in the system.
   ***************/
   listen(evt, callback) {
     this.listeners[evt] = callback;
@@ -365,8 +357,7 @@ class Deva {
   /**************
   func: once
   params:
-    - evt:      The event to listen to for a once call. These event are handy
-                when waiting for a key response one time.
+    - evt: The event to listen to for a once call.
     - callback: The callback functoin to run when the event fires.
   describe:
   ***************/
@@ -377,10 +368,9 @@ class Deva {
   /**************
   func: ignore
   params:
-    - evt:      The event you'd like to ignore.
+    - evt: The event you'd like to ignore.
     - callback: a callback function to execute after removing the event from listerns.
-  describe:
-    The ignore function allow the removal of events that are in the existing devas lister group.
+  describe: The ignore function allow the removal of events in the listener group.
   ***************/
   ignore(evt, callback) {
     return this.events.removeListener(evt, callback);
@@ -398,9 +388,10 @@ class Deva {
   question(TEXT=false, DATA=false) {
     // check the active status
     if (!this._active) return Promise.resolve(this._messages.offline);
-    this.zone('question');
-    const id = this.uid();                                // generate a unique id for transport.
-    const t_split = TEXT.split(' ');                      // split the text on spaces to get words.
+    this.zone('question'); // set the zone to question.
+    const id = this.uid(); // generate a unique id for transport.
+    const t_split = TEXT.split(' '); // split the text on spaces to get words.
+    const data = DATA; // set the DATA to data
 
     // check to see if the string is an #ask string to talk to the other Deva.
     const isAsk = t_split[0].startsWith(this.askChr);
@@ -408,31 +399,26 @@ class Deva {
     // check to see if the string is a command string to run a local method.
     const isCmd = t_split[0].startsWith(this.cmdChr);
 
-    this.state('data');
     // Format the packet for return on the request.
-    const data = DATA;                                    // set the DATA to data
-    const packet = {                                      // create the base q/a packet
-      id,                                                 // set the id into packet
-      q: false,                                              // create empty q object in packet
-      a: false,                                              // create empty a object in packet
-      created: Date.now(),                                // timestamp the packet
+    const packet = { // create the base q/a packet
+      id, // set the id into packet
+      q: false, // create empty q object in packet
+      a: false, // create empty a object in packet
+      created: Date.now(), // timestamp the packet
     };
 
-    let text = TEXT,                                      // let TEXT is text for a manipulation variable
-        params = false,                                   // params as false to build params string
-        method = 'question',                              // set the default method to question
-        key = this._agent.key;                            // set a temporary key from the agent key.
+    let text = TEXT, // let TEXT is text for a manipulation variable
+        params = false, // params as false to build params string
+        method = 'question', // set the default method to question
+        key = this._agent.key; // set a temporary key from the agent key.
 
     return new Promise((resolve, reject) => {
       // resolve with the no text message if the client says nothing.
       if (!TEXT) return this.finish(this._messages.notext, resolve);
-      // reject question if Deva offline
-      if (!this._active) return this.finish(this._messages.offline, resolve);
-      let _action = 'question';
-      this.state('question');
-      try {                                               // try to answer the question
-        if (isAsk) {                                      // determine if hte question isAsk
-          this.state('ask');
+      let _action = 'question'; // set the initial _action to question.
+      this.state('question'); // set the state to question
+      try { // try to answer the question
+        if (isAsk) { // determine if hte question isAsk
           _action = 'question_ask';
           // if:isAsk split the agent key and remove first command character
           key = t_split[0].substring(1);
@@ -440,53 +426,53 @@ class Deva {
           params = t_split[1] ? t_split[1].split(':') : false;
           method = params[0]; // the method to check is then params index 0
           text = t_split.slice(2).join(' ').trim(); // rejoin the text with space
+          this.state('ask', `${key} ${method}`);
         }
         else if (isCmd) { // determine if the question is a command
-          this.state('cmd');
           _action = 'question_cmd';
           //if:isCmd use text split index 1 as the parameter block
           params = t_split[0] ? t_split[0].split(':').slice(1) : false;
-          method = t_split[0].substring(1);               // if:isCmd use the 0 index as the command
-          text = t_split.slice(1).join(' ').trim();       // if:isCmd rejoin the string on the space after removing first index
+          method = t_split[0].substring(1); // if:isCmd use the 0 index as the command
+          text = t_split.slice(1).join(' ').trim(); // if:isCmd rejoin the string on the space after removing first index
+          this.state('cmd', method); // set the state to cmd.
         }
 
-        packet.q = {                                      // build packet.q container
-            id: this.uid(),
-            agent: this.agent() || false,                  // set the agent
-            client: this.client() || false,                // set the client
-            meta: {                                       // build the meta container
-              key,                                        // set the key variable
-              method,                                     // set method to track function use
-              params,                                     // set any params that are associated
+        packet.q = { // build packet.q container
+            id: this.uid(), // set the transport id for the question.
+            agent: this.agent(), // set the agent
+            client: this.client(), // set the client
+            meta: { // build the meta container
+              key, // set the key variable
+              method, // set method to track function use
+              params, // set any params that are associated
             },
-            text,                                         // set the text for the packet.
-            data,                                         // set the data object
-            created: Date.now(),                          // timestamp the question
+            text, // set the text for the packet.
+            data, // set the data object
+            created: Date.now(), // timestamp the question
         }
 
         // hash the question
         packet.q.meta.hash = this.hash(packet.q);
 
-        this.action(_action);
+        this.action(_action, method); // set current action to what was defined by _action variable.
         this.talk(config.events.question, this.copy(packet)); // global question event make sure to copy data.
 
-        if (isAsk) {                                      // isAsk check if the question isAsk and talk
+        if (isAsk) { // isAsk check if the question isAsk and talk
           // if: isAsk wait for the once event which is key'd to the packet ID for specified responses
           this.talk(`${key}:ask`, packet);
           this.once(`${key}:ask:${packet.id}`, answer => {
             this.action('question_ask_answer');
-
             this.talk(config.events.ask, this.copy(answer));
-            return this.finish(answer, resolve);                       // if:isAsk resolve the answer from the call
+            return this.finish(answer, resolve); // if:isAsk resolve the answer from the call
           });
         }
-        else {                                            // else: answer tue question locally
-          this.action('question_answer');
+        else { // else: answer tue question locally
+          this.action('question_answer', method);
           return this.answer(packet, resolve, reject);
         }
       }
-      catch(e) {                                          // try block error trap
-        return this.error(e);                             // if a overall error happens this witll call this.error
+      catch(e) {
+        return this.error(e); // if a overall error happens this witll call this.error
       }
     });
   }
@@ -503,7 +489,9 @@ class Deva {
   ***************/
   answer(packet, resolve, reject) {
     if (!this._active) return Promise.resolve(this._messages.offline);
-    this.state('answer');
+    this.zone('answer');
+    const agent = this.agent();
+    const client = this.client();
     // check if method exists and is of type function
     const {method,params} = packet.q.meta;
     const isMethod = this.methods[method] && typeof this.methods[method] == 'function';
@@ -512,7 +500,7 @@ class Deva {
     }
     // Call the local method to process the question based the extracted parameters
     return this.methods[method](packet).then(result => {
-      this.action('answer');
+      this.action('answer', method); // set the action to answer
       // check the result for the text, html, and data object.
       // this is for when answers are returned from nested Devas.
       const text = typeof result === 'object' ? result.text : result;
@@ -520,28 +508,25 @@ class Deva {
       // if the data passed is NOT an object it will FALSE
       const data = typeof result === 'object' ? result.data : false;
 
-      const agent = this.agent() || false;
-      const client = this.client() || false;
-      const packet_answer = {                                  // setup the packet.a container
+      const packet_answer = { // setup the packet.a container
         id: this.uid(),
-        agent,                                      // set the agent who answered the question
-        client,                                     // set the client asking the question
-        meta: {                                     // setup the answer meta container
-          key: agent.key,                           // set the agent key inot the meta
-          method,                                   // set the method into the meta
-          params,                                   // set the params into the meta
+        agent, // set the agent who answered the question
+        client, // set the client asking the question
+        meta: { // setup the answer meta container
+          key: agent.key, // set the agent key inot the meta
+          method, // set the method into the meta
+          params, // set the params into the meta
         },
-        text,                                       // set answer text
-        html,                                       // set the answer html
-        data,                                       // set the answer data
-        created: Date.now(),
+        text, // set answer text
+        html, // set the answer html
+        data, // set the answer data
+        created: Date.now(), // set the created date for the answer
       };
 
+      this.state('answer', method);
       // create a hash for the answer and insert into answer meta.
       packet_answer.meta.hash = this.hash(packet_answer);
-
-      packet.a = packet_answer;
-      this.action('answer_talk');
+      packet.a = packet_answer; // set the packet.a to the packet_answer
       this.talk(config.events.answer, this.copy(packet)); // global talk event
       return this.finish(packet, resolve); // resolve the packet to the caller.
     }).catch(err => { // catch any errors in the method
@@ -566,8 +551,8 @@ class Deva {
   ***************/
   ask(packet) {
     if (!this._active) return Promise.resolve(this._messages.offline);
-
-    this.state('ask');
+    const {method, params} = packet.q.meta;
+    this.zone('ask', method);
 
     const agent = this.agent();
     const client = this.client();
@@ -578,8 +563,8 @@ class Deva {
       client,
       meta: {
         key: agent.key,
-        method: packet.q.meta.method,
-        params: packet.q.meta.params,
+        method,
+        params,
       },
       text: false,
       html: false,
@@ -587,18 +572,18 @@ class Deva {
       created: Date.now(),
     };
 
+    this.action('ask', method);
     try {
-      if (typeof this.methods[packet.q.meta.method] !== 'function') {
+      if (typeof this.methods[method] !== 'function') {
         return setImmediate(() => {
-          this.action('invalid')
+          this.action('invalid', method);
           this.talk(`${this._agent.key}:ask:${packet.id}`, this._methodNotFound(packet));
         });
       }
 
       // The method is parsed and depending on what method is asked for it returns
       // the response based on the passed through packet.
-      this.action('ask');
-      this.methods[packet.q.meta.method](packet).then(result => {
+      this.methods[method](packet).then(result => {
         if (typeof result === 'object') {
           packet_answer.text = result.text || false;
           packet_answer.html = result.html || false;
@@ -607,8 +592,9 @@ class Deva {
         else {
           packet_answer.text = result;
         }
+
+        this.state('ask', method);
         packet_answer.meta.hash = this.hash(packet_answer);
-        this.action('ask_answer');
         packet.a = packet_answer;
         this.talk(config.events.answer, this.copy(packet)); // global talk event
         this.talk(`${agent.key}:ask:${packet.id}`, packet);
@@ -644,6 +630,7 @@ class Deva {
     // set client
     this._active = Date.now();
     const agent = this.agent();
+
     const _data = {
       id: this.uid(true),
       key: 'init',
@@ -668,7 +655,9 @@ class Deva {
       }).then(() => {
         this.zone('init');
         const hasOnInit = this.onInit && typeof this.onInit === 'function';
-        return hasOnInit ? this.onInit(_data) : this.start(_data)
+        return hasOnInit ? this.onInit(_data) : this.start(_data);
+      }).then(done => {
+        return resolve(done);
       }).catch(err => {
         return this.error(err, client, reject);
       });
@@ -688,12 +677,12 @@ class Deva {
   start(data) {
     this.zone('start');
     if (!this._active) return Promise.resolve(this._messages.offline);
-    this.state('start');
+    this.action('start');
     data.value = 'start';
     delete data.hash;
     data.hash = this.hash(data);
     const hasOnStart = this.onStart && typeof this.onStart === 'function' ? true : false;
-    this.action('start');
+    this.state('start');
     return hasOnStart ? this.onStart(data) : this.enter(data)
   }
 
@@ -711,11 +700,11 @@ class Deva {
   enter(data) {
     this.zone('enter');
     if (!this._active) return Promise.resolve(this._messages.offline);
-    this.state('enter');
+    this.action('enter');
     data.value = 'enter';
     delete data.hash;
     data.hash = this.hash(data);
-    this.action('enter');
+    this.state('enter');
     const hasOnEnter = this.onEnter && typeof this.onEnter === 'function' ? true : false;
     return hasOnEnter ? this.onEnter(data) : this.done(data)
   }
@@ -734,12 +723,12 @@ class Deva {
   done(data) {
     this.zone('done');
     if (!this._active) return Promise.resolve(this._messages.offline);
-    this.state('done');
+    this.action('done');
     data.value = 'done';
     delete data.hash;
     data.hash = this.hash(data);
     const hasOnDone = this.onDone && typeof this.onDone === 'function' ? true : false;
-    this.action('done')
+    this.state('done');
     return hasOnDone ? this.onDone(data) : Promise.resolve(data);
   }
 
@@ -748,21 +737,24 @@ class Deva {
   params:
   - packet: the data to pass to the resolve
   - resolve: the finish resolve to pass back
-  describe:
-    This function is use to relay the Agent ito a finish state when resolving a
-    question or data.
-  usage:
-    this.finish(data, resolve)
+  describe: This function is use to relay the Agent ito a finish state when
+            resolving a question or data.
+  usage: this.finish(data, resolve)
   ***************/
   finish(packet, resolve) {
-    this.zone('finish');
+    this.zone('finish'); // set the zone to finish
     if (!this._active) return Promise.resolve(this._messages.offline);
-    this.state('finish');
+
+    this.state('finish'); // set the finish state
     packet.hash = this.hash(packet);// hash the entire packet before finishing.
-    const hasOnFinish = this.onFinish && typeof this.onFinish === 'function' ? true : false;
+    // check for agent on finish function in agent
+    const hasOnFinish = this.onFinish && typeof this.onFinish === 'function';
+
+    this.action('finish'); // set the finish action
+    // if: agent has on finish then return on finish
 
     if (hasOnFinish) return this.onFinish(packet, resolve);
-    this.action('finish');
+    // return the provided resolve function or a promise resolve.
     return resolve ? resolve(packet) : Promise.resolve(packet);
   }
 
@@ -780,25 +772,21 @@ class Deva {
     this.stop()
   ***************/
   stop() {
-    this.zone('stop');
+    this.zone('stop'); // set the zone to stop
     if (!this._active) return Promise.resolve(this._messages.offline);
-
-    this.state('stop');
-    const agent = this.agent();
-    const client = this.client();
-
-    const data = {
-      id: this.uid(true),
-      key: 'stop',
-      value: this._messages.stop,
-      agent,
-      client,
-      created: Date.now(),
+    this.state('stop'); // set the state to stop
+    const data = { // build the stop data
+      id: this.uid(), // set the id
+      agent: this.agent(), // set the agent
+      client: this.client(), // set the client
+      key: 'stop', // set the key
+      value: this._messages.stop, // set the value
+      created: Date.now(), // set the created date
     }
-    data.hash = this.hash(data);
-
-    this.action('stop');
+    this.action('stop'); // set the stop action
+    // has stop function then set hasOnStop variable
     const hasOnStop = this.onStop && typeof this.onStop === 'function';
+    // if: has on stop then run on stop function or return exit function.
     return hasOnStop ? this.onStop(data) : this.exit(data)
   }
 
@@ -820,10 +808,10 @@ class Deva {
   exit() {
     this.zone('exit');
 
-    this.state('exit');
     const agent = this.agent();
     const client = this.client();
 
+    this.action('exit');
     const data = {
       id: this.uid(true),
       key: 'exit',
@@ -841,7 +829,7 @@ class Deva {
     this._support = false;
     this._services = false;
 
-    this.action('exit');
+    this.state('exit');
     const hasOnExit = this.onExit && typeof this.onExit === 'function';
     return hasOnExit ? this.onExit(data) : Promise.resolve(data)
   }
@@ -852,27 +840,28 @@ class Deva {
   /**************
   func: state
   params:
-    - st: The state flag to set for the Deva that matches to this._states
-  describe
+    - value: The state value to set for the Deva that matches to this._states
+    - extra: any extra text to add ot the state change.
   ***************/
-  state(state) {
+  state(value=false, extra=false) {
     try {
-      if (!this._states[state]) return;
-      this._state = state;
-      const text = this._states[state];
-      const data = {
-        id: this.uid(true),
-        key: 'state',
-        value: state,
-        agent: this.agent(),
-        client: this.client(),
-        text,
-        created: Date.now(),
+      if (!value || !this._states[value]) return; // return if no matching value
+      this._state = value; // set the local state variable.
+      const lookup = this._states[value]; // set the local states lookup
+      const text = extra ? `${lookup} ${extra}` : lookup; // set text from lookup with extra
+      const data = { // build the data object
+        id: this.uid(), // set the data id
+        agent: this.agent(), // set the agent
+        client: this.client(), // set the client
+        key: 'state', // set the key to state
+        value, // set the value to the passed in value
+        text, // set the text value of the data
+        created: Date.now(), // set the data created date.
       };
-      data.hash = this.hash(data);
-      this.talk(config.events.state, data);
-    } catch (e) {
-      return this.error(e);
+      data.hash = this.hash(data); // hash the data
+      this.talk(config.events.state, data); // broadcasat the state event
+    } catch (e) { // catch any errors
+      return this.error(e); // return if an error happens
     }
   }
 
@@ -882,7 +871,8 @@ class Deva {
   describe: returns the avaiable staets values.
   ***************/
   states() {
-    this.action('states');
+    this.action('func', 'states');
+    this.state('return', 'states');
     return {
       id: this.uid(true),
       key: 'states',
@@ -897,16 +887,20 @@ class Deva {
     - st: The zone flag to set for the Deva that matches to this._zones
   describe
   ***************/
-  zone(value) {
-    if (!this._zones[value] || value === this._zone) return;
+  zone(value=false, extra=false) {
+    if (!value || !this._zones[value] || value === this._zone) return;
     try {
       this._zone = value;
-      const text = this._zones[value];
-      const data = {
-        id: this.uid(true),
+
+      const lookup = this._zones[value]; // set the lookup value
+      const text = extra ? `${lookup} ${extra}` : lookup; // set the text value
+
+      const data = { // build the zone data
+        id: this.uid(), // set the packetid
+        agent: this.agent(),
+        client: this.client(),
         key: 'zone',
         value,
-        agent: this.agent(),
         text,
         created: Date.now(),
       };
@@ -917,35 +911,47 @@ class Deva {
     }
   }
 
+  /**************
+  func: zones
+  params: none
+  describe: returns a listing of zones currently in the system.
+  ***************/
   zones() {
-    this.action('zones');
+    this.action('func', 'zones');
+    this.state('return', 'zones');
     return {
-      id: this.uid(true),
-      key: 'zones',
-      value: this._zones,
-      created: Date.now(),
+      id: this.uid(true), // set the uuid of the data
+      agent: this.agent(), // set the agent value
+      cleint: this.cleint(), // set the client value
+      key: 'zones', // set the key return value
+      value: this._zones, // set the list of zones
+      created: Date.now(), // set the created date of the object.
     }
   }
+
   /**************
   func: action
   params:
-    - st: The state flag to set for the Deva that matches to this._states
+    - value: The state flag to set for the Deva that matches to this._states
+    - extra: Any extra text to send with the action value.
   describe
   ***************/
-  action(action) {
+  action(value=false, extra=false) {
     try {
-      this._action = action; // set the local action variable
+      if (!value) return; // check feature value
+      this._action = value; // set the local action variable
       // check local vars for custom actions
-      const var_action = this.vars.actions ? this.vars.actions[action] : false;
-      // check action messages
-      const msg_action = this._actions[action] || var_action;
-      const text = msg_action || action; // set the text of the action
+      const var_action = this.vars.actions ? this.vars.actions[value] : false;
+      // check the message action
+      const msg_action = var_action || this._actions[value];
+      const msg = msg_action || action; // set the correct message
+      const text = extra ? `${msg} ${extra}` : msg; // set the text of the action
       const data = { // build the data object for the action.
         id: this.uid(true), // generate a guid for the action transmitssion.
-        key: 'action', // the key for event to transmit action type
-        value: action, // the value key which is the action passed
         agent: this.agent(), // the agent data to send with the action
         client: this.client(), // the client data to send with the action
+        key: 'action', // the key for event to transmit action type
+        value, // the value key which is the action passed
         text, // text of the action to send
         created: Date.now(), // action time stamp
       };
@@ -956,74 +962,96 @@ class Deva {
     }
   }
 
+  /**************
+  func: actions
+  params: none
+  describe: Returns a list of available actions in the system.
+  ***************/
   actions() {
-    this.action('actions');
+    this.action('func', 'actions');
+    this.state('return', 'actions');
     return {
-      id: this.uid(true),
-      key: 'actions',
-      value: this._actions,
-      created: Date.now(),
+      id: this.uid(true), // set the id with a uuid
+      agent: this.agent(), // set the agent value
+      client: this.client(), // set the client value
+      key: 'actions', // set the data key
+      value: this._actions, // set the value to the actions list
+      created: Date.now(), // set the data created date
     }
   }
 
   /**************
   func: feature
   params:
-    - st: The state flag to set for the Deva that matches to this._states
+    - value: The feature flag to set for the Deva that matches to this._features
+    - extra: Any extra text to send with the feature value.
   describe
   ***************/
-  feature(feature) {
+  feature(value=false, extra=false) {
     try {
-      if (!this._features[feature]) return;
-      this._feature = feature;
-      const text = this._features[feature] ;
-      const talk = {
-        id: this.uid(true),
-        key: 'feature',
-        value: feature,
-        agent: this._agent,
-        text,
-        created: Date.now(),
+      if (!value || !this._features[value]) return; // check feature value
+      this._feature = value; // set local feature variable
+
+      const lookup = this._features[value]; // set the lookup value
+      const text = extra ? `${lookup} ${extra}` : lookup; // set the text value
+
+      const data = { // build data object
+        id: this.uid(true), // set the id
+        agent: this.agent(), // set the agent transporting the packet.
+        key: 'feature', // set the key for transport
+        value, // set the value of the key
+        text, // set the text value
+        created: Date.now(), // set the creation date
       };
-      talk.hash = this.hash(talk);
-      this.talk(config.events.feature, talk);
-    } catch (e) {
-      return this.error(e);
+      data.hash = this.hash(data); // generate the hash value of the data packet
+      this.talk(config.events.feature, data); // talk the feature event with data
+    } catch (e) { // catch any errors
+      return this.error(e); // retun this.error when an error is caught.
     }
   }
 
+  /**************
+  func: features
+  params: none
+  describe: return a list of features that are available to the system.
+  ***************/
   features() {
-    this.action('features');
-    return {
-      id: this.uid(true),
-      key: 'features',
-      value: this._features,
-      created: Date.now(),
+    this.action('func', 'features');
+    this.state('return', 'features');
+    return { // return the data object
+      id: this.uid(true), // set the object id
+      agent: this.agent(), // set the agent value.
+      client: this.client(), // set the client value.
+      key: 'features', // set the key
+      value: this._features, // set the value to the features list
+      created: Date.now(), // set the created date.
     }
   }
 
   /**************
   func: context
   params:
-    - st: The context flag to set for the Deva that matches to this._contexts
+    - value: The context flag to set for the Deva that matches to this._contexts
+    - extra: Any extra text that is sent with the context value.
   describe
   ***************/
   context(value=false, extra=false) {
     try {
-      if (!value) return this._context;
+      if (!value) return;
       this._context = value;
       const lookup = this.vars.context[value] || value;
       const text = extra ? `${lookup} ${extra}` : lookup;
 
       const data = {
         id: this.uid(true),
-        key: 'context',
-        value,
         agent: this.agent(),
         client: this.client(),
+        key: 'context',
+        value,
         text,
         created: Date.now(),
       };
+
       data.hash = this.hash(data);
       this.talk(config.events.context, data);
     } catch (e) {
@@ -1032,9 +1060,12 @@ class Deva {
   }
 
   contexts() {
-    this.action('contexts');
+    this.action('func', 'contexts');
+    this.state('return', 'contexts');
     return {
       id: this.uid(true),
+      agent: this.agent(),
+      client: this.client(),
       key: 'contexts',
       value: this.vars.context || false,
       created: Date.now(),
@@ -1044,29 +1075,25 @@ class Deva {
   /**************
   func: client
   params: none
-  describe:
-    this function allows state management for when client prfioe is
-    being accessed.
+  describe: returns the current client values in the system.
   usage: this.client();
   ***************/
   client() {
-    if (!this._active) return this._messages.offline;    // check the active status
-    const client_copy = this.copy(this._client);
-    return client_copy;                                 // return the client feature
+    if (!this._active) return this._messages.offline; // check the active status
+    const client_copy = this.copy(this._client); // create a copy of the client data
+    return client_copy; // return the copy of the client data.
   }
 
   /**************
   func: agent
   params: none
-  describe:
-    this function allows statement management for when client prfioe is
-    being accessed.
+  describe: returns the current agent values in the system.
   usage: this.agent()
   ***************/
   agent() {
-    if (!this._active) return this._messages.offline;
-    const agent_copy = this.copy(this._agent);
-    return agent_copy;
+    if (!this._active) return this._messages.offline; // check the active status
+    const agent_copy = this.copy(this._agent); // create a copy of the agent data.
+    return agent_copy; // return the copy of the agent data.
   }
 
   // FEATURE FUNCTIONS
@@ -1077,11 +1104,12 @@ class Deva {
   usage: this.security()
   ***************/
   security() {
+    this.zone('security');
     this.feature('security'); // set the security state
     if (!this._active) return this._messages.offline; // check the active status
-    this.state('data'); // set the security state
+    this.action('feature', 'security'); // set the security state
     try {
-      this.action('security'); // set the security state
+      this.state('return', 'security'); // set the security state
       return this.copy(this._security); // return the security feature
     } catch (e) {return this.error(e);}
   }
@@ -1093,13 +1121,16 @@ class Deva {
   usage: this.support()
   ***************/
   support() {
+    this.zone('support');
     this.feature('support'); // set the support state
     if (!this._active) return this._messages.offline; // check the active status
-    this.state('data');
+    this.action('feature', 'support'); // set the state to data
     try {
-      this.action('support');
+      this.state('return', 'support'); // set the action to support.
       return this.copy(this._support); // return the support feature
-    } catch (e) {return this.error(e);}
+    } catch (e) {
+      return this.error(e); // return this.error when error catch
+    }
   }
 
   /**************
@@ -1109,13 +1140,16 @@ class Deva {
   usage: this.services()
   ***************/
   services(opts) {
+    this.zone('services');
     this.feature('services'); // set the support state
     if (!this._active) return this._messages.offline; // check the active status
-    this.state('data'); // set the services state
+    this.action('feature', 'services'); // set the services state
     try {
-      this.action('services'); // set the services state
+      this.state('return', 'services'); // set the services state
       return this.copy(this._services); // return the services feature
-    } catch (e) {return this.error(e);}
+    } catch (e) {
+      return this.error(e); // return this.error when error catch
+    }
   }
 
   /**************
@@ -1125,7 +1159,9 @@ class Deva {
   describe: This function will enable fast loading of Deva into the system.
   ***************/
   load(key, client) {
-    this.state('load');
+    this.zone('load', key);
+    this.action('load', key);
+    this.state('load', key);
     return this.devas[key].init(client);
   }
 
@@ -1136,13 +1172,15 @@ class Deva {
   describe: Unload a currently loaded Deva.
   ***************/
   unload(key) {
+    this.zone('unload', key);
     return new Promise((resolve, reject) => {
       try {
-        this.state('uload');
+        this.action('uload', key);
         this.devas[key].stop().then(exit => {
           delete this.devas[key];
           this.talk(config.events.unload, key);
         });
+        this.state('unload', key)
         return resolve(this._states.unload);
       } catch (e) {
         return this.error(e, this.devas[key], reject)
@@ -1203,6 +1241,7 @@ class Deva {
     defined client security settings.
   ***************/
   cipher(str) {
+    this.feature('cipher');
     // this.action('cipher');
     const security = this._security;
     const {password, algorithm} = security.cipher;
@@ -1213,6 +1252,7 @@ class Deva {
     const _cipher = createCipheriv(algorithm, key_in_bytes, iv);
     const encrypted = _cipher.update(String(str), 'utf8', 'hex') + _cipher.final('hex');
 
+    this.state('return', 'cipher');
     return {
       iv: iv.toString('base64'),
       key,
@@ -1221,6 +1261,7 @@ class Deva {
   }
 
   decipher(opt) {
+    this.feature('decipher');
     // this.action('decipher');
     const iv = Buffer.from(opt.iv, 'base64');
     const encrypted = Buffer.from(opt.encrypted, 'hex');
@@ -1231,6 +1272,7 @@ class Deva {
     const decrypted = decipher.update(encrypted);
     const final = Buffer.concat([decrypted, decipher.final()]);
     return final.toString();
+    this.state('return', 'decipher');
   }
 
   /**************
@@ -1243,7 +1285,7 @@ class Deva {
   usage: this.prompt('text')
   ***************/
   prompt(text) {
-    this.action('prompt');
+    this.feature('prompt');
     // Talk a global prompt event for the client
     const agent = this.agent();
     const client = this.client();
@@ -1256,6 +1298,7 @@ class Deva {
       text,
       created: Date.now(),
     }
+    this.state('talk', 'prompt')
     return this.talk(config.events.prompt, _data);
   }
 
@@ -1283,13 +1326,14 @@ class Deva {
     with no time value for the current day.
   ***************/
   getToday(d) {
-    this.action('gettoday');
+    this.feature('getToday');
     d = d ? d : Date.now();
     const today = new Date(d);
     today.setHours(0);
     today.setMinutes(0);
     today.setSeconds(0);
     today.setMilliseconds(0);
+    this.state('return', 'getToday');
     return today.getTime();
   }
 
@@ -1306,6 +1350,7 @@ class Deva {
     system based on the language and locale in the client profile.
   ***************/
   formatDate(d, format='milli', time=false) {
+    this.feature('formatDate');
     if (!d) d = Date.now();
     d = new Date(d);
 
@@ -1324,6 +1369,7 @@ class Deva {
     };
     const theDate = d.toLocaleDateString(this._client.locale, formats[format]);
     const theTime = this.formatTime(d);
+    this.state('return', 'formatDate');
     return !theTime ? theDate : `${theDate} - ${theTime}`;
   }
 
@@ -1336,6 +1382,7 @@ class Deva {
     parameter based on the locale setting in the client profile..
   ***************/
   formatTime(t) {
+    this.feature('formatTime');
     return t.toLocaleTimeString(this._client.locale);     // return the formatted time string
   }
 
@@ -1348,6 +1395,7 @@ class Deva {
     in the client profile.
   ***************/
   formatCurrency(n) {
+    this.feature('formatCurrency');
     return new Intl.NumberFormat(this._client.locale, { style: 'currency', currency: this._client.currency }).format(n);
   }
 
@@ -1359,6 +1407,7 @@ class Deva {
   describe:
   ***************/
   formatPercent(n, dec=2) {
+    this.feature('formatPercent');
     return parseFloat(n).toFixed(dec) + '%';
   }
 
@@ -1371,8 +1420,10 @@ class Deva {
     A utility function to trimText intput to a specific word count.
   ***************/
   trimWords(text, maxwords) {
+    this.feature('trimWords');
     const splitter = text.split(' ');
     if (splitter < maxwords) return text;
+    this.state('return', 'trimmed words');
     return splitter.slice(0, maxwords).join(' ');
   }
 
@@ -1382,9 +1433,10 @@ class Deva {
   describe: remove duplicees from an array.
   ***************/
   dupes(dupers) {
-    this.action('dupes');
+    this.feature('dupes');
     if (!Array.isArray(dupers)) return dupers;
     const check = [];
+    this.state('return', 'duplicates removed');
     return dupers.filter(dupe => {
       if (!check.includes(dupe)) {
         check.push(dupe);
@@ -1401,7 +1453,7 @@ class Deva {
   info() {
     // check the active status
     if (!this._active) return Promise.resolve(this._messages.offline);
-    this.action('info');
+    this.feature('info');
     return this._info;
   }
 
@@ -1418,11 +1470,12 @@ class Deva {
   ***************/
   status(msg=false) {
     // check the active status
-    if (!this._active) return Promise.resolve(this._messages.states.offline);
+    if (!this._active) return Promise.resolve(this._messages.offline);
+    this.feature('status');
+
     // format the date since active for output.
     const dateFormat = this.formatDate(this._active, 'long', true);
     // create the text msg string
-    this.action('status');
     let text = `${this._agent.profile.name} active since ${dateFormat}`;
     if (msg) text = text + `\n${msg}`;                      // append the msg string if msg true.
     return text;                           // return final text string
@@ -1439,19 +1492,21 @@ class Deva {
     one exists it will then present it based on the users request text input.
   ***************/
   help(msg, help_dir) {
-    this.zone('help');
     return new Promise((resolve, reject) => {
-      if (!this._active) return resolve(this._messages.states.offline);
-      this.state('data');
+      if (!this._active) return resolve(this._messages.offline);
+      this.feature('help');
+      this.zone('help');
+
       const params = msg.split(' ');
       let helpFile = 'main';
       if (params[0]) helpFile = params[0];
       if (params[1]) helpFile = `${params[0]}_${params[1]}`;
       helpFile = path.join(help_dir, 'help', `${helpFile}.feecting`);
       try {
-        this.action('help');
+        this.state('resolve', 'help');
         return resolve(fs.readFileSync(helpFile, 'utf8'));
       } catch (e) {
+        this.state('reject', 'helpFile');
         return reject(e)
       }
     });
@@ -1470,7 +1525,7 @@ class Deva {
   error(err,data=false,reject=false) {
     this.zone('error');
 
-    this.state('error')
+    this.action('error')
     const agent = this.agent();
     const client = this.client();
     const _data = {
@@ -1485,7 +1540,8 @@ class Deva {
     }
     this.talk(config.events.error, this.copy(_data));
     const hasOnError = this.onError && typeof this.onError === 'function' ? true : false;
-    this.action('error');
+
+    this.state('error');
     if (hasOnError) return this.onError(err, data, reject);
     else return reject ? reject(err) : err;
   }