@sprucelabs/spruce-conversation-plugin 56.1.5 → 56.1.7

package/build/__tests__/behavioral/TestingAConversation.test.d.ts

@@ -1,3 +1,4 @@
+import { SkillContext } from '@sprucelabs/spruce-skill-utils';
 import AbstractConversationTest from '../../tests/AbstractConversationTest';
 export default class TestingAConversationTest extends AbstractConversationTest {
     protected static afterEach(): Promise<void>;
@@ -6,5 +7,8 @@ export default class TestingAConversationTest extends AbstractConversationTest {
     protected static bootsInTestModeWithProperAction(): Promise<void>;
     protected static throwsWithBadScript(): Promise<void>;
     protected static throwsWithThrowsInScript(): Promise<void>;
+    protected static scriptTesterGetsContext(context: SkillContext): Promise<void>;
+    private static getScriptTester;
     private static bootAndGetConversationFeature;
+    private static getConversationFeature;
 }

package/build/__tests__/behavioral/TestingAConversation.test.js

@@ -9,6 +9,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+const mercury_client_1 = require("@sprucelabs/mercury-client");
 const test_utils_1 = require("@sprucelabs/test-utils");
 const test_utils_2 = require("@sprucelabs/test-utils");
 const AbstractConversationTest_1 = __importDefault(require("../../tests/AbstractConversationTest"));
@@ -49,11 +50,46 @@ class TestingAConversationTest extends AbstractConversationTest_1.default {
         const err = await test_utils_1.assert.doesThrowAsync(() => skill.execute());
         test_utils_2.errorAssert.assertError(err, 'CONVERSATION_ABORTED');
     }
+    static async scriptTesterGetsContext(context) {
+        this.cwd = this.resolveTestPath('skill-with-one-topic');
+        mercury_client_1.MercuryClientFactory.setIsTestMode(true);
+        process.env.ACTION = 'test.conversation';
+        process.env.FIRST_MESSAGE = 'hey there!';
+        const skill = await this.Skill();
+        const getContext = () => context;
+        //@ts-ignore
+        skill.getContext = getContext;
+        void this.bootSkill({ skill });
+        await this.wait(100);
+        const scriptTester = await this.getScriptTester(skill);
+        //@ts-ignore
+        scriptTester.writeHandler = () => { };
+        //@ts-ignore
+        const player = scriptTester.player;
+        test_utils_1.assert.isTruthy(player);
+        //@ts-ignore
+        test_utils_1.assert.isEqualDeep(player.getContext(), context);
+        await skill.kill();
+    }
+    static async getScriptTester(skill) {
+        const conversation = this.getConversationFeature(skill);
+        //@ts-ignore
+        while (!conversation.tester) {
+            await this.wait(100);
+        }
+        //@ts-ignore
+        const scriptTester = conversation.tester;
+        test_utils_1.assert.isTruthy(scriptTester);
+        return scriptTester;
+    }
     static async bootAndGetConversationFeature(options) {
         const { skill } = await this.bootSkill(options);
-        const conversation = skill.getFeatureByCode('conversation');
+        const conversation = this.getConversationFeature(skill);
         return conversation;
     }
+    static getConversationFeature(skill) {
+        return skill.getFeatureByCode('conversation');
+    }
 }
 __decorate([
     (0, test_utils_1.test)()
@@ -67,4 +103,8 @@ __decorate([
 __decorate([
     (0, test_utils_1.test)()
 ], TestingAConversationTest, "throwsWithThrowsInScript", null);
+__decorate([
+    (0, test_utils_1.test)('can get context 1', { hello: 'world' }),
+    (0, test_utils_1.test)('can get context 2', { what: 'the!?' })
+], TestingAConversationTest, "scriptTesterGetsContext", null);
 exports.default = TestingAConversationTest;

package/build/__tests__/implementation/ConversationCoordinator.test.d.ts

@@ -1,3 +1,4 @@
+import { SkillContext } from '@sprucelabs/spruce-skill-utils';
 import AbstractConversationTest from '../../tests/AbstractConversationTest';
 export default class TopicCoordinatorTest extends AbstractConversationTest {
     private static coordinator;
@@ -13,5 +14,5 @@ export default class TopicCoordinatorTest extends AbstractConversationTest {
     protected static playsScriptWhenTopicIsSelected(): Promise<void>;
     protected static canHandlePromptsInScript(): Promise<void>;
     protected static canPlaceMixedScriptsUntilTheEndAndStartsOver(): Promise<void>;
-    protected static passesThroughContextGetter(context: Record<string, any>): Promise<void>;
+    protected static passesThroughContextGetter(context: SkillContext): Promise<void>;
 }

package/build/__tests__/implementation/ConversationCoordinator.test.js

@@ -9,6 +9,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+const spruce_test_fixtures_1 = require("@sprucelabs/spruce-test-fixtures");
 const test_utils_1 = require("@sprucelabs/test-utils");
 const test_utils_2 = require("@sprucelabs/test-utils");
 const ConversationCoordinator_1 = require("../../conversations/ConversationCoordinator");
@@ -124,7 +125,9 @@ class TopicCoordinatorTest extends AbstractConversationTest_1.default {
     }
 }
 TopicCoordinatorTest.sentMessages = [];
-TopicCoordinatorTest.skillContext = {};
+TopicCoordinatorTest.skillContext = {
+    client: spruce_test_fixtures_1.fake.getClient(),
+};
 __decorate([
     (0, test_utils_1.test)()
 ], TopicCoordinatorTest, "canCreateTopicCoordinator", null);

package/build/__tests__/implementation/ScriptTester.test.d.ts

@@ -1,12 +1,12 @@
 import AbstractConversationTest from '../../tests/AbstractConversationTest';
 import { Script } from '../../types/conversation.types';
 export default class ScriptTesterTest extends AbstractConversationTest {
+    private static readonly basicBookingScript;
     protected static throwsWithoutScript(): Promise<void>;
     protected static acceptsSimpleScript(): Promise<void>;
     protected static callingGoDoesntCrash(): Promise<void>;
     protected static cantHandleMessageBeforeStartup(): Promise<void>;
     protected static selectingBadScriptToStartThrows(): Promise<void>;
-    private static readonly basicBookingScript;
     protected static asksWhichScriptYouWantToStartWithWhenThereIsMoreThanOne(): Promise<void>;
     protected static playsSimpleScript(script: Script): Promise<void>;
     protected static canSendInputToThePlayer(answer: string): Promise<void>;
@@ -15,4 +15,5 @@ export default class ScriptTesterTest extends AbstractConversationTest {
     protected static promptsToStartAgainAfterDone(): Promise<void>;
     protected static messagesAboutTransitionResponseTopicChanger(): Promise<void>;
     protected static messagesAboutTransitionResponseWithRepairs(): Promise<void>;
+    private static Tester;
 }

package/build/__tests__/implementation/ScriptTester.test.js

@@ -45,7 +45,7 @@ class ScriptTesterTest extends AbstractConversationTest_1.default {
         });
     }
     static async acceptsSimpleScript() {
-        const tester = await ScriptTester_1.default.Tester({
+        const tester = await ScriptTesterTest.Tester({
             topics: [
                 {
                     utterances: [],
@@ -58,7 +58,7 @@ class ScriptTesterTest extends AbstractConversationTest_1.default {
         test_utils_1.assert.isTruthy(tester);
     }
     static async callingGoDoesntCrash() {
-        const tester = await ScriptTester_1.default.Tester({
+        const tester = await this.Tester({
             topics: [
                 {
                     utterances: [],
@@ -74,7 +74,7 @@ class ScriptTesterTest extends AbstractConversationTest_1.default {
         void tester.go();
     }
     static async cantHandleMessageBeforeStartup() {
-        const tester = await ScriptTester_1.default.Tester({
+        const tester = await this.Tester({
             topics: [
                 {
                     utterances: [],
@@ -91,7 +91,7 @@ class ScriptTesterTest extends AbstractConversationTest_1.default {
         test_utils_2.errorAssert.assertError(err, 'TESTER_NOT_STARTED');
     }
     static async selectingBadScriptToStartThrows() {
-        const tester = await ScriptTester_1.default.Tester({
+        const tester = await this.Tester({
             topics: this.basicBookingScript,
             selectPromptHandler: async () => {
                 return 'oeuou';
@@ -108,7 +108,7 @@ class ScriptTesterTest extends AbstractConversationTest_1.default {
     static async asksWhichScriptYouWantToStartWithWhenThereIsMoreThanOne() {
         let choices;
         const writes = [];
-        const tester = await ScriptTester_1.default.Tester({
+        const tester = await this.Tester({
             topics: this.basicBookingScript,
             selectPromptHandler: async (message) => {
                 var _a;
@@ -136,7 +136,7 @@ class ScriptTesterTest extends AbstractConversationTest_1.default {
     }
     static async playsSimpleScript(script) {
         const writes = [];
-        const tester = await ScriptTester_1.default.Tester({
+        const tester = await this.Tester({
             shouldPlayReplayAfterFinish: false,
             lineDelay: 0,
             topics: [{ key: 'test', label: 'Testing', script, utterances: [] }],
@@ -159,7 +159,7 @@ class ScriptTesterTest extends AbstractConversationTest_1.default {
     }
     static async canSendInputToThePlayer(answer) {
         const writes = [];
-        const tester = await ScriptTester_1.default.Tester({
+        const tester = await this.Tester({
             shouldPlayReplayAfterFinish: false,
             topics: [
                 {
@@ -201,7 +201,7 @@ class ScriptTesterTest extends AbstractConversationTest_1.default {
         const writes = [];
         const promptWrites = [];
         let promptResolve;
-        const tester = await ScriptTester_1.default.Tester({
+        const tester = await this.Tester({
             lineDelay: 0,
             topics: [
                 {
@@ -238,7 +238,7 @@ class ScriptTesterTest extends AbstractConversationTest_1.default {
     static async showsConfidenceRatingBasedOnFirstMesageSent() {
         const writes = [];
         const promptWrites = [];
-        const tester = await ScriptTester_1.default.Tester({
+        const tester = await this.Tester({
             lineDelay: 0,
             topics: [
                 {
@@ -264,7 +264,7 @@ class ScriptTesterTest extends AbstractConversationTest_1.default {
     static async promptsToStartAgainAfterDone() {
         const writes = [];
         let promptHitCount = 0;
-        const tester = await ScriptTester_1.default.Tester({
+        const tester = await this.Tester({
             lineDelay: 0,
             topics: [
                 {
@@ -303,7 +303,7 @@ class ScriptTesterTest extends AbstractConversationTest_1.default {
     static async messagesAboutTransitionResponseTopicChanger() {
         const writes = [];
         let promptHitCount = 0;
-        const tester = await ScriptTester_1.default.Tester({
+        const tester = await this.Tester({
             lineDelay: 0,
             topics: [
                 {
@@ -353,7 +353,7 @@ class ScriptTesterTest extends AbstractConversationTest_1.default {
     static async messagesAboutTransitionResponseWithRepairs() {
         const writes = [];
         let promptHitCount = 0;
-        const tester = await ScriptTester_1.default.Tester({
+        const tester = await this.Tester({
             lineDelay: 0,
             topics: [
                 {
@@ -400,6 +400,9 @@ class ScriptTesterTest extends AbstractConversationTest_1.default {
             ScriptTester_1.END_OF_LINE,
         ]);
     }
+    static async Tester(options) {
+        return await ScriptTester_1.default.Tester(Object.assign({ getContext: () => ({}), topics: [] }, options));
+    }
 }
 ScriptTesterTest.basicBookingScript = [
     {

package/build/__tests__/implementation/TopicScriptPlayer.test.d.ts

@@ -1,3 +1,4 @@
+import { SkillContext } from '@sprucelabs/spruce-skill-utils';
 import AbstractConversationTest from '../../tests/AbstractConversationTest';
 export default class TopicScriptPlayerTest extends AbstractConversationTest {
     protected static throwsWhenRequiredOptionsNotSent(): Promise<void>;
@@ -16,7 +17,7 @@ export default class TopicScriptPlayerTest extends AbstractConversationTest {
     protected static retainsStateBetweenScriptLines(): Promise<void>;
     protected static retainsStateBetweenMessages(): Promise<void>;
     protected static alwaysEndsWithRedirectToDiscovery(): Promise<void>;
-    protected static skillContextAvailableOnScriptLine(context: Record<string, any>): Promise<void>;
+    protected static skillContextAvailableOnScriptLine(context: SkillContext): Promise<void>;
     private static Player;
     private static sendMessage;
 }

package/build/__tests__/testDirsAndFiles/skill-with-one-topic/build/.spruce/events/listeners.d.ts

@@ -0,0 +1,2 @@
+declare const _default: never[];
+export default _default;

package/build/__tests__/testDirsAndFiles/skill-with-one-topic/build/.spruce/events/listeners.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = [];

package/build/__tests__/testDirsAndFiles/skill-with-one-topic/build/conversations/bookAppointment.topic.d.ts

@@ -0,0 +1,3 @@
+import { TopicDefinition } from '../../../../../types/conversation.types';
+declare const topicDefinition: TopicDefinition;
+export default topicDefinition;

package/build/__tests__/testDirsAndFiles/skill-with-one-topic/build/conversations/bookAppointment.topic.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const topicDefinition = {
+    label: 'book appointment',
+    utterances: ['book appointment', 'Can i book my appointment?', 'book'],
+    script: ['Sweet, lets book!', 'Lemme find your appointment!'],
+};
+exports.default = topicDefinition;

package/build/conversations/ConversationCoordinator.d.ts

@@ -29,6 +29,6 @@ export declare class ConversationCoordinator {
         getContext: GetContext;
         Class?: new (...args: any[]) => ConversationCoordinator;
     }): Promise<ConversationCoordinator>;
-    handleMessage(message: Message, topic?: string): Promise<MessageResponsePayload | void>;
+    handleMessage(message: Message, topic?: string): Promise<MessageResponsePayload | null>;
 }
 export {};

package/build/conversations/ConversationCoordinator.js

@@ -78,6 +78,7 @@ class ConversationCoordinator {
         if (results) {
             return results;
         }
+        return null;
     }
 }
 exports.ConversationCoordinator = ConversationCoordinator;

package/build/esm/__tests__/behavioral/TestingAConversation.test.d.ts

@@ -1,3 +1,4 @@
+import { SkillContext } from '@sprucelabs/spruce-skill-utils';
 import AbstractConversationTest from '../../tests/AbstractConversationTest';
 export default class TestingAConversationTest extends AbstractConversationTest {
     protected static afterEach(): Promise<void>;
@@ -6,5 +7,8 @@ export default class TestingAConversationTest extends AbstractConversationTest {
     protected static bootsInTestModeWithProperAction(): Promise<void>;
     protected static throwsWithBadScript(): Promise<void>;
     protected static throwsWithThrowsInScript(): Promise<void>;
+    protected static scriptTesterGetsContext(context: SkillContext): Promise<void>;
+    private static getScriptTester;
     private static bootAndGetConversationFeature;
+    private static getConversationFeature;
 }

package/build/esm/__tests__/behavioral/TestingAConversation.test.js

@@ -13,6 +13,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
+import { MercuryClientFactory } from '@sprucelabs/mercury-client';
 import { test, assert } from '@sprucelabs/test-utils';
 import { errorAssert } from '@sprucelabs/test-utils';
 import AbstractConversationTest from '../../tests/AbstractConversationTest.js';
@@ -71,13 +72,52 @@ export default class TestingAConversationTest extends AbstractConversationTest {
             errorAssert.assertError(err, 'CONVERSATION_ABORTED');
         });
     }
+    static scriptTesterGetsContext(context) {
+        return __awaiter(this, void 0, void 0, function* () {
+            this.cwd = this.resolveTestPath('skill-with-one-topic');
+            MercuryClientFactory.setIsTestMode(true);
+            process.env.ACTION = 'test.conversation';
+            process.env.FIRST_MESSAGE = 'hey there!';
+            const skill = yield this.Skill();
+            const getContext = () => context;
+            //@ts-ignore
+            skill.getContext = getContext;
+            void this.bootSkill({ skill });
+            yield this.wait(100);
+            const scriptTester = yield this.getScriptTester(skill);
+            //@ts-ignore
+            scriptTester.writeHandler = () => { };
+            //@ts-ignore
+            const player = scriptTester.player;
+            assert.isTruthy(player);
+            //@ts-ignore
+            assert.isEqualDeep(player.getContext(), context);
+            yield skill.kill();
+        });
+    }
+    static getScriptTester(skill) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const conversation = this.getConversationFeature(skill);
+            //@ts-ignore
+            while (!conversation.tester) {
+                yield this.wait(100);
+            }
+            //@ts-ignore
+            const scriptTester = conversation.tester;
+            assert.isTruthy(scriptTester);
+            return scriptTester;
+        });
+    }
     static bootAndGetConversationFeature(options) {
         return __awaiter(this, void 0, void 0, function* () {
             const { skill } = yield this.bootSkill(options);
-            const conversation = skill.getFeatureByCode('conversation');
+            const conversation = this.getConversationFeature(skill);
             return conversation;
         });
     }
+    static getConversationFeature(skill) {
+        return skill.getFeatureByCode('conversation');
+    }
 }
 __decorate([
     test()
@@ -91,3 +131,7 @@ __decorate([
 __decorate([
     test()
 ], TestingAConversationTest, "throwsWithThrowsInScript", null);
+__decorate([
+    test('can get context 1', { hello: 'world' }),
+    test('can get context 2', { what: 'the!?' })
+], TestingAConversationTest, "scriptTesterGetsContext", null);

package/build/esm/__tests__/implementation/ConversationCoordinator.test.d.ts

@@ -1,3 +1,4 @@
+import { SkillContext } from '@sprucelabs/spruce-skill-utils';
 import AbstractConversationTest from '../../tests/AbstractConversationTest';
 export default class TopicCoordinatorTest extends AbstractConversationTest {
     private static coordinator;
@@ -13,5 +14,5 @@ export default class TopicCoordinatorTest extends AbstractConversationTest {
     protected static playsScriptWhenTopicIsSelected(): Promise<void>;
     protected static canHandlePromptsInScript(): Promise<void>;
     protected static canPlaceMixedScriptsUntilTheEndAndStartsOver(): Promise<void>;
-    protected static passesThroughContextGetter(context: Record<string, any>): Promise<void>;
+    protected static passesThroughContextGetter(context: SkillContext): Promise<void>;
 }

package/build/esm/__tests__/implementation/ConversationCoordinator.test.js

@@ -13,6 +13,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
+import { fake } from '@sprucelabs/spruce-test-fixtures';
 import { test, assert } from '@sprucelabs/test-utils';
 import { errorAssert } from '@sprucelabs/test-utils';
 import { ConversationCoordinator } from '../../conversations/ConversationCoordinator.js';
@@ -153,7 +154,9 @@ class TopicCoordinatorTest extends AbstractConversationTest {
     }
 }
 TopicCoordinatorTest.sentMessages = [];
-TopicCoordinatorTest.skillContext = {};
+TopicCoordinatorTest.skillContext = {
+    client: fake.getClient(),
+};
 __decorate([
     test()
 ], TopicCoordinatorTest, "canCreateTopicCoordinator", null);

package/build/esm/__tests__/implementation/ScriptTester.test.d.ts

@@ -1,12 +1,12 @@
 import AbstractConversationTest from '../../tests/AbstractConversationTest';
 import { Script } from '../../types/conversation.types';
 export default class ScriptTesterTest extends AbstractConversationTest {
+    private static readonly basicBookingScript;
     protected static throwsWithoutScript(): Promise<void>;
     protected static acceptsSimpleScript(): Promise<void>;
     protected static callingGoDoesntCrash(): Promise<void>;
     protected static cantHandleMessageBeforeStartup(): Promise<void>;
     protected static selectingBadScriptToStartThrows(): Promise<void>;
-    private static readonly basicBookingScript;
     protected static asksWhichScriptYouWantToStartWithWhenThereIsMoreThanOne(): Promise<void>;
     protected static playsSimpleScript(script: Script): Promise<void>;
     protected static canSendInputToThePlayer(answer: string): Promise<void>;
@@ -15,4 +15,5 @@ export default class ScriptTesterTest extends AbstractConversationTest {
     protected static promptsToStartAgainAfterDone(): Promise<void>;
     protected static messagesAboutTransitionResponseTopicChanger(): Promise<void>;
     protected static messagesAboutTransitionResponseWithRepairs(): Promise<void>;
+    private static Tester;
 }

package/build/esm/__tests__/implementation/ScriptTester.test.js

@@ -29,7 +29,7 @@ class ScriptTesterTest extends AbstractConversationTest {
     }
     static acceptsSimpleScript() {
         return __awaiter(this, void 0, void 0, function* () {
-            const tester = yield ScriptTester.Tester({
+            const tester = yield ScriptTesterTest.Tester({
                 topics: [
                     {
                         utterances: [],
@@ -44,7 +44,7 @@ class ScriptTesterTest extends AbstractConversationTest {
     }
     static callingGoDoesntCrash() {
         return __awaiter(this, void 0, void 0, function* () {
-            const tester = yield ScriptTester.Tester({
+            const tester = yield this.Tester({
                 topics: [
                     {
                         utterances: [],
@@ -62,7 +62,7 @@ class ScriptTesterTest extends AbstractConversationTest {
     }
     static cantHandleMessageBeforeStartup() {
         return __awaiter(this, void 0, void 0, function* () {
-            const tester = yield ScriptTester.Tester({
+            const tester = yield this.Tester({
                 topics: [
                     {
                         utterances: [],
@@ -81,7 +81,7 @@ class ScriptTesterTest extends AbstractConversationTest {
     }
     static selectingBadScriptToStartThrows() {
         return __awaiter(this, void 0, void 0, function* () {
-            const tester = yield ScriptTester.Tester({
+            const tester = yield this.Tester({
                 topics: this.basicBookingScript,
                 selectPromptHandler: () => __awaiter(this, void 0, void 0, function* () {
                     return 'oeuou';
@@ -100,7 +100,7 @@ class ScriptTesterTest extends AbstractConversationTest {
         return __awaiter(this, void 0, void 0, function* () {
             let choices;
             const writes = [];
-            const tester = yield ScriptTester.Tester({
+            const tester = yield this.Tester({
                 topics: this.basicBookingScript,
                 selectPromptHandler: (message) => __awaiter(this, void 0, void 0, function* () {
                     var _a;
@@ -130,7 +130,7 @@ class ScriptTesterTest extends AbstractConversationTest {
     static playsSimpleScript(script) {
         return __awaiter(this, void 0, void 0, function* () {
             const writes = [];
-            const tester = yield ScriptTester.Tester({
+            const tester = yield this.Tester({
                 shouldPlayReplayAfterFinish: false,
                 lineDelay: 0,
                 topics: [{ key: 'test', label: 'Testing', script, utterances: [] }],
@@ -155,7 +155,7 @@ class ScriptTesterTest extends AbstractConversationTest {
     static canSendInputToThePlayer(answer) {
         return __awaiter(this, void 0, void 0, function* () {
             const writes = [];
-            const tester = yield ScriptTester.Tester({
+            const tester = yield this.Tester({
                 shouldPlayReplayAfterFinish: false,
                 topics: [
                     {
@@ -199,7 +199,7 @@ class ScriptTesterTest extends AbstractConversationTest {
             const writes = [];
             const promptWrites = [];
             let promptResolve;
-            const tester = yield ScriptTester.Tester({
+            const tester = yield this.Tester({
                 lineDelay: 0,
                 topics: [
                     {
@@ -238,7 +238,7 @@ class ScriptTesterTest extends AbstractConversationTest {
         return __awaiter(this, void 0, void 0, function* () {
             const writes = [];
             const promptWrites = [];
-            const tester = yield ScriptTester.Tester({
+            const tester = yield this.Tester({
                 lineDelay: 0,
                 topics: [
                     {
@@ -266,7 +266,7 @@ class ScriptTesterTest extends AbstractConversationTest {
         return __awaiter(this, void 0, void 0, function* () {
             const writes = [];
             let promptHitCount = 0;
-            const tester = yield ScriptTester.Tester({
+            const tester = yield this.Tester({
                 lineDelay: 0,
                 topics: [
                     {
@@ -307,7 +307,7 @@ class ScriptTesterTest extends AbstractConversationTest {
         return __awaiter(this, void 0, void 0, function* () {
             const writes = [];
             let promptHitCount = 0;
-            const tester = yield ScriptTester.Tester({
+            const tester = yield this.Tester({
                 lineDelay: 0,
                 topics: [
                     {
@@ -359,7 +359,7 @@ class ScriptTesterTest extends AbstractConversationTest {
         return __awaiter(this, void 0, void 0, function* () {
             const writes = [];
             let promptHitCount = 0;
-            const tester = yield ScriptTester.Tester({
+            const tester = yield this.Tester({
                 lineDelay: 0,
                 topics: [
                     {
@@ -407,6 +407,11 @@ class ScriptTesterTest extends AbstractConversationTest {
             ]);
         });
     }
+    static Tester(options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return yield ScriptTester.Tester(Object.assign({ getContext: () => ({}), topics: [] }, options));
+        });
+    }
 }
 ScriptTesterTest.basicBookingScript = [
     {

package/build/esm/__tests__/implementation/TopicScriptPlayer.test.d.ts

@@ -1,3 +1,4 @@
+import { SkillContext } from '@sprucelabs/spruce-skill-utils';
 import AbstractConversationTest from '../../tests/AbstractConversationTest';
 export default class TopicScriptPlayerTest extends AbstractConversationTest {
     protected static throwsWhenRequiredOptionsNotSent(): Promise<void>;
@@ -16,7 +17,7 @@ export default class TopicScriptPlayerTest extends AbstractConversationTest {
     protected static retainsStateBetweenScriptLines(): Promise<void>;
     protected static retainsStateBetweenMessages(): Promise<void>;
     protected static alwaysEndsWithRedirectToDiscovery(): Promise<void>;
-    protected static skillContextAvailableOnScriptLine(context: Record<string, any>): Promise<void>;
+    protected static skillContextAvailableOnScriptLine(context: SkillContext): Promise<void>;
     private static Player;
     private static sendMessage;
 }

package/build/esm/__tests__/testDirsAndFiles/skill-with-one-topic/build/conversations/bookAppointment.topic.d.ts

@@ -0,0 +1,3 @@
+import { TopicDefinition } from '../../../../../types/conversation.types';
+declare const topicDefinition: TopicDefinition;
+export default topicDefinition;

package/build/esm/__tests__/testDirsAndFiles/skill-with-one-topic/build/conversations/bookAppointment.topic.js

@@ -0,0 +1,6 @@
+const topicDefinition = {
+    label: 'book appointment',
+    utterances: ['book appointment', 'Can i book my appointment?', 'book'],
+    script: ['Sweet, lets book!', 'Lemme find your appointment!'],
+};
+export default topicDefinition;

package/build/esm/conversations/ConversationCoordinator.d.ts

@@ -29,6 +29,6 @@ export declare class ConversationCoordinator {
         getContext: GetContext;
         Class?: new (...args: any[]) => ConversationCoordinator;
     }): Promise<ConversationCoordinator>;
-    handleMessage(message: Message, topic?: string): Promise<MessageResponsePayload | void>;
+    handleMessage(message: Message, topic?: string): Promise<MessageResponsePayload | null>;
 }
 export {};

package/build/esm/conversations/ConversationCoordinator.js

@@ -84,6 +84,7 @@ export class ConversationCoordinator {
             if (results) {
                 return results;
             }
+            return null;
         });
     }
 }

package/build/esm/interfaces/MessageGraphicsInterface.d.ts

@@ -36,5 +36,5 @@ export default class MessageGraphicsInterface implements GraphicsInterface {
     protected waitForNextMessage(): Promise<string>;
     handleMessageBody(body: string): Promise<void>;
     isWaitingForInput(): boolean;
-    destory(): void;
+    destroy(): void;
 }

package/build/esm/interfaces/MessageGraphicsInterface.js

@@ -154,7 +154,7 @@ export default class MessageGraphicsInterface {
     isWaitingForInput() {
         return !!this.resolve;
     }
-    destory() {
+    destroy() {
         this.isDestroyed = true;
     }
 }

package/build/esm/plugins/conversation.plugin.d.ts

@@ -9,6 +9,7 @@ export declare class ConversationFeature implements SkillFeature {
     private _isTesting;
     private coordinatorsBySource;
     private bootHandler?;
+    private tester?;
     constructor(skill: Skill);
     onBoot(cb: BootCallback): void;
     execute(): Promise<void>;

package/build/esm/plugins/conversation.plugin.js

@@ -81,14 +81,18 @@ export class ConversationFeature {
     }
     startScriptTesterAndNotifyBoot(topics) {
         return __awaiter(this, void 0, void 0, function* () {
-            const tester = yield ScriptTester.Tester({ topics });
+            this.tester = yield ScriptTester.Tester({
+                topics,
+                getContext: () => this.skill.getContext(),
+            });
             const promise = new Promise((resolve, reject) => {
                 this.skill.onBoot(() => __awaiter(this, void 0, void 0, function* () {
+                    var _a;
                     this.log.info(`Found ${topics.length} topic${topics.length ? '' : 's'}. Holding for a second to let your skill finish building...`);
                     this.log.info('Booting conversation tester.');
                     console.clear();
                     try {
-                        yield tester.go(process.env.FIRST_MESSAGE);
+                        yield ((_a = this.tester) === null || _a === void 0 ? void 0 : _a.go(process.env.FIRST_MESSAGE));
                         resolve();
                     }
                     catch (err) {
@@ -149,10 +153,9 @@ export class ConversationFeature {
             this.log.info(`Found ${topics.length} conversation topics.`);
             const client = yield this.connectToApi();
             this.log.info('Unregistering all past conversation topics.');
-            const unregisterResults = yield client.emit('unregister-conversation-topics::v2020_12_25', {
+            yield client.emitAndFlattenResponses('unregister-conversation-topics::v2020_12_25', {
                 payload: { shouldUnregisterAll: true },
             });
-            eventResponseUtil.getFirstResponseOrThrow(unregisterResults);
             if (topics.length > 0) {
                 this.log.info(`Registering new ${topics.length} topic${topics.length === 1 ? '' : 's'}.`);
                 const results = yield client.emit(`register-conversation-topics::v2020_12_25`, { payload: { topics: topics.map((topic) => ({ key: topic.key })) } });
@@ -209,11 +212,12 @@ export class ConversationFeature {
         });
     }
     destroy() {
-        var _a;
+        var _a, _b;
         return __awaiter(this, void 0, void 0, function* () {
             this._isTesting = false;
             (_a = this.executeResolver) === null || _a === void 0 ? void 0 : _a.call(this);
             this.executeResolver = undefined;
+            (_b = this.tester) === null || _b === void 0 ? void 0 : _b.destroy();
             while (this.isExecuting) {
                 yield new Promise((resolve) => setTimeout(resolve, 250));
             }

package/build/esm/tests/AbstractGraphicsInterfaceTest.js

@@ -31,7 +31,7 @@ export default class AbstractGraphicsInterfaceTest extends AbstractConversationT
         });
         return __awaiter(this, void 0, void 0, function* () {
             yield _super.afterEach.call(this);
-            this.ui.destory();
+            this.ui.destroy();
         });
     }
     static sendMessage(body) {

package/build/esm/tests/ScriptTester.d.ts

@@ -1,3 +1,4 @@
+import { SkillContext } from '@sprucelabs/spruce-skill-utils';
 import { PromptHandler } from '../interfaces/TestGraphicsInterface';
 import { LoadedTopicDefinition, Message } from '../types/conversation.types';
 export default class ScriptTester {
@@ -9,23 +10,28 @@ export default class ScriptTester {
     private lineDelay?;
     private shouldPlayReplayAfterFinish;
     private suggester?;
+    private getContext;
+    private isDestroyed;
     private constructor();
     go(firstMessage?: string): Promise<void>;
+    destroy(): void;
     private reportOnConfidence;
     private promptForDesiredTopic;
     handleInput(input: string): Promise<import("@sprucelabs/schema").SchemaStaticValues<import("@sprucelabs/mercury-types").SpruceSchemas.Mercury.v2020_12_25.DidMessageResponsePayloadSchema, false, import("@sprucelabs/schema").SchemaOptionalFieldNames<import("@sprucelabs/mercury-types").SpruceSchemas.Mercury.v2020_12_25.DidMessageResponsePayloadSchema>, import("@sprucelabs/schema").StaticSchemaAllValues<import("@sprucelabs/mercury-types").SpruceSchemas.Mercury.v2020_12_25.DidMessageResponsePayloadSchema, false>> | null>;
-    static Tester(options: {
-        topics: SimplifiedTopic[];
-        writeHandler?: WriteHandler;
-        selectPromptHandler?: SelectHandler;
-        promptHandler?: PromptHandler;
-        lineDelay?: number;
-        shouldPlayReplayAfterFinish?: boolean;
-    }): Promise<ScriptTester>;
+    static Tester(options: ScriptTesterOptions): Promise<ScriptTester>;
 }
 export declare function generateTransitionMessage(transitionConversationTo: string): string;
 type WriteHandler = (message: Pick<Message, 'body' | 'choices'>) => void;
 type SelectHandler = (message: Pick<Message, 'body' | 'choices'>) => Promise<string>;
 type SimplifiedTopic = LoadedTopicDefinition;
 export declare const END_OF_LINE = "END OF LINE \uD83D\uDC7E";
+export interface ScriptTesterOptions {
+    topics: SimplifiedTopic[];
+    writeHandler?: WriteHandler;
+    selectPromptHandler?: SelectHandler;
+    promptHandler?: PromptHandler;
+    lineDelay?: number;
+    shouldPlayReplayAfterFinish?: boolean;
+    getContext: () => SkillContext;
+}
 export {};

package/build/esm/tests/ScriptTester.js

@@ -15,8 +15,10 @@ import { TopicScriptPlayer } from '../topics/TopicScriptPlayer.js';
 import { TopicSuggester } from '../topics/TopicSuggester.js';
 import randomUtil from '../utilities/random.utility.js';
 export default class ScriptTester {
-    constructor(topics, writeHandler, selectPromptHandler, promptHandler, lineDelay, shouldPlayReplayAfterFinish) {
+    constructor(topics, getContext, writeHandler, selectPromptHandler, promptHandler, lineDelay, shouldPlayReplayAfterFinish) {
+        this.isDestroyed = false;
         this.writeHandler = writeHandler !== null && writeHandler !== void 0 ? writeHandler : ((message) => console.log(message.body));
+        this.getContext = getContext;
         this.topics = topics;
         this.selectPromptHandler =
             selectPromptHandler !== null && selectPromptHandler !== void 0 ? selectPromptHandler : inquirerSelectPromptHandler;
@@ -46,7 +48,7 @@ export default class ScriptTester {
                 sendMessageHandler: (message) => __awaiter(this, void 0, void 0, function* () {
                     return this.writeHandler(message);
                 }),
-                getContext: () => ({}),
+                getContext: this.getContext,
             });
             let msg = firstMessage;
             if (!msg) {
@@ -57,7 +59,13 @@ export default class ScriptTester {
             yield this.reportOnConfidence(msg);
             // eslint-disable-next-line no-constant-condition
             while (true) {
+                if (this.isDestroyed) {
+                    return;
+                }
                 const response = yield this.handleInput(msg);
+                if (this.isDestroyed) {
+                    return;
+                }
                 if (response === null || response === void 0 ? void 0 : response.transitionConversationTo) {
                     if (response.topicChangers) {
                         this.writeHandler({ body: randomUtil.rand(response.topicChangers) });
@@ -70,13 +78,16 @@ export default class ScriptTester {
                     });
                 }
                 this.writeHandler({ body: END_OF_LINE });
-                if (!this.shouldPlayReplayAfterFinish) {
+                if (!this.shouldPlayReplayAfterFinish || this.isDestroyed) {
                     return;
                 }
                 yield this.promptHandler({ body: 'Enter to start again.' });
             }
         });
     }
+    destroy() {
+        this.isDestroyed = true;
+    }
     reportOnConfidence(msg) {
         return __awaiter(this, void 0, void 0, function* () {
             if (!this.suggester) {
@@ -133,7 +144,7 @@ export default class ScriptTester {
             if (missing.length > 0) {
                 throw new SchemaError({ code: 'MISSING_PARAMETERS', parameters: missing });
             }
-            return new ScriptTester(options.topics, options.writeHandler, options.selectPromptHandler, options.promptHandler, options.lineDelay, options.shouldPlayReplayAfterFinish);
+            return new ScriptTester(options.topics, options.getContext, options.writeHandler, options.selectPromptHandler, options.promptHandler, options.lineDelay, options.shouldPlayReplayAfterFinish);
         });
     }
 }

package/build/interfaces/MessageGraphicsInterface.d.ts

@@ -36,5 +36,5 @@ export default class MessageGraphicsInterface implements GraphicsInterface {
     protected waitForNextMessage(): Promise<string>;
     handleMessageBody(body: string): Promise<void>;
     isWaitingForInput(): boolean;
-    destory(): void;
+    destroy(): void;
 }

package/build/interfaces/MessageGraphicsInterface.js

@@ -142,7 +142,7 @@ class MessageGraphicsInterface {
     isWaitingForInput() {
         return !!this.resolve;
     }
-    destory() {
+    destroy() {
         this.isDestroyed = true;
     }
 }

package/build/plugins/conversation.plugin.d.ts

@@ -9,6 +9,7 @@ export declare class ConversationFeature implements SkillFeature {
     private _isTesting;
     private coordinatorsBySource;
     private bootHandler?;
+    private tester?;
     constructor(skill: Skill);
     onBoot(cb: BootCallback): void;
     execute(): Promise<void>;

package/build/plugins/conversation.plugin.js

@@ -71,14 +71,18 @@ class ConversationFeature {
         await ((_a = this.bootHandler) === null || _a === void 0 ? void 0 : _a.call(this));
     }
     async startScriptTesterAndNotifyBoot(topics) {
-        const tester = await ScriptTester_1.default.Tester({ topics });
+        this.tester = await ScriptTester_1.default.Tester({
+            topics,
+            getContext: () => this.skill.getContext(),
+        });
         const promise = new Promise((resolve, reject) => {
             this.skill.onBoot(async () => {
+                var _a;
                 this.log.info(`Found ${topics.length} topic${topics.length ? '' : 's'}. Holding for a second to let your skill finish building...`);
                 this.log.info('Booting conversation tester.');
                 console.clear();
                 try {
-                    await tester.go(process.env.FIRST_MESSAGE);
+                    await ((_a = this.tester) === null || _a === void 0 ? void 0 : _a.go(process.env.FIRST_MESSAGE));
                     resolve();
                 }
                 catch (err) {
@@ -133,10 +137,9 @@ class ConversationFeature {
         this.log.info(`Found ${topics.length} conversation topics.`);
         const client = await this.connectToApi();
         this.log.info('Unregistering all past conversation topics.');
-        const unregisterResults = await client.emit('unregister-conversation-topics::v2020_12_25', {
+        await client.emitAndFlattenResponses('unregister-conversation-topics::v2020_12_25', {
             payload: { shouldUnregisterAll: true },
         });
-        spruce_event_utils_1.eventResponseUtil.getFirstResponseOrThrow(unregisterResults);
         if (topics.length > 0) {
             this.log.info(`Registering new ${topics.length} topic${topics.length === 1 ? '' : 's'}.`);
             const results = await client.emit(`register-conversation-topics::v2020_12_25`, { payload: { topics: topics.map((topic) => ({ key: topic.key })) } });
@@ -186,10 +189,11 @@ class ConversationFeature {
         return true;
     }
     async destroy() {
-        var _a;
+        var _a, _b;
         this._isTesting = false;
         (_a = this.executeResolver) === null || _a === void 0 ? void 0 : _a.call(this);
         this.executeResolver = undefined;
+        (_b = this.tester) === null || _b === void 0 ? void 0 : _b.destroy();
         while (this.isExecuting) {
             await new Promise((resolve) => setTimeout(resolve, 250));
         }

package/build/tests/AbstractGraphicsInterfaceTest.js

@@ -18,7 +18,7 @@ class AbstractGraphicsInterfaceTest extends AbstractConversationTest_1.default {
     }
     static async afterEach() {
         await super.afterEach();
-        this.ui.destory();
+        this.ui.destroy();
     }
     static async sendMessage(body) {
         await this.ui.handleMessageBody(body);

package/build/tests/ScriptTester.d.ts

@@ -1,3 +1,4 @@
+import { SkillContext } from '@sprucelabs/spruce-skill-utils';
 import { PromptHandler } from '../interfaces/TestGraphicsInterface';
 import { LoadedTopicDefinition, Message } from '../types/conversation.types';
 export default class ScriptTester {
@@ -9,23 +10,28 @@ export default class ScriptTester {
     private lineDelay?;
     private shouldPlayReplayAfterFinish;
     private suggester?;
+    private getContext;
+    private isDestroyed;
     private constructor();
     go(firstMessage?: string): Promise<void>;
+    destroy(): void;
     private reportOnConfidence;
     private promptForDesiredTopic;
     handleInput(input: string): Promise<import("@sprucelabs/schema").SchemaStaticValues<import("@sprucelabs/mercury-types").SpruceSchemas.Mercury.v2020_12_25.DidMessageResponsePayloadSchema, false, import("@sprucelabs/schema").SchemaOptionalFieldNames<import("@sprucelabs/mercury-types").SpruceSchemas.Mercury.v2020_12_25.DidMessageResponsePayloadSchema>, import("@sprucelabs/schema").StaticSchemaAllValues<import("@sprucelabs/mercury-types").SpruceSchemas.Mercury.v2020_12_25.DidMessageResponsePayloadSchema, false>> | null>;
-    static Tester(options: {
-        topics: SimplifiedTopic[];
-        writeHandler?: WriteHandler;
-        selectPromptHandler?: SelectHandler;
-        promptHandler?: PromptHandler;
-        lineDelay?: number;
-        shouldPlayReplayAfterFinish?: boolean;
-    }): Promise<ScriptTester>;
+    static Tester(options: ScriptTesterOptions): Promise<ScriptTester>;
 }
 export declare function generateTransitionMessage(transitionConversationTo: string): string;
 type WriteHandler = (message: Pick<Message, 'body' | 'choices'>) => void;
 type SelectHandler = (message: Pick<Message, 'body' | 'choices'>) => Promise<string>;
 type SimplifiedTopic = LoadedTopicDefinition;
 export declare const END_OF_LINE = "END OF LINE \uD83D\uDC7E";
+export interface ScriptTesterOptions {
+    topics: SimplifiedTopic[];
+    writeHandler?: WriteHandler;
+    selectPromptHandler?: SelectHandler;
+    promptHandler?: PromptHandler;
+    lineDelay?: number;
+    shouldPlayReplayAfterFinish?: boolean;
+    getContext: () => SkillContext;
+}
 export {};

package/build/tests/ScriptTester.js

@@ -12,8 +12,10 @@ const TopicScriptPlayer_1 = require("../topics/TopicScriptPlayer");
 const TopicSuggester_1 = require("../topics/TopicSuggester");
 const random_utility_1 = __importDefault(require("../utilities/random.utility"));
 class ScriptTester {
-    constructor(topics, writeHandler, selectPromptHandler, promptHandler, lineDelay, shouldPlayReplayAfterFinish) {
+    constructor(topics, getContext, writeHandler, selectPromptHandler, promptHandler, lineDelay, shouldPlayReplayAfterFinish) {
+        this.isDestroyed = false;
         this.writeHandler = writeHandler !== null && writeHandler !== void 0 ? writeHandler : ((message) => console.log(message.body));
+        this.getContext = getContext;
         this.topics = topics;
         this.selectPromptHandler =
             selectPromptHandler !== null && selectPromptHandler !== void 0 ? selectPromptHandler : inquirerSelectPromptHandler;
@@ -42,7 +44,7 @@ class ScriptTester {
             sendMessageHandler: async (message) => {
                 return this.writeHandler(message);
             },
-            getContext: () => ({}),
+            getContext: this.getContext,
         });
         let msg = firstMessage;
         if (!msg) {
@@ -53,7 +55,13 @@ class ScriptTester {
         await this.reportOnConfidence(msg);
         // eslint-disable-next-line no-constant-condition
         while (true) {
+            if (this.isDestroyed) {
+                return;
+            }
             const response = await this.handleInput(msg);
+            if (this.isDestroyed) {
+                return;
+            }
             if (response === null || response === void 0 ? void 0 : response.transitionConversationTo) {
                 if (response.topicChangers) {
                     this.writeHandler({ body: random_utility_1.default.rand(response.topicChangers) });
@@ -66,12 +74,15 @@ class ScriptTester {
                 });
             }
             this.writeHandler({ body: exports.END_OF_LINE });
-            if (!this.shouldPlayReplayAfterFinish) {
+            if (!this.shouldPlayReplayAfterFinish || this.isDestroyed) {
                 return;
             }
             await this.promptHandler({ body: 'Enter to start again.' });
         }
     }
+    destroy() {
+        this.isDestroyed = true;
+    }
     async reportOnConfidence(msg) {
         if (!this.suggester) {
             this.suggester = await TopicSuggester_1.TopicSuggester.Suggester({ topics: this.topics });
@@ -121,7 +132,7 @@ class ScriptTester {
         if (missing.length > 0) {
             throw new schema_1.SchemaError({ code: 'MISSING_PARAMETERS', parameters: missing });
         }
-        return new ScriptTester(options.topics, options.writeHandler, options.selectPromptHandler, options.promptHandler, options.lineDelay, options.shouldPlayReplayAfterFinish);
+        return new ScriptTester(options.topics, options.getContext, options.writeHandler, options.selectPromptHandler, options.promptHandler, options.lineDelay, options.shouldPlayReplayAfterFinish);
     }
 }
 exports.default = ScriptTester;

package/package.json

@@ -12,7 +12,7 @@
       "@types/inquirer"
     ]
   },
-  "version": "56.1.5",
+  "version": "56.1.7",
   "files": [
     "build/**/*",
     "!build/__tests__",
@@ -68,11 +68,11 @@
     "@sprucelabs/mercury-core-events": "^18.0.36",
     "@sprucelabs/schema": "^28.5.155",
     "@sprucelabs/spruce-core-schemas": "^37.2.21",
-    "@sprucelabs/spruce-event-plugin": "^56.1.5",
+    "@sprucelabs/spruce-event-plugin": "^56.1.7",
     "@sprucelabs/spruce-event-utils": "^34.0.33",
-    "@sprucelabs/spruce-skill-booter": "^56.1.5",
+    "@sprucelabs/spruce-skill-booter": "^56.1.7",
     "@sprucelabs/spruce-skill-utils": "^28.1.111",
-    "@sprucelabs/spruce-test-fixtures": "^56.1.5",
+    "@sprucelabs/spruce-test-fixtures": "^56.1.7",
     "fuzzyset": "^1.0.7",
     "inquirer": "^8.2.4",
     "node-nlp": "^4.26.1",
@@ -118,5 +118,5 @@
       "^#spruce/(.*)$": "<rootDir>/build/.spruce/$1"
     }
   },
-  "gitHead": "3f0fee630df22a40f5874a0a7680ab635fd0faa6"
+  "gitHead": "00a3509e09365b734b62431828946b97259556b1"
 }