bugfix: route stickness precedences (transaction in the same intent)

tests/test_route_stickiness_transaction_shift.py

@@ -1,3 +1,4 @@
+import pytest
 from types import SimpleNamespace
 
 from agent_framework.routing.enterprise_router import EnterpriseRouter
@@ -12,3 +13,84 @@ def test_explicit_keyword_shift_preempts_stickiness():
 def test_short_generic_keyword_does_not_preempt():
     d = RouteDecision(route="x", agent="x", intent="x", method="keyword", metadata={"matched_keyword": "id"})
     assert EnterpriseRouter._is_explicit_intent_shift(d) is False
+
+
+def test_same_agent_explicit_intent_shift_must_preempt_stickiness():
+    router = object.__new__(EnterpriseRouter)
+    router.intents = []
+    # This test documents the key regression: changing from a read-only intent
+    # to a transactional intent handled by the SAME agent must still be treated
+    # as an explicit intent shift. The route() integration tests exercise the
+    # full async path; here we lock the explicitness predicate itself.
+    d = RouteDecision(
+        route="orders_agent",
+        agent="orders_agent",
+        intent="retail_order_cancel",
+        method="keyword",
+        metadata={"matched_keyword": "cancelar pedido"},
+    )
+    assert EnterpriseRouter._is_explicit_intent_shift(d) is True
+
+@pytest.mark.asyncio
+async def test_same_agent_transaction_keyword_preempts_continuity(monkeypatch):
+    """Regression: tracking -> cancelar pedido must not reuse tracking intent."""
+    from agent_framework.routing.models import IntentDefinition
+
+    class _Continuity:
+        async def evaluate(self, state, *, intents):
+            raise AssertionError("continuity must be preempted by explicit intent shift")
+
+    router = object.__new__(EnterpriseRouter)
+    router.state_policies = []
+    router.intents = [
+        IntentDefinition(
+            name="retail_order_cancel",
+            domain="retail",
+            agent="orders_agent",
+            description="cancelamento",
+            priority=20,
+            mcp_tools=["consultar_pedido", "cancelar_pedido"],
+            keywords=["cancelar pedido"],
+            examples=[],
+            enabled=True,
+        ),
+        IntentDefinition(
+            name="retail_order_tracking",
+            domain="retail",
+            agent="orders_agent",
+            description="tracking",
+            priority=30,
+            mcp_tools=["consultar_pedido", "consultar_entrega"],
+            keywords=["pedido"],
+            examples=[],
+            enabled=True,
+        ),
+    ]
+    router.continuity = _Continuity()
+    router.enable_llm_router = False
+    router.llm = None
+    router.telemetry = None
+    router.fallback_agent = "billing_agent"
+
+    decision = await router.route({
+        "user_text": "quero cancelar pedido",
+        "sanitized_input": "quero cancelar pedido",
+        "active_agent": "orders_agent",
+        "intent": "retail_order_tracking",
+        "route_decision": {
+            "route": "orders_agent",
+            "agent": "orders_agent",
+            "intent": "retail_order_tracking",
+            "domain": "retail",
+            "mcp_tools": ["consultar_pedido", "consultar_entrega"],
+        },
+        "context": {"session": {}},
+    })
+
+    assert decision.agent == "orders_agent"
+    assert decision.intent == "retail_order_cancel"
+    assert decision.method == "keyword"
+    assert decision.mcp_tools == ["consultar_pedido", "cancelar_pedido"]
+    assert decision.metadata["route_stickiness_preempted"] is True
+    assert decision.metadata["previous_agent"] == "orders_agent"
+    assert decision.metadata["previous_intent"] == "retail_order_tracking"