@knowlearning/agents 0.9.178 → 0.9.180

package/agents/browser/embedded.js

@@ -3,7 +3,7 @@ import EmbeddedAgent from '../embedded.js'
 export default () => {
   //  default to window opener if present
   const parent = window.opener ? window.opener : window.parent
-  const agent = EmbeddedAgent(parent)
+  const agent = EmbeddedAgent(message =>  parent.postMessage(message, '*'))
 
   return agent
 }

package/agents/browser/initialize.js

@@ -48,6 +48,7 @@ function embed(environment, iframe) {
   const watchers = {}
   const postMessageQueue = []
   const listeners = {}
+  const responses = {}
   let frameLoaded = false
   let embeddedAgentInitialized = false
 
@@ -70,7 +71,10 @@ function embed(environment, iframe) {
   const handleMessage = async message => {
     const { requestId, type } = message
 
-    const sendDown = (response, error) => postMessage({ requestId, response, error })
+    const sendDown = (response, error) => {
+      if (responses[requestId]) responses[requestId](response, error)
+      postMessage({ requestId, response, error })
+    }
 
     if (type === 'error') {
       console.error(message)
@@ -103,7 +107,7 @@ function embed(environment, iframe) {
       const namespacedScope = getNamespacedScope(environment.namespace, scope)
       let before, after
       if (listeners.mutate) before = copy(await Agent.state(namespacedScope))
-      await Agent.interact(namespacedScope, patch, true, [environment.id, ...context])
+      const response = await Agent.interact(namespacedScope, patch, true, [environment.id, ...context])
       if (listeners.mutate) {
         const patchCopy = copy(patch)
         patchCopy.forEach(op => op.path.shift()) //  remove "active" path prefix
@@ -115,7 +119,7 @@ function embed(environment, iframe) {
             patch: patchCopy
           })
       }
-      sendDown({}) // TODO: might want to send down the interaction index
+      sendDown(response)
     }
     else if (type === 'metadata') {
       const { scope, user, domain } = message
@@ -146,7 +150,7 @@ function embed(environment, iframe) {
       Agent
         .query(query, params, domain, [environment.id, ...context])
         .then(sendDown)
-        .catch(error => sendDown(null, error.error))
+        .catch(error => sendDown(null, error))
     }
     else if (type === 'upload') {
       const { info } = message
@@ -163,8 +167,19 @@ function embed(environment, iframe) {
     else if (type === 'disconnect') sendDown(await Agent.disconnect())
     else if (type === 'reconnect') sendDown(await Agent.reconnect())
     else if (type === 'synced') sendDown(await Agent.synced())
+    else if (type === 'guarantee') {
+      const { script, namespaces=[], context=[] } = message
+      sendDown(await Agent.guarantee(script, [environment.namespace || '', ...namespaces], [environment.id, ...context]))
+    }
+    else if (type === 'response') {
+      const { id, requestId } = message
+      responses[id] = (response, error) => {
+        delete responses[id]
+        sendDown(response, error)
+      }
+    }
     else {
-      console.log('Unknown message type passed up...', message)
+      console.warn('Unknown message type passed up...', message)
       sendDown({})
     }
   }

package/agents/embedded.js

@@ -2,7 +2,7 @@ import { validate as isUUID, v1 as uuid } from 'uuid'
 import PatchProxy from '@knowlearning/patch-proxy'
 import watchImplementation from './watch.js'
 
-export default function EmbeddedAgent(parent) {
+export default function EmbeddedAgent(postMessage) {
   let messageIndex = 0
   let resolveSession
   const session = new Promise(r => resolveSession = r)
@@ -12,18 +12,19 @@ export default function EmbeddedAgent(parent) {
 
   const [ watch, removeWatcher ] = watchImplementation({ metadata, state, watchers, synced, sentUpdates, environment })
 
+  let lastRequestId
+
   async function send(message) {
-    const requestId = message.requestId || uuid()
+    const requestId = lastRequestId = message.requestId || uuid()
 
     messageIndex += 1
     try {
-      parent
-        .postMessage({
-          ...message,
-          session: await session,
-          requestId,
-          index: messageIndex
-        }, '*')
+      postMessage({
+        ...message,
+        session: await session,
+        requestId,
+        index: messageIndex
+      })
       return new Promise((resolve, reject) => {
         responses[requestId] = { resolve, reject }
       })
@@ -203,6 +204,8 @@ export default function EmbeddedAgent(parent) {
   function reconnect() { return send({ type: 'reconnect' }) }
   function synced() { return send({ type: 'synced' }) }
   function close(info) { return send({ type: 'close', info }) }
+  function guarantee(script, namespaces, context) { return send({ type: 'guarantee', script, namespaces, context }) }
+  function response(id=lastRequestId) { return send({ type: 'response', id }) }
 
   return {
     embedded: true,
@@ -223,6 +226,7 @@ export default function EmbeddedAgent(parent) {
     reconnect,
     synced,
     close,
+    response,
     query
   }
 }

package/agents/generic/index.js

@@ -28,9 +28,10 @@ export default function Agent({ Connection, domain, token, sid, uuid, fetch, app
   ] = messageQueue({ token, sid, domain, Connection, watchers, states, applyPatch, log, login, interact, reboot, trigger, handleDomainMessage, variables })
 
   // initialize session
+  const initialSessionData = { queries: {}, subscriptions: {}, guarantees: {} }
   environment()
     .then(({ session }) => {
-      interact('sessions', [{ op: 'add', path: ['active', session], value: { queries: {}, subscriptions: {} } }], false)
+      interact('sessions', [{ op: 'add', path: ['active', session], value: initialSessionData }], false)
     })
 
   const internalReferences = {
@@ -157,23 +158,10 @@ export default function Agent({ Connection, domain, token, sid, uuid, fetch, app
     ], false)
     try {
       const response = await lastMessageResponse()
-      const { rows } = response
-
-      interact('sessions', [
-        {
-          op: 'add',
-          path: ['active', session, 'queries', id, 'agent_latency'],
-          value: Date.now() - requested
-        },
-        {
-          op: 'remove',
-          path: ['active', session, 'queries', id]
-        }
-      ], false)
-      return rows
+      return response.rows
     }
     catch (error) {
-      throw error
+      throw error.error
     }
   }
 
@@ -188,6 +176,37 @@ export default function Agent({ Connection, domain, token, sid, uuid, fetch, app
     reactions[event].forEach(f => f(data))
   }
 
+  async function guarantee(script, namespaces=[], context=[]) {
+    const { session } = await environment()
+    const id = uuid()
+
+    interact('sessions', [
+      {
+        op: 'add',
+        path: ['active', session, 'guarantees', id],
+        value: { script, namespaces, context }
+      }
+    ], false)
+
+    return {
+      execute() {
+        //  TODO: use simplified worker wrapper to execute script in restricted environment
+      },
+      cancel() {
+        interact('sessions', [
+          {
+            op: 'remove',
+            path: ['active', session, 'guarantees', id]
+          }
+        ], false)
+      }
+    }
+  }
+
+  function response() {
+    return lastMessageResponse()
+  }
+
   return {
     uuid,
     environment,
@@ -208,6 +227,8 @@ export default function Agent({ Connection, domain, token, sid, uuid, fetch, app
     disconnect,
     reconnect,
     debug,
+    guarantee,
+    response,
     on
   }
 }

package/agents/generic/message-queue.js

@@ -227,7 +227,11 @@ export default function messageQueue({ token, sid, domain, Connection, watchers,
     return syncPromise
   }
 
-  function lastMessageResponse() { return new Promise((res, rej) => responses[si].push([res, rej])) }
+  function lastMessageResponse() {
+    if (!responses[si]) throw new Error('A response must be requested before all outstanding responses have already returned')
+
+    return new Promise((res, rej) => responses[si].push([res, rej]))
+  }
 
   function disconnect() {
     log('DISCONNECTED AGENT!!!!!!!!!!!!!!!')

package/browser.d.ts

@@ -39,6 +39,7 @@ export interface Agent {
   environment(userId?: string): Promise<AgentEnvironment>;
   close(): void;
   reset(ns: string): Promise<void>;
+  //  TODO: add query function
   synced(): Promise<void>;
 }
 

package/package.json

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