@knowlearning/agents 0.9.84 → 0.9.86

package/agents/generic/index.js

@@ -13,7 +13,7 @@ const POSTGRES_QUERY_TYPE = 'application/json;type=postgres-query'
 const TAG_TYPE = 'application/json;type=tag'
 const DOMAIN_CLAIM_TYPE = 'application/json;type=domain-claim'
 
-export default function Agent({ Connection, token, uuid, fetch, applyPatch, login, logout, reboot }) {
+export default function Agent({ Connection, token, uuid, fetch, applyPatch, login, logout, reboot, handleDomainInteraction }) {
   const states = {}
   const watchers = {}
   const keyToSubscriptionId = {}
@@ -29,7 +29,7 @@ export default function Agent({ Connection, token, uuid, fetch, applyPatch, logi
     reconnect,
     synced,
     environment
-  ] = messageQueue({ token, Connection, watchers, states, applyPatch, log, login, interact, reboot })
+  ] = messageQueue({ token, Connection, watchers, states, applyPatch, log, login, interact, reboot, trigger })
 
   // initialize session
   environment()
@@ -216,6 +216,17 @@ export default function Agent({ Connection, token, uuid, fetch, applyPatch, logi
     })
   }
 
+  const reactions = { child: [] }
+
+  function on(event, reaction) {
+    if (!reactions[event]) throw new Error('Agent can only listen to events of "child"')
+    reactions[event].push(reaction)
+  }
+
+  function trigger(event, data) {
+    reactions[event].forEach(f => f(data))
+  }
+
   return {
     uuid,
     environment,
@@ -235,6 +246,7 @@ export default function Agent({ Connection, token, uuid, fetch, applyPatch, logi
     disconnect,
     reconnect,
     tag,
-    debug
+    debug,
+    on
   }
 }

package/agents/generic/message-queue.js

@@ -1,6 +1,7 @@
 import { validate as isUUID } from 'uuid'
 
 const HEARTBEAT_TIMEOUT = 10000
+const DOMAIN_MESSAGES = { open: true, mutate: true, close: true }
 
 //  transform our custom path implementation to the standard JSONPatch path
 function standardJSONPatch(patch) {
@@ -14,7 +15,7 @@ function sanitizeJSONPatchPathSegment(s) {
   else return s
 }
 
-export default function messageQueue({ token, Connection, watchers, states, applyPatch, log, login, reboot }) {
+export default function messageQueue({ token, Connection, watchers, states, applyPatch, log, login, reboot, handleDomainMessage, trigger }) {
   let connection
   let user
   let authed = false
@@ -159,7 +160,10 @@ export default function messageQueue({ token, Connection, watchers, states, appl
           flushMessageQueue()
         }
         else {
-          if (message.si !== undefined) {
+          if (DOMAIN_MESSAGES[message.type]) {
+            handleDomainMessage && handleDomainMessage(message, trigger)
+          }
+          else if (message.si !== undefined) {
             if (responses[message.si]) {
               //  TODO: remove "acknowledged" messages from queue and do accounting with si
               responses[message.si]

package/deno.js

@@ -18,11 +18,43 @@ function Connection() {
   return thisConnection
 }
 
-export default new Agent({
+const children = {}
+const listeners = {}
+
+const agent = new Agent({
   Connection,
   token: () => AGENT_TOKEN,
   uuid: () => crypto.randomUUID(),
   fetch,
   applyPatch: fastJSONPatch.applyPatch,
-  reboot: () => Deno.exit(1)
+  reboot: () => Deno.exit(1),
+  handleDomainMessage: ({ type, session, data }, trigger) => {
+    //  this functionality is only implemented for the deno
+    //  agent for now, but this central management of children
+    //  concept probably has a place in the generic agent
+    if (type === 'open') {
+      const child = {
+        on: (eventType, reaction) => {
+          if (!listeners[session]) throw new Error('Error attaching listener, child is closed')
+          if (!listeners[session][eventType]) throw new Error('Only "mutate" and "close" events can be listened to with Agent.on')
+          listeners[session][eventType].push(reaction)
+        }
+      }
+      listeners[session] = { mutate: [], close: [] }
+      children[session] = child
+      trigger('child', child)
+    }
+    else if (type === 'mutate') {
+      listeners[session].mutate.forEach(f => f(data))
+      delete listeners[session]
+      delete children[session]
+    }
+    else if (type === 'close') {
+      listeners[session].close.forEach(f => f(data))
+      delete listeners[session]
+      delete children[session]
+    }
+  }
 })
+
+export default agent

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@knowlearning/agents",
-  "version": "0.9.84",
+  "version": "0.9.86",
   "description": "API for embedding applications in KnowLearning systems.",
   "main": "node.js",
   "browser": "browser.js",