@microsoft/agents-hosting-dialogs 0.2.14 → 0.4.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/src/agentComponent.d.ts +18 -4
- package/dist/src/agentComponent.js +12 -4
- package/dist/src/agentComponent.js.map +1 -1
- package/dist/src/agentStateSet.d.ts +2 -2
- package/dist/src/agentStateSet.js +2 -2
- package/dist/src/choices/choice.d.ts +9 -0
- package/dist/src/choices/findChoices.d.ts +12 -0
- package/dist/src/choices/findChoices.js.map +1 -1
- package/dist/src/choices/findValues.d.ts +27 -0
- package/dist/src/choices/findValues.js.map +1 -1
- package/dist/src/choices/modelResult.d.ts +20 -0
- package/dist/src/choices/modelResult.js +4 -0
- package/dist/src/choices/modelResult.js.map +1 -1
- package/dist/src/choices/tokenizer.d.ts +15 -0
- package/dist/src/choices/tokenizer.js +4 -0
- package/dist/src/choices/tokenizer.js.map +1 -1
- package/dist/src/configurable.d.ts +1 -0
- package/dist/src/configurable.js +1 -0
- package/dist/src/configurable.js.map +1 -1
- package/dist/src/converter.d.ts +10 -1
- package/dist/src/dialog.d.ts +14 -13
- package/dist/src/dialog.js +11 -10
- package/dist/src/dialog.js.map +1 -1
- package/dist/src/dialogContext.d.ts +34 -35
- package/dist/src/dialogContext.js +24 -25
- package/dist/src/dialogContext.js.map +1 -1
- package/dist/src/dialogEvent.d.ts +3 -0
- package/dist/src/dialogEvents.d.ts +20 -0
- package/dist/src/dialogEvents.js +20 -0
- package/dist/src/dialogEvents.js.map +1 -1
- package/dist/src/dialogHelper.js +14 -0
- package/dist/src/dialogHelper.js.map +1 -1
- package/dist/src/dialogManager.d.ts +0 -1
- package/dist/src/dialogManager.js +0 -1
- package/dist/src/dialogManager.js.map +1 -1
- package/dist/src/dialogSet.d.ts +5 -9
- package/dist/src/dialogSet.js +5 -9
- package/dist/src/dialogSet.js.map +1 -1
- package/dist/src/dialogTurnStateConstants.d.ts +13 -1
- package/dist/src/dialogTurnStateConstants.js +13 -1
- package/dist/src/dialogTurnStateConstants.js.map +1 -1
- package/dist/src/intentScore.d.ts +6 -0
- package/dist/src/memory/dialogPath.d.ts +40 -8
- package/dist/src/memory/dialogPath.js +32 -8
- package/dist/src/memory/dialogPath.js.map +1 -1
- package/dist/src/memory/dialogStateManager.d.ts +2 -2
- package/dist/src/memory/dialogStateManager.js +2 -2
- package/dist/src/memory/pathResolvers/aliasPathResolver.d.ts +4 -0
- package/dist/src/memory/pathResolvers/aliasPathResolver.js +4 -0
- package/dist/src/memory/pathResolvers/aliasPathResolver.js.map +1 -1
- package/dist/src/memory/pathResolvers/atAtPathResolver.d.ts +6 -2
- package/dist/src/memory/pathResolvers/atAtPathResolver.js +6 -2
- package/dist/src/memory/pathResolvers/atAtPathResolver.js.map +1 -1
- package/dist/src/memory/pathResolvers/atPathResolver.d.ts +13 -7
- package/dist/src/memory/pathResolvers/atPathResolver.js +13 -7
- package/dist/src/memory/pathResolvers/atPathResolver.js.map +1 -1
- package/dist/src/memory/pathResolvers/dollarPathResolver.d.ts +7 -2
- package/dist/src/memory/pathResolvers/dollarPathResolver.js +7 -2
- package/dist/src/memory/pathResolvers/dollarPathResolver.js.map +1 -1
- package/dist/src/memory/pathResolvers/hashPathResolver.d.ts +7 -2
- package/dist/src/memory/pathResolvers/hashPathResolver.js +7 -2
- package/dist/src/memory/pathResolvers/hashPathResolver.js.map +1 -1
- package/dist/src/memory/pathResolvers/pathResolver.d.ts +10 -5
- package/dist/src/memory/pathResolvers/percentPathResolver.d.ts +7 -2
- package/dist/src/memory/pathResolvers/percentPathResolver.js +7 -2
- package/dist/src/memory/pathResolvers/percentPathResolver.js.map +1 -1
- package/dist/src/memory/scopePath.d.ts +27 -0
- package/dist/src/memory/scopePath.js +27 -0
- package/dist/src/memory/scopePath.js.map +1 -1
- package/dist/src/memory/scopes/classMemoryScope.d.ts +18 -14
- package/dist/src/memory/scopes/classMemoryScope.js +18 -14
- package/dist/src/memory/scopes/classMemoryScope.js.map +1 -1
- package/dist/src/memory/scopes/dialogClassMemoryScope.d.ts +12 -6
- package/dist/src/memory/scopes/dialogClassMemoryScope.js +12 -6
- package/dist/src/memory/scopes/dialogClassMemoryScope.js.map +1 -1
- package/dist/src/memory/scopes/dialogContextMemoryScope.d.ts +11 -7
- package/dist/src/memory/scopes/dialogContextMemoryScope.js +11 -7
- package/dist/src/memory/scopes/dialogContextMemoryScope.js.map +1 -1
- package/dist/src/memory/scopes/dialogMemoryScope.d.ts +23 -16
- package/dist/src/memory/scopes/dialogMemoryScope.js +23 -16
- package/dist/src/memory/scopes/dialogMemoryScope.js.map +1 -1
- package/dist/src/memory/scopes/turnMemoryScope.d.ts +14 -13
- package/dist/src/memory/scopes/turnMemoryScope.js +14 -13
- package/dist/src/memory/scopes/turnMemoryScope.js.map +1 -1
- package/dist/src/memory/turnPath.d.ts +61 -13
- package/dist/src/memory/turnPath.js +49 -13
- package/dist/src/memory/turnPath.js.map +1 -1
- package/dist/src/prompts/attachmentPrompt.d.ts +1 -1
- package/dist/src/prompts/attachmentPrompt.js +1 -1
- package/dist/src/prompts/choicePrompt.d.ts +17 -3
- package/dist/src/prompts/choicePrompt.js +1 -1
- package/dist/src/prompts/choicePrompt.js.map +1 -1
- package/dist/src/prompts/confirmPrompt.d.ts +6 -6
- package/dist/src/prompts/confirmPrompt.js +3 -3
- package/dist/src/prompts/datetimePrompt.d.ts +6 -6
- package/dist/src/prompts/datetimePrompt.js +3 -3
- package/dist/src/prompts/numberPrompt.d.ts +6 -6
- package/dist/src/prompts/numberPrompt.js +6 -6
- package/dist/src/prompts/prompt.d.ts +7 -7
- package/dist/src/prompts/prompt.js +2 -2
- package/dist/src/prompts/promptCultureModels.d.ts +38 -3
- package/dist/src/prompts/promptCultureModels.js +38 -3
- package/dist/src/prompts/promptCultureModels.js.map +1 -1
- package/dist/src/recognizer.d.ts +8 -1
- package/dist/src/recognizer.js +5 -1
- package/dist/src/recognizer.js.map +1 -1
- package/dist/src/recognizerResult.d.ts +15 -0
- package/dist/src/recognizerResult.js.map +1 -1
- package/dist/src/serviceCollection.d.ts +22 -22
- package/dist/src/serviceCollection.js +11 -11
- package/dist/src/waterfallDialog.d.ts +5 -5
- package/dist/src/waterfallDialog.js +5 -5
- package/dist/src/waterfallStepContext.d.ts +21 -0
- package/dist/src/waterfallStepContext.js.map +1 -1
- package/package.json +2 -2
- package/src/agentComponent.ts +18 -4
- package/src/agentStateSet.ts +2 -2
- package/src/choices/choice.ts +11 -0
- package/src/choices/findChoices.ts +15 -0
- package/src/choices/findValues.ts +33 -0
- package/src/choices/modelResult.ts +25 -0
- package/src/choices/tokenizer.ts +19 -0
- package/src/configurable.ts +1 -0
- package/src/converter.ts +10 -1
- package/src/dialog.ts +14 -13
- package/src/dialogContext.ts +42 -43
- package/src/dialogEvent.ts +3 -0
- package/src/dialogEvents.ts +25 -0
- package/src/dialogHelper.ts +14 -1
- package/src/dialogManager.ts +0 -1
- package/src/dialogSet.ts +5 -9
- package/src/dialogTurnStateConstants.ts +15 -1
- package/src/intentScore.ts +9 -2
- package/src/memory/dialogPath.ts +47 -23
- package/src/memory/dialogStateManager.ts +2 -2
- package/src/memory/pathResolvers/aliasPathResolver.ts +4 -0
- package/src/memory/pathResolvers/atAtPathResolver.ts +6 -2
- package/src/memory/pathResolvers/atPathResolver.ts +13 -7
- package/src/memory/pathResolvers/dollarPathResolver.ts +7 -2
- package/src/memory/pathResolvers/hashPathResolver.ts +7 -2
- package/src/memory/pathResolvers/pathResolver.ts +10 -5
- package/src/memory/pathResolvers/percentPathResolver.ts +7 -2
- package/src/memory/scopePath.ts +35 -0
- package/src/memory/scopes/classMemoryScope.ts +18 -14
- package/src/memory/scopes/dialogClassMemoryScope.ts +12 -6
- package/src/memory/scopes/dialogContextMemoryScope.ts +11 -7
- package/src/memory/scopes/dialogMemoryScope.ts +23 -16
- package/src/memory/scopes/turnMemoryScope.ts +14 -13
- package/src/memory/turnPath.ts +61 -25
- package/src/prompts/attachmentPrompt.ts +1 -1
- package/src/prompts/choicePrompt.ts +18 -3
- package/src/prompts/confirmPrompt.ts +6 -6
- package/src/prompts/datetimePrompt.ts +6 -6
- package/src/prompts/numberPrompt.ts +6 -6
- package/src/prompts/prompt.ts +7 -7
- package/src/prompts/promptCultureModels.ts +38 -3
- package/src/recognizer.ts +8 -1
- package/src/recognizerResult.ts +24 -5
- package/src/serviceCollection.ts +22 -22
- package/src/waterfallDialog.ts +5 -5
- package/src/waterfallStepContext.ts +32 -6
|
@@ -13,10 +13,10 @@ import { DialogTurnResult } from './dialogTurnResult';
|
|
|
13
13
|
import { Choice } from './choices';
|
|
14
14
|
import { Activity } from '@microsoft/agents-activity';
|
|
15
15
|
/**
|
|
16
|
-
* Contains dialog state, information about the state of the dialog stack, for a specific DialogSet.
|
|
16
|
+
* Contains dialog state, information about the state of the dialog stack, for a specific {@link DialogSet}.
|
|
17
17
|
*
|
|
18
18
|
* @remarks
|
|
19
|
-
* State is read from and saved to storage each turn, and state cache for the turn is managed through the TurnContext.
|
|
19
|
+
* State is read from and saved to storage each turn, and state cache for the turn is managed through the {@link @microsoft/agents-hosting.TurnContext}.
|
|
20
20
|
*
|
|
21
21
|
* For more information, see the articles on
|
|
22
22
|
* [Managing state](https://docs.microsoft.com/azure/bot-service/bot-builder-concept-state) and
|
|
@@ -24,17 +24,17 @@ import { Activity } from '@microsoft/agents-activity';
|
|
|
24
24
|
*/
|
|
25
25
|
export interface DialogState {
|
|
26
26
|
/**
|
|
27
|
-
* Contains state information for each Dialog on the stack.
|
|
27
|
+
* Contains state information for each {@link Dialog} on the stack.
|
|
28
28
|
*/
|
|
29
29
|
dialogStack: DialogInstance[];
|
|
30
30
|
}
|
|
31
31
|
/**
|
|
32
|
-
* The context for the current dialog turn with respect to a specific DialogSet.
|
|
32
|
+
* The context for the current dialog turn with respect to a specific {@link DialogSet}.
|
|
33
33
|
*
|
|
34
34
|
* @remarks
|
|
35
35
|
* This includes the turn context, information about the dialog set, and the state of the dialog stack.
|
|
36
36
|
*
|
|
37
|
-
* From code outside of a dialog in the set, use DialogSet.createContext
|
|
37
|
+
* From code outside of a dialog in the set, use {@link DialogSet.createContext | DialogSet.createContext method}
|
|
38
38
|
* to create the dialog context. Then use the methods of the dialog context to manage the progression of dialogs in the set.
|
|
39
39
|
*
|
|
40
40
|
* When you implement a dialog, the dialog context is a parameter available to the various methods you override or implement.
|
|
@@ -44,21 +44,21 @@ export declare class DialogContext {
|
|
|
44
44
|
/**
|
|
45
45
|
* Creates an new instance of the DialogContext class.
|
|
46
46
|
*
|
|
47
|
-
* @param dialogs The DialogSet for which to create the dialog context.
|
|
48
|
-
* @param contextOrDialogContext The TurnContext object for the current turn.
|
|
49
|
-
* @param state The state object to use to read and write DialogState to storage.
|
|
47
|
+
* @param dialogs The `DialogSet` for which to create the dialog context.
|
|
48
|
+
* @param contextOrDialogContext The `TurnContext` object for the current turn.
|
|
49
|
+
* @param state The state object to use to read and write `DialogState` to storage.
|
|
50
50
|
* @remarks
|
|
51
|
-
* Passing in a DialogContext instance will clone the dialog context.
|
|
51
|
+
* Passing in a `DialogContext` instance will clone the dialog context.
|
|
52
52
|
*/
|
|
53
53
|
constructor(dialogs: DialogSet, contextOrDialogContext: TurnContext, state: DialogState);
|
|
54
54
|
/**
|
|
55
55
|
* Creates an new instance of the DialogContext class.
|
|
56
56
|
*
|
|
57
|
-
* @param dialogs The DialogSet for which to create the dialog context.
|
|
58
|
-
* @param contextOrDialogContext The DialogContext object for the current turn.
|
|
59
|
-
* @param state The state object to use to read and write DialogState to storage.
|
|
57
|
+
* @param dialogs The `DialogSet` for which to create the dialog context.
|
|
58
|
+
* @param contextOrDialogContext The `DialogContext` object for the current turn.
|
|
59
|
+
* @param state The state object to use to read and write `DialogState` to storage.
|
|
60
60
|
* @remarks
|
|
61
|
-
* Passing in a DialogContext instance will clone the dialog context.
|
|
61
|
+
* Passing in a `DialogContext` instance will clone the dialog context.
|
|
62
62
|
*/
|
|
63
63
|
constructor(dialogs: DialogSet, contextOrDialogContext: DialogContext, state: DialogState);
|
|
64
64
|
/**
|
|
@@ -77,8 +77,8 @@ export declare class DialogContext {
|
|
|
77
77
|
* The parent dialog context for this dialog context, or `undefined` if this context doesn't have a parent.
|
|
78
78
|
*
|
|
79
79
|
* @remarks
|
|
80
|
-
* When it attempts to start a dialog, the dialog context searches for the Dialog.id
|
|
81
|
-
* in its DialogContext.dialogs. If the dialog to start is not found
|
|
80
|
+
* When it attempts to start a dialog, the dialog context searches for the {@link Dialog.id}
|
|
81
|
+
* in its {@link DialogContext.dialogs}. If the dialog to start is not found
|
|
82
82
|
* in this dialog context, it searches in its parent dialog context, and so on.
|
|
83
83
|
*/
|
|
84
84
|
parent: DialogContext | undefined;
|
|
@@ -92,7 +92,7 @@ export declare class DialogContext {
|
|
|
92
92
|
*/
|
|
93
93
|
get activeDialog(): DialogInstance | undefined;
|
|
94
94
|
/**
|
|
95
|
-
* Gets the DialogStateManager which manages view of all memory scopes.
|
|
95
|
+
* Gets the {@link DialogStateManager} which manages view of all memory scopes.
|
|
96
96
|
*/
|
|
97
97
|
state: DialogStateManager;
|
|
98
98
|
/**
|
|
@@ -100,8 +100,7 @@ export declare class DialogContext {
|
|
|
100
100
|
*/
|
|
101
101
|
services: TurnContextStateCollection;
|
|
102
102
|
/**
|
|
103
|
-
* @
|
|
104
|
-
* @returns The current dialog manager instance. This property is deprecated.
|
|
103
|
+
* @returns The current dialog manager instance.
|
|
105
104
|
*/
|
|
106
105
|
get dialogManager(): DialogManager;
|
|
107
106
|
/**
|
|
@@ -121,7 +120,7 @@ export declare class DialogContext {
|
|
|
121
120
|
* If there's already an active dialog on the stack, that dialog will be paused until
|
|
122
121
|
* it is again the top dialog on the stack.
|
|
123
122
|
*
|
|
124
|
-
* The DialogTurnResult.status of returned object describes
|
|
123
|
+
* The {@link DialogTurnResult.status} of returned object describes
|
|
125
124
|
* the status of the dialog stack after this method completes.
|
|
126
125
|
*
|
|
127
126
|
* This method throws an exception if the requested dialog can't be found in this dialog context
|
|
@@ -137,12 +136,12 @@ export declare class DialogContext {
|
|
|
137
136
|
* @param eventValue Optional. Value to pass along with custom cancellation event.
|
|
138
137
|
* @returns {Promise<DialogTurnResult>} a promise resolving to the dialog turn result.
|
|
139
138
|
* @remarks
|
|
140
|
-
* This calls each dialog's
|
|
139
|
+
* This calls each dialog's {@link Dialog.endDialog | endDialog method} before
|
|
141
140
|
* removing the dialog from the stack.
|
|
142
141
|
*
|
|
143
142
|
* If there were any dialogs on the stack initially, the DialogTurnResult.status
|
|
144
|
-
* of the return value is DialogTurnStatus.cancelled; otherwise, it's
|
|
145
|
-
* DialogTurnStatus.empty.
|
|
143
|
+
* of the return value is {@link DialogTurnStatus.cancelled}; otherwise, it's
|
|
144
|
+
* {@link DialogTurnStatus.empty}.
|
|
146
145
|
*
|
|
147
146
|
*/
|
|
148
147
|
cancelAllDialogs(cancelParents?: boolean, eventName?: string, eventValue?: any): Promise<DialogTurnResult>;
|
|
@@ -152,7 +151,7 @@ export declare class DialogContext {
|
|
|
152
151
|
* @param dialogId ID of the dialog to search for.
|
|
153
152
|
* @returns The dialog for the provided ID.
|
|
154
153
|
* @remarks
|
|
155
|
-
* If the dialog to start is not found in the DialogSet associated
|
|
154
|
+
* If the dialog to start is not found in the {@link DialogSet} associated
|
|
156
155
|
* with this dialog context, it attempts to find the dialog in its parent dialog context.
|
|
157
156
|
*
|
|
158
157
|
*/
|
|
@@ -167,7 +166,7 @@ export declare class DialogContext {
|
|
|
167
166
|
*
|
|
168
167
|
* @remarks
|
|
169
168
|
* This helper method formats the object to use as the `options` parameter, and then calls
|
|
170
|
-
* DialogContext.beginDialog to start the specified prompt dialog.
|
|
169
|
+
* {@link DialogContext.beginDialog} to start the specified prompt dialog.
|
|
171
170
|
*
|
|
172
171
|
*/
|
|
173
172
|
prompt(dialogId: string, promptOrOptions: string | Partial<Activity> | PromptOptions): Promise<DialogTurnResult>;
|
|
@@ -176,26 +175,26 @@ export declare class DialogContext {
|
|
|
176
175
|
*
|
|
177
176
|
* @param dialogId ID of the prompt dialog to start.
|
|
178
177
|
* @param promptOrOptions The text of the initial prompt to send the user,
|
|
179
|
-
* the Activity to send as the initial prompt, or
|
|
178
|
+
* the {@link @microsoft/agents-activity.Activity} to send as the initial prompt, or
|
|
180
179
|
* the object with which to format the prompt dialog.
|
|
181
180
|
* @param choices Optional. Array of choices for the user to choose from,
|
|
182
|
-
* for use with a ChoicePrompt.
|
|
181
|
+
* for use with a {@link ChoicePrompt}.
|
|
183
182
|
* @remarks
|
|
184
183
|
* This helper method formats the object to use as the `options` parameter, and then calls
|
|
185
|
-
* DialogContext.beginDialog to start the specified prompt dialog.
|
|
184
|
+
* {@link DialogContext.beginDialog} to start the specified prompt dialog.
|
|
186
185
|
*
|
|
187
186
|
*/
|
|
188
187
|
prompt(dialogId: string, promptOrOptions: string | Partial<Activity> | PromptOptions, choices: (string | Choice)[]): Promise<DialogTurnResult>;
|
|
189
188
|
/**
|
|
190
189
|
* Continues execution of the active dialog, if there is one, by passing this dialog context to its
|
|
191
|
-
*
|
|
190
|
+
* {@link DialogContext.continueDialog} method.
|
|
192
191
|
*
|
|
193
192
|
* @returns {Promise<DialogTurnResult>} a promise resolving to the dialog turn result.
|
|
194
193
|
* @remarks
|
|
195
|
-
* After the call completes, you can check the turn context's TurnContext.responded
|
|
194
|
+
* After the call completes, you can check the turn context's {@link @microsoft/agents-hosting.TurnContext.responded | TurnContext.responded}
|
|
196
195
|
* property to determine if the dialog sent a reply to the user.
|
|
197
196
|
*
|
|
198
|
-
* The DialogTurnResult.status of returned object describes
|
|
197
|
+
* The {@link DialogTurnResult.status} of returned object describes
|
|
199
198
|
* the status of the dialog stack after this method completes.
|
|
200
199
|
*
|
|
201
200
|
* Typically, you would call this from within your agent's turn handler.
|
|
@@ -211,12 +210,12 @@ export declare class DialogContext {
|
|
|
211
210
|
* @returns {Promise<DialogTurnResult>} a promise resolving to the dialog turn result.
|
|
212
211
|
* @remarks
|
|
213
212
|
* The _parent_ dialog is the next dialog on the dialog stack, if there is one. This method
|
|
214
|
-
* calls the parent's Dialog.resumeDialog method,
|
|
213
|
+
* calls the parent's {@link Dialog.resumeDialog} method,
|
|
215
214
|
* passing the result returned by the ending dialog. If there is no parent dialog, the turn ends
|
|
216
215
|
* and the result is available to the agent through the returned object's
|
|
217
|
-
* DialogTurnResult.result property.
|
|
216
|
+
* {@link DialogTurnResult.result} property.
|
|
218
217
|
*
|
|
219
|
-
* The DialogTurnResult.status of returned object describes
|
|
218
|
+
* The {@link DialogTurnResult.status} of returned object describes
|
|
220
219
|
* the status of the dialog stack after this method completes.
|
|
221
220
|
*
|
|
222
221
|
* Typically, you would call this from within the logic for a specific dialog to signal back to
|
|
@@ -234,7 +233,7 @@ export declare class DialogContext {
|
|
|
234
233
|
* @remarks
|
|
235
234
|
* This is particularly useful for creating a loop or redirecting to another dialog.
|
|
236
235
|
*
|
|
237
|
-
* The DialogTurnResult.status of returned object describes
|
|
236
|
+
* The {@link DialogTurnResult.status} of returned object describes
|
|
238
237
|
* the status of the dialog stack after this method completes.
|
|
239
238
|
*
|
|
240
239
|
* This method is similar to ending the current dialog and immediately beginning the new one.
|
|
@@ -246,7 +245,7 @@ export declare class DialogContext {
|
|
|
246
245
|
* Requests the active dialog to re-prompt the user for input.
|
|
247
246
|
*
|
|
248
247
|
* @remarks
|
|
249
|
-
* This calls the active dialog's Dialog.repromptDialog method.
|
|
248
|
+
* This calls the active dialog's {@link Dialog.repromptDialog} method.
|
|
250
249
|
*
|
|
251
250
|
*/
|
|
252
251
|
repromptDialog(): Promise<void>;
|
|
@@ -38,12 +38,12 @@ const wrapErrors = async (dialogContext, promise) => {
|
|
|
38
38
|
*/
|
|
39
39
|
const ACTIVITY_RECEIVED_EMITTED = Symbol('ActivityReceivedEmitted');
|
|
40
40
|
/**
|
|
41
|
-
* The context for the current dialog turn with respect to a specific DialogSet.
|
|
41
|
+
* The context for the current dialog turn with respect to a specific {@link DialogSet}.
|
|
42
42
|
*
|
|
43
43
|
* @remarks
|
|
44
44
|
* This includes the turn context, information about the dialog set, and the state of the dialog stack.
|
|
45
45
|
*
|
|
46
|
-
* From code outside of a dialog in the set, use DialogSet.createContext
|
|
46
|
+
* From code outside of a dialog in the set, use {@link DialogSet.createContext | DialogSet.createContext method}
|
|
47
47
|
* to create the dialog context. Then use the methods of the dialog context to manage the progression of dialogs in the set.
|
|
48
48
|
*
|
|
49
49
|
* When you implement a dialog, the dialog context is a parameter available to the various methods you override or implement.
|
|
@@ -51,12 +51,12 @@ const ACTIVITY_RECEIVED_EMITTED = Symbol('ActivityReceivedEmitted');
|
|
|
51
51
|
*/
|
|
52
52
|
class DialogContext {
|
|
53
53
|
/**
|
|
54
|
-
* Creates an new instance of the DialogContext class.
|
|
54
|
+
* Creates an new instance of the `DialogContext` class.
|
|
55
55
|
*
|
|
56
|
-
* @param dialogs The DialogSet for which to create the dialog context.
|
|
57
|
-
* @param contextOrDialogContext The TurnContext or DialogContext for the current turn.
|
|
58
|
-
* @param state The state object to use to read and write DialogState to storage.
|
|
59
|
-
* @remarks Passing in a DialogContext instance will clone the dialog context.
|
|
56
|
+
* @param dialogs The `DialogSet` for which to create the dialog context.
|
|
57
|
+
* @param contextOrDialogContext The `TurnContext` or `DialogContext` for the current turn.
|
|
58
|
+
* @param state The state object to use to read and write `DialogState` to storage.
|
|
59
|
+
* @remarks Passing in a `DialogContext` instance will clone the dialog context.
|
|
60
60
|
*/
|
|
61
61
|
constructor(dialogs, contextOrDialogContext, state) {
|
|
62
62
|
/**
|
|
@@ -105,8 +105,7 @@ class DialogContext {
|
|
|
105
105
|
return this.stack.length > 0 ? this.stack[this.stack.length - 1] : undefined;
|
|
106
106
|
}
|
|
107
107
|
/**
|
|
108
|
-
* @
|
|
109
|
-
* @returns The current dialog manager instance. This property is deprecated.
|
|
108
|
+
* @returns The current dialog manager instance.
|
|
110
109
|
*/
|
|
111
110
|
get dialogManager() {
|
|
112
111
|
return this.context.turnState.get(dialogTurnStateConstants_1.DialogTurnStateConstants.dialogManager);
|
|
@@ -140,7 +139,7 @@ class DialogContext {
|
|
|
140
139
|
* If there's already an active dialog on the stack, that dialog will be paused until
|
|
141
140
|
* it is again the top dialog on the stack.
|
|
142
141
|
*
|
|
143
|
-
* The DialogTurnResult.status of returned object describes
|
|
142
|
+
* The {@link DialogTurnResult.status} of returned object describes
|
|
144
143
|
* the status of the dialog stack after this method completes.
|
|
145
144
|
*
|
|
146
145
|
* This method throws an exception if the requested dialog can't be found in this dialog context
|
|
@@ -170,12 +169,12 @@ class DialogContext {
|
|
|
170
169
|
* @param eventValue Optional. Value to pass along with custom cancellation event.
|
|
171
170
|
* @returns {Promise<DialogTurnResult>} a promise resolving to the dialog turn result.
|
|
172
171
|
* @remarks
|
|
173
|
-
* This calls each dialog's
|
|
172
|
+
* This calls each dialog's {@link Dialog.endDialog | endDialog method} before
|
|
174
173
|
* removing the dialog from the stack.
|
|
175
174
|
*
|
|
176
175
|
* If there were any dialogs on the stack initially, the DialogTurnResult.status
|
|
177
|
-
* of the return value is DialogTurnStatus.cancelled; otherwise, it's
|
|
178
|
-
* DialogTurnStatus.empty.
|
|
176
|
+
* of the return value is {@link DialogTurnStatus.cancelled}; otherwise, it's
|
|
177
|
+
* {@link DialogTurnStatus.empty}.
|
|
179
178
|
*
|
|
180
179
|
*/
|
|
181
180
|
async cancelAllDialogs(cancelParents = false, eventName, eventValue) {
|
|
@@ -214,7 +213,7 @@ class DialogContext {
|
|
|
214
213
|
* @param dialogId ID of the dialog to search for.
|
|
215
214
|
* @returns The dialog for the provided ID.
|
|
216
215
|
* @remarks
|
|
217
|
-
* If the dialog to start is not found in the DialogSet associated
|
|
216
|
+
* If the dialog to start is not found in the {@link DialogSet} associated
|
|
218
217
|
* with this dialog context, it attempts to find the dialog in its parent dialog context.
|
|
219
218
|
*
|
|
220
219
|
*/
|
|
@@ -230,12 +229,12 @@ class DialogContext {
|
|
|
230
229
|
*
|
|
231
230
|
* @param dialogId ID of the prompt dialog to start.
|
|
232
231
|
* @param promptOrOptions The text of the initial prompt to send the user,
|
|
233
|
-
* or the Activity to send as the initial prompt.
|
|
232
|
+
* or the {@link @microsoft/agents-activity.Activity} to send as the initial prompt.
|
|
234
233
|
* @param choices Optional. Array of choices for the user to choose from,
|
|
235
|
-
* for use with a ChoicePrompt.
|
|
234
|
+
* for use with a {@link ChoicePrompt}.
|
|
236
235
|
* @returns {Promise<DialogTurnResult>} a promise resolving to the dialog turn result.
|
|
237
236
|
* @remarks This helper method formats the object to use as the `options` parameter, and then calls
|
|
238
|
-
* beginDialog to start the specified prompt dialog.
|
|
237
|
+
* {@link DialogContext.beginDialog} to start the specified prompt dialog.
|
|
239
238
|
*
|
|
240
239
|
*/
|
|
241
240
|
async prompt(dialogId, promptOrOptions, choices) {
|
|
@@ -254,14 +253,14 @@ class DialogContext {
|
|
|
254
253
|
}
|
|
255
254
|
/**
|
|
256
255
|
* Continues execution of the active dialog, if there is one, by passing this dialog context to its
|
|
257
|
-
*
|
|
256
|
+
* {@link DialogContext.continueDialog} method.
|
|
258
257
|
*
|
|
259
258
|
* @returns {Promise<DialogTurnResult>} a promise resolving to the dialog turn result.
|
|
260
259
|
* @remarks
|
|
261
|
-
* After the call completes, you can check the turn context's TurnContext.responded
|
|
260
|
+
* After the call completes, you can check the turn context's {@link @microsoft/agents-hosting.TurnContext.responded | TurnContext.responded}
|
|
262
261
|
* property to determine if the dialog sent a reply to the user.
|
|
263
262
|
*
|
|
264
|
-
* The DialogTurnResult.status of returned object describes
|
|
263
|
+
* The {@link DialogTurnResult.status} of returned object describes
|
|
265
264
|
* the status of the dialog stack after this method completes.
|
|
266
265
|
*
|
|
267
266
|
* Typically, you would call this from within your agent's turn handler.
|
|
@@ -300,12 +299,12 @@ class DialogContext {
|
|
|
300
299
|
* @returns {Promise<DialogTurnResult>} a promise resolving to the dialog turn result.
|
|
301
300
|
* @remarks
|
|
302
301
|
* The _parent_ dialog is the next dialog on the dialog stack, if there is one. This method
|
|
303
|
-
* calls the parent's Dialog.resumeDialog method,
|
|
302
|
+
* calls the parent's {@link Dialog.resumeDialog} method,
|
|
304
303
|
* passing the result returned by the ending dialog. If there is no parent dialog, the turn ends
|
|
305
304
|
* and the result is available to the agent through the returned object's
|
|
306
|
-
* DialogTurnResult.result property.
|
|
305
|
+
* {@link DialogTurnResult.result} property.
|
|
307
306
|
*
|
|
308
|
-
* The DialogTurnResult.status of returned object describes
|
|
307
|
+
* The {@link DialogTurnResult.status} of returned object describes
|
|
309
308
|
* the status of the dialog stack after this method completes.
|
|
310
309
|
*
|
|
311
310
|
* Typically, you would call this from within the logic for a specific dialog to signal back to
|
|
@@ -341,7 +340,7 @@ class DialogContext {
|
|
|
341
340
|
* @remarks
|
|
342
341
|
* This is particularly useful for creating a loop or redirecting to another dialog.
|
|
343
342
|
*
|
|
344
|
-
* The DialogTurnResult.status of returned object describes
|
|
343
|
+
* The {@link DialogTurnResult.status} of returned object describes
|
|
345
344
|
* the status of the dialog stack after this method completes.
|
|
346
345
|
*
|
|
347
346
|
* This method is similar to ending the current dialog and immediately beginning the new one.
|
|
@@ -358,7 +357,7 @@ class DialogContext {
|
|
|
358
357
|
* Requests the active dialog to re-prompt the user for input.
|
|
359
358
|
*
|
|
360
359
|
* @remarks
|
|
361
|
-
* This calls the active dialog's Dialog.repromptDialog method.
|
|
360
|
+
* This calls the active dialog's {@link Dialog.repromptDialog} method.
|
|
362
361
|
*
|
|
363
362
|
*/
|
|
364
363
|
async repromptDialog() {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"dialogContext.js","sourceRoot":"","sources":["../../src/dialogContext.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,8DAAmF;AAInF,qCAAuD;AACvD,uDAAmD;AACnD,iDAA6C;AAE7C,yEAAqE;AACrE,6DAAyD;AAEzD,iDAA6C;AAG7C,yDAAqD;AAIrD;;;;;;GAMG;AACH,MAAM,UAAU,GAAG,KAAK,EAAK,aAA4B,EAAE,OAAmB,EAAc,EAAE;IAC5F,IAAI,CAAC;QACH,OAAO,MAAM,OAAO,CAAA;IACtB,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,IAAI,GAAG,YAAY,uCAAkB,EAAE,CAAC;YACtC,MAAM,GAAG,CAAA;QACX,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,uCAAkB,CAAC,GAAY,EAAE,aAAa,CAAC,CAAA;QAC3D,CAAC;IACH,CAAC;AACH,CAAC,CAAA;AAED;;GAEG;AACH,MAAM,yBAAyB,GAAG,MAAM,CAAC,yBAAyB,CAAC,CAAA;AAmBnE;;;;;;;;;;;GAWG;AACH,MAAa,aAAa;IAuBxB;;;;;;;SAOK;IACL,YAAa,OAAkB,EAAE,sBAAmD,EAAE,KAAkB;QA2ExG;;aAEK;QACL,aAAQ,GAA+B,IAAI,2CAA0B,EAAE,CAAA;QA7ErE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;QACtB,IAAI,sBAAsB,YAAY,aAAa,EAAE,CAAC;YACpD,IAAI,CAAC,OAAO,GAAG,sBAAsB,CAAC,OAAO,CAAA;YAC7C,IAAI,CAAC,MAAM,GAAG,sBAAsB,CAAA;YACpC,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;gBACzB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,EAAQ,EAAE;oBAChD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;gBAC/B,CAAC,CAAC,CAAA;YACJ,CAAC;QACH,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,OAAO,GAAG,sBAAsB,CAAA;QACvC,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC;YACtC,KAAK,CAAC,WAAW,GAAG,EAAE,CAAA;QACxB,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,WAAW,CAAA;QAC9B,IAAI,CAAC,KAAK,GAAG,IAAI,2BAAkB,CAAC,IAAI,CAAC,CAAA;QACzC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,iBAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC/D,CAAC;IA2BD;;SAEK;IACL,IAAI,KAAK;QACP,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAA;QAClC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,gCAAgC;YAChC,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;YAC3C,IAAI,MAAM,YAAY,iCAAe,EAAE,CAAC;gBACtC,OAAO,MAAM,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAA;YACxC,CAAC;QACH,CAAC;QAED,OAAO,SAAS,CAAA;IAClB,CAAC;IAED;;;SAGK;IACL,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IAC9E,CAAC;IAYD
|
|
1
|
+
{"version":3,"file":"dialogContext.js","sourceRoot":"","sources":["../../src/dialogContext.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,3 +1,6 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Represents an event that occurs within a dialog, providing details such as its name, whether it should bubble to parent contexts, and any associated value.
|
|
3
|
+
*/
|
|
1
4
|
export interface DialogEvent {
|
|
2
5
|
/**
|
|
3
6
|
* Flag indicating whether the event will be bubbled to the parent `DialogContext`.
|
|
@@ -4,12 +4,32 @@
|
|
|
4
4
|
*/
|
|
5
5
|
/**
|
|
6
6
|
* Represents the events related to the "lifecycle" of the dialog.
|
|
7
|
+
*
|
|
8
|
+
* These events are used to signal various stages or actions within a dialog's lifecycle.
|
|
7
9
|
*/
|
|
8
10
|
export declare class DialogEvents {
|
|
11
|
+
/**
|
|
12
|
+
* Event triggered when a dialog begins.
|
|
13
|
+
*/
|
|
9
14
|
static readonly beginDialog = "beginDialog";
|
|
15
|
+
/**
|
|
16
|
+
* Event triggered to reprompt a dialog.
|
|
17
|
+
*/
|
|
10
18
|
static readonly repromptDialog = "repromptDialog";
|
|
19
|
+
/**
|
|
20
|
+
* Event triggered when a dialog is canceled.
|
|
21
|
+
*/
|
|
11
22
|
static readonly cancelDialog = "cancelDialog";
|
|
23
|
+
/**
|
|
24
|
+
* Event triggered when an activity is received.
|
|
25
|
+
*/
|
|
12
26
|
static readonly activityReceived = "activityReceived";
|
|
27
|
+
/**
|
|
28
|
+
* Event triggered when the dialog version changes.
|
|
29
|
+
*/
|
|
13
30
|
static readonly versionChanged = "versionChanged";
|
|
31
|
+
/**
|
|
32
|
+
* Event triggered when an error occurs.
|
|
33
|
+
*/
|
|
14
34
|
static readonly error = "error";
|
|
15
35
|
}
|
package/dist/src/dialogEvents.js
CHANGED
|
@@ -7,14 +7,34 @@ Object.defineProperty(exports, "__esModule", { value: true });
|
|
|
7
7
|
exports.DialogEvents = void 0;
|
|
8
8
|
/**
|
|
9
9
|
* Represents the events related to the "lifecycle" of the dialog.
|
|
10
|
+
*
|
|
11
|
+
* These events are used to signal various stages or actions within a dialog's lifecycle.
|
|
10
12
|
*/
|
|
11
13
|
class DialogEvents {
|
|
12
14
|
}
|
|
13
15
|
exports.DialogEvents = DialogEvents;
|
|
16
|
+
/**
|
|
17
|
+
* Event triggered when a dialog begins.
|
|
18
|
+
*/
|
|
14
19
|
DialogEvents.beginDialog = 'beginDialog';
|
|
20
|
+
/**
|
|
21
|
+
* Event triggered to reprompt a dialog.
|
|
22
|
+
*/
|
|
15
23
|
DialogEvents.repromptDialog = 'repromptDialog';
|
|
24
|
+
/**
|
|
25
|
+
* Event triggered when a dialog is canceled.
|
|
26
|
+
*/
|
|
16
27
|
DialogEvents.cancelDialog = 'cancelDialog';
|
|
28
|
+
/**
|
|
29
|
+
* Event triggered when an activity is received.
|
|
30
|
+
*/
|
|
17
31
|
DialogEvents.activityReceived = 'activityReceived';
|
|
32
|
+
/**
|
|
33
|
+
* Event triggered when the dialog version changes.
|
|
34
|
+
*/
|
|
18
35
|
DialogEvents.versionChanged = 'versionChanged';
|
|
36
|
+
/**
|
|
37
|
+
* Event triggered when an error occurs.
|
|
38
|
+
*/
|
|
19
39
|
DialogEvents.error = 'error';
|
|
20
40
|
//# sourceMappingURL=dialogEvents.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"dialogEvents.js","sourceRoot":"","sources":["../../src/dialogEvents.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH
|
|
1
|
+
{"version":3,"file":"dialogEvents.js","sourceRoot":"","sources":["../../src/dialogEvents.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH;;;;GAIG;AACH,MAAa,YAAY;;AAAzB,oCA8BC;AA7BC;;GAEG;AACa,wBAAW,GAAG,aAAa,CAAA;AAE3C;;GAEG;AACa,2BAAc,GAAG,gBAAgB,CAAA;AAEjD;;GAEG;AACa,yBAAY,GAAG,cAAc,CAAA;AAE7C;;GAEG;AACa,6BAAgB,GAAG,kBAAkB,CAAA;AAErD;;GAEG;AACa,2BAAc,GAAG,gBAAgB,CAAA;AAEjD;;GAEG;AACa,kBAAK,GAAG,OAAO,CAAA"}
|
package/dist/src/dialogHelper.js
CHANGED
|
@@ -79,6 +79,14 @@ async function internalRun(context, dialogId, dialogContext, dialogStateManagerC
|
|
|
79
79
|
// return the redundant result because the DialogManager contract expects it
|
|
80
80
|
return dialogTurnResult;
|
|
81
81
|
}
|
|
82
|
+
/**
|
|
83
|
+
* Executes the dialog by either continuing an existing dialog or starting a new one.
|
|
84
|
+
*
|
|
85
|
+
* @param context The TurnContext for the turn.
|
|
86
|
+
* @param dialogId The ID of the dialog to start or continue.
|
|
87
|
+
* @param dialogContext The DialogContext for the current turn of conversation.
|
|
88
|
+
* @returns A promise resolving to the result of the dialog turn.
|
|
89
|
+
*/
|
|
82
90
|
async function innerRun(context, dialogId, dialogContext) {
|
|
83
91
|
// Continue or start the dialog.
|
|
84
92
|
let result = await dialogContext.continueDialog();
|
|
@@ -102,6 +110,12 @@ function getActiveDialogContext(dialogContext) {
|
|
|
102
110
|
return getActiveDialogContext(child);
|
|
103
111
|
}
|
|
104
112
|
// Helper to send a trace activity with a memory snapshot of the active dialog DC.
|
|
113
|
+
/**
|
|
114
|
+
* Sends a trace activity containing a memory snapshot of the active dialog context.
|
|
115
|
+
*
|
|
116
|
+
* @param dialogContext The DialogContext for the current turn of conversation.
|
|
117
|
+
* @returns A promise that resolves when the trace activity is sent.
|
|
118
|
+
*/
|
|
105
119
|
const sendStateSnapshotTrace = async (dialogContext) => {
|
|
106
120
|
const traceLabel = 'Agent State';
|
|
107
121
|
// Send trace of memory
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"dialogHelper.js","sourceRoot":"","sources":["../../src/dialogHelper.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAsBH,8BA2BC;AASD,kCA6CC;
|
|
1
|
+
{"version":3,"file":"dialogHelper.js","sourceRoot":"","sources":["../../src/dialogHelper.ts"],"names":[],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"dialogManager.js","sourceRoot":"","sources":["../../src/dialogManager.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,8DAMkC;AAClC,mDAA+C;AAC/C,iDAA6C;AAC7C,uDAAmD;AACnD,mDAA4D;AAC5D,iDAA4C;AAC5C,2CAAuC;AACvC,yEAAqE;AAKrE,MAAM,WAAW,GAAG,aAAa,CAAA;AACjC,MAAM,kBAAkB,GAAG,mBAAmB,CAAA;AAC9C,MAAM,UAAU,GAAG,WAAW,CAAA;AAc9B
|
|
1
|
+
{"version":3,"file":"dialogManager.js","sourceRoot":"","sources":["../../src/dialogManager.ts"],"names":[],"mappings":"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"}
|
package/dist/src/dialogSet.d.ts
CHANGED
|
@@ -18,8 +18,8 @@ export interface DialogDependencies {
|
|
|
18
18
|
* The constructor for the dialog set should be passed a state property that will be used to
|
|
19
19
|
* persist the dialog stack for the set:
|
|
20
20
|
*
|
|
21
|
-
* To interact with the sets dialogs you can call createcontext with the
|
|
22
|
-
* current
|
|
21
|
+
* To interact with the sets dialogs you can call `createcontext` with the
|
|
22
|
+
* current {@link @microsoft/agents-hosting.TurnContext}. That will create a {@link DialogContext} that can be used to start or continue
|
|
23
23
|
* execution of the sets dialogs:
|
|
24
24
|
*
|
|
25
25
|
*/
|
|
@@ -31,8 +31,8 @@ export declare class DialogSet {
|
|
|
31
31
|
* Creates a new DialogSet instance.
|
|
32
32
|
*
|
|
33
33
|
* @remarks
|
|
34
|
-
* If the `dialogState`
|
|
35
|
-
* will return an error. You will need to create a
|
|
34
|
+
* If the `dialogState` parameter is not passed in, calls to {@link @microsoft/agents-hosting-dialogs.DialogSet.createcontext | createContext}
|
|
35
|
+
* will return an error. You will need to create a {@link DialogContext} for the set manually and
|
|
36
36
|
* pass in your own state object for persisting the sets dialog stack:
|
|
37
37
|
*
|
|
38
38
|
* @param dialogState (Optional) state property used to persist the sets dialog stack.
|
|
@@ -50,7 +50,7 @@ export declare class DialogSet {
|
|
|
50
50
|
* Adds a new dialog or prompt to the set.
|
|
51
51
|
*
|
|
52
52
|
* @remarks
|
|
53
|
-
* If the
|
|
53
|
+
* If the {@link Dialog.id} being added already exists in the set, the dialogs id will be updated to
|
|
54
54
|
* include a suffix which makes it unique. So adding 2 dialogs named "duplicate" to the set
|
|
55
55
|
* would result in the first one having an id of "duplicate" and the second one having an id
|
|
56
56
|
* of "duplicate2".
|
|
@@ -68,10 +68,6 @@ export declare class DialogSet {
|
|
|
68
68
|
createContext(context: TurnContext): Promise<DialogContext>;
|
|
69
69
|
/**
|
|
70
70
|
* Finds a dialog that was previously added to the set using add.
|
|
71
|
-
*
|
|
72
|
-
* @remarks
|
|
73
|
-
* This example finds a dialog named "greeting":
|
|
74
|
-
*
|
|
75
71
|
* @param dialogId ID of the dialog or prompt to lookup.
|
|
76
72
|
* @returns The dialog if found; otherwise undefined.
|
|
77
73
|
*/
|
package/dist/src/dialogSet.js
CHANGED
|
@@ -11,8 +11,8 @@ const stringUtils_1 = require("./stringUtils");
|
|
|
11
11
|
* The constructor for the dialog set should be passed a state property that will be used to
|
|
12
12
|
* persist the dialog stack for the set:
|
|
13
13
|
*
|
|
14
|
-
* To interact with the sets dialogs you can call createcontext with the
|
|
15
|
-
* current
|
|
14
|
+
* To interact with the sets dialogs you can call `createcontext` with the
|
|
15
|
+
* current {@link @microsoft/agents-hosting.TurnContext}. That will create a {@link DialogContext} that can be used to start or continue
|
|
16
16
|
* execution of the sets dialogs:
|
|
17
17
|
*
|
|
18
18
|
*/
|
|
@@ -21,8 +21,8 @@ class DialogSet {
|
|
|
21
21
|
* Creates a new DialogSet instance.
|
|
22
22
|
*
|
|
23
23
|
* @remarks
|
|
24
|
-
* If the `dialogState`
|
|
25
|
-
* will return an error. You will need to create a
|
|
24
|
+
* If the `dialogState` parameter is not passed in, calls to {@link @microsoft/agents-hosting-dialogs.DialogSet.createcontext | createContext}
|
|
25
|
+
* will return an error. You will need to create a {@link DialogContext} for the set manually and
|
|
26
26
|
* pass in your own state object for persisting the sets dialog stack:
|
|
27
27
|
*
|
|
28
28
|
* @param dialogState (Optional) state property used to persist the sets dialog stack.
|
|
@@ -55,7 +55,7 @@ class DialogSet {
|
|
|
55
55
|
* Adds a new dialog or prompt to the set.
|
|
56
56
|
*
|
|
57
57
|
* @remarks
|
|
58
|
-
* If the
|
|
58
|
+
* If the {@link Dialog.id} being added already exists in the set, the dialogs id will be updated to
|
|
59
59
|
* include a suffix which makes it unique. So adding 2 dialogs named "duplicate" to the set
|
|
60
60
|
* would result in the first one having an id of "duplicate" and the second one having an id
|
|
61
61
|
* of "duplicate2".
|
|
@@ -115,10 +115,6 @@ class DialogSet {
|
|
|
115
115
|
}
|
|
116
116
|
/**
|
|
117
117
|
* Finds a dialog that was previously added to the set using add.
|
|
118
|
-
*
|
|
119
|
-
* @remarks
|
|
120
|
-
* This example finds a dialog named "greeting":
|
|
121
|
-
*
|
|
122
118
|
* @param dialogId ID of the dialog or prompt to lookup.
|
|
123
119
|
* @returns The dialog if found; otherwise undefined.
|
|
124
120
|
*/
|