diff --git a/core/core.slnx b/core/core.slnx
index 5bd7088e..1adeb2fb 100644
--- a/core/core.slnx
+++ b/core/core.slnx
@@ -19,6 +19,7 @@
+
diff --git a/core/samples/HtmlWidgetBot/HtmlWidgetBot.csproj b/core/samples/HtmlWidgetBot/HtmlWidgetBot.csproj
new file mode 100644
index 00000000..a718b9f3
--- /dev/null
+++ b/core/samples/HtmlWidgetBot/HtmlWidgetBot.csproj
@@ -0,0 +1,14 @@
+
+
+
+ net10.0
+ enable
+ enable
+ $(NoWarn);ExperimentalTeamsHtmlWidget
+
+
+
+
+
+
+
diff --git a/core/samples/HtmlWidgetBot/Program.cs b/core/samples/HtmlWidgetBot/Program.cs
new file mode 100644
index 00000000..773f5cc2
--- /dev/null
+++ b/core/samples/HtmlWidgetBot/Program.cs
@@ -0,0 +1,370 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+
+using System.Text.Json;
+
+using Microsoft.Teams.Apps;
+using Microsoft.Teams.Apps.Handlers;
+using Microsoft.Teams.Apps.HtmlWidget;
+using Microsoft.Teams.Apps.Schema;
+
+using HtmlWidgetBot;
+
+WebApplicationBuilder webAppBuilder = WebApplication.CreateSlimBuilder(args);
+webAppBuilder.Services.AddTeamsBotApplication();
+WebApplication webApp = webAppBuilder.Build();
+
+TeamsBotApplication teamsApp = webApp.UseTeamsBotApplication();
+
+// ==================== MESSAGE COMMANDS ====================
+
+teamsApp.OnMessage(async (context, cancellationToken) =>
+{
+ var text = context.Activity.Text?.Trim().ToLowerInvariant() ?? "";
+
+ switch (text)
+ {
+ case "/simple":
+ {
+ var message = HtmlWidgetHelpers.BuildHtmlWidgetMessage(
+ new HtmlWidgetPayload
+ {
+ Name = "Simple Widget",
+ Description = "A static HTML widget with no callbacks.",
+ Html = Widgets.SimpleHtml,
+ Domain = "https://teams.microsoft.com",
+ SecurityPolicy = new HtmlWidgetSecurityPolicy
+ {
+ ConnectDomains = [],
+ ResourceDomains = ["'self'", "data:"],
+ FrameDomains = [],
+ BaseUriDomains = [],
+ },
+ },
+ new HtmlWidgetMarkdownOptions
+ {
+ Before = "Here is a simple static widget:",
+ After = "No callbacks needed for static content.",
+ });
+ await context.SendActivityAsync(message, cancellationToken);
+ break;
+ }
+
+ case "/calltool":
+ {
+ var message = HtmlWidgetHelpers.BuildHtmlWidgetMessage(
+ new HtmlWidgetPayload
+ {
+ Name = "CallTool Widget",
+ Description = "Widget that calls tools on the bot.",
+ Html = Widgets.CallToolHtml,
+ Domain = "https://teams.microsoft.com",
+ SecurityPolicy = new HtmlWidgetSecurityPolicy
+ {
+ ConnectDomains = ["https://teams.microsoft.com", "https://teams.cloud.microsoft.com"],
+ ResourceDomains = ["'self'", "data:"],
+ FrameDomains = [],
+ BaseUriDomains = [],
+ },
+ ToolInput = new { demo = true },
+ ToolOutput = new
+ {
+ content = new[] { new { type = "text", text = "Initial data loaded." } },
+ structuredContent = new { counter = 0, lastAction = "init" },
+ isError = false,
+ },
+ },
+ new HtmlWidgetMarkdownOptions
+ {
+ Before = "Here is a widget with callTool support (click Refresh):",
+ });
+ await context.SendActivityAsync(message, cancellationToken);
+ break;
+ }
+
+ case "/messageback":
+ {
+ var message = HtmlWidgetHelpers.BuildHtmlWidgetMessage(
+ new HtmlWidgetPayload
+ {
+ Name = "MessageBack Widget",
+ Description = "Widget that sends messageBack to the bot.",
+ Html = Widgets.MessageBackHtml,
+ Domain = "https://teams.microsoft.com",
+ SecurityPolicy = new HtmlWidgetSecurityPolicy
+ {
+ ConnectDomains = [],
+ ResourceDomains = ["'self'", "data:"],
+ FrameDomains = [],
+ BaseUriDomains = [],
+ },
+ },
+ new HtmlWidgetMarkdownOptions
+ {
+ Before = "This widget tests the onMessage (messageBack) callback:",
+ });
+ await context.SendActivityAsync(message, cancellationToken);
+ break;
+ }
+
+ case "/fullscreen":
+ {
+ var message = HtmlWidgetHelpers.BuildHtmlWidgetMessage(
+ new HtmlWidgetPayload
+ {
+ Name = "Fullscreen Widget",
+ Description = "Widget that requests fullscreen mode.",
+ Html = Widgets.FullscreenHtml,
+ Domain = "https://teams.microsoft.com",
+ SecurityPolicy = new HtmlWidgetSecurityPolicy
+ {
+ ConnectDomains = [],
+ ResourceDomains = ["'self'", "data:"],
+ FrameDomains = [],
+ BaseUriDomains = [],
+ },
+ },
+ new HtmlWidgetMarkdownOptions
+ {
+ Before = "This widget will request fullscreen mode:",
+ });
+ await context.SendActivityAsync(message, cancellationToken);
+ break;
+ }
+
+ case "/multi":
+ {
+ var message = HtmlWidgetHelpers.BuildHtmlWidgetMessage(
+ new HtmlWidgetPayload
+ {
+ Name = "Multi-Tool Widget",
+ Description = "Widget that calls multiple different tools.",
+ Html = Widgets.MultiToolHtml,
+ Domain = "https://teams.microsoft.com",
+ SecurityPolicy = new HtmlWidgetSecurityPolicy
+ {
+ ConnectDomains = ["https://teams.microsoft.com"],
+ ResourceDomains = ["'self'", "data:"],
+ FrameDomains = [],
+ BaseUriDomains = [],
+ },
+ ToolInput = new { },
+ ToolOutput = new
+ {
+ content = new[] { new { type = "text", text = "Ready." } },
+ structuredContent = new { tools = new[] { "getTime", "roll", "echo" } },
+ isError = false,
+ },
+ },
+ new HtmlWidgetMarkdownOptions
+ {
+ Before = "This widget has multiple tools to test dispatch:",
+ });
+ await context.SendActivityAsync(message, cancellationToken);
+ break;
+ }
+
+ case "/openlink":
+ {
+ var message = HtmlWidgetHelpers.BuildHtmlWidgetMessage(
+ new HtmlWidgetPayload
+ {
+ Name = "open-link-test",
+ Html = Widgets.OpenLinkHtml,
+ Domain = "https://teams.microsoft.com",
+ },
+ new HtmlWidgetMarkdownOptions
+ {
+ Before = "Widget with ui/open-link support (click a button to open a URL):",
+ });
+ await context.SendActivityAsync(message, cancellationToken);
+ break;
+ }
+
+ case "/context":
+ {
+ var message = HtmlWidgetHelpers.BuildHtmlWidgetMessage(
+ new HtmlWidgetPayload
+ {
+ Name = "update-context-test",
+ Html = Widgets.UpdateContextHtml,
+ Domain = "https://teams.microsoft.com",
+ },
+ new HtmlWidgetMarkdownOptions
+ {
+ Before = "Widget with ui/update-model-context support:",
+ });
+ await context.SendActivityAsync(message, cancellationToken);
+ break;
+ }
+
+ case "/hostcontext":
+ {
+ var message = HtmlWidgetHelpers.BuildHtmlWidgetMessage(
+ new HtmlWidgetPayload
+ {
+ Name = "host-context-inspector",
+ Html = Widgets.HostContextHtml,
+ Domain = "https://teams.microsoft.com",
+ },
+ new HtmlWidgetMarkdownOptions
+ {
+ Before = "Widget that inspects hostContext from ui/initialize:",
+ });
+ await context.SendActivityAsync(message, cancellationToken);
+ break;
+ }
+
+ case "/validate":
+ {
+ var htmlWithExternalRefs = """
+
+
+
Validation Demo
+
This widget was validated before sending.
+
+
Hello from HTML Widget!
+
This is a static widget with no callbacks. It demonstrates basic HTML rendering in Teams.
+
+ Rendered at:
+
+
+
+
CallTool Widget
+
Ready
+
+
+
+
+
MessageBack Widget
+
Click a button to send a messageBack to the bot:
+
+
+
+
+
Fullscreen Widget
+
Current mode: inline
+
+
+
+
+
Multi-Tool Widget
+
+
+
+
+
+
+
+
+
Open Link Widget
+
+
+
+
+ """;
+
+ public const string UpdateContextHtml = """
+
+
Update Context Widget
+
+
+
+
+
+
Host Context Inspector
+
Waiting for ui/initialize...
+
+