New features: Route Stickness, Handoff, Clarification, Read-Only/Transactional, Long Term Memory

templates/agent_template_backend/app/agents/billing_agent.py

@@ -44,6 +44,36 @@ class BillingAgent(AgentRuntimeMixin):
                 component="agent.billing.mcp",
             )
 
+        state["mcp_results"] = tool_context
+        clarification_message = self.transaction_clarification_message(state)
+        if clarification_message:
+            return {
+                "answer": f"[{self.__class__.__name__}] {clarification_message}",
+                "next_state": state.get("next_state") or "COLLECTING_PARAMETERS",
+                "mcp_results": tool_context,
+                **self.transaction_state_patch(state),
+            }
+
+        confirmation_message = self.transaction_confirmation_message(state)
+        if confirmation_message:
+            result = {
+                "answer": f"[{self.__class__.__name__}] {confirmation_message}",
+                "next_state": state.get("next_state"),
+                "mcp_results": tool_context,
+                **self.transaction_state_patch(state),
+            }
+            return result
+
+        direct_answer = self.build_direct_mcp_answer(state, tool_context, agent_label="BillingAgent")
+        if direct_answer:
+            return {
+                "answer": direct_answer,
+                "next_state": state.get("next_state") or "ACTIVE",
+                "mcp_results": tool_context,
+                "rag": {"enabled": False, "skipped": True, "reason": "direct_mcp_answer"},
+                **self.transaction_state_patch(state),
+            }
+
         rag_context, rag_metadata = await self._retrieve_rag_context(state)
         if rag_metadata.get("enabled"):
             await self._emit_ic(
@@ -79,6 +109,7 @@ class BillingAgent(AgentRuntimeMixin):
             "mcp_results": tool_context,
             "rag": rag_metadata,
             "memory_context_metadata": state.get("memory_context_metadata"),
+            **self.transaction_state_patch(state),
         }
 
         await self._emit_ic(

templates/agent_template_backend/app/agents/orders_agent.py

@@ -44,6 +44,36 @@ class OrdersAgent(AgentRuntimeMixin):
                 component="agent.orders.mcp",
             )
 
+        state["mcp_results"] = tool_context
+        clarification_message = self.transaction_clarification_message(state)
+        if clarification_message:
+            return {
+                "answer": f"[{self.__class__.__name__}] {clarification_message}",
+                "next_state": state.get("next_state") or "COLLECTING_PARAMETERS",
+                "mcp_results": tool_context,
+                **self.transaction_state_patch(state),
+            }
+
+        confirmation_message = self.transaction_confirmation_message(state)
+        if confirmation_message:
+            result = {
+                "answer": f"[{self.__class__.__name__}] {confirmation_message}",
+                "next_state": state.get("next_state"),
+                "mcp_results": tool_context,
+                **self.transaction_state_patch(state),
+            }
+            return result
+
+        direct_answer = self.build_direct_mcp_answer(state, tool_context, agent_label="OrdersAgent")
+        if direct_answer:
+            return {
+                "answer": direct_answer,
+                "next_state": state.get("next_state") or "ACTIVE",
+                "mcp_results": tool_context,
+                "rag": {"enabled": False, "skipped": True, "reason": "direct_mcp_answer"},
+                **self.transaction_state_patch(state),
+            }
+
         rag_context, rag_metadata = await self._retrieve_rag_context(state)
         if rag_metadata.get("enabled"):
             await self._emit_ic(
@@ -79,6 +109,7 @@ class OrdersAgent(AgentRuntimeMixin):
             "mcp_results": tool_context,
             "rag": rag_metadata,
             "memory_context_metadata": state.get("memory_context_metadata"),
+            **self.transaction_state_patch(state),
         }
 
         await self._emit_ic(

templates/agent_template_backend/app/agents/product_agent.py

@@ -44,6 +44,36 @@ class ProductAgent(AgentRuntimeMixin):
                 component="agent.product.mcp",
             )
 
+        state["mcp_results"] = tool_context
+        clarification_message = self.transaction_clarification_message(state)
+        if clarification_message:
+            return {
+                "answer": f"[{self.__class__.__name__}] {clarification_message}",
+                "next_state": state.get("next_state") or "COLLECTING_PARAMETERS",
+                "mcp_results": tool_context,
+                **self.transaction_state_patch(state),
+            }
+
+        confirmation_message = self.transaction_confirmation_message(state)
+        if confirmation_message:
+            result = {
+                "answer": f"[{self.__class__.__name__}] {confirmation_message}",
+                "next_state": state.get("next_state"),
+                "mcp_results": tool_context,
+                **self.transaction_state_patch(state),
+            }
+            return result
+
+        direct_answer = self.build_direct_mcp_answer(state, tool_context, agent_label="ProductAgent")
+        if direct_answer:
+            return {
+                "answer": direct_answer,
+                "next_state": state.get("next_state") or "ACTIVE",
+                "mcp_results": tool_context,
+                "rag": {"enabled": False, "skipped": True, "reason": "direct_mcp_answer"},
+                **self.transaction_state_patch(state),
+            }
+
         rag_context, rag_metadata = await self._retrieve_rag_context(state)
         if rag_metadata.get("enabled"):
             await self._emit_ic(
@@ -79,6 +109,7 @@ class ProductAgent(AgentRuntimeMixin):
             "mcp_results": tool_context,
             "rag": rag_metadata,
             "memory_context_metadata": state.get("memory_context_metadata"),
+            **self.transaction_state_patch(state),
         }
 
         await self._emit_ic(

templates/agent_template_backend/app/agents/support_agent.py

@@ -44,6 +44,36 @@ class SupportAgent(AgentRuntimeMixin):
                 component="agent.support.mcp",
             )
 
+        state["mcp_results"] = tool_context
+        clarification_message = self.transaction_clarification_message(state)
+        if clarification_message:
+            return {
+                "answer": f"[{self.__class__.__name__}] {clarification_message}",
+                "next_state": state.get("next_state") or "COLLECTING_PARAMETERS",
+                "mcp_results": tool_context,
+                **self.transaction_state_patch(state),
+            }
+
+        confirmation_message = self.transaction_confirmation_message(state)
+        if confirmation_message:
+            result = {
+                "answer": f"[{self.__class__.__name__}] {confirmation_message}",
+                "next_state": state.get("next_state"),
+                "mcp_results": tool_context,
+                **self.transaction_state_patch(state),
+            }
+            return result
+
+        direct_answer = self.build_direct_mcp_answer(state, tool_context, agent_label="SupportAgent")
+        if direct_answer:
+            return {
+                "answer": direct_answer,
+                "next_state": state.get("next_state") or "ACTIVE",
+                "mcp_results": tool_context,
+                "rag": {"enabled": False, "skipped": True, "reason": "direct_mcp_answer"},
+                **self.transaction_state_patch(state),
+            }
+
         rag_context, rag_metadata = await self._retrieve_rag_context(state)
         if rag_metadata.get("enabled"):
             await self._emit_ic(
@@ -79,6 +109,7 @@ class SupportAgent(AgentRuntimeMixin):
             "mcp_results": tool_context,
             "rag": rag_metadata,
             "memory_context_metadata": state.get("memory_context_metadata"),
+            **self.transaction_state_patch(state),
         }
 
         await self._emit_ic(