Add conversations V3 to allow testing of query/streaming_query V2

It is using conversations as conversation v3 endpoint

Author: luis5tb

src/app/routers.py

@@ -42,6 +42,7 @@ def include_routers(app: FastAPI) -> None:
     # V2 endpoints - Response API support
     app.include_router(query_v2.router, prefix="/v2")
     app.include_router(streaming_query_v2.router, prefix="/v2")
+    app.include_router(conversations.router, prefix="/v3")
 
     # road-core does not version these endpoints
     app.include_router(health.router)

src/utils/suid.py

@@ -13,15 +13,31 @@ def get_suid() -> str:
 
 
 def check_suid(suid: str) -> bool:
-    """Check if given string is a proper session ID.
+    """Check if given string is a proper session ID or response ID.
 
-    Args:
-        suid: The string to check.
-
-    Returns True if the string is a valid UUID, False otherwise.
+    Rules:
+    - If it starts with "resp-" or "resp_", accept as a valid Responses API ID (opaque).
+    - Otherwise, require a valid UUID string.
     """
+    if not isinstance(suid, str) or not suid:
+        return False
+
+    # Handle Responses API IDs
+    if suid.startswith("resp-") or suid.startswith("resp_"):
+        token = suid[5:]
+        if not token:
+            return False
+        # If truncated (e.g., shell cut reduced length), pad to canonical UUID length
+        if len(token) < 36:
+            token = token + ("0" * (36 - len(token)))
+        try:
+            uuid.UUID(token)
+            return True
+        except (ValueError, TypeError):
+            return False
+
+    # Otherwise, enforce UUID format
     try:
-        # accepts strings and bytes only
         uuid.UUID(suid)
         return True
     except (ValueError, TypeError):

tests/unit/app/test_routers.py

@@ -63,7 +63,7 @@ def test_include_routers() -> None:
     include_routers(app)
 
     # are all routers added?
-    assert len(app.routers) == 14
+    assert len(app.routers) == 15
     assert root.router in app.get_routers()
     assert info.router in app.get_routers()
     assert models.router in app.get_routers()
@@ -76,6 +76,7 @@ def test_include_routers() -> None:
     assert health.router in app.get_routers()
     assert authorized.router in app.get_routers()
     assert conversations.router in app.get_routers()
+    assert conversations_v2.router in app.get_routers()
     assert metrics.router in app.get_routers()
 
 
@@ -85,7 +86,7 @@ def test_check_prefixes() -> None:
     include_routers(app)
 
     # are all routers added?
-    assert len(app.routers) == 14
+    assert len(app.routers) == 15
     assert app.get_router_prefix(root.router) == ""
     assert app.get_router_prefix(info.router) == "/v1"
     assert app.get_router_prefix(models.router) == "/v1"