@scout9/app 1.0.0-alpha.0.6.5 → 1.0.0-alpha.0.6.7

package/dist/{dev-6e60a643.cjs → dev-197a7adb.cjs}

@@ -1,6 +1,6 @@
 'use strict';
 
-var spirits = require("./spirits-985e6711.cjs");
+var spirits = require("./spirits-9719ae4f.cjs");
 var require$$0$4 = require('util');
 var require$$0$3 = require('stream');
 var require$$1 = require('path');
@@ -21,7 +21,7 @@ var node_url = require('node:url');
 var node_events = require('node:events');
 var Stream = require('node:stream');
 var node_string_decoder = require('node:string_decoder');
-var macros = require("./macros-1a4fd407.cjs");
+var macros = require("./macros-85a033b9.cjs");
 var readline = require('node:readline');
 var process$2 = require('node:process');
 var node_os = require('node:os');
@@ -35241,7 +35241,7 @@ function _loadUserPackageJson() {
           targetPkgUrl = isTest ? packageTestJsonUrl : packageJsonUrl;
           _context2.t0 = JSON;
           _context2.next = 10;
-          return fs__default["default"].readFile(new URL(targetPkgUrl, (typeof document === 'undefined' ? new (require('u' + 'rl').URL)('file:' + __filename).href : (document.currentScript && document.currentScript.src || new URL('dev-6e60a643.js', document.baseURI).href))), 'utf-8');
+          return fs__default["default"].readFile(new URL(targetPkgUrl, (typeof document === 'undefined' ? new (require('u' + 'rl').URL)('file:' + __filename).href : (document.currentScript && document.currentScript.src || new URL('dev-197a7adb.js', document.baseURI).href))), 'utf-8');
         case 10:
           _context2.t1 = _context2.sent;
           pkg = _context2.t0.parse.call(_context2.t0, _context2.t1);

package/dist/{index-bf3ce1b6.cjs → index-1010a60c.cjs}

@@ -1,8 +1,8 @@
 'use strict';
 
-var spirits = require("./spirits-985e6711.cjs");
-var dev = require("./dev-6e60a643.cjs");
-var macros = require("./macros-1a4fd407.cjs");
+var spirits = require("./spirits-9719ae4f.cjs");
+var dev = require("./dev-197a7adb.cjs");
+var macros = require("./macros-85a033b9.cjs");
 var require$$0 = require('fs');
 var require$$2$1 = require('events');
 var require$$1 = require('path');
@@ -29483,7 +29483,7 @@ class Body {
     }
     const {
       toFormData
-    } = await Promise.resolve().then(function () { return require("./multipart-parser-13478cb7.cjs"); });
+    } = await Promise.resolve().then(function () { return require("./multipart-parser-0d83aaf8.cjs"); });
     return toFormData(this.body, ct);
   }
 
@@ -41884,7 +41884,7 @@ function _loadUserPackageJson() {
           targetPkgUrl = isTest ? packageTestJsonUrl : packageJsonUrl;
           _context.t0 = JSON;
           _context.next = 10;
-          return fs__default["default"].readFile(new URL(targetPkgUrl, (typeof document === 'undefined' ? new (require('u' + 'rl').URL)('file:' + __filename).href : (document.currentScript && document.currentScript.src || new URL('index-bf3ce1b6.js', document.baseURI).href))), 'utf-8');
+          return fs__default["default"].readFile(new URL(targetPkgUrl, (typeof document === 'undefined' ? new (require('u' + 'rl').URL)('file:' + __filename).href : (document.currentScript && document.currentScript.src || new URL('index-1010a60c.js', document.baseURI).href))), 'utf-8');
         case 10:
           _context.t1 = _context.sent;
           pkg = _context.t0.parse.call(_context.t0, _context.t1);
@@ -43176,7 +43176,7 @@ var ProjectFiles = /*#__PURE__*/function () {
   return ProjectFiles;
 }();
 
-var __filename$1 = node_url.fileURLToPath((typeof document === 'undefined' ? new (require('u' + 'rl').URL)('file:' + __filename).href : (document.currentScript && document.currentScript.src || new URL('index-bf3ce1b6.js', document.baseURI).href)));
+var __filename$1 = node_url.fileURLToPath((typeof document === 'undefined' ? new (require('u' + 'rl').URL)('file:' + __filename).href : (document.currentScript && document.currentScript.src || new URL('index-1010a60c.js', document.baseURI).href)));
 var __dirname$1 = path__default["default"].dirname(__filename$1);
 function zipDirectory(source, out) {
   var archive = archiver$1('tar', {
@@ -43391,7 +43391,7 @@ function _buildApp() {
         case 11:
           _context4.t0 = JSON;
           _context4.next = 14;
-          return fs__default["default"].readFile(new URL(templatePackagePath, (typeof document === 'undefined' ? new (require('u' + 'rl').URL)('file:' + __filename).href : (document.currentScript && document.currentScript.src || new URL('index-bf3ce1b6.js', document.baseURI).href))), 'utf-8');
+          return fs__default["default"].readFile(new URL(templatePackagePath, (typeof document === 'undefined' ? new (require('u' + 'rl').URL)('file:' + __filename).href : (document.currentScript && document.currentScript.src || new URL('index-1010a60c.js', document.baseURI).href))), 'utf-8');
         case 14:
           _context4.t1 = _context4.sent;
           packageTemplate = _context4.t0.parse.call(_context4.t0, _context4.t1);

package/dist/index.cjs

@@ -2,10 +2,10 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var index = require("./index-bf3ce1b6.cjs");
-var dev = require("./dev-6e60a643.cjs");
-require("./spirits-985e6711.cjs");
-require("./macros-1a4fd407.cjs");
+var index = require("./index-1010a60c.cjs");
+var dev = require("./dev-197a7adb.cjs");
+require("./spirits-9719ae4f.cjs");
+require("./macros-85a033b9.cjs");
 require('fs');
 require('events');
 require('path');

package/dist/{macros-1a4fd407.cjs → macros-85a033b9.cjs}

@@ -4336,6 +4336,12 @@ var WorkflowEventSchema = z.object({
     description: 'Any developer notes to provide'
   }).optional()
 });
+var DirectMessageSchema = MessageSchema.partial().omit({
+  id: true,
+  entities: true,
+  time: true,
+  role: true
+});
 
 /**
  * The workflow response object slot
@@ -4347,16 +4353,27 @@ var WorkflowResponseSlotBaseSchema = z.object({
   }).optional(),
   instructions: InstructionSchema.optional(),
   removeInstructions: z.array(z.string()).optional(),
-  message: z.union([z.string(), z.object({
-    content: z.string(),
-    transform: z["boolean"]().optional()
-  })]).optional(),
+  message: z.union([z.string(), DirectMessageSchema]).optional(),
   secondsDelay: z.number().optional(),
   scheduled: z.number().optional(),
   contextUpsert: ConversationContext.optional(),
   resetIntent: z["boolean"]().optional(),
   followup: FollowupSchema.optional()
 });
+var deleteSchema = z.object({
+  entityType: z.string(),
+  entityRecordId: z.string(),
+  method: z.literal('delete')
+});
+var mutateSchema = z.object({
+  entityType: z.string(),
+  entityRecordId: z.string(),
+  method: z.literal('mutate'),
+  fields: z.record(z.union([z.string(), z.number(), z["boolean"](), z["null"](), z.literal('#remove'), z.literal('#delete')]))
+});
+var EntityContextUpsertSchema = z.discriminatedUnion('method', [deleteSchema, mutateSchema], {
+  description: 'Metadata to provide a atomic transaction on a entity context record\n * @ingress auto/manual only'
+});
 
 /**
  * The workflow response object slot
@@ -4364,13 +4381,14 @@ var WorkflowResponseSlotBaseSchema = z.object({
 var WorkflowResponseSlotSchema = WorkflowResponseSlotBaseSchema.extend({
   anticipate: z.union([z.object({
     did: z.string({
-      definition: 'The prompt to check if true or false'
+      description: 'The prompt to check if true or false'
     }),
     yes: WorkflowResponseSlotBaseSchema,
     no: WorkflowResponseSlotBaseSchema
   }), z.array(WorkflowResponseSlotBaseSchema.extend({
     keywords: z.array(z.string()).min(1).max(20)
-  }))]).optional()
+  }))]).optional(),
+  entityContextUpsert: z.array(EntityContextUpsertSchema).optional()
 });
 
 /**
@@ -4594,10 +4612,12 @@ exports.ConversationContext = ConversationContext;
 exports.ConversationSchema = ConversationSchema;
 exports.CustomerSchema = CustomerSchema;
 exports.CustomerValueSchema = CustomerValueSchema;
+exports.DirectMessageSchema = DirectMessageSchema;
 exports.EntitiesRootConfigurationSchema = EntitiesRootConfigurationSchema;
 exports.EntitiesRootProjectConfigurationSchema = EntitiesRootProjectConfigurationSchema;
 exports.EntityApiConfigurationSchema = EntityApiConfigurationSchema;
 exports.EntityConfigurationSchema = EntityConfigurationSchema;
+exports.EntityContextUpsertSchema = EntityContextUpsertSchema;
 exports.EntityRootProjectConfigurationSchema = EntityRootProjectConfigurationSchema;
 exports.FollowupBaseSchema = FollowupBaseSchema;
 exports.FollowupSchema = FollowupSchema;

package/dist/{multipart-parser-13478cb7.cjs → multipart-parser-0d83aaf8.cjs}

@@ -2,9 +2,9 @@
 
 require('node:fs');
 require('node:path');
-var index = require("./index-bf3ce1b6.cjs");
-require("./spirits-985e6711.cjs");
-require("./dev-6e60a643.cjs");
+var index = require("./index-1010a60c.cjs");
+require("./spirits-9719ae4f.cjs");
+require("./dev-197a7adb.cjs");
 require('util');
 require('stream');
 require('path');
@@ -23,7 +23,7 @@ require('node:url');
 require('node:events');
 require('node:stream');
 require('node:string_decoder');
-require("./macros-1a4fd407.cjs");
+require("./macros-85a033b9.cjs");
 require('node:readline');
 require('node:process');
 require('node:os');

package/dist/schemas.cjs

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var macros = require("./macros-1a4fd407.cjs");
+var macros = require("./macros-85a033b9.cjs");
 
 
 
@@ -19,10 +19,12 @@ exports.ConversationContext = macros.ConversationContext;
 exports.ConversationSchema = macros.ConversationSchema;
 exports.CustomerSchema = macros.CustomerSchema;
 exports.CustomerValueSchema = macros.CustomerValueSchema;
+exports.DirectMessageSchema = macros.DirectMessageSchema;
 exports.EntitiesRootConfigurationSchema = macros.EntitiesRootConfigurationSchema;
 exports.EntitiesRootProjectConfigurationSchema = macros.EntitiesRootProjectConfigurationSchema;
 exports.EntityApiConfigurationSchema = macros.EntityApiConfigurationSchema;
 exports.EntityConfigurationSchema = macros.EntityConfigurationSchema;
+exports.EntityContextUpsertSchema = macros.EntityContextUpsertSchema;
 exports.EntityRootProjectConfigurationSchema = macros.EntityRootProjectConfigurationSchema;
 exports.FollowupBaseSchema = macros.FollowupBaseSchema;
 exports.FollowupSchema = macros.FollowupSchema;

package/dist/{spirits-985e6711.cjs → spirits-9719ae4f.cjs}

@@ -746,7 +746,7 @@ var Spirits = {
         while (1) switch (_context2.prev = _context2.next) {
           case 0:
             customer = input.customer, config = input.config, parser = input.parser, workflow = input.workflow, generator = input.generator, transformer = input.transformer, idGenerator = input.idGenerator, _input$progress = input.progress, progress = _input$progress === void 0 ? function (message, level, type, payload) {} : _input$progress, messageBefore = input.message, contextBefore = input.context, messagesBefore = input.messages, conversationBefore = input.conversation;
-            conversation = input.conversation, messages = input.messages, context = input.context, message = input.message;
+            conversation = input.conversation, messages = input.messages, context = input.context, message = input.message; // Storing post process events here
             followup = [];
             entityContextUpsert = []; // 0. Setup Helpers
             updateConversation = function updateConversation(previousConversation, conversationUpdates) {
@@ -1021,7 +1021,7 @@ var Spirits = {
             _iterator.s();
           case 55:
             if ((_step = _iterator.n()).done) {
-              _context2.next = 116;
+              _context2.next = 125;
               break;
             }
             _step$value = _step.value, forward = _step$value.forward, forwardNote = _step$value.forwardNote, instructions = _step$value.instructions, removeInstructions = _step$value.removeInstructions, manualMessage = _step$value.message, scheduled = _step$value.scheduled, resetIntent = _step$value.resetIntent, secondsDelay = _step$value.secondsDelay, contextUpsert = _step$value.contextUpsert, anticipate = _step$value.anticipate, slotFollowup = _step$value.followup, slotEntityContextUpsert = _step$value.entityContextUpsert;
@@ -1216,21 +1216,37 @@ var Spirits = {
             return _context2.finish(102);
           case 105:
             if (!manualMessage) {
-              _context2.next = 112;
+              _context2.next = 121;
               break;
             }
+            /** @type {import('@scout9/app').Message} */
             manualMessageObj = {
-              id: idGenerator('agent'),
+              id: idGenerator('persona'),
               role: 'agent',
-              content: manualMessage,
+              // @TODO switch role to persona
+              content: '',
               time: new Date().toISOString()
             };
-            if (!(typeof manualMessage !== 'string')) {
-              _context2.next = 109;
+            if (!(_typeof(manualMessage) === 'object')) {
+              _context2.next = 113;
               break;
             }
-            throw new Error('Manual message must be of type "string"');
-          case 109:
+            Object.assign(manualMessageObj, manualMessage);
+            manualMessageObj.role = 'agent';
+            manualMessageObj.time = new Date().toISOString();
+            _context2.next = 118;
+            break;
+          case 113:
+            if (!(typeof manualMessage === 'string')) {
+              _context2.next = 117;
+              break;
+            }
+            manualMessageObj.content = manualMessage;
+            _context2.next = 118;
+            break;
+          case 117:
+            throw new Error('Manual message must be of type "string" or "DirectMessage"');
+          case 118:
             if (scheduled) {
               manualMessageObj.time = new Date(scheduled * 1000).toISOString();
               manualMessageObj.scheduled = manualMessageObj.time;
@@ -1242,7 +1258,7 @@ var Spirits = {
             }
             messages.push(manualMessageObj);
             progress('Added manual message', 'info', 'ADD_MESSAGE', messages[messages.length - 1]);
-          case 112:
+          case 121:
             if (contextUpsert) {
               context = updateContext(context, contextUpsert);
               progress('Upserted context', 'info', 'UPDATE_CONTEXT', contextUpsert);
@@ -1250,21 +1266,21 @@ var Spirits = {
             if (resetIntent) {
               resettedIntent = true;
             }
-          case 114:
+          case 123:
             _context2.next = 55;
             break;
-          case 116:
-            _context2.next = 121;
+          case 125:
+            _context2.next = 130;
             break;
-          case 118:
-            _context2.prev = 118;
+          case 127:
+            _context2.prev = 127;
             _context2.t2 = _context2["catch"](53);
             _iterator.e(_context2.t2);
-          case 121:
-            _context2.prev = 121;
+          case 130:
+            _context2.prev = 130;
             _iterator.f();
-            return _context2.finish(121);
-          case 124:
+            return _context2.finish(130);
+          case 133:
             if (resettedIntent && !_forward) {
               conversation.intent = null;
               conversation.intentScore = null;
@@ -1283,16 +1299,16 @@ var Spirits = {
             // 4. Generate response
             // If conversation previously locked, don't generate
             if (input.conversation.locked) {
-              _context2.next = 172;
+              _context2.next = 181;
               break;
             }
             if (!((!conversation.locked || !hasNoInstructions) && !!hasNoCustomMessage)) {
-              _context2.next = 139;
+              _context2.next = 148;
               break;
             }
-            _context2.prev = 127;
+            _context2.prev = 136;
             progress('Generating message', 'info', 'SET_PROCESSING', 'system');
-            _context2.next = 131;
+            _context2.next = 140;
             return generator({
               messages: messages,
               persona: persona,
@@ -1300,7 +1316,7 @@ var Spirits = {
               llm: config.llm,
               pmt: config.pmt
             });
-          case 131:
+          case 140:
             generatorPayload = _context2.sent;
             if (!generatorPayload.send) {
               progress('Generated response', 'failed', undefined, {
@@ -1339,29 +1355,29 @@ var Spirits = {
                 }
               }
             }
-            _context2.next = 139;
+            _context2.next = 148;
             break;
-          case 135:
-            _context2.prev = 135;
-            _context2.t3 = _context2["catch"](127);
+          case 144:
+            _context2.prev = 144;
+            _context2.t3 = _context2["catch"](136);
             console.error("Locking conversation, error generating response: ".concat(_context2.t3.message));
             conversation = lockConversation(conversation, 'API: ' + _context2.t3.message);
-          case 139:
+          case 148:
             if (!(messagesToTransform.length && transformer)) {
-              _context2.next = 171;
+              _context2.next = 180;
               break;
             }
-            _context2.prev = 140;
+            _context2.prev = 149;
             _iterator2 = _createForOfIteratorHelper(messagesToTransform);
-            _context2.prev = 142;
+            _context2.prev = 151;
             _iterator2.s();
-          case 144:
+          case 153:
             if ((_step2 = _iterator2.n()).done) {
-              _context2.next = 155;
+              _context2.next = 164;
               break;
             }
             _step2.value;
-            _context2.next = 148;
+            _context2.next = 157;
             return transformer({
               message: messagesToTransform,
               persona: persona,
@@ -1369,7 +1385,7 @@ var Spirits = {
               messages: messages,
               context: context
             });
-          case 148:
+          case 157:
             transformResponse = _context2.sent;
             progress('Generated response', 'success', undefined, undefined);
             // Check if already had message
@@ -1389,36 +1405,36 @@ var Spirits = {
               });
               progress('Added agent message', 'info', 'ADD_MESSAGE', messages[messages.length - 1]);
             }
-          case 153:
-            _context2.next = 144;
+          case 162:
+            _context2.next = 153;
             break;
-          case 155:
-            _context2.next = 160;
+          case 164:
+            _context2.next = 169;
             break;
-          case 157:
-            _context2.prev = 157;
-            _context2.t4 = _context2["catch"](142);
+          case 166:
+            _context2.prev = 166;
+            _context2.t4 = _context2["catch"](151);
             _iterator2.e(_context2.t4);
-          case 160:
-            _context2.prev = 160;
+          case 169:
+            _context2.prev = 169;
             _iterator2.f();
-            return _context2.finish(160);
-          case 163:
-            _context2.next = 169;
+            return _context2.finish(169);
+          case 172:
+            _context2.next = 178;
             break;
-          case 165:
-            _context2.prev = 165;
-            _context2.t5 = _context2["catch"](140);
+          case 174:
+            _context2.prev = 174;
+            _context2.t5 = _context2["catch"](149);
             console.error("Locking conversation, error transforming response: ".concat(_context2.t5.message));
             conversation = lockConversation(conversation, 'API: ' + _context2.t5.message);
-          case 169:
-            _context2.next = 172;
+          case 178:
+            _context2.next = 181;
             break;
-          case 171:
+          case 180:
             if (messagesToTransform.length) {
               console.warn("No transformer provided");
             }
-          case 172:
+          case 181:
             progress('Parsing message', 'info', 'SET_PROCESSING', null);
             return _context2.abrupt("return", {
               conversation: {
@@ -1442,11 +1458,11 @@ var Spirits = {
               followup: followup,
               entityContextUpsert: entityContextUpsert
             });
-          case 174:
+          case 183:
           case "end":
             return _context2.stop();
         }
-      }, _callee, null, [[53, 118, 121, 124], [90, 99, 102, 105], [127, 135], [140, 165], [142, 157, 160, 163]]);
+      }, _callee, null, [[53, 127, 130, 133], [90, 99, 102, 105], [136, 144], [149, 174], [151, 166, 169, 172]]);
     }));
     function customer(_x) {
       return _customer.apply(this, arguments);

package/dist/spirits.cjs

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var spirits = require("./spirits-985e6711.cjs");
+var spirits = require("./spirits-9719ae4f.cjs");
 
 
 

package/dist/testing-tools.cjs

@@ -2,8 +2,8 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var dev = require("./dev-6e60a643.cjs");
-require("./spirits-985e6711.cjs");
+var dev = require("./dev-197a7adb.cjs");
+require("./spirits-9719ae4f.cjs");
 require('util');
 require('stream');
 require('path');
@@ -24,7 +24,7 @@ require('node:url');
 require('node:events');
 require('node:stream');
 require('node:string_decoder');
-require("./macros-1a4fd407.cjs");
+require("./macros-85a033b9.cjs");
 require('node:readline');
 require('node:process');
 require('node:os');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scout9/app",
-  "version": "1.0.0-alpha.0.6.5",
+  "version": "1.0.0-alpha.0.6.7",
   "description": "Build and deploy your Scout9 app for SMS auto replies",
   "publishConfig": {
     "access": "public"

package/src/public.d.ts

@@ -589,7 +589,7 @@ export type Message = {
     intentScore?: (number | null) | undefined;
     /** How long to delay the message manually in seconds */
     delayInSeconds?: (number | null) | undefined;
-    /** Entities related to the message */
+    /** Entities related to the message (gets set after the PMT transform) */
     entities?: EntityToken[] | null;
     /** If set to true, the PMT will not transform, message will be sent as is */
     ignoreTransform?: boolean;
@@ -690,19 +690,7 @@ export type AnticipateKeywords = WorkflowResponseSlotBase & {
 
 export type Anticipate = AnticipateDid | AnticipateKeywords[];
 
-export type DirectMessagePayload = {
-    /**
-     * The content
-     */
-    content: string;
-
-    /**
-     * If true, the PMT will transform the message into the owners own words. By default will send the message as is
-     */
-    transform?: boolean;
-
-    mediaUrls?: string[];
-};
+export type DirectMessage = Partial<Omit<Message, 'id' | 'entities' | 'time' | 'role'>>;
 
 /**
  * Workflow Response Slot, can use for both PMT workflow event and event macro runtimes
@@ -710,6 +698,7 @@ export type DirectMessagePayload = {
 export type WorkflowResponseSlotBase = {
     /** Forward input information of a conversation */
     forward?: Forward | undefined;
+
     /** Note to provide to the agent, recommend using forward object api instead */
     forwardNote?: string | undefined;
 
@@ -720,7 +709,7 @@ export type WorkflowResponseSlotBase = {
     removeInstructions?: string[] | undefined;
 
     /** If provided, sends a direct message to the user */
-    message?: string | DirectMessagePayload | undefined;
+    message?: string | DirectMessage | undefined;
 
     /** Delays in seconds of instructions (if provided) to PMT and direct message (if provided) to user */
     secondsDelay?: number | undefined;
@@ -751,7 +740,6 @@ export type WorkflowResponseSlot = WorkflowResponseSlotBase & {
      */
     anticipate?: Anticipate | undefined;
 
-
     /**
      * If provided, it will propagate entity context to your Scout9 entity context store
      * @ingress auto/manual only

package/src/runtime/schemas/workflow.js

@@ -143,6 +143,8 @@ export const WorkflowEventSchema = z.object({
   note: z.string({description: 'Any developer notes to provide'}).optional()
 });
 
+export const DirectMessageSchema = MessageSchema.partial().omit({id: true, entities: true, time: true, role: true})
+
 /**
  * The workflow response object slot
  */
@@ -152,10 +154,7 @@ export const WorkflowResponseSlotBaseSchema = z.object({
     .optional(),
   instructions: InstructionSchema.optional(),
   removeInstructions: z.array(z.string()).optional(),
-  message: z.union([z.string(), z.object({
-    content: z.string(),
-    transform: z.boolean().optional()
-  })]).optional(),
+  message: z.union([z.string(), DirectMessageSchema]).optional(),
   secondsDelay: z.number().optional(),
   scheduled: z.number().optional(),
   contextUpsert: ConversationContext.optional(),
@@ -163,20 +162,50 @@ export const WorkflowResponseSlotBaseSchema = z.object({
   followup: FollowupSchema.optional()
 });
 
+
+const deleteSchema = z.object({
+  entityType: z.string(),
+  entityRecordId: z.string(),
+  method: z.literal('delete')
+});
+
+const mutateSchema = z.object({
+  entityType: z.string(),
+  entityRecordId: z.string(),
+  method: z.literal('mutate'),
+  fields: z.record(
+    z.union([
+      z.string(),
+      z.number(),
+      z.boolean(),
+      z.null(),
+      z.literal('#remove'),
+      z.literal('#delete')
+    ])
+  )
+});
+
+export const EntityContextUpsertSchema = z.discriminatedUnion('method', [
+  deleteSchema,
+  mutateSchema
+], {description: 'Metadata to provide a atomic transaction on a entity context record\n * @ingress auto/manual only'});
+
 /**
  * The workflow response object slot
  */
 export const WorkflowResponseSlotSchema = WorkflowResponseSlotBaseSchema.extend({
   anticipate: z.union([
     z.object({
-      did: z.string({definition: 'The prompt to check if true or false'}),
+      did: z.string({description: 'The prompt to check if true or false'}),
       yes: WorkflowResponseSlotBaseSchema,
       no: WorkflowResponseSlotBaseSchema
     }),
     z.array(WorkflowResponseSlotBaseSchema.extend({
       keywords: z.array(z.string()).min(1).max(20)
     }))
-  ]).optional()
+  ]).optional(),
+
+  entityContextUpsert: z.array(EntityContextUpsertSchema).optional()
 });
 
 /**