@indra.ai/deva 1.2.20 → 1.2.22

package/config.json

@@ -30,169 +30,175 @@
     "context": false,
     "zone": "deva",
     "zones": {
-      "init": "Initialize",
-      "start": "Start",
-      "stop": "Stop",
-      "enter": "Enter",
-      "exit": "Exit",
-      "finish": "Finish",
-      "done": "Done",
-      "question": "Question",
-      "ask": "Ask",
-      "answer": "Answer",
-      "deva": "Deva",
-      "client": "Client",
-      "agent": "Agent",
-      "security": "Security",
-      "support": "Support",
-      "services": "Services",
-      "systems": "Systems",
-      "legal": "Legal",
-      "business": "Business",
-      "art": "Art",
-      "music": "Music",
-      "fun": "Fun",
-      "party": "Party",
-      "adventure": "Adventure",
-      "cartoon": "Cartoon",
-      "mystery": "Mystery",
-      "fantasy": "Fantasy",
-      "romance": "Romance",
-      "comedy": "Comedy",
-      "drama": "Drama",
-      "scifi": "SciFi",
-      "help": "Help",
-      "error": "ERROR!"
+      "load": "🚛 Load",
+      "unload": "🛻 Unload",
+      "init": "🚀 Initialize",
+      "start": "🏎️ Start",
+      "stop": "🛑 Stop",
+      "enter": "🏡 Enter",
+      "exit": "🚪 Exit",
+      "finish": "🏁 Finish",
+      "done": "✅ Done",
+      "question": "🙋‍♂️ Question",
+      "ask": "📢 Ask",
+      "answer": "💁‍♂️ Answer",
+      "deva": "🧞‍♂️ Deva",
+      "client": "👨‍💼 Client",
+      "agent": "🤖 Agent",
+      "security": "🔐 Security",
+      "support": "💼 Support",
+      "services": "🛠️ Services",
+      "help": "💚 Help",
+      "error": "❌ ERROR!"
     },
     "state": "offline",
     "states": {
-      "online": "Online",
-      "offline": "Offline",
-      "active": "Active",
-      "inactive": "Inactive",
-      "idle": "Idle",
-      "talk": "Talk",
-      "listen": "Listen",
-      "ask": "Ask",
-      "question": "Question",
-      "cmd": "Command",
-      "answer": "Answer",
-      "ready": "Ready",
-      "wait": "Waiting",
-      "pause": "Pause",
-      "resume": "Resume",
-      "connect": "Connect",
-      "disconnect": "Disconnect",
-      "send": "Send",
-      "receive": "Receive",
-      "init": "Initialize",
-      "forward": "Forward",
-      "backward": "Backward",
-      "start": "Start",
-      "stop": "Stop",
-      "open": "Open",
-      "close": "Close",
-      "enter": "Enter",
-      "exit": "Exit",
-      "begin": "Begin",
-      "end": "End",
-      "load": "Load",
-      "unload": "Unload",
-      "resolve": "Resolve",
-      "reject": "Reject",
-      "done": "Done",
-      "data": "Data",
-      "finish": "Finish",
-      "complete": "Complete",
-      "create": "Create",
-      "destroy": "Destroy",
-      "save": "Save",
-      "delete": "Delete",
-      "get": "Get",
-      "put": "Put",
-      "push": "Push",
-      "pull": "Pull",
-      "set": "Set",
-      "response": "Response",
-      "invalid": "INVALID!",
-      "abort": "ABORT!",
-      "error": "ERROR!",
-      "help": "HELP!"
+      "online": "🤩 Online",
+      "offline": "😴 Offline",
+      "active": "😀 Active",
+      "inactive": "🫥 Inactive",
+      "idle": "🚘 Idle",
+      "talk": "📢 Talk",
+      "listen": "👂 Listen",
+      "ask": "🗣️ Ask",
+      "question": "💬 Question",
+      "cmd": "🪖 Command",
+      "answer": "💡 Answer",
+      "ready": "😊 Ready",
+      "wait": "⏳ Waiting",
+      "pause": "⏸️ Pause",
+      "resume": "🚙 Resume",
+      "connect": "📳 Connect",
+      "disconnect": "📴 Disconnect",
+      "send": "📬 Send",
+      "receive": "📪 Receive",
+      "init": "🚀 Initialize",
+      "forward": "⏭️ Forward",
+      "backward": "⏮️ Backward",
+      "start": "🛝 Start",
+      "stop": "⏹️ Stop",
+      "open": "🥫 Open",
+      "close": "📦 Close",
+      "enter": "🏡 Enter",
+      "exit": "🚪 Exit",
+      "begin": "🗺️ Begin",
+      "end": "🎬 End",
+      "load": "🚚 Load",
+      "unload": "🛻 Unload",
+      "resolve": "🔬 Resolve",
+      "reject": "🧱 Reject",
+      "done": "✅ Done",
+      "data": "📡 Data",
+      "finish": "🏁 Finish",
+      "complete": "⌛️ Complete",
+      "create": "🎨 Create",
+      "destroy": "💣 Destroy",
+      "write": "📝 Write",
+      "save": "💾 Save",
+      "delete": "🧨 Delete",
+      "set": "🖖 Set",
+      "get": "👍 Get",
+      "put": "🤝 Put",
+      "push": "🫸 Push",
+      "pull": "👉 Pull",
+      "search": "🔎 Search",
+      "memory": "💭 Memory",
+      "response": "✍️ Response",
+      "invalid": "👎 INVALID!",
+      "valid": "👍 VALID!",
+      "abort": "💔 ABORT!",
+      "error": "❌ ERROR!",
+      "help": "💙 Help"
     },
     "action": false,
     "actions": {
-      "client": "get Client",
-      "agent": "get Agent",
-      "wait": "Waiting",
-      "start": "Start",
-      "enter": "Enter",
-      "exit": "Exit",
-      "stop": "Stop",
-      "load": "Load",
-      "unload": "Unload",
-      "done": "Done",
-      "question": "Question",
+      "client": "👨‍💼 Client",
+      "agent": "🕵️‍♂️ Agent",
+      "wait": "⏳ Waiting",
+      "start": "🎬 Start",
+      "enter": "🏡 Enter",
+      "exit": "🚪 Exit",
+      "stop": "🛑 Stop",
+      "load": "📦 Load",
+      "unload": "🥡 Unload",
+      "done": "✅ Done",
+      "question": "🙋 Question",
       "context": "Context",
-      "prompt": "Prompt",
-      "issue": "Issue",
-      "find": "Find",
-      "parse": "Parse",
-      "view": "View",
-      "insert": "Insert",
-      "update": "Update",
-      "delete": "Delete",
-      "info": "Information",
-      "status": "Status",
-      "func": "Function",
-      "list": "List items",
-      "reply": "Reply",
-      "set": "Set",
-      "get": "Get",
-      "return": "Return",
+      "prompt": "🐚 Prompt",
+      "issue": "🎫 Issue",
+      "find": "🔎 Find",
+      "parse": "🏘️ Parse",
+      "view": "👓 View",
+      "insert": "👉 Insert",
+      "update": "👆 Update",
+      "delete": "🗑️ Delete",
+      "info": "💁‍♂️ Information",
+      "status": "🚥 Status",
+      "func": "🔦 Function",
+      "method": "⚡️ Method",
+      "list": "📋 List items",
+      "reply": "📮 Reply",
+      "write": "️📝 Write",
+      "set": "🍽️ Set",
+      "get": "🤔 Get",
+      "return": "🎁 Return",
+      "resolve": "⛵️ Resolve",
+      "reject": "❌ Reject",
 
-      "question_ask": "Ask question",
-      "question_ask_answer": "Answer question asked",
-      "question_cmd": "Question command",
-      "question_method": "Question method",
-      "question_talk": "Question talk",
-      "question_answer": "Answer question",
-      "question_done": "Question done",
+      "question_ask": "🗣️ Asked",
+      "question_ask_answer": "🎙️ Answered",
+      "question_cmd": "🪖 Command",
+      "question_answer": "📞 Answer",
 
-      "answer": "Answer",
-      "ask": "Ask",
+      "answer": "💡 Answer",
+      "ask": "📣 Ask",
 
       "security": "Get Security",
       "support": "Get Support",
       "services": "Get Services",
 
-      "Client": "Set client",
+      "Client": "Set Client",
       "Security": "Set Security",
       "Support": "Set Support",
       "Systems": "Set Systems",
       "Services": "Set Services",
-      "Done": "Done",
+      "Done": "✅ Done",
 
-      "invalid": "Invalid",
-      "states": "States",
-      "actions": "Actions",
+      "invalid": "❌ Invalid",
+      "states": "🛻 States",
+      "actions": "🏎️ Actions",
       "zones": "Zones",
-      "features": "Getting features",
-      "contexts": "Getting contexts",
-      "finish": "Finished action",
-      "help": "Giving some HELP!",
-      "error": "ERROR!"
+      "feature": "🎥 Feature",
+      "features": "🎥 Getting features",
+      "contexts": "🌈 Getting contexts",
+      "finish": "🏁 Finish",
+      "help": "💜 Help",
+      "error": "🔴 ERROR!"
     },
     "feature": false,
     "features": {
-      "security": "Security",
-      "support": "Support",
-      "services": "Services",
-      "systems": "Systems"
+      "security": "🔐 Security",
+      "support": "💼 Support",
+      "services": "🛠️ Services",
+      "cipher": "🔒 Cipher",
+      "decipher": "🔓 Decipher",
+      "promp": "🪵 Prompt",
+      "getToday": "📆 Get Today",
+      "formatDate": "📅 Date",
+      "formatTime": "🕰️ Time",
+      "formatCurrency": "💰 Currency",
+      "formatPercent": "💯 Percent",
+      "trimWords": "🙊 Trim Words",
+      "dupes": "📋 Duplicates",
+      "info": "💁‍♂️ Info",
+      "status": "❤️ Status",
+      "help": "🌈 Help"
     },
     "message": "offline",
     "messages": {
       "init": "Initializing Deva",
       "offline": "The Deva is OFFLINE.",
+      "noid": "NO ID WAS PROVIDED",
       "notext": "NO TEXT WAS PROVIDED",
       "nopacket": "NO PACKET WAS PROVIDED",
       "method_not_found": "METHOD NOT FOUND",

package/index.js

@@ -215,11 +215,12 @@ class Deva {
   ***************/
   Security() {
     this.zone('security');
+    this.action('Security'); // set action to Security
     const _cl = this.client(); // set local copy of client data
     try {
       if (!_cl.features.security) return this.Support(); // if no security feature goto Support
       else {
-        this.state('data');
+        this.state('set', 'Security');
         const {id, profile, features} = _cl; // make a copy the clinet data.
         const {security} = features; // make a copy the clinet data.
         this._security = { // set this_security with data
@@ -233,10 +234,11 @@ class Deva {
           personal: security.devas[this._agent.key], // Client personal features and rules.
         };
         delete this._client.features.security; // make a copy the clinet data.
-        this.action('Security'); // set action to Security
+        this.state('resolve', 'Support');
         return this.Support(); // goto Support when done with Security
       }
     } catch (e) {
+      this.state('reject', 'Support');
       return this.error(e); // run error handling if an error is caught
     }
   }
@@ -250,11 +252,12 @@ class Deva {
   ***************/
   Support() {
     this.zone('support');
+    this.action('Support');
     const _cl = this.client(); // set the local client variable
     try {
       if (!_cl.features.support) return this.Services() // move to Services if no support feature
       else {
-        this.state('data');
+        this.state('set', 'Support');
         const {id, features, profile} = _cl; // set the local consts from client copy
         const {support} = features; // set support from features const
         this._support = { // set this_support with data
@@ -266,10 +269,11 @@ class Deva {
           personal: support.devas[this._agent.key], // Client personalSecurity features and rules.
         };
         delete this._client.features.support; // delete the support key from the client
-        this.action('Support');
+        this.state('resolve', 'Services');
         return this.Services(); // when done move to Services
       }
     } catch (e) {
+      this.state('reject', 'Services');
       return this.error(e); // run error handling if an error is caught
     }
   }
@@ -283,11 +287,12 @@ class Deva {
   ***************/
   Services() {
     this.zone('services')
+    this.action('Services');
     const _cl = this.client(); // set local client
     try {
       if (!_cl.features.services) return this.Done(); // move to Done if no Services feature
       else {
-        this.state('data');
+        this.state('set', 'Services');
         const {id, features, profile} = _cl;   // set the local consts from client copy
         const {services} = features; // set services from features const
         this._services = { // set this_services with data
@@ -299,10 +304,11 @@ class Deva {
           personal: services.devas[this._agent.key], // Client personal features and rules.
         };
         delete this._client.features.services; // delete the services key for isolation
-        this.action('Services');
+        this.state('resolve', 'Services');
         return this.Done(); // go to Done
       }
     } catch (e) {
+      this.state('reject', 'Services');
       return this.error(e); // run error handling if an error is caught
     }
   }
@@ -313,15 +319,15 @@ class Deva {
   describe: The end of the workflow Client Feature Workflow
   ***************/
   Done(client) {
-    this.state('done');
     this.action('done');
     return new Promise((resolve, reject) => {
       try {
+        this.state('done');
         delete this._client.features; // delete the features key when done.
-        this.state('ready');
-        this.action('wait');
+        this.state('resolve', 'done');
         return resolve(client); // resolve an empty pr
       } catch (e) {
+        this.state('reject', 'done');
         return this.error(e, false, reject);
       }
     });
@@ -389,9 +395,10 @@ class Deva {
   question(TEXT=false, DATA=false) {
     // check the active status
     if (!this._active) return Promise.resolve(this._messages.offline);
-    this.zone('question'); // set the zone to question.
+    this.action('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);
@@ -400,7 +407,6 @@ class Deva {
     const isCmd = t_split[0].startsWith(this.cmdChr);
 
     // 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
@@ -416,64 +422,61 @@ class Deva {
     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);
-      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
-          this.state('ask');
-          _action = 'question_ask';
           // if:isAsk split the agent key and remove first command character
           key = t_split[0].substring(1);
           //if:isAsk use text split index 1 as the parameter block
           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'); // set the state to 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
+          this.state('cmd', method); // set the state to cmd.
         }
 
-        this.state('data');
+        this.state('set', `question:${method}`)
         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
+          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
         }
 
         // hash the question
         packet.q.meta.hash = this.hash(packet.q);
 
-        this.action(_action); // set current action to what was defined by _action variable.
+        this.state('talk', config.events.question); // 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 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.state('talk', config.events.ask);
             this.talk(config.events.ask, this.copy(answer));
             return this.finish(answer, resolve); // if:isAsk resolve the answer from the call
           });
         }
         else { // else: answer tue question locally
-          this.action('question_answer');
+          this.state('answer', `question:${method}`);
           return this.answer(packet, resolve, reject);
         }
       }
       catch(e) {
+        this.state('reject', 'question');
         return this.error(e); // if a overall error happens this witll call this.error
       }
     });
@@ -491,7 +494,6 @@ class Deva {
   ***************/
   answer(packet, resolve, reject) {
     if (!this._active) return Promise.resolve(this._messages.offline);
-    this.zone('answer');
     const agent = this.agent();
     const client = this.client();
     // check if method exists and is of type function
@@ -501,8 +503,8 @@ class Deva {
       return resolve(this._methodNotFound(packet)); // resolve method not found if check if check fails
     }
     // Call the local method to process the question based the extracted parameters
-    return this.methods[method](packet).then(result => {
-      this.state('answer');
+    this.action('answer', method);
+    this.methods[method](packet).then(result => {
       // 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;
@@ -510,6 +512,7 @@ class Deva {
       // if the data passed is NOT an object it will FALSE
       const data = typeof result === 'object' ? result.data : false;
 
+      this.state('set', 'answer')
       const packet_answer = { // setup the packet.a container
         id: this.uid(),
         agent, // set the agent who answered the question
@@ -528,10 +531,12 @@ class Deva {
       // create a hash for the answer and insert into answer meta.
       packet_answer.meta.hash = this.hash(packet_answer);
       packet.a = packet_answer; // set the packet.a to the packet_answer
-      this.action('answer'); // set the action to answer
+      this.state('talk', config.events.answer);
       this.talk(config.events.answer, this.copy(packet)); // global talk event
+      this.state('resovle', 'answer')
       return this.finish(packet, resolve); // resolve the packet to the caller.
     }).catch(err => { // catch any errors in the method
+      this.state('reject', 'answer');
       return this.error(err, packet, reject); // return this.error with err, packet, reject
     });
   }
@@ -553,8 +558,8 @@ class Deva {
   ***************/
   ask(packet) {
     if (!this._active) return Promise.resolve(this._messages.offline);
-
-    this.zone('ask');
+    const {method, params} = packet.q.meta;
+    this.action('ask', method);
 
     const agent = this.agent();
     const client = this.client();
@@ -565,8 +570,8 @@ class Deva {
       client,
       meta: {
         key: agent.key,
-        method: packet.q.meta.method,
-        params: packet.q.meta.params,
+        method,
+        params,
       },
       text: false,
       html: false,
@@ -575,17 +580,16 @@ class Deva {
     };
 
     try {
-      if (typeof this.methods[packet.q.meta.method] !== 'function') {
+      if (typeof this.methods[method] !== 'function') {
         return setImmediate(() => {
-          this.action('invalid');
+          this.state('invalid', method);
           this.talk(`${this._agent.key}:ask:${packet.id}`, this._methodNotFound(packet));
         });
       }
 
-      this.state('ask');
       // The method is parsed and depending on what method is asked for it returns
       // the response based on the passed through packet.
-      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;
@@ -594,9 +598,11 @@ class Deva {
         else {
           packet_answer.text = result;
         }
+
+        this.state('set', `ask:${method}`);
         packet_answer.meta.hash = this.hash(packet_answer);
-        this.action('ask');
         packet.a = packet_answer;
+        this.state('talk', config.events.answer);
         this.talk(config.events.answer, this.copy(packet)); // global talk event
         this.talk(`${agent.key}:ask:${packet.id}`, packet);
       }).catch(err => {
@@ -631,6 +637,7 @@ class Deva {
     // set client
     this._active = Date.now();
     const agent = this.agent();
+
     const _data = {
       id: this.uid(true),
       key: 'init',
@@ -655,7 +662,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);
       });
@@ -675,12 +684,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)
   }
 
@@ -698,11 +707,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)
   }
@@ -721,12 +730,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);
   }
 
@@ -740,18 +749,15 @@ class Deva {
   usage: this.finish(data, resolve)
   ***************/
   finish(packet, resolve) {
-    this.zone('finish'); // set the zone to finish
     if (!this._active) return Promise.resolve(this._messages.offline);
+    this.action('finish'); // set the finish action
 
-    this.state('finish'); // set the finish state
     packet.hash = this.hash(packet);// hash the entire packet before finishing.
     // 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
-
-    this.context('finish'); // set the context to finish
+    this.state('finish'); // set the finish state
     if (hasOnFinish) return this.onFinish(packet, resolve);
     // return the provided resolve function or a promise resolve.
     return resolve ? resolve(packet) : Promise.resolve(packet);
@@ -807,10 +813,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',
@@ -828,7 +834,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)
   }
@@ -870,7 +876,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',
@@ -915,7 +922,8 @@ class Deva {
   describe: returns a listing of zones currently in the system.
   ***************/
   zones() {
-    this.action('zones'); // set the action to zones
+    this.action('func', 'zones');
+    this.state('return', 'zones');
     return {
       id: this.uid(true), // set the uuid of the data
       agent: this.agent(), // set the agent value
@@ -965,7 +973,8 @@ class Deva {
   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), // set the id with a uuid
       agent: this.agent(), // set the agent value
@@ -1000,6 +1009,7 @@ class Deva {
         created: Date.now(), // set the creation date
       };
       data.hash = this.hash(data); // generate the hash value of the data packet
+      this.state('talk', 'feature');
       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.
@@ -1012,7 +1022,7 @@ class Deva {
   describe: return a list of features that are available to the system.
   ***************/
   features() {
-    this.action('features'); // set the action to 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.
@@ -1046,7 +1056,9 @@ class Deva {
         text,
         created: Date.now(),
       };
+
       data.hash = this.hash(data);
+      this.state('talk', 'context');
       this.talk(config.events.context, data);
     } catch (e) {
       return this.error(e);
@@ -1054,7 +1066,8 @@ class Deva {
   }
 
   contexts() {
-    this.action('contexts');
+    if (!this._active) return this._messages.offline; // check the active status
+    this.state('return', 'contexts');
     return {
       id: this.uid(true),
       agent: this.agent(),
@@ -1097,11 +1110,11 @@ class Deva {
   usage: this.security()
   ***************/
   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.zone('security');
+    this.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);}
   }
@@ -1113,11 +1126,11 @@ class Deva {
   usage: this.support()
   ***************/
   support() {
-    this.feature('support'); // set the support state
     if (!this._active) return this._messages.offline; // check the active status
-    this.state('data'); // set the state to data
+    this.zone('support');
+    this.feature('support'); // set the support state
     try {
-      this.action('support'); // set the action to 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); // return this.error when error catch
@@ -1131,11 +1144,11 @@ class Deva {
   usage: this.services()
   ***************/
   services(opts) {
-    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.zone('services');
+    this.feature('services'); // set the support 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); // return this.error when error catch
@@ -1149,7 +1162,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);
   }
 
@@ -1160,13 +1175,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)
@@ -1227,6 +1244,7 @@ class Deva {
     defined client security settings.
   ***************/
   cipher(str) {
+    this.feature('cipher');
     // this.action('cipher');
     const security = this._security;
     const {password, algorithm} = security.cipher;
@@ -1237,6 +1255,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,
@@ -1245,6 +1264,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');
@@ -1255,6 +1275,7 @@ class Deva {
     const decrypted = decipher.update(encrypted);
     const final = Buffer.concat([decrypted, decipher.final()]);
     return final.toString();
+    this.state('return', 'decipher');
   }
 
   /**************
@@ -1267,7 +1288,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();
@@ -1280,6 +1301,7 @@ class Deva {
       text,
       created: Date.now(),
     }
+    this.state('talk', 'prompt')
     return this.talk(config.events.prompt, _data);
   }
 
@@ -1307,13 +1329,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();
   }
 
@@ -1330,6 +1353,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);
 
@@ -1348,6 +1372,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}`;
   }
 
@@ -1360,6 +1385,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
   }
 
@@ -1372,6 +1398,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);
   }
 
@@ -1383,6 +1410,7 @@ class Deva {
   describe:
   ***************/
   formatPercent(n, dec=2) {
+    this.feature('formatPercent');
     return parseFloat(n).toFixed(dec) + '%';
   }
 
@@ -1395,8 +1423,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(' ');
   }
 
@@ -1406,9 +1436,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);
@@ -1425,7 +1456,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;
   }
 
@@ -1442,11 +1473,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
@@ -1463,19 +1495,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)
       }
     });
@@ -1494,7 +1528,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 = {
@@ -1509,7 +1543,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;
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indra.ai/deva",
-  "version": "1.2.20",
+  "version": "1.2.22",
   "description": "The Deva Core",
   "main": "index.js",
   "scripts": {