LOTS OF PLUMBING, but they go all the way from json to the ControlCore

src/cascadia/TerminalControl/ControlCore.cpp

@@ -130,6 +130,9 @@ namespace winrt::Microsoft::Terminal::Control::implementation
         auto pfnPlayMidiNote = std::bind(&ControlCore::_terminalPlayMidiNote, this, std::placeholders::_1, std::placeholders::_2, std::placeholders::_3);
         _terminal->SetPlayMidiNoteCallback(pfnPlayMidiNote);
 
+        auto pfnTrigger = std::bind(&ControlCore::_terminalTrigger, this, std::placeholders::_1, std::placeholders::_2);
+        _terminal->SetTriggerCallback(pfnTrigger);
+
         // MSFT 33353327: Initialize the renderer in the ctor instead of Initialize().
         // We need the renderer to be ready to accept new engines before the SwapChainPanel is ready to go.
         // If we wait, a screen reader may try to get the AutomationPeer (aka the UIA Engine), and we won't be able to attach
@@ -2137,4 +2140,14 @@ namespace winrt::Microsoft::Terminal::Control::implementation
             }
         }
     }
+
+    void ControlCore::_terminalTrigger(size_t index, std::wstring_view line)
+    {
+        if (index > _settings->Triggers().Size())
+            return;
+
+        auto pattern = _settings->Triggers().GetAt(base::saturated_cast<uint32_t>(index));
+
+        _TriggerHitHandlers(*this, *winrt::make_self<implementation::TriggerHitArgs>(index, line));
+    }
 }

src/cascadia/TerminalControl/ControlCore.h

@@ -219,6 +219,7 @@ namespace winrt::Microsoft::Terminal::Control::implementation
         TYPED_EVENT(ShowWindowChanged,         IInspectable, Control::ShowWindowArgs);
         TYPED_EVENT(UpdateSelectionMarkers,    IInspectable, Control::UpdateSelectionMarkersEventArgs);
         TYPED_EVENT(OpenHyperlink,             IInspectable, Control::OpenHyperlinkEventArgs);
+        TYPED_EVENT(TriggerHit,                IInspectable, Control::TriggerHitArgs);
         // clang-format on
 
     private:
@@ -291,6 +292,8 @@ namespace winrt::Microsoft::Terminal::Control::implementation
         void _terminalPlayMidiNote(const int noteNumber,
                                    const int velocity,
                                    const std::chrono::microseconds duration);
+
+        void _terminalTrigger(size_t index, std::wstring_view line);
 #pragma endregion
 
         std::unique_ptr<MidiAudio> _midiAudio;

src/cascadia/TerminalControl/ControlCore.idl

@@ -154,5 +154,7 @@ namespace Microsoft.Terminal.Control
         event Windows.Foundation.TypedEventHandler<Object, ShowWindowArgs> ShowWindowChanged;
         event Windows.Foundation.TypedEventHandler<Object, UpdateSelectionMarkersEventArgs> UpdateSelectionMarkers;
         event Windows.Foundation.TypedEventHandler<Object, OpenHyperlinkEventArgs> OpenHyperlink;
+
+        event Windows.Foundation.TypedEventHandler<Object, TriggerHitArgs> TriggerHit;
     };
 }

src/cascadia/TerminalControl/EventArgs.cpp

@@ -14,3 +14,4 @@
 #include "FoundResultsArgs.g.cpp"
 #include "ShowWindowArgs.g.cpp"
 #include "UpdateSelectionMarkersEventArgs.g.cpp"
+#include "TriggerHitArgs.g.cpp"

src/cascadia/TerminalControl/EventArgs.h

@@ -14,6 +14,7 @@
 #include "FoundResultsArgs.g.h"
 #include "ShowWindowArgs.g.h"
 #include "UpdateSelectionMarkersEventArgs.g.h"
+#include "TriggerHitArgs.g.h"
 
 namespace winrt::Microsoft::Terminal::Control::implementation
 {
@@ -169,4 +170,19 @@ namespace winrt::Microsoft::Terminal::Control::implementation
 
         WINRT_PROPERTY(bool, ClearMarkers, false);
     };
+
+    struct TriggerHitArgs : public TriggerHitArgsT<TriggerHitArgs>
+    {
+    public:
+        TriggerHitArgs() = default;
+        TriggerHitArgs(size_t index, std::wstring_view line)
+        {
+            _Index = ::base::saturated_cast<uint32_t>(index);
+            _Matches = winrt::single_threaded_vector<winrt::hstring>();
+            _Matches.Append(winrt::hstring{ line });
+        };
+
+        WINRT_PROPERTY(uint32_t, Index);
+        WINRT_PROPERTY(winrt::Windows::Foundation::Collections::IVector<winrt::hstring>, Matches);
+    };
 }

src/cascadia/TerminalControl/EventArgs.idl

@@ -83,4 +83,10 @@ namespace Microsoft.Terminal.Control
     {
         Boolean ClearMarkers { get; };
     }
+
+    runtimeclass TriggerHitArgs
+    {
+        UInt32 Index { get; };
+        IVector<String> Matches { get; };
+    }
 }

src/cascadia/TerminalControl/TermControl.h

@@ -142,8 +142,9 @@ namespace winrt::Microsoft::Terminal::Control::implementation
         PROJECTED_FORWARDED_TYPED_EVENT(SetTaskbarProgress,     IInspectable, IInspectable, _core, TaskbarProgressChanged);
         PROJECTED_FORWARDED_TYPED_EVENT(ConnectionStateChanged, IInspectable, IInspectable, _core, ConnectionStateChanged);
         PROJECTED_FORWARDED_TYPED_EVENT(ShowWindowChanged,      IInspectable, Control::ShowWindowArgs, _core, ShowWindowChanged);
+        PROJECTED_FORWARDED_TYPED_EVENT(TriggerHit,             IInspectable, Control::TriggerHitArgs, _core, TriggerHit);
 
-        PROJECTED_FORWARDED_TYPED_EVENT(PasteFromClipboard, IInspectable, Control::PasteFromClipboardEventArgs, _interactivity, PasteFromClipboard);
+        PROJECTED_FORWARDED_TYPED_EVENT(PasteFromClipboard,     IInspectable, Control::PasteFromClipboardEventArgs, _interactivity, PasteFromClipboard);
 
         TYPED_EVENT(OpenHyperlink,             IInspectable, Control::OpenHyperlinkEventArgs);
         TYPED_EVENT(RaiseNotice,               IInspectable, Control::NoticeEventArgs);

src/cascadia/TerminalControl/TermControl.idl

@@ -49,6 +49,8 @@ namespace Microsoft.Terminal.Control
 
         event Windows.Foundation.TypedEventHandler<Object, ShowWindowArgs> ShowWindowChanged;
 
+        event Windows.Foundation.TypedEventHandler<Object, TriggerHitArgs> TriggerHit;
+
         Boolean CopySelectionToClipboard(Boolean singleLine, Windows.Foundation.IReference<CopyFormat> formats);
         void PasteTextFromClipboard();
         void SelectAll();

src/cascadia/TerminalCore/ICoreSettings.idl

@@ -29,6 +29,7 @@ namespace Microsoft.Terminal.Core
 
         Boolean AutoMarkPrompts;
 
+        IVector<String> Triggers;
     };
 
 }

src/cascadia/TerminalCore/Terminal.cpp

@@ -143,6 +143,12 @@ void Terminal::UpdateSettings(ICoreSettings settings)
         _startingTabColor = settings.StartingTabColor().Value();
     }
 
+    _triggers.clear();
+    for (const auto& trigger : settings.Triggers())
+    {
+        _triggers.emplace_back(std::wregex{ trigger.c_str() });
+    }
+
     // TODO:MSFT:21327402 - if HistorySize has changed, resize the buffer so we
     // have a smaller scrollback. We should do this carefully - if the new buffer
     // size is smaller than where the mutable viewport currently is, we'll want
@@ -1377,6 +1383,11 @@ void Terminal::SetPlayMidiNoteCallback(std::function<void(const int, const int,
     _pfnPlayMidiNote.swap(pfn);
 }
 
+void Terminal::SetTriggerCallback(std::function<void(const size_t, std::wstring_view)> pfn) noexcept
+{
+    _pfnTriggerCallback.swap(pfn);
+}
+
 // Method Description:
 // - Sets the cursor to be currently on. On/Off is tracked independently of
 //   cursor visibility (hidden/visible). On/off is controlled by the cursor
@@ -1638,3 +1649,26 @@ til::color Terminal::GetColorForMark(const Microsoft::Console::VirtualTerminal::
     }
     }
 }
+
+void Terminal::_runTriggers()
+{
+    if (!_pfnTriggerCallback || _triggers.size() == 0)
+    {
+        return;
+    }
+
+    const auto cursorPos = _activeBuffer().GetCursor().GetPosition();
+    // const auto bufferRow = cursorPos.Y;
+    const auto& row = _activeBuffer().GetRowByOffset(cursorPos.Y);
+    const auto text = row.GetText();
+
+    for (auto i = 0u; i < _triggers.size(); i++)
+    {
+        const std::wregex& trigger = _triggers[i];
+        if (std::regex_search(text, trigger))
+        {
+            // That regex matched. Bubble it up to the handler.
+            _pfnTriggerCallback(i, text);
+        }
+    }
+}

src/cascadia/TerminalCore/Terminal.hpp

@@ -217,6 +217,7 @@ class Microsoft::Terminal::Core::Terminal final :
     void TaskbarProgressChangedCallback(std::function<void()> pfn) noexcept;
     void SetShowWindowCallback(std::function<void(bool)> pfn) noexcept;
     void SetPlayMidiNoteCallback(std::function<void(const int, const int, const std::chrono::microseconds)> pfn) noexcept;
+    void SetTriggerCallback(std::function<void(const size_t, std::wstring_view)> pfn) noexcept;
 
     void SetCursorOn(const bool isOn);
     bool IsCursorBlinkingAllowed() const noexcept;
@@ -314,6 +315,7 @@ class Microsoft::Terminal::Core::Terminal final :
     std::function<void()> _pfnTaskbarProgressChanged;
     std::function<void(bool)> _pfnShowWindowChanged;
     std::function<void(const int, const int, const std::chrono::microseconds)> _pfnPlayMidiNote;
+    std::function<void(const size_t, std::wstring_view)> _pfnTriggerCallback;
 
     RenderSettings _renderSettings;
     std::unique_ptr<::Microsoft::Console::VirtualTerminal::StateMachine> _stateMachine;
@@ -401,6 +403,7 @@ class Microsoft::Terminal::Core::Terminal final :
     std::optional<KeyEventCodes> _lastKeyEventCodes;
 
     std::vector<Microsoft::Console::VirtualTerminal::DispatchTypes::ScrollMark> _scrollMarks;
+    std::vector<std::wregex> _triggers;
 
     static WORD _ScanCodeFromVirtualKey(const WORD vkey) noexcept;
     static WORD _VirtualKeyFromScanCode(const WORD scanCode) noexcept;
@@ -428,6 +431,8 @@ class Microsoft::Terminal::Core::Terminal final :
     TextBuffer& _activeBuffer() const noexcept;
     void _updateUrlDetection();
 
+    void _runTriggers();
+
 #pragma region TextSelection
     // These methods are defined in TerminalSelection.cpp
     std::vector<til::inclusive_rect> _GetSelectionRects() const noexcept;

src/cascadia/TerminalCore/TerminalApi.cpp

@@ -84,6 +84,8 @@ void Terminal::LineFeed(const bool withReturn)
     // row we just came from
     _activeBuffer().GetRowByOffset(cursorPos.Y).SetWrapForced(false);
 
+    _runTriggers();
+
     cursorPos.Y++;
     if (withReturn)
     {

src/cascadia/TerminalCore/pch.h

@@ -8,6 +8,7 @@
 #define BLOCK_TIL
 #include <LibraryIncludes.h>
 #include "winrt/Windows.Foundation.h"
+#include "winrt/Windows.Foundation.Collections.h"
 
 #include "winrt/Microsoft.Terminal.Core.h"
 #include <til.h>

src/cascadia/TerminalSettingsModel/Command.cpp

@@ -451,7 +451,7 @@ namespace winrt::Microsoft::Terminal::Settings::Model::implementation
     // - input: the string to JSON escape.
     // Return Value:
     // - the input string escaped properly to be inserted into another json blob.
-    std::string _escapeForJson(const std::string& input)
+    static std::string _escapeForJson(const std::string& input)
     {
         Json::Value inJson{ input };
         Json::StreamWriterBuilder builder;

src/cascadia/TerminalSettingsModel/MTSMSettings.h

@@ -82,7 +82,8 @@ Author(s):
     X(bool, Elevate, "elevate", false)                                                                                                                         \
     X(bool, VtPassthrough, "experimental.connection.passthroughMode", false)                                                                                   \
     X(bool, AutoMarkPrompts, "experimental.autoMarkPrompts", false)                                                                                            \
-    X(bool, ShowMarks, "experimental.showMarksOnScrollbar", false)
+    X(bool, ShowMarks, "experimental.showMarksOnScrollbar", false)                                                                                             \
+    X(Windows::Foundation::Collections::IVector<winrt::Microsoft::Terminal::Settings::Model::Trigger>, Triggers, "experimental.triggers", nullptr)
 
 // Intentionally omitted Profile settings:
 // * Name

src/cascadia/TerminalSettingsModel/Microsoft.Terminal.Settings.ModelLib.vcxproj

@@ -92,6 +92,7 @@
     <ClInclude Include="VsDevShellGenerator.h" />
     <ClInclude Include="VsSetupConfiguration.h" />
     <ClInclude Include="WslDistroGenerator.h" />
+    <ClInclude Include="Trigger.h" />
   </ItemGroup>
   <!-- ========================= Cpp Files ======================== -->
   <ItemGroup>
@@ -165,6 +166,9 @@
     <ClCompile Include="VsDevShellGenerator.cpp" />
     <ClCompile Include="VsSetupConfiguration.cpp" />
     <ClCompile Include="WslDistroGenerator.cpp" />
+    <ClCompile Include="Trigger.cpp">
+      <DependentUpon>Profile.idl</DependentUpon>
+    </ClCompile>
     <!-- You _NEED_ to include this file and the jsoncpp IncludePath (below) if
     you want to use jsoncpp -->
     <ClCompile Include="$(OpenConsoleDir)\dep\jsoncpp\jsoncpp.cpp">

src/cascadia/TerminalSettingsModel/Profile.cpp

@@ -9,6 +9,7 @@
 #include "TerminalSettingsSerializationHelpers.h"
 #include "AppearanceConfig.h"
 #include "FontConfig.h"
+#include "Trigger.h"
 
 #include "Profile.g.cpp"
 

src/cascadia/TerminalSettingsModel/Profile.idl

@@ -3,6 +3,11 @@
 
 import "IAppearanceConfig.idl";
 import "FontConfig.idl";
+
+// For triggers, TODO! move to my own file
+import "ActionArgs.idl";
+
+
 #include "IInheritable.idl.h"
 
 #define INHERITABLE_PROFILE_SETTING(Type, Name) \
@@ -11,6 +16,19 @@ import "FontConfig.idl";
 
 namespace Microsoft.Terminal.Settings.Model
 {
+
+    enum TriggerType
+    {
+        MatchRegex = 0,
+    };
+
+    [default_interface] runtimeclass Trigger {
+        Trigger();
+        TriggerType Type { get; };
+        String Match { get; };
+        ActionAndArgs ActionAndArgs { get; };
+    }
+
     // This tag is used to identify the context in which the Profile was created
     enum OriginTag
     {
@@ -87,5 +105,7 @@ namespace Microsoft.Terminal.Settings.Model
         INHERITABLE_PROFILE_SETTING(Boolean, Elevate);
         INHERITABLE_PROFILE_SETTING(Boolean, AutoMarkPrompts);
         INHERITABLE_PROFILE_SETTING(Boolean, ShowMarks);
+
+        INHERITABLE_PROFILE_SETTING(IVector<Trigger>, Triggers);
     }
 }

src/cascadia/TerminalSettingsModel/TerminalSettings.cpp

@@ -283,6 +283,12 @@ namespace winrt::Microsoft::Terminal::Settings::Model::implementation
         _Elevate = profile.Elevate();
         _AutoMarkPrompts = Feature_ScrollbarMarks::IsEnabled() && profile.AutoMarkPrompts();
         _ShowMarks = Feature_ScrollbarMarks::IsEnabled() && profile.ShowMarks();
+
+        _Triggers = winrt::single_threaded_vector<winrt::hstring>();
+        for (const auto& trigger : profile.Triggers())
+        {
+            _Triggers->Append(trigger.Match());
+        }
     }
 
     // Method Description:

src/cascadia/TerminalSettingsModel/TerminalSettings.h

@@ -112,6 +112,8 @@ namespace winrt::Microsoft::Terminal::Settings::Model::implementation
 
         INHERITABLE_SETTING(Model::TerminalSettings, Microsoft::Terminal::Core::AdjustTextMode, AdjustIndistinguishableColors, Core::AdjustTextMode::Never);
 
+        INHERITABLE_SETTING(Model::TerminalSettings, Windows::Foundation::Collections::IVector<winrt::hstring>, Triggers, nullptr);
+
         // ------------------------ End of Core Settings -----------------------
 
         INHERITABLE_SETTING(Model::TerminalSettings, hstring, ProfileName);