Merge branch 'main' into copilot/fix-docfx-cross-reference-links

Author: gwharris7

libraries/microsoft-agents-a365-notifications/microsoft_agents_a365/notifications/agent_notification.py

@@ -426,6 +426,121 @@ async def handle_user_deleted(context, state, notification):
         """
         return self.on_lifecycle_notification(AgentLifecycleEvent.USERDELETED, **kwargs)
 
+    def on_user_undeleted(
+        self, **kwargs: Any
+    ) -> Callable[[AgentHandler], Callable[[TurnContext, TurnState], Awaitable[None]]]:
+        """Register a handler for user un-deletion lifecycle events.
+
+        This is a convenience decorator that registers a handler specifically for
+        agentic user identity un-deletion events.
+
+        Args:
+            **kwargs: Additional keyword arguments passed to the app's add_route method.
+
+        Returns:
+            A decorator function that registers the handler with the application.
+
+        Example:
+            ```python
+            @notifications.on_user_undeleted()
+            async def handle_user_undeleted(context, state, notification):
+                print("Agentic user identity un-deleted")
+            ```
+        """
+        return self.on_lifecycle_notification(AgentLifecycleEvent.USERUNDELETED, **kwargs)
+
+    def on_user_updated(
+        self, **kwargs: Any
+    ) -> Callable[[AgentHandler], Callable[[TurnContext, TurnState], Awaitable[None]]]:
+        """Register a handler for user updated lifecycle events.
+
+        This is a convenience decorator that registers a handler specifically for
+        agentic user identity updated events.
+
+        Args:
+            **kwargs: Additional keyword arguments passed to the app's add_route method.
+
+        Returns:
+            A decorator function that registers the handler with the application.
+
+        Example:
+            ```python
+            @notifications.on_user_updated()
+            async def handle_user_updated(context, state, notification):
+                print("Agentic user identity updated")
+            ```
+        """
+        return self.on_lifecycle_notification(AgentLifecycleEvent.USERUPDATED, **kwargs)
+
+    def on_user_manager_updated(
+        self, **kwargs: Any
+    ) -> Callable[[AgentHandler], Callable[[TurnContext, TurnState], Awaitable[None]]]:
+        """Register a handler for user manager updated lifecycle events.
+
+        This is a convenience decorator that registers a handler specifically for
+        agentic user manager updated events.
+
+        Args:
+            **kwargs: Additional keyword arguments passed to the app's add_route method.
+
+        Returns:
+            A decorator function that registers the handler with the application.
+
+        Example:
+            ```python
+            @notifications.on_user_manager_updated()
+            async def handle_user_manager_updated(context, state, notification):
+                print("Agentic user manager updated")
+            ```
+        """
+        return self.on_lifecycle_notification(AgentLifecycleEvent.USERMANAGERUPDATED, **kwargs)
+
+    def on_user_enabled(
+        self, **kwargs: Any
+    ) -> Callable[[AgentHandler], Callable[[TurnContext, TurnState], Awaitable[None]]]:
+        """Register a handler for user enabled lifecycle events.
+
+        This is a convenience decorator that registers a handler specifically for
+        agentic user enabled events.
+
+        Args:
+            **kwargs: Additional keyword arguments passed to the app's add_route method.
+
+        Returns:
+            A decorator function that registers the handler with the application.
+
+        Example:
+            ```python
+            @notifications.on_user_enabled()
+            async def handle_user_enabled(context, state, notification):
+                print("Agentic user enabled")
+            ```
+        """
+        return self.on_lifecycle_notification(AgentLifecycleEvent.USERENABLED, **kwargs)
+
+    def on_user_disabled(
+        self, **kwargs: Any
+    ) -> Callable[[AgentHandler], Callable[[TurnContext, TurnState], Awaitable[None]]]:
+        """Register a handler for user disabled lifecycle events.
+
+        This is a convenience decorator that registers a handler specifically for
+        agentic user disabled events.
+
+        Args:
+            **kwargs: Additional keyword arguments passed to the app's add_route method.
+
+        Returns:
+            A decorator function that registers the handler with the application.
+
+        Example:
+            ```python
+            @notifications.on_user_disabled()
+            async def handle_user_disabled(context, state, notification):
+                print("Agentic user disabled")
+            ```
+        """
+        return self.on_lifecycle_notification(AgentLifecycleEvent.USERDISABLED, **kwargs)
+
     @staticmethod
     def _normalize_subchannel(value: str | AgentSubChannel | None) -> str:
         """Normalize a subchannel value to a lowercase string.

libraries/microsoft-agents-a365-notifications/microsoft_agents_a365/notifications/models/agent_lifecycle_event.py

@@ -15,8 +15,18 @@ class AgentLifecycleEvent(str, Enum):
         USERWORKLOADONBOARDINGUPDATED: Event triggered when a user's workload
             onboarding status is updated.
         USERDELETED: Event triggered when an agentic user identity is deleted.
+        USERUNDELETED: Event triggered when an agentic user identity is un-deleted.
+        USERUPDATED: Event triggered when an agentic user identity is updated.
+        USERMANAGERUPDATED: Event triggered when an agentic user's manager is updated.
+        USERENABLED: Event triggered when an agentic user is enabled.
+        USERDISABLED: Event triggered when an agentic user is disabled.
     """
 
     USERCREATED = "agenticuseridentitycreated"
     USERWORKLOADONBOARDINGUPDATED = "agenticuserworkloadonboardingupdated"
-    USERDELETED = "agenticuseridentitydeleted"
+    USERDELETED = "agenticuserdeleted"
+    USERUNDELETED = "agenticuserundeleted"
+    USERUPDATED = "agenticuseridentityupdated"
+    USERMANAGERUPDATED = "agenticusermanagerupdated"
+    USERENABLED = "agenticuserenabled"
+    USERDISABLED = "agenticuserdisabled"