DialogRouter.cs
1 //
2 // Copyright (c) Microsoft. All rights reserved.
3 // Licensed under the MIT license.
4 //
5 // Microsoft Bot Framework: http://botframework.com
6 //
7 // Bot Builder SDK GitHub:
8 // https://github.com/Microsoft/BotBuilder
9 //
10 // Copyright (c) Microsoft Corporation
11 // All rights reserved.
12 //
13 // MIT License:
14 // Permission is hereby granted, free of charge, to any person obtaining
15 // a copy of this software and associated documentation files (the
16 // "Software"), to deal in the Software without restriction, including
17 // without limitation the rights to use, copy, modify, merge, publish,
18 // distribute, sublicense, and/or sell copies of the Software, and to
19 // permit persons to whom the Software is furnished to do so, subject to
20 // the following conditions:
21 //
22 // The above copyright notice and this permission notice shall be
23 // included in all copies or substantial portions of the Software.
24 //
25 // THE SOFTWARE IS PROVIDED ""AS IS"", WITHOUT WARRANTY OF ANY KIND,
26 // EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
27 // MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
28 // NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
29 // LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
30 // OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
31 // WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
32 //
33 
34 using System;
35 using System.Collections.Generic;
36 using System.Linq;
37 
40 using Microsoft.Bot.Connector;
42 
43 namespace Microsoft.Bot.Builder.Dialogs.Internals
44 {
48  public sealed class DialogRouter : DelegatingScorable<IActivity, double>
49  {
50  public static IEnumerable<IScorable<IActivity, double>> EnumerateRelevant(
51  IDialogStack stack,
52  IEnumerable<IScorable<IActivity, double>> fromActivity,
53  IEnumerable<IScorable<IResolver, double>> fromResolver,
54  Func<IActivity, IResolver> makeResolver)
55  {
56  // first, let's go through stack frames
57  var targets = stack.Frames.Select(f => f.Target);
58  foreach (var target in targets)
59  {
60  var activityScorable = target as IScorable<IActivity, double>;
61  if (activityScorable != null)
62  {
63  yield return activityScorable;
64  }
65 
66  var resolverScorable = target as IScorable<IResolver, double>;
67  if (resolverScorable != null)
68  {
69  yield return resolverScorable.SelectItem(makeResolver);
70  }
71  }
72 
73  // then global scorables "on the side"
74  foreach (var activityScorable in fromActivity)
75  {
76  yield return activityScorable;
77  }
78 
79  foreach (var resolverScorable in fromResolver)
80  {
81  yield return resolverScorable.SelectItem(makeResolver);
82  }
83  }
84 
86  IDialogStack stack,
87  IEnumerable<IScorable<IActivity, double>> fromActivity,
88  IEnumerable<IScorable<IResolver, double>> fromResolver,
89  Func<IActivity, IResolver> makeResolver,
90  ITraits<double> traits,
91  IComparer<double> comparer)
92  {
93  // since the stack of scorables changes over time, this should be lazy
94  var relevant = EnumerateRelevant(stack, fromActivity, fromResolver, makeResolver);
95  var significant = relevant.Select(s => s.WhereScore((_, score) => comparer.Compare(score, traits.Minimum) >= 0));
96  var scorable = new TraitsScorable<IActivity, double>(traits, comparer, significant);
97  return scorable;
98  }
99 
100  public DialogRouter(
101  IDialogStack stack,
102  IEnumerable<IScorable<IActivity, double>> fromActivity,
103  IEnumerable<IScorable<IResolver, double>> fromResolver,
104  Func<IActivity, IResolver> makeResolver,
105  ITraits<double> traits,
106  IComparer<double> comparer)
107  : base(MakeDelegate(stack, fromActivity, fromResolver, makeResolver, traits, comparer))
108  {
109  }
110  }
111 }
Namespace for the Microsoft Bot Connector SDK.
IReadOnlyList< Delegate > Frames
The dialog frames active on the stack.
Definition: IDialogTask.cs:51
Allow the scoring of items, with external comparison of scores, and enable the winner to take some ac...
Definition: Scorable.cs:49
Scorable for Dialog module routing.
Definition: DialogRouter.cs:48
Namespace for internal scorable implementation that is not useful for most developers and may change ...
Namespace for scorable interfaces, classes and compositions.
Namespace for internal machinery that is not useful for most developers and may change in the future...
DialogRouter(IDialogStack stack, IEnumerable< IScorable< IActivity, double >> fromActivity, IEnumerable< IScorable< IResolver, double >> fromResolver, Func< IActivity, IResolver > makeResolver, ITraits< double > traits, IComparer< double > comparer)
static IEnumerable< IScorable< IActivity, double > > EnumerateRelevant(IDialogStack stack, IEnumerable< IScorable< IActivity, double >> fromActivity, IEnumerable< IScorable< IResolver, double >> fromResolver, Func< IActivity, IResolver > makeResolver)
Definition: DialogRouter.cs:50
Namespace for the internal fibers machinery that is not useful for most developers and may change in ...
The stack of dialogs in the conversational process.
Definition: IDialogTask.cs:46
Root namespace for the Microsoft Bot Builder SDK.
static IScorable< IActivity, double > MakeDelegate(IDialogStack stack, IEnumerable< IScorable< IActivity, double >> fromActivity, IEnumerable< IScorable< IResolver, double >> fromResolver, Func< IActivity, IResolver > makeResolver, ITraits< double > traits, IComparer< double > comparer)
Definition: DialogRouter.cs:85