@microsoft/agents-hosting-dialogs 0.1.49

package/dist/src/memory/scopes/conversationMemoryScope.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+import { AgentStateMemoryScope } from './agentStateMemoryScope';
+/**
+ * Memory that's scoped to the current conversation.
+ */
+export declare class ConversationMemoryScope extends AgentStateMemoryScope {
+    protected stateKey: string;
+    /**
+       * Initializes a new instance of the ConversationMemoryScope class.
+       */
+    constructor();
+}

package/dist/src/memory/scopes/conversationMemoryScope.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConversationMemoryScope = void 0;
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+const agentStateMemoryScope_1 = require("./agentStateMemoryScope");
+const scopePath_1 = require("../scopePath");
+/**
+ * Memory that's scoped to the current conversation.
+ */
+class ConversationMemoryScope extends agentStateMemoryScope_1.AgentStateMemoryScope {
+    /**
+       * Initializes a new instance of the ConversationMemoryScope class.
+       */
+    constructor() {
+        super(scopePath_1.ScopePath.conversation);
+        this.stateKey = 'ConversationState';
+    }
+}
+exports.ConversationMemoryScope = ConversationMemoryScope;
+//# sourceMappingURL=conversationMemoryScope.js.map

package/dist/src/memory/scopes/conversationMemoryScope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversationMemoryScope.js","sourceRoot":"","sources":["../../../../src/memory/scopes/conversationMemoryScope.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,mEAA+D;AAC/D,4CAAwC;AAExC;;GAEG;AACH,MAAa,uBAAwB,SAAQ,6CAAqB;IAEhE;;SAEK;IACL;QACE,KAAK,CAAC,qBAAS,CAAC,YAAY,CAAC,CAAA;QALrB,aAAQ,GAAG,mBAAmB,CAAA;IAMxC,CAAC;CACF;AARD,0DAQC"}

package/dist/src/memory/scopes/dialogClassMemoryScope.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+import { ClassMemoryScope } from './classMemoryScope';
+import { DialogContext } from '../../dialogContext';
+import { Dialog } from '../../dialog';
+export declare class DialogClassMemoryScope extends ClassMemoryScope {
+    /**
+       * Initializes a new instance of the DialogClassMemoryScope class.
+       */
+    constructor();
+    /**
+       * @protected
+       * @param dialogContext The DialogContext object for this turn.
+       * @returns The current Dialog.
+       */
+    protected onFindDialog(dialogContext: DialogContext): Dialog | undefined;
+}

package/dist/src/memory/scopes/dialogClassMemoryScope.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DialogClassMemoryScope = void 0;
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+const classMemoryScope_1 = require("./classMemoryScope");
+const scopePath_1 = require("../scopePath");
+const dialogContainer_1 = require("../../dialogContainer");
+class DialogClassMemoryScope extends classMemoryScope_1.ClassMemoryScope {
+    /**
+       * Initializes a new instance of the DialogClassMemoryScope class.
+       */
+    constructor() {
+        super(scopePath_1.ScopePath.dialogClass);
+    }
+    /**
+       * @protected
+       * @param dialogContext The DialogContext object for this turn.
+       * @returns The current Dialog.
+       */
+    onFindDialog(dialogContext) {
+        // Is the active dialog a container?
+        const dialog = dialogContext.findDialog(dialogContext.activeDialog.id);
+        if (dialog && dialog instanceof dialogContainer_1.DialogContainer) {
+            return dialog;
+        }
+        // Return parent dialog if there is one?
+        const parent = dialogContext.parent;
+        if (parent && parent.activeDialog) {
+            const parentDialog = parent.findDialog(parent.activeDialog.id);
+            if (parentDialog) {
+                return parentDialog;
+            }
+        }
+        // Fallback to returning current dialog
+        return dialog;
+    }
+}
+exports.DialogClassMemoryScope = DialogClassMemoryScope;
+//# sourceMappingURL=dialogClassMemoryScope.js.map

package/dist/src/memory/scopes/dialogClassMemoryScope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialogClassMemoryScope.js","sourceRoot":"","sources":["../../../../src/memory/scopes/dialogClassMemoryScope.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,yDAAqD;AACrD,4CAAwC;AAGxC,2DAAuD;AAEvD,MAAa,sBAAuB,SAAQ,mCAAgB;IAC1D;;SAEK;IACL;QACE,KAAK,CAAC,qBAAS,CAAC,WAAW,CAAC,CAAA;IAC9B,CAAC;IAED;;;;SAIK;IACK,YAAY,CAAE,aAA4B;QAClD,oCAAoC;QACpC,MAAM,MAAM,GAAG,aAAa,CAAC,UAAU,CAAC,aAAa,CAAC,YAAY,CAAC,EAAE,CAAC,CAAA;QACtE,IAAI,MAAM,IAAI,MAAM,YAAY,iCAAe,EAAE,CAAC;YAChD,OAAO,MAAM,CAAA;QACf,CAAC;QAED,wCAAwC;QACxC,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAA;QACnC,IAAI,MAAM,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;YAClC,MAAM,YAAY,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC,CAAA;YAC9D,IAAI,YAAY,EAAE,CAAC;gBACjB,OAAO,YAAY,CAAA;YACrB,CAAC;QACH,CAAC;QAED,uCAAuC;QACvC,OAAO,MAAM,CAAA;IACf,CAAC;CACF;AAhCD,wDAgCC"}

package/dist/src/memory/scopes/dialogContextMemoryScope.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+import { DialogContext } from '../../dialogContext';
+import { MemoryScope } from './memoryScope';
+export declare class DialogContextMemoryScope extends MemoryScope {
+    /**
+       * Initializes a new instance of the `DialogContextMemoryScope` class.
+       */
+    constructor();
+    /**
+       * Gets the backing memory for this scope.
+       *
+       * @param dialogContext The `DialogContext` object for this turn.
+       * @returns Memory for the scope.
+       */
+    getMemory(dialogContext: DialogContext): Record<'stack' | 'activeDialog' | 'parent', unknown>;
+}

package/dist/src/memory/scopes/dialogContextMemoryScope.js

@@ -0,0 +1,48 @@
+"use strict";
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DialogContextMemoryScope = void 0;
+const memoryScope_1 = require("./memoryScope");
+const scopePath_1 = require("../scopePath");
+class DialogContextMemoryScope extends memoryScope_1.MemoryScope {
+    /**
+       * Initializes a new instance of the `DialogContextMemoryScope` class.
+       */
+    constructor() {
+        super(scopePath_1.ScopePath.dialogContext, false);
+    }
+    /**
+       * Gets the backing memory for this scope.
+       *
+       * @param dialogContext The `DialogContext` object for this turn.
+       * @returns Memory for the scope.
+       */
+    getMemory(dialogContext) {
+        const stack = [];
+        let currentDialogContext = dialogContext;
+        // go to leaf node
+        while (currentDialogContext.child) {
+            currentDialogContext = currentDialogContext.child;
+        }
+        while (currentDialogContext) {
+            for (let i = currentDialogContext.stack.length - 1; i >= 0; i--) {
+                const item = currentDialogContext.stack[i];
+                // filter out ActionScope items because they are internal bookkeeping.
+                if (!item.id.startsWith('ActionScope[')) {
+                    stack.push(item.id);
+                }
+            }
+            currentDialogContext = currentDialogContext.parent;
+        }
+        return {
+            stack,
+            activeDialog: dialogContext.activeDialog && dialogContext.activeDialog.id,
+            parent: dialogContext.parent && dialogContext.parent.activeDialog && dialogContext.parent.activeDialog.id,
+        };
+    }
+}
+exports.DialogContextMemoryScope = DialogContextMemoryScope;
+//# sourceMappingURL=dialogContextMemoryScope.js.map

package/dist/src/memory/scopes/dialogContextMemoryScope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialogContextMemoryScope.js","sourceRoot":"","sources":["../../../../src/memory/scopes/dialogContextMemoryScope.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAGH,+CAA2C;AAC3C,4CAAwC;AAExC,MAAa,wBAAyB,SAAQ,yBAAW;IACvD;;SAEK;IACL;QACE,KAAK,CAAC,qBAAS,CAAC,aAAa,EAAE,KAAK,CAAC,CAAA;IACvC,CAAC;IAED;;;;;SAKK;IACL,SAAS,CAAE,aAA4B;QACrC,MAAM,KAAK,GAAG,EAAE,CAAA;QAChB,IAAI,oBAAoB,GAA8B,aAAa,CAAA;QAEnE,kBAAkB;QAClB,OAAO,oBAAoB,CAAC,KAAK,EAAE,CAAC;YAClC,oBAAoB,GAAG,oBAAoB,CAAC,KAAK,CAAA;QACnD,CAAC;QAED,OAAO,oBAAoB,EAAE,CAAC;YAC5B,KAAK,IAAI,CAAC,GAAG,oBAAoB,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;gBAChE,MAAM,IAAI,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;gBAC1C,sEAAsE;gBACtE,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;oBACxC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;gBACrB,CAAC;YACH,CAAC;YAED,oBAAoB,GAAG,oBAAoB,CAAC,MAAM,CAAA;QACpD,CAAC;QAED,OAAO;YACL,KAAK;YACL,YAAY,EAAE,aAAa,CAAC,YAAY,IAAI,aAAa,CAAC,YAAY,CAAC,EAAE;YACzE,MAAM,EAAE,aAAa,CAAC,MAAM,IAAI,aAAa,CAAC,MAAM,CAAC,YAAY,IAAI,aAAa,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE;SAC1G,CAAA;IACH,CAAC;CACF;AAzCD,4DAyCC"}

package/dist/src/memory/scopes/dialogMemoryScope.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+import { MemoryScope } from './memoryScope';
+import { DialogContext } from '../../dialogContext';
+export declare class DialogMemoryScope extends MemoryScope {
+    /**
+       * Initializes a new instance of the DialogMemoryScope class.
+       */
+    constructor();
+    /**
+       * Gets the backing memory for this scope.
+       *
+       * @param dialogContext The DialogContext object for this turn.
+       * @returns The memory for the scope.
+       */
+    getMemory(dialogContext: DialogContext): object;
+    /**
+       * Changes the backing object for the memory scope.
+       *
+       * @param dialogContext The DialogContext object for this turn.
+       * @param memory Memory object to set for the scope.
+       */
+    setMemory(dialogContext: DialogContext, memory: object): void;
+    /**
+       * @private
+       * @param dialogContext The DialogContext object for this turn.
+       * @returns A boolean indicating whether is a cointainer or not.
+       */
+    private isContainer;
+}

package/dist/src/memory/scopes/dialogMemoryScope.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DialogMemoryScope = void 0;
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+const memoryScope_1 = require("./memoryScope");
+const scopePath_1 = require("../scopePath");
+const dialogContainer_1 = require("../../dialogContainer");
+class DialogMemoryScope extends memoryScope_1.MemoryScope {
+    /**
+       * Initializes a new instance of the DialogMemoryScope class.
+       */
+    constructor() {
+        super(scopePath_1.ScopePath.dialog);
+    }
+    /**
+       * Gets the backing memory for this scope.
+       *
+       * @param dialogContext The DialogContext object for this turn.
+       * @returns The memory for the scope.
+       */
+    getMemory(dialogContext) {
+        // If active dialog is a container dialog then "dialog" binds to it.
+        // Otherwise the "dialog" will bind to the dialogs parent assuming it
+        // is a container.
+        let parent = dialogContext;
+        if (!this.isContainer(parent) && parent.parent && this.isContainer(parent.parent)) {
+            parent = parent.parent;
+        }
+        // If there's no active dialog then return undefined.
+        return parent.activeDialog ? parent.activeDialog.state : {};
+    }
+    /**
+       * Changes the backing object for the memory scope.
+       *
+       * @param dialogContext The DialogContext object for this turn.
+       * @param memory Memory object to set for the scope.
+       */
+    setMemory(dialogContext, memory) {
+        if (memory === undefined) {
+            throw new Error('DialogMemoryScope.setMemory: undefined memory object passed in.');
+        }
+        // If active dialog is a container dialog then "dialog" binds to it.
+        // Otherwise the "dialog" will bind to the dialogs parent assuming it
+        // is a container.
+        let parent = dialogContext;
+        if (!this.isContainer(parent) && parent.parent && this.isContainer(parent.parent)) {
+            parent = parent.parent;
+        }
+        // If there's no active dialog then throw an error.
+        if (!parent.activeDialog) {
+            throw new Error('DialogMemoryScope.setMemory: no active dialog found.');
+        }
+        parent.activeDialog.state = memory;
+    }
+    /**
+       * @private
+       * @param dialogContext The DialogContext object for this turn.
+       * @returns A boolean indicating whether is a cointainer or not.
+       */
+    isContainer(dialogContext) {
+        if (dialogContext !== undefined && dialogContext.activeDialog !== undefined) {
+            const dialog = dialogContext.findDialog(dialogContext.activeDialog.id);
+            if (dialog instanceof dialogContainer_1.DialogContainer) {
+                return true;
+            }
+        }
+        return false;
+    }
+}
+exports.DialogMemoryScope = DialogMemoryScope;
+//# sourceMappingURL=dialogMemoryScope.js.map

package/dist/src/memory/scopes/dialogMemoryScope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialogMemoryScope.js","sourceRoot":"","sources":["../../../../src/memory/scopes/dialogMemoryScope.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,+CAA2C;AAC3C,4CAAwC;AAExC,2DAAuD;AAEvD,MAAa,iBAAkB,SAAQ,yBAAW;IAChD;;SAEK;IACL;QACE,KAAK,CAAC,qBAAS,CAAC,MAAM,CAAC,CAAA;IACzB,CAAC;IAED;;;;;SAKK;IACL,SAAS,CAAE,aAA4B;QACrC,oEAAoE;QACpE,qEAAqE;QACrE,kBAAkB;QAClB,IAAI,MAAM,GAAkB,aAAa,CAAA;QACzC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YAClF,MAAM,GAAG,MAAM,CAAC,MAAM,CAAA;QACxB,CAAC;QAED,qDAAqD;QACrD,OAAO,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAA;IAC7D,CAAC;IAED;;;;;SAKK;IACL,SAAS,CAAE,aAA4B,EAAE,MAAc;QACrD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAA;QACpF,CAAC;QAED,oEAAoE;QACpE,qEAAqE;QACrE,kBAAkB;QAClB,IAAI,MAAM,GAAkB,aAAa,CAAA;QACzC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YAClF,MAAM,GAAG,MAAM,CAAC,MAAM,CAAA;QACxB,CAAC;QAED,mDAAmD;QACnD,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAA;QACzE,CAAC;QAED,MAAM,CAAC,YAAY,CAAC,KAAK,GAAG,MAAM,CAAA;IACpC,CAAC;IAED;;;;SAIK;IACG,WAAW,CAAE,aAA4B;QAC/C,IAAI,aAAa,KAAK,SAAS,IAAI,aAAa,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;YAC5E,MAAM,MAAM,GAAG,aAAa,CAAC,UAAU,CAAC,aAAa,CAAC,YAAY,CAAC,EAAE,CAAC,CAAA;YACtE,IAAI,MAAM,YAAY,iCAAe,EAAE,CAAC;gBACtC,OAAO,IAAI,CAAA;YACb,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAA;IACd,CAAC;CACF;AArED,8CAqEC"}

package/dist/src/memory/scopes/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+export * from './agentStateMemoryScope';
+export * from './classMemoryScope';
+export * from './conversationMemoryScope';
+export * from './dialogClassMemoryScope';
+export * from './dialogContextMemoryScope';
+export * from './dialogMemoryScope';
+export * from './memoryScope';
+export * from './settingsMemoryScope';
+export * from './thisMemoryScope';
+export * from './turnMemoryScope';
+export * from './userMemoryScope';

package/dist/src/memory/scopes/index.js

@@ -0,0 +1,32 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+__exportStar(require("./agentStateMemoryScope"), exports);
+__exportStar(require("./classMemoryScope"), exports);
+__exportStar(require("./conversationMemoryScope"), exports);
+__exportStar(require("./dialogClassMemoryScope"), exports);
+__exportStar(require("./dialogContextMemoryScope"), exports);
+__exportStar(require("./dialogMemoryScope"), exports);
+__exportStar(require("./memoryScope"), exports);
+__exportStar(require("./settingsMemoryScope"), exports);
+__exportStar(require("./thisMemoryScope"), exports);
+__exportStar(require("./turnMemoryScope"), exports);
+__exportStar(require("./userMemoryScope"), exports);
+//# sourceMappingURL=index.js.map

package/dist/src/memory/scopes/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/memory/scopes/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;GAGG;AACH,0DAAuC;AACvC,qDAAkC;AAClC,4DAAyC;AACzC,2DAAwC;AACxC,6DAA0C;AAC1C,sDAAmC;AACnC,gDAA6B;AAC7B,wDAAqC;AACrC,oDAAiC;AACjC,oDAAiC;AACjC,oDAAiC"}

package/dist/src/memory/scopes/memoryScope.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+import { DialogContext } from '../../dialogContext';
+/**
+ * Abstract base class for all memory scopes.
+ */
+export declare abstract class MemoryScope {
+    /**
+       * Initializes a new instance of the MemoryScope class.
+       *
+       * @param name Name of the scope.
+       * @param includeInSnapshot Boolean value indicating whether this memory
+       * should be included in snapshot. Default value is true.
+       */
+    constructor(name: string, includeInSnapshot?: boolean);
+    readonly name: string;
+    readonly includeInSnapshot: boolean;
+    /**
+       * Get the backing memory for this scope
+       *
+       * @param dialogContext Current dialog context.
+       * @returns memory for the scope
+       */
+    abstract getMemory(dialogContext: DialogContext): object;
+    /**
+       * Changes the backing object for the memory scope.
+       *
+       * @param _dialogContext Current dialog context
+       * @param _memory memory to assign
+       */
+    setMemory(_dialogContext: DialogContext, _memory: object): void;
+    /**
+       * Loads a scopes backing memory at the start of a turn.
+       *
+       * @param _dialogContext Current dialog context.
+       */
+    load(_dialogContext: DialogContext): Promise<void>;
+    /**
+       * Saves a scopes backing memory at the end of a turn.
+       *
+       * @param _dialogContext Current dialog context.
+       */
+    saveChanges(_dialogContext: DialogContext): Promise<void>;
+    /**
+       * Deletes the backing memory for a scope.
+       *
+       * @param _dialogContext Current dialog context.
+       */
+    delete(_dialogContext: DialogContext): Promise<void>;
+}

package/dist/src/memory/scopes/memoryScope.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoryScope = void 0;
+/**
+ * Abstract base class for all memory scopes.
+ */
+class MemoryScope {
+    /**
+       * Initializes a new instance of the MemoryScope class.
+       *
+       * @param name Name of the scope.
+       * @param includeInSnapshot Boolean value indicating whether this memory
+       * should be included in snapshot. Default value is true.
+       */
+    constructor(name, includeInSnapshot = true) {
+        this.includeInSnapshot = includeInSnapshot;
+        this.name = name;
+    }
+    /**
+       * Changes the backing object for the memory scope.
+       *
+       * @param _dialogContext Current dialog context
+       * @param _memory memory to assign
+       */
+    setMemory(_dialogContext, _memory) {
+        throw new Error(`MemoryScope.setMemory: The '${this.name}' memory scope is read-only.`);
+    }
+    /**
+       * Loads a scopes backing memory at the start of a turn.
+       *
+       * @param _dialogContext Current dialog context.
+       */
+    async load(_dialogContext) {
+        // No initialization by default.
+    }
+    /**
+       * Saves a scopes backing memory at the end of a turn.
+       *
+       * @param _dialogContext Current dialog context.
+       */
+    async saveChanges(_dialogContext) {
+        // No initialization by default.
+    }
+    /**
+       * Deletes the backing memory for a scope.
+       *
+       * @param _dialogContext Current dialog context.
+       */
+    async delete(_dialogContext) {
+        throw new Error(`MemoryScope.delete: The '${this.name}' memory scope can't be deleted.`);
+    }
+}
+exports.MemoryScope = MemoryScope;
+//# sourceMappingURL=memoryScope.js.map

package/dist/src/memory/scopes/memoryScope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memoryScope.js","sourceRoot":"","sources":["../../../../src/memory/scopes/memoryScope.ts"],"names":[],"mappings":";;;AAMA;;GAEG;AACH,MAAsB,WAAW;IAC/B;;;;;;SAMK;IACL,YAAa,IAAY,EAAE,iBAAiB,GAAG,IAAI;QACjD,IAAI,CAAC,iBAAiB,GAAG,iBAAiB,CAAA;QAC1C,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;IAaD;;;;;SAKK;IACL,SAAS,CAAE,cAA6B,EAAE,OAAe;QACvD,MAAM,IAAI,KAAK,CAAC,+BAA+B,IAAI,CAAC,IAAI,8BAA8B,CAAC,CAAA;IACzF,CAAC;IAED;;;;SAIK;IACL,KAAK,CAAC,IAAI,CAAE,cAA6B;QACvC,gCAAgC;IAClC,CAAC;IAED;;;;SAIK;IACL,KAAK,CAAC,WAAW,CAAE,cAA6B;QAC9C,gCAAgC;IAClC,CAAC;IAED;;;;SAIK;IACL,KAAK,CAAC,MAAM,CAAE,cAA6B;QACzC,MAAM,IAAI,KAAK,CAAC,4BAA4B,IAAI,CAAC,IAAI,kCAAkC,CAAC,CAAA;IAC1F,CAAC;CACF;AA5DD,kCA4DC"}

package/dist/src/memory/scopes/settingsMemoryScope.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+import { DialogContext } from '../../dialogContext';
+import { MemoryScope } from './memoryScope';
+export declare class SettingsMemoryScope extends MemoryScope {
+    private readonly initialSettings?;
+    private static readonly blockingList;
+    /**
+       * Initializes a new instance of the SettingsMemoryScope class.
+       *
+       * @param initialSettings initial set of settings to supply
+       */
+    constructor(initialSettings?: Record<string, unknown>);
+    /**
+       * Gets the backing memory for this scope.
+       *
+       * @param {DialogContext} dialogContext The DialogContext object for this turn.
+       * @returns {Record<string, ?>} The memory for the scope.
+       */
+    getMemory(dialogContext: DialogContext): Record<string, unknown>;
+    /**
+       * @param dialogContext Current dialog context.
+       */
+    load(dialogContext: DialogContext): Promise<void>;
+    /**
+       * Build a dictionary view of configuration providers.
+       *
+       * @param {Record<string, string>} configuration The configuration that we are running with.
+       * @returns {Record<string, ?>} Projected dictionary for settings.
+       */
+    protected static loadSettings(configuration: Record<string, string>): Record<string, unknown>;
+    /**
+       * Generate a node tree with the flatten settings.
+       * For example:
+       * {
+       *   "array":["item1", "item2"],
+       *   "object":{"array":["item1"], "2":"numberkey"}
+       * }
+       *
+       * Would generate a flatten settings like:
+       * array:0 item1
+       * array:1 item2
+       * object:array:0 item1
+       * object:2 numberkey
+       *
+       * After Converting it from flatten settings into node tree, would get:
+       *
+       *                         null
+       *                |                     |
+       *              array                object
+       *            |        |            |        |
+       *           0          1        array        2
+       *           |          |         |           |
+       *         item1       item2      0        numberkey
+       *                                |
+       *                              item1
+       * The result is a Tree.
+       *
+       * @param {Array<[string, string]>} kvs Configurations with key value pairs.
+       * @returns {Node} The root node of the tree.
+       */
+    private static convertFlattenSettingToNode;
+    private static convertNodeToObject;
+    private static filterSettings;
+    private static deletePropertyPath;
+}