Composer samples

.gitignore

@@ -171,6 +171,9 @@ PublishScripts/
 **/packages/*
 # except build/, which is used as an MSBuild target.
 !**/packages/build/
+# except is specific places in composer-samples
+!composer-samples/csharp_dotnetcore/packages/*
+!composer-samples/javascript_nodejs/packages/*
 # Uncomment if necessary however generally it will be regenerated when needed
 #!**/packages/repositories.config
 # NuGet v3's project.json files produces more ignoreable files

composer-samples/csharp_dotnetcore/packages/DialogAndTriggerPackage/MemberUpdatesBotComponent.cs

@@ -0,0 +1,33 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+
+using Microsoft.Bot.Builder;
+using Microsoft.Bot.Builder.Dialogs.Declarative;
+using Microsoft.Extensions.Configuration;
+using Microsoft.Extensions.DependencyInjection;
+
+namespace Microsoft.Bot.Components.Samples.DialogAndTriggerPackage
+{
+    /// <summary>
+    /// Definition of a <see cref="Microsoft.Bot.Builder.BotComponent"/> that allows registration of
+    /// services, custom actions, memory scopes and adapters.
+    /// </summary>
+    /// To make your components available to the system you derive from BotComponent and register services to add functionality.
+    /// These components then are consumed in appropriate places by the systems that need them. When using Composer, Startup gets called
+    /// automatically on the components by the bot runtime, as long as the components are registered in the configuration.
+    public class MemberUpdatesBotComponent : BotComponent
+    {
+        /// <summary>
+        /// Entry point for bot components to register types in resource explorer, consume configuration and register services in the
+        /// services collection.
+        /// </summary>
+        /// <param name="services">Services collection to register dependency injection.</param>
+        /// <param name="configuration">Configuration for the bot component.</param>
+        public override void ConfigureServices(IServiceCollection services, IConfiguration configuration)
+        {
+            // Anything that could be done in Startup.ConfigureServices can be done here.
+            // In this case, the OnMembersAdded and OnMembersRemoved needs to be added as a new DeclarativeTypes.
+            services.AddSingleton<DeclarativeType>(sp => new DeclarativeType<OnMembersAdded>(OnMembersAdded.Kind));
+        }
+    }
+}

composer-samples/csharp_dotnetcore/packages/DialogAndTriggerPackage/Microsoft.Bot.Components.Samples.DialogAndTriggerPackage.csproj

@@ -0,0 +1,24 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Library</OutputType>
+    <TargetFramework>netcoreapp3.1</TargetFramework>
+	<PackageId>Microsoft.Bot.Components.Samples.DialogAndTriggerPackage</PackageId>
+	<Description>This library implements .NET support for a custom trigger and an Adaptive dialog.</Description>
+	<Summary>This library implements .NET support for a custom trigger (OnMembersAdded) and an Adaptive dialog (WelcomeDialog).</Summary>
+	<ContentTargetFolders>content</ContentTargetFolders>
+	<PackageTags>msbot-component;msbot-content;msbot-trigger</PackageTags>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <Content Include="**/*.schema" />
+    <Content Include="**/*.uischema" />
+    <None Include="exported/**/*.*" Pack="true" PackagePath="exported" />
+    <None Include="README.md" Condition="Exists('README.md')" Pack="true" PackagePath="" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.Bot.Builder.Dialogs.Adaptive.Runtime" Version="4.13.1" />
+  </ItemGroup>
+
+</Project>

composer-samples/csharp_dotnetcore/packages/DialogAndTriggerPackage/README.md

@@ -0,0 +1,13 @@
+# Microsoft.Bot.Components.Samples.DialogAndTriggerPackage
+
+This sample package contains a dialog and supporting declarative assets for greeting new and returning users, as well as a custom trigger that fires when new members join the conversation.
+
+## Getting started
+
+* Published it to a NuGet feed.  For testing purposes, this is easiest when done to a [local feed](https://docs.microsoft.com/nuget/hosting-packages/local-feeds). After setting up the local feed, add it to the Package Manager in Composer so that your local packages can be installed in a bot.
+
+* Once you've installed the package in Composer, you can use it in your bot.
+
+## Feedback and issues
+
+If you encounter any issues with this package, or would like to share any feedback please open an Issue in our [GitHub repository](https://github.com/microsoft/botframework-components/issues/new/choose).

composer-samples/csharp_dotnetcore/packages/DialogAndTriggerPackage/Schemas/TriggerConditions/Microsoft.OnMembersAdded.schema

@@ -0,0 +1,9 @@
+{
+    "$schema": "https://schemas.botframework.com/schemas/component/v1.0/component.schema",
+    "$role": [ "implements(Microsoft.ITrigger)", "extends(Microsoft.OnCondition)" ],
+    "title": "On Members Added",
+    "description": "Actions to perform on receipt of an activity with type 'ConversationUpdate' and MembersAdded > 0.",
+    "type": "object",
+    "required": [
+    ]
+}

composer-samples/csharp_dotnetcore/packages/DialogAndTriggerPackage/Schemas/TriggerConditions/Microsoft.OnMembersAdded.uischema

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://schemas.botframework.com/schemas/ui/v1.0/ui.schema",
+  "form": {
+      "order": [
+          "condition",
+          "*"
+      ],
+      "hidden": [
+          "actions"
+      ],
+      "label": "Members Added",
+      "subtitle": "Members Added ConversationUpdate activity",
+      "description": "Handle the events fired when a members have been added to a conversation.",
+      "helpLink": "https://aka.ms/bf-composer-docs-conversation-update-activity"
+  },
+  "trigger": {
+		"label": "Members Added (ConversationUpdate activity)",
+		"order": 5.2,
+		"submenu": "Activities"
+	}
+}

composer-samples/csharp_dotnetcore/packages/DialogAndTriggerPackage/TriggerConditions/OnMembersAdded.cs

@@ -0,0 +1,49 @@
+// Licensed under the MIT License.
+// Copyright (c) Microsoft Corporation. All rights reserved.
+
+using System.Collections.Generic;
+using System.Runtime.CompilerServices;
+using AdaptiveExpressions;
+using Microsoft.Bot.Builder.Dialogs;
+using Microsoft.Bot.Builder.Dialogs.Adaptive.Conditions;
+using Microsoft.Bot.Schema;
+using Newtonsoft.Json;
+
+namespace Microsoft.Bot.Components.Samples.DialogAndTriggerPackage
+{
+    /// <summary>
+    /// Actions triggered when ConversationUpdateActivity is received with Activity.MembersAdded > 0.
+    /// </summary>
+    public class OnMembersAdded : OnActivity
+    {
+        /// <summary>
+        /// Gets the unique name (class identifier) of this trigger.
+        /// </summary>
+        /// <remarks>
+        /// There should be at least a .schema file of the same name.  There can optionally be a
+        /// .uischema file of the same name that describes how Composer displays this trigger.
+        /// </remarks>
+        [JsonProperty("$kind")]
+        public new const string Kind = "Microsoft.OnMembersAdded";
+
+        /// <summary>
+        /// Initializes a new instance of the <see cref="OnMembersAdded"/> class.
+        /// </summary>
+        /// <param name="actions">Optional, list of <see cref="Dialog"/> actions.</param>
+        /// <param name="condition">Optional, condition which needs to be met for the actions to be executed.</param>
+        /// <param name="callerPath">Optional, source file full path.</param>
+        /// <param name="callerLine">Optional, line number in source file.</param>
+        [JsonConstructor]
+        public OnMembersAdded(List<Dialog> actions = null, string condition = null, [CallerFilePath] string callerPath = "", [CallerLineNumber] int callerLine = 0)
+            : base(type: ActivityTypes.ConversationUpdate, actions: actions, condition: condition, callerPath: callerPath, callerLine: callerLine)
+        {
+        }
+
+        /// <inheritdoc/>
+        protected override Expression CreateExpression()
+        {
+            // The Activity.MembersAdded list must have more than 0 items.
+            return Expression.AndExpression(Expression.Parse($"count({TurnPath.Activity}.MembersAdded) > 0"), base.CreateExpression());
+        }
+    }
+}

composer-samples/csharp_dotnetcore/packages/DialogAndTriggerPackage/exported/WelcomeDialog/WelcomeDialog.dialog

@@ -0,0 +1,61 @@
+{
+  "$kind": "Microsoft.AdaptiveDialog",
+  "$designer": {
+    "$designer": {
+      "name": "WelcomeDialog",
+      "description": "Greets new and returning users",
+      "id": "8pOkoq"
+    },
+    "name": "WelcomeDialog"
+  },
+  "autoEndDialog": true,
+  "defaultResultProperty": "dialog.result",
+  "triggers": [
+    {
+      "$kind": "Microsoft.OnBeginDialog",
+      "$designer": {
+        "id": "tcqJ5M",
+        "name": "BeginDialog"
+      },
+      "actions": [
+        {
+          "$kind": "Microsoft.IfCondition",
+          "$designer": {
+            "id": "sF0fYv"
+          },
+          "condition": "exists(user.greeted)",
+          "actions": [
+            {
+              "$kind": "Microsoft.SendActivity",
+              "$designer": {
+                "id": "PsAJ3p"
+              },
+              "activity": "${SendActivity_WelcomeReturningUser()}"
+            }
+          ],
+          "elseActions": [
+            {
+              "$kind": "Microsoft.SendActivity",
+              "$designer": {
+                "id": "f3uG2y"
+              },
+              "activity": "${SendActivity_WelcomeNewUser()}"
+            },
+            {
+              "$kind": "Microsoft.SetProperty",
+              "$designer": {
+                "id": "ucFnwQ"
+              },
+              "property": "user.greeted",
+              "value": "true"
+            }
+          ]
+        }
+      ]
+    }
+  ],
+  "$schema": "https://raw.githubusercontent.com/microsoft/BotFramework-Composer/stable/Composer/packages/server/schemas/sdk.schema",
+  "generator": "WelcomeDialog.lg",
+  "id": "WelcomeDialog",
+  "recognizer": "WelcomeDialog.lu.qna"
+}

composer-samples/csharp_dotnetcore/packages/DialogAndTriggerPackage/exported/WelcomeDialog/language-generation/en-us/WelcomeDialog.en-us.lg

@@ -0,0 +1,23 @@
+[import](common.lg)
+
+# SendActivity_WelcomeReturningUser()
+[Activity
+    Text = ${SendActivity_WelcomeReturningUser_text()}
+]
+
+# SendActivity_WelcomeReturningUser_text()
+- 🖐️ Welcome back! How can I help you today?
+- 🖐️ Hello again! What can I help with?
+- 🖐️ Good to see you again. What do you want to do today?
+- 🖐️ Hey, there! Let's get started.
+- 🖐️ Hello again! How can I help?
+
+# SendActivity_WelcomeNewUser()
+[Activity
+    Text = ${SendActivity_WelcomeNewUser_text()}
+]
+
+# SendActivity_WelcomeNewUser_text()
+- 🖐️ Hey, there! How can I help you today?
+- 🖐️ Hi! How can I help?
+- 🖐️ Hello! What do you want to do today?

composer-samples/csharp_dotnetcore/packages/DialogAndTriggerPackage/exported/WelcomeDialog/recognizers/WelcomeDialog.en-us.lu.dialog

@@ -0,0 +1,8 @@
+{
+  "$kind": "Microsoft.LuisRecognizer",
+  "id": "LUIS_WelcomeDialog",
+  "applicationId": "=settings.luis.WelcomeDialog_en_us_lu.appId",
+  "version": "=settings.luis.WelcomeDialog_en_us_lu.version",
+  "endpoint": "=settings.luis.endpoint",
+  "endpointKey": "=settings.luis.endpointKey"
+}

composer-samples/csharp_dotnetcore/packages/DialogAndTriggerPackage/exported/WelcomeDialog/recognizers/WelcomeDialog.lu.dialog

@@ -0,0 +1,5 @@
+{
+  "$kind": "Microsoft.MultiLanguageRecognizer",
+  "id": "LUIS_WelcomeDialog",
+  "recognizers": {}
+}

composer-samples/csharp_dotnetcore/packages/DialogAndTriggerPackage/exported/WelcomeDialog/recognizers/WelcomeDialog.lu.qna.dialog

@@ -0,0 +1,4 @@
+{
+  "$kind": "Microsoft.CrossTrainedRecognizerSet",
+  "recognizers": []
+}

composer-samples/csharp_dotnetcore/packages/MemberUpdates/MemberUpdatesBotComponent.cs

@@ -0,0 +1,34 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+
+using Microsoft.Bot.Builder;
+using Microsoft.Bot.Builder.Dialogs.Declarative;
+using Microsoft.Extensions.Configuration;
+using Microsoft.Extensions.DependencyInjection;
+
+namespace Microsoft.Bot.Components.Samples.MemberUpdates
+{
+    /// <summary>
+    /// Definition of a <see cref="Microsoft.Bot.Builder.BotComponent"/> that allows registration of
+    /// services, custom actions, memory scopes and adapters.
+    /// </summary>
+    /// To make your components available to the system you derive from BotComponent and register services to add functionality.
+    /// These components then are consumed in appropriate places by the systems that need them. When using Composer, Startup gets called
+    /// automatically on the components by the bot runtime, as long as the components are registered in the configuration.
+    public class MemberUpdatesBotComponent : BotComponent
+    {
+        /// <summary>
+        /// Entry point for bot components to register types in resource explorer, consume configuration and register services in the
+        /// services collection.
+        /// </summary>
+        /// <param name="services">Services collection to register dependency injection.</param>
+        /// <param name="configuration">Configuration for the bot component.</param>
+        public override void ConfigureServices(IServiceCollection services, IConfiguration configuration)
+        {
+            // Anything that could be done in Startup.ConfigureServices can be done here.
+            // In this case, the OnMembersAdded and OnMembersRemoved needs to be added as a new DeclarativeTypes.
+            services.AddSingleton<DeclarativeType>(sp => new DeclarativeType<OnMembersAdded>(OnMembersAdded.Kind));
+            services.AddSingleton<DeclarativeType>(sp => new DeclarativeType<OnMembersRemoved>(OnMembersRemoved.Kind));
+        }
+    }
+}

composer-samples/csharp_dotnetcore/packages/MemberUpdates/Microsoft.Bot.Components.Samples.MemberUpdates.csproj

@@ -0,0 +1,24 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Library</OutputType>
+    <TargetFramework>netcoreapp3.1</TargetFramework>
+	<PackageId>Microsoft.Bot.Components.Samples.MemberUpdates</PackageId>
+	<Description>This library implements .NET support for custom triggers for conversation member updates.</Description>
+	<Summary>This library implements .NET support for custom triggers for conversation member updates.  OnMembersAdded and OnMembersRemoved.</Summary>
+	<ContentTargetFolders>content</ContentTargetFolders>
+	<PackageTags>msbot-component;msbot-trigger</PackageTags>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <Content Include="**/*.schema" />
+    <Content Include="**/*.uischema" />
+    <None Include="exported/**/*.*" Pack="true" PackagePath="exported" />
+    <None Include="README.md" Condition="Exists('README.md')" Pack="true" PackagePath="" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.Bot.Builder.Dialogs.Adaptive.Runtime" Version="4.13.1" />
+  </ItemGroup>
+
+</Project>

composer-samples/csharp_dotnetcore/packages/MemberUpdates/README.md

@@ -0,0 +1,13 @@
+# Microsoft.Bot.Component.Samples.MemberUpdates
+
+This sample demonstrates custom triggers for [Bot Framework Composer](https://docs.microsoft.com/composer) that fires when members are added or removed from the conversation.
+
+## Getting started
+
+* Published it to a NuGet feed.  For testing purposes, this is easiest when done to a [local feed](https://docs.microsoft.com/nuget/hosting-packages/local-feeds). After setting up the local feed, add it to the Package Manager in Composer so that your local packages can be installed in a bot.
+
+* Once you've installed the package in Composer, you can use it in your bot.
+
+## Feedback and issues
+
+If you encounter any issues with this package, or would like to share any feedback please open an Issue in our [GitHub repository](https://github.com/microsoft/botbuilder-samples/issues/new/choose).

composer-samples/csharp_dotnetcore/packages/MemberUpdates/Schemas/TriggerConditions/Microsoft.OnMembersAdded.schema

@@ -0,0 +1,9 @@
+{
+    "$schema": "https://schemas.botframework.com/schemas/component/v1.0/component.schema",
+    "$role": [ "implements(Microsoft.ITrigger)", "extends(Microsoft.OnCondition)" ],
+    "title": "On Members Added",
+    "description": "Actions to perform on receipt of an activity with type 'ConversationUpdate' and MembersAdded > 0.",
+    "type": "object",
+    "required": [
+    ]
+}

composer-samples/csharp_dotnetcore/packages/MemberUpdates/Schemas/TriggerConditions/Microsoft.OnMembersAdded.uischema

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://schemas.botframework.com/schemas/ui/v1.0/ui.schema",
+  "form": {
+      "order": [
+          "condition",
+          "*"
+      ],
+      "hidden": [
+          "actions"
+      ],
+      "label": "Members Added",
+      "subtitle": "Members Added ConversationUpdate activity",
+      "description": "Handle the events fired when a members have been added to a conversation.",
+      "helpLink": "https://aka.ms/bf-composer-docs-conversation-update-activity"
+  },
+  "trigger": {
+		"label": "Members Added (ConversationUpdate activity)",
+		"order": 5.2,
+		"submenu": "Activities"
+	}
+}

composer-samples/csharp_dotnetcore/packages/MemberUpdates/Schemas/TriggerConditions/Microsoft.OnMembersRemoved.schema

@@ -0,0 +1,9 @@
+{
+    "$schema": "https://schemas.botframework.com/schemas/component/v1.0/component.schema",
+    "$role": [ "implements(Microsoft.ITrigger)", "extends(Microsoft.OnCondition)" ],
+    "title": "On Members Removed",
+    "description": "Actions to perform on receipt of an activity with type 'ConversationUpdate' and MembersRemoved > 0.",
+    "type": "object",
+    "required": [
+    ]
+}