add a bit more documentation

Author: pgrayy

src/strands/multiagent/swarm.py

@@ -10,6 +10,7 @@
 - Autonomous agent collaboration without central control
 - Dynamic task distribution based on agent capabilities
 - Collective intelligence through shared context
+- Human input via user interrupts raised in BeforeNodeCallEvent hooks and agent nodes
 """
 
 import asyncio
@@ -676,6 +677,9 @@ def _build_node_input(self, target_node: SwarmNode) -> str:
     def _activate_interrupt(self, node: SwarmNode, interrupts: list[Interrupt]) -> MultiAgentNodeInterruptEvent:
         """Activate the interrupt state.
 
+        Note, a Swarm may be interrupted either from a BeforeNodeCallEvent hook or from within an agent node. In either
+        case, we must manage the interrupt state of both the Swarm and the individual agent nodes.
+
         Args:
             node: The interrupted node.
             interrupts: The interrupts raised by the user.