Initial commit

opc/layer1_perception/task_router.py

@@ -0,0 +1,47 @@
+"""Task router — DEPRECATED.
+
+Mode selection is now determined by user metadata, not LLM-based routing.
+This module is retained for backward compatibility only. Importing TaskRouter
+still works, but ``route()`` returns a default ModeSelection(TASK_MODE).
+"""
+
+from __future__ import annotations
+
+import warnings
+from typing import Any
+
+from loguru import logger
+
+from opc.core.models import ExecutionMode, ModeSelection
+from opc.layer1_perception.context_loader import LoadedContext
+
+RouterDecision = ModeSelection
+
+
+class TaskRouter:
+    """Deprecated — kept for backward compatibility.
+
+    ``route()`` now returns a default ``ModeSelection`` with ``TASK_MODE``
+    without making any LLM calls.  Callers should migrate to reading mode
+    from user metadata directly.
+    """
+
+    def __init__(self, llm: Any = None) -> None:
+        self.llm = llm
+        warnings.warn(
+            "TaskRouter is deprecated. Mode is now determined by user metadata.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+
+    async def route(
+        self,
+        user_message: str,
+        context: LoadedContext | None = None,
+        preferences: dict[str, Any] | None = None,
+    ) -> ModeSelection:
+        logger.debug("TaskRouter.route() called — returning default TASK_MODE")
+        return ModeSelection(
+            mode=ExecutionMode.TASK_MODE,
+            domains=["general"],
+        )