@scout9/app 1.0.0-alpha.0.4.9 → 1.0.0-alpha.0.5.1

package/dist/{dev-51604173.cjs → dev-65b97c9d.cjs}

@@ -1,6 +1,6 @@
 'use strict';
 
-var spirits = require("./spirits-8225c9fd.cjs");
+var spirits = require("./spirits-2ab4d673.cjs");
 var require$$0$4 = require('util');
 var require$$0$3 = require('stream');
 var require$$1 = require('path');
@@ -23,7 +23,7 @@ var Stream = require('node:stream');
 var node_string_decoder = require('node:string_decoder');
 var readline = require('node:readline');
 var process$2 = require('node:process');
-var macros = require("./macros-c9b4654d.cjs");
+var macros = require("./macros-2f21c706.cjs");
 var node_os = require('node:os');
 var promises = require('fs/promises');
 
@@ -35164,7 +35164,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-51604173.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-65b97c9d.js', document.baseURI).href))), 'utf-8');
         case 10:
           _context2.t1 = _context2.sent;
           pkg = _context2.t0.parse.call(_context2.t0, _context2.t1);
@@ -37779,6 +37779,57 @@ function _loadWorkflowsConfig() {
   return _loadWorkflowsConfig.apply(this, arguments);
 }
 
+/**
+ * @returns {Promise<CommandConfiguration[]>}
+ */
+function loadCommandsConfig() {
+  return _loadCommandsConfig.apply(this, arguments);
+}
+function _loadCommandsConfig() {
+  _loadCommandsConfig = spirits._asyncToGenerator( /*#__PURE__*/spirits._regeneratorRuntime().mark(function _callee() {
+    var _ref,
+      _ref$cwd,
+      cwd,
+      _ref$src,
+      src,
+      config,
+      _args = arguments;
+    return spirits._regeneratorRuntime().wrap(function _callee$(_context) {
+      while (1) switch (_context.prev = _context.next) {
+        case 0:
+          _ref = _args.length > 0 && _args[0] !== undefined ? _args[0] : {}, _ref$cwd = _ref.cwd, cwd = _ref$cwd === void 0 ? process.cwd() : _ref$cwd, _ref$src = _ref.src, src = _ref$src === void 0 ? 'src' : _ref$src, _ref.cb;
+          // const config = globSync(path.resolve(cwd, `${src}/workflows/**/workflow.{ts,js}`), {cwd, absolute: true})
+          config = globSync("".concat(src, "/commands/**/{index,command,*.command}.{ts,js}"), {
+            cwd: cwd,
+            absolute: false
+          }).map(function (path) {
+            var dir = path$2.dirname(path);
+            var entity = path$2.basename(path).replace(/\..*$/, ''); // Removes any "."'s
+            if (!entity) {
+              throw new Error("Invalid command path \"".concat(path, "\""));
+            }
+            switch (entity) {
+              case "index":
+              case "command":
+                entity = path$2.basename(dir);
+                break;
+            }
+            return {
+              entity: entity,
+              path: path.split(src + '/commands/')[1]
+            };
+          }); // Validate the config
+          macros.CommandsSchema.parse(config);
+          return _context.abrupt("return", config);
+        case 4:
+        case "end":
+          return _context.stop();
+      }
+    }, _callee);
+  }));
+  return _loadCommandsConfig.apply(this, arguments);
+}
+
 function loadEnvConfig() {
   var _ref = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {},
     _ref$cwd = _ref.cwd,
@@ -37831,6 +37882,7 @@ function _loadConfig() {
       entitiesConfig,
       agentsConfig,
       workflowsConfig,
+      commandsConfig,
       projectConfig,
       result,
       _args = arguments;
@@ -37886,24 +37938,35 @@ function _loadConfig() {
           });
         case 13:
           workflowsConfig = _context.sent;
+          _context.next = 16;
+          return loadCommandsConfig({
+            cwd: cwd,
+            src: src,
+            logger: logger,
+            deploying: deploying,
+            cb: cb
+          });
+        case 16:
+          commandsConfig = _context.sent;
           /**
            * @type {Scout9ProjectBuildConfig}
            */
           projectConfig = spirits._objectSpread2(spirits._objectSpread2({}, baseProjectConfig), {}, {
             entities: entitiesConfig,
             agents: agentsConfig,
-            workflows: workflowsConfig
+            workflows: workflowsConfig,
+            commands: commandsConfig
           }); // Validate the config
           result = macros.Scout9ProjectBuildConfigSchema.safeParse(projectConfig);
           if (result.success) {
-            _context.next = 19;
+            _context.next = 22;
             break;
           }
           result.error.source = "".concat(src, "/index.js");
           throw result.error;
-        case 19:
+        case 22:
           return _context.abrupt("return", projectConfig);
-        case 20:
+        case 23:
         case "end":
           return _context.stop();
       }
@@ -42546,7 +42609,18 @@ var createMockWorkflowEvent = function createMockWorkflowEvent(message) {
 /**
  * Testing tool kit, used to handle Scout9 operations such as parsing, workflow, and generating responses
  */
+var _project = /*#__PURE__*/new WeakMap();
+var _app = /*#__PURE__*/new WeakMap();
+var _command = /*#__PURE__*/new WeakMap();
+var _api = /*#__PURE__*/new WeakMap();
+var _cwd = /*#__PURE__*/new WeakMap();
+var _src = /*#__PURE__*/new WeakMap();
+var _mode = /*#__PURE__*/new WeakMap();
+var _loaded = /*#__PURE__*/new WeakMap();
+var _personaId = /*#__PURE__*/new WeakMap();
 var _defaultLog = /*#__PURE__*/new WeakMap();
+var _loadApp = /*#__PURE__*/new WeakSet();
+var _loadCommand = /*#__PURE__*/new WeakSet();
 var Scout9Test = /*#__PURE__*/function () {
   /**
    * Mimics a customer message to your app (useful for testing)
@@ -42585,6 +42659,12 @@ var Scout9Test = /*#__PURE__*/function () {
       _ref$log = _ref.log,
       log = _ref$log === void 0 ? false : _ref$log;
     spirits._classCallCheck(this, Scout9Test);
+    /**
+     * @param {string} command
+     * @returns {Promise<void>}
+     */
+    spirits._classPrivateMethodInitSpec(this, _loadCommand);
+    spirits._classPrivateMethodInitSpec(this, _loadApp);
     /**
      * @type {import('@scout9/app').Customer}
      */
@@ -42605,64 +42685,62 @@ var Scout9Test = /*#__PURE__*/function () {
      * @type {import('@scout9/app').ConversationContext}
      */
     spirits._defineProperty(this, "context", void 0);
-    /**
-     * @private
-     * @type {import('@scout9/app').Scout9ProjectBuildConfig | null}
-     */
-    spirits._defineProperty(this, "_project", null);
-    /**
-     * @private
-     * @type {import('@scout9/app').WorkflowFunction | null}
-     */
-    spirits._defineProperty(this, "_app", null);
-    /**
-     * @private
-     * @type {import('@scout9/admin').Scout9Api | null}
-     */
-    spirits._defineProperty(this, "_api", null);
-    /**
-     * @private
-     */
-    spirits._defineProperty(this, "_cwd", void 0);
-    /**
-     * @private
-     */
-    spirits._defineProperty(this, "_src", void 0);
-    /**
-     * @private
-     */
-    spirits._defineProperty(this, "_mode", void 0);
-    /**
-     * @private
-     */
-    spirits._defineProperty(this, "_loaded", void 0);
-    /**
-     * @private
-     */
-    spirits._defineProperty(this, "_personaId", void 0);
-    /**
-     * @private
-     */
+    spirits._classPrivateFieldInitSpec(this, _project, {
+      writable: true,
+      value: null
+    });
+    spirits._classPrivateFieldInitSpec(this, _app, {
+      writable: true,
+      value: null
+    });
+    spirits._classPrivateFieldInitSpec(this, _command, {
+      writable: true,
+      value: null
+    });
+    spirits._classPrivateFieldInitSpec(this, _api, {
+      writable: true,
+      value: null
+    });
+    spirits._classPrivateFieldInitSpec(this, _cwd, {
+      writable: true,
+      value: void 0
+    });
+    spirits._classPrivateFieldInitSpec(this, _src, {
+      writable: true,
+      value: void 0
+    });
+    spirits._classPrivateFieldInitSpec(this, _mode, {
+      writable: true,
+      value: void 0
+    });
+    spirits._classPrivateFieldInitSpec(this, _loaded, {
+      writable: true,
+      value: void 0
+    });
+    spirits._classPrivateFieldInitSpec(this, _personaId, {
+      writable: true,
+      value: void 0
+    });
     spirits._classPrivateFieldInitSpec(this, _defaultLog, {
       writable: true,
       value: void 0
     });
     this.messages = [];
-    this._cwd = cwd;
-    this._src = src;
-    this._mode = mode;
+    spirits._classPrivateFieldSet(this, _cwd, cwd);
+    spirits._classPrivateFieldSet(this, _src, src);
+    spirits._classPrivateFieldSet(this, _mode, mode);
     this.context = spirits._objectSpread2(spirits._objectSpread2({}, context || {}), {}, {
       __no_cache: true
     });
     this.conversation = conversation;
     if (api) {
-      this._api = api;
+      spirits._classPrivateFieldSet(this, _api, api);
     }
     if (app) {
-      this._app = app;
+      spirits._classPrivateFieldSet(this, _app, app);
     }
     if (project) {
-      this._project = project;
+      spirits._classPrivateFieldSet(this, _project, project);
     }
     if (!customer) {
       customer = {
@@ -42677,7 +42755,7 @@ var Scout9Test = /*#__PURE__*/function () {
     }
     this.customer = customer;
     this.context.customer = customer;
-    this._personaId = persona;
+    spirits._classPrivateFieldSet(this, _personaId, persona);
     spirits._classPrivateFieldSet(this, _defaultLog, !!log);
   }
 
@@ -42698,57 +42776,65 @@ var Scout9Test = /*#__PURE__*/function () {
           while (1) switch (_context.prev = _context.next) {
             case 0:
               override = _args.length > 0 && _args[0] !== undefined ? _args[0] : false;
-              if (!(override || !this._app)) {
-                _context.next = 5;
+              if (!(override || !spirits._classPrivateFieldGet(this, _app))) {
+                _context.next = 9;
                 break;
               }
-              _context.next = 4;
-              return this._loadApp();
-            case 4:
-              this._app = _context.sent;
-            case 5:
-              if (!(override || !this._project)) {
-                _context.next = 9;
+              _context.t0 = spirits._classPrivateFieldSet;
+              _context.t1 = this;
+              _context.t2 = _app;
+              _context.next = 7;
+              return spirits._classPrivateMethodGet(this, _loadApp, _loadApp2).call(this);
+            case 7:
+              _context.t3 = _context.sent;
+              (0, _context.t0)(_context.t1, _context.t2, _context.t3);
+            case 9:
+              if (!(override || !spirits._classPrivateFieldGet(this, _project))) {
+                _context.next = 17;
                 break;
               }
-              _context.next = 8;
+              _context.t4 = spirits._classPrivateFieldSet;
+              _context.t5 = this;
+              _context.t6 = _project;
+              _context.next = 15;
               return loadConfig({
-                cwd: this._cwd,
-                src: this._src,
-                mode: this._mode
+                cwd: spirits._classPrivateFieldGet(this, _cwd),
+                src: spirits._classPrivateFieldGet(this, _src),
+                mode: spirits._classPrivateFieldGet(this, _mode)
               });
-            case 8:
-              this._project = _context.sent;
-            case 9:
-              if (override || !this._api) {
-                this._api = new build.Scout9Api(new build.Configuration({
+            case 15:
+              _context.t7 = _context.sent;
+              (0, _context.t4)(_context.t5, _context.t6, _context.t7);
+            case 17:
+              if (override || !spirits._classPrivateFieldGet(this, _api)) {
+                spirits._classPrivateFieldSet(this, _api, new build.Scout9Api(new build.Configuration({
                   apiKey: process.env.SCOUT9_API_KEY
-                }));
+                })));
               }
-              if (this._personaId) {
-                _context.next = 14;
+              if (spirits._classPrivateFieldGet(this, _personaId)) {
+                _context.next = 22;
                 break;
               }
-              this._personaId = (_ref2 = this._project.persona || this._project.agents) === null || _ref2 === void 0 || (_ref2 = _ref2[0]) === null || _ref2 === void 0 ? void 0 : _ref2.id;
-              if (this._personaId) {
-                _context.next = 14;
+              spirits._classPrivateFieldSet(this, _personaId, (_ref2 = spirits._classPrivateFieldGet(this, _project).persona || spirits._classPrivateFieldGet(this, _project).agents) === null || _ref2 === void 0 || (_ref2 = _ref2[0]) === null || _ref2 === void 0 ? void 0 : _ref2.id);
+              if (spirits._classPrivateFieldGet(this, _personaId)) {
+                _context.next = 22;
                 break;
               }
               throw new Error("No persona found in config, please specify a persona id");
-            case 14:
-              this.conversation.$agent = this._personaId;
-              this.persona = (this._project.persona || this._project.agents).find(function (p) {
-                return p.id === _this._personaId;
+            case 22:
+              this.conversation.$agent = spirits._classPrivateFieldGet(this, _personaId);
+              this.persona = (spirits._classPrivateFieldGet(this, _project).persona || spirits._classPrivateFieldGet(this, _project).agents).find(function (p) {
+                return p.id === spirits._classPrivateFieldGet(_this, _personaId);
               });
               if (this.persona) {
-                _context.next = 18;
+                _context.next = 26;
                 break;
               }
-              throw new Error("Could not find persona with id: ".concat(this._personaId, ", ensure your project is sync'd by running \"scout9 sync\" or you are using the correct persona id"));
-            case 18:
+              throw new Error("Could not find persona with id: ".concat(spirits._classPrivateFieldGet(this, _personaId), ", ensure your project is sync'd by running \"scout9 sync\" or you are using the correct persona id"));
+            case 26:
               this.context.agent = this.persona;
-              this._loaded = true;
-            case 20:
+              spirits._classPrivateFieldSet(this, _loaded, true);
+            case 28:
             case "end":
               return _context.stop();
           }
@@ -42766,10 +42852,10 @@ var Scout9Test = /*#__PURE__*/function () {
   }, {
     key: "teardown",
     value: function teardown() {
-      this._loaded = false;
-      this._api = null;
-      this._project = null;
-      this._app = null;
+      spirits._classPrivateFieldSet(this, _loaded, false);
+      spirits._classPrivateFieldSet(this, _api, null);
+      spirits._classPrivateFieldSet(this, _project, null);
+      spirits._classPrivateFieldSet(this, _app, null);
     }
 
     /**
@@ -42784,6 +42870,8 @@ var Scout9Test = /*#__PURE__*/function () {
       var _send = spirits._asyncToGenerator( /*#__PURE__*/spirits._regeneratorRuntime().mark(function _callee4(message) {
         var _this2 = this;
         var progress,
+          target,
+          commandToSwitchTo,
           defaultProgressLogger,
           progressInput,
           _message,
@@ -42795,13 +42883,34 @@ var Scout9Test = /*#__PURE__*/function () {
           while (1) switch (_context4.prev = _context4.next) {
             case 0:
               progress = _args4.length > 1 && _args4[1] !== undefined ? _args4[1] : spirits._classPrivateFieldGet(this, _defaultLog);
-              if (this._loaded) {
+              if (spirits._classPrivateFieldGet(this, _loaded)) {
                 _context4.next = 4;
                 break;
               }
               _context4.next = 4;
               return this.load();
             case 4:
+              // Check if it's a command
+              target = message.toLowerCase().trim();
+              commandToSwitchTo = spirits._classPrivateFieldGet(this, _project).commands.find(function (command) {
+                return command.entity === target;
+              });
+              if (!commandToSwitchTo) {
+                _context4.next = 15;
+                break;
+              }
+              _context4.t0 = spirits._classPrivateFieldSet;
+              _context4.t1 = this;
+              _context4.t2 = _command;
+              _context4.next = 12;
+              return spirits._classPrivateMethodGet(this, _loadCommand, _loadCommand2).call(this, commandToSwitchTo.entity);
+            case 12:
+              _context4.t3 = _context4.sent;
+              (0, _context4.t0)(_context4.t1, _context4.t2, _context4.t3);
+              Object.assign(this.context, {
+                __command: commandToSwitchTo.entity
+              });
+            case 15:
               defaultProgressLogger = function defaultProgressLogger(message) {
                 var level = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 'info';
                 var type = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : '';
@@ -42820,18 +42929,19 @@ var Scout9Test = /*#__PURE__*/function () {
 
               /**
                * @type {import('@scout9/app').Message}
+               * If we are switching to a command instance, we would want the first message to be system invoke
                */
               _message = {
                 id: 'user_mock_' + Math.random().toString(36).slice(2, 11),
-                role: 'customer',
-                content: message,
+                role: commandToSwitchTo ? 'system' : 'customer',
+                content: commandToSwitchTo ? "Start by gathering/asking the user for relevant \"".concat(commandToSwitchTo.entity, "\" parameters") : message,
                 time: new Date().toISOString()
               };
               this.messages.push(_message);
-              _context4.next = 11;
+              _context4.next = 22;
               return spirits.Spirits.customer({
                 customer: this.customer,
-                config: this._project,
+                config: spirits._classPrivateFieldGet(this, _project),
                 parser: function () {
                   var _parser = spirits._asyncToGenerator( /*#__PURE__*/spirits._regeneratorRuntime().mark(function _callee2(_msg, _lng) {
                     var detectableEntities;
@@ -42839,11 +42949,11 @@ var Scout9Test = /*#__PURE__*/function () {
                       while (1) switch (_context2.prev = _context2.next) {
                         case 0:
                           // @TODO can't do this for HUGE data sets
-                          detectableEntities = _this2._project.entities.filter(function (e) {
+                          detectableEntities = spirits._classPrivateFieldGet(_this2, _project).entities.filter(function (e) {
                             var _e$training, _e$definitions;
                             return ((_e$training = e.training) === null || _e$training === void 0 ? void 0 : _e$training.length) > 0 && ((_e$definitions = e.definitions) === null || _e$definitions === void 0 ? void 0 : _e$definitions.length) > 0;
                           });
-                          return _context2.abrupt("return", _this2._api.parse({
+                          return _context2.abrupt("return", spirits._classPrivateFieldGet(_this2, _api).parse({
                             message: _msg,
                             language: _lng,
                             entities: detectableEntities
@@ -42863,13 +42973,20 @@ var Scout9Test = /*#__PURE__*/function () {
                 }(),
                 workflow: function () {
                   var _workflow = spirits._asyncToGenerator( /*#__PURE__*/spirits._regeneratorRuntime().mark(function _callee3(event) {
+                    var _this2$conversation$$;
                     return spirits._regeneratorRuntime().wrap(function _callee3$(_context3) {
                       while (1) switch (_context3.prev = _context3.next) {
                         case 0:
                           globalThis.SCOUT9 = spirits._objectSpread2(spirits._objectSpread2({}, event), {}, {
-                            $convo: _this2.conversation.$id
+                            $convo: (_this2$conversation$$ = _this2.conversation.$id) !== null && _this2$conversation$$ !== void 0 ? _this2$conversation$$ : 'test_convo'
                           });
-                          return _context3.abrupt("return", _this2._app(event));
+                          return _context3.abrupt("return", (spirits._classPrivateFieldGet(_this2, _command) ? spirits._classPrivateFieldGet(_this2, _command) : spirits._classPrivateFieldGet(_this2, _app))(event).then(function (response) {
+                            if ('toJSON' in response) {
+                              return response.toJSON();
+                            } else {
+                              return response;
+                            }
+                          }).then(macros.WorkflowResponseSchema.parse));
                         case 2:
                         case "end":
                           return _context3.stop();
@@ -42882,7 +42999,7 @@ var Scout9Test = /*#__PURE__*/function () {
                   return workflow;
                 }(),
                 generator: function generator(request) {
-                  return _this2._api.generate(request).then(function (_res) {
+                  return spirits._classPrivateFieldGet(_this2, _api).generate(request).then(function (_res) {
                     return _res.data;
                   });
                 },
@@ -42895,7 +43012,7 @@ var Scout9Test = /*#__PURE__*/function () {
                 messages: this.messages,
                 conversation: this.conversation
               });
-            case 11:
+            case 22:
               result = _context4.sent;
               this.context = result.context.after;
               this.messages = result.messages.after;
@@ -42923,7 +43040,7 @@ var Scout9Test = /*#__PURE__*/function () {
                 console.error("Message not found in result.messages.after", result.message.after.id);
               }
               return _context4.abrupt("return", result);
-            case 18:
+            case 29:
             case "end":
               return _context4.stop();
           }
@@ -42951,16 +43068,16 @@ var Scout9Test = /*#__PURE__*/function () {
           while (1) switch (_context5.prev = _context5.next) {
             case 0:
               language = _args5.length > 1 && _args5[1] !== undefined ? _args5[1] : 'en';
-              if (this._project) {
+              if (spirits._classPrivateFieldGet(this, _project)) {
                 _context5.next = 3;
                 break;
               }
               throw new Error("Config is not defined");
             case 3:
-              return _context5.abrupt("return", this._api.parse({
+              return _context5.abrupt("return", spirits._classPrivateFieldGet(this, _api).parse({
                 message: message,
                 language: language,
-                entities: this._project.entities
+                entities: spirits._classPrivateFieldGet(this, _project).entities
               }).then(function (_res) {
                 return _res.data;
               }));
@@ -42992,7 +43109,7 @@ var Scout9Test = /*#__PURE__*/function () {
           while (1) switch (_context6.prev = _context6.next) {
             case 0:
               event = _args6.length > 1 && _args6[1] !== undefined ? _args6[1] : {};
-              if (this._app) {
+              if (spirits._classPrivateFieldGet(this, _app)) {
                 _context6.next = 3;
                 break;
               }
@@ -43001,7 +43118,7 @@ var Scout9Test = /*#__PURE__*/function () {
               if (event.hasOwnProperty('message')) {
                 console.warn("WARNING: inserting a \"event.message\" will overwrite your \"message\" argument");
               }
-              return _context6.abrupt("return", this._app(spirits._objectSpread2(spirits._objectSpread2({}, createMockWorkflowEvent(message)), event)));
+              return _context6.abrupt("return", spirits._classPrivateFieldGet(this, _app).call(this, spirits._objectSpread2(spirits._objectSpread2({}, createMockWorkflowEvent(message)), event)));
             case 5:
             case "end":
               return _context6.stop();
@@ -43031,20 +43148,20 @@ var Scout9Test = /*#__PURE__*/function () {
         return spirits._regeneratorRuntime().wrap(function _callee7$(_context7) {
           while (1) switch (_context7.prev = _context7.next) {
             case 0:
-              _ref3$personaId = _ref3.personaId, personaId = _ref3$personaId === void 0 ? this._personaId : _ref3$personaId, _ref3$conversation = _ref3.conversation, conversation = _ref3$conversation === void 0 ? {} : _ref3$conversation, _ref3$messages = _ref3.messages, messages = _ref3$messages === void 0 ? this.messages : _ref3$messages, _ref3$context = _ref3.context, context = _ref3$context === void 0 ? this.context : _ref3$context;
-              if (this._api) {
+              _ref3$personaId = _ref3.personaId, personaId = _ref3$personaId === void 0 ? spirits._classPrivateFieldGet(this, _personaId) : _ref3$personaId, _ref3$conversation = _ref3.conversation, conversation = _ref3$conversation === void 0 ? {} : _ref3$conversation, _ref3$messages = _ref3.messages, messages = _ref3$messages === void 0 ? this.messages : _ref3$messages, _ref3$context = _ref3.context, context = _ref3$context === void 0 ? this.context : _ref3$context;
+              if (spirits._classPrivateFieldGet(this, _api)) {
                 _context7.next = 3;
                 break;
               }
               throw new Error("Scout9 API is not loaded or found - make sure to run \".load()\" before calling \".generate()\"");
             case 3:
-              if (this._project) {
+              if (spirits._classPrivateFieldGet(this, _project)) {
                 _context7.next = 5;
                 break;
               }
               throw new Error("Config is not defined - make sure to run \".load()\" before calling \".generate()\"");
             case 5:
-              persona = (this._project.persona || this._project.agents).find(function (p) {
+              persona = (spirits._classPrivateFieldGet(this, _project).persona || spirits._classPrivateFieldGet(this, _project).agents).find(function (p) {
                 return p.id === personaId;
               });
               if (persona) {
@@ -43053,7 +43170,7 @@ var Scout9Test = /*#__PURE__*/function () {
               }
               throw new Error("Could not find persona with id: ".concat(personaId, ", ensure your project is sync'd by running \"scout9 sync\""));
             case 8:
-              return _context7.abrupt("return", this._api.generate({
+              return _context7.abrupt("return", spirits._classPrivateFieldGet(this, _api).generate({
                 convo: spirits._objectSpread2(spirits._objectSpread2({
                   $customer: this.customer.id,
                   environment: this.conversation.environment,
@@ -43064,8 +43181,8 @@ var Scout9Test = /*#__PURE__*/function () {
                 messages: messages,
                 context: context,
                 persona: persona,
-                llm: this._project.llm,
-                pmt: this._project.pmt
+                llm: spirits._classPrivateFieldGet(this, _project).llm,
+                pmt: spirits._classPrivateFieldGet(this, _project).pmt
               }).then(function (_res) {
                 return _res.data;
               }));
@@ -43089,52 +43206,99 @@ var Scout9Test = /*#__PURE__*/function () {
     set: function set(ctx) {
       this.context = spirits._objectSpread2(spirits._objectSpread2({}, this.context), ctx);
     }
-
-    /**
-     * @private
-     */
-  }, {
-    key: "_loadApp",
-    value: (function () {
-      var _loadApp2 = spirits._asyncToGenerator( /*#__PURE__*/spirits._regeneratorRuntime().mark(function _callee8() {
-        var paths, _paths, appFilePath;
-        return spirits._regeneratorRuntime().wrap(function _callee8$(_context8) {
-          while (1) switch (_context8.prev = _context8.next) {
-            case 0:
-              paths = globSync("".concat(this._src, "/app.{ts,cjs,mjs,js}"), {
-                cwd: this._cwd,
-                absolute: true
-              });
-              if (!(paths.length === 0)) {
-                _context8.next = 5;
-                break;
-              }
-              throw new Error("Missing main project entry file ".concat(this._src, "/app.{js|ts|cjs|mjs}"));
-            case 5:
-              if (!(paths.length > 1)) {
-                _context8.next = 7;
-                break;
-              }
-              throw new Error("Multiple main project entry files found ".concat(this._src, "/app.{js|ts|cjs|mjs}"));
-            case 7:
-              _paths = spirits._slicedToArray(paths, 1), appFilePath = _paths[0];
-              return _context8.abrupt("return", requireProjectFile(appFilePath).then(function (mod) {
-                return mod["default"];
-              }));
-            case 9:
-            case "end":
-              return _context8.stop();
-          }
-        }, _callee8, this);
-      }));
-      function _loadApp() {
-        return _loadApp2.apply(this, arguments);
-      }
-      return _loadApp;
-    }())
   }]);
   return Scout9Test;
 }();
+function _loadApp2() {
+  return _loadApp3.apply(this, arguments);
+}
+function _loadApp3() {
+  _loadApp3 = spirits._asyncToGenerator( /*#__PURE__*/spirits._regeneratorRuntime().mark(function _callee8() {
+    var paths, _paths, appFilePath;
+    return spirits._regeneratorRuntime().wrap(function _callee8$(_context8) {
+      while (1) switch (_context8.prev = _context8.next) {
+        case 0:
+          paths = globSync("".concat(spirits._classPrivateFieldGet(this, _src), "/app.{ts,cjs,mjs,js}"), {
+            cwd: spirits._classPrivateFieldGet(this, _cwd),
+            absolute: true
+          });
+          if (!(paths.length === 0)) {
+            _context8.next = 5;
+            break;
+          }
+          throw new Error("Missing main project entry file ".concat(spirits._classPrivateFieldGet(this, _src), "/app.{js|ts|cjs|mjs}"));
+        case 5:
+          if (!(paths.length > 1)) {
+            _context8.next = 7;
+            break;
+          }
+          throw new Error("Multiple main project entry files found ".concat(spirits._classPrivateFieldGet(this, _src), "/app.{js|ts|cjs|mjs}"));
+        case 7:
+          _paths = spirits._slicedToArray(paths, 1), appFilePath = _paths[0];
+          return _context8.abrupt("return", requireProjectFile(appFilePath).then(function (mod) {
+            return mod["default"];
+          }));
+        case 9:
+        case "end":
+          return _context8.stop();
+      }
+    }, _callee8, this);
+  }));
+  return _loadApp3.apply(this, arguments);
+}
+function _loadCommand2(_x8) {
+  return _loadCommand3.apply(this, arguments);
+}
+function _loadCommand3() {
+  _loadCommand3 = spirits._asyncToGenerator( /*#__PURE__*/spirits._regeneratorRuntime().mark(function _callee9(command) {
+    var commandsDir, commandConfig, commandFilePath, mod;
+    return spirits._regeneratorRuntime().wrap(function _callee9$(_context9) {
+      while (1) switch (_context9.prev = _context9.next) {
+        case 0:
+          if (spirits._classPrivateFieldGet(this, _project)) {
+            _context9.next = 2;
+            break;
+          }
+          throw new Error("Must load #project before running #loadCommand");
+        case 2:
+          commandsDir = path$2.resolve(spirits._classPrivateFieldGet(this, _src), "./commands");
+          commandConfig = spirits._classPrivateFieldGet(this, _project).commands.find(function (command) {
+            return command.entity === command || command.path === command;
+          });
+          if (commandConfig) {
+            _context9.next = 6;
+            break;
+          }
+          throw new Error("Unable to find command \"".concat(command, "\""));
+        case 6:
+          commandFilePath = path$2.resolve(commandsDir, commandConfig.path);
+          _context9.prev = 7;
+          _context9.next = 10;
+          return (function (t) { return Promise.resolve().then(function () { return /*#__PURE__*/_interopNamespace(require(t)); }); })(commandFilePath);
+        case 10:
+          mod = _context9.sent;
+          _context9.next = 16;
+          break;
+        case 13:
+          _context9.prev = 13;
+          _context9.t0 = _context9["catch"](7);
+          throw new Error("Unable to resolve command ".concat(command, " at ").concat(commandFilePath));
+        case 16:
+          if (!(!mod || !mod["default"])) {
+            _context9.next = 18;
+            break;
+          }
+          throw new Error("Unable to run command ".concat(command, " at ").concat(commandFilePath, " - must return a default function that returns a WorkflowEvent payload"));
+        case 18:
+          return _context9.abrupt("return", mod["default"]);
+        case 19:
+        case "end":
+          return _context9.stop();
+      }
+    }, _callee9, this, [[7, 13]]);
+  }));
+  return _loadCommand3.apply(this, arguments);
+}
 
 exports.$ = $$1;
 exports.MacroGlobals = MacroGlobals;