chore: minor fixes from agent implementations

- Orchestrator tools cleanup
- Trace logger fix
- WebSocket server update
- Constitutional geometry and governance minor fixes

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: EightRice

atn/orchestrator/tools.py

@@ -35,6 +35,7 @@
 from ..events import Event, EventType
 from ..loader import delete_agent_dir, save_agent
 from ..providers.base import ToolDefinition
+from ..runtime.provider_manager import get_model_tier, get_tier_label
 
 if TYPE_CHECKING:
     from ..runtime import Runtime
@@ -919,12 +920,24 @@ async def _create_agent(runtime: Runtime, input: dict[str, Any]) -> dict[str, An
         if not system_prompt and prompt and parent_id:
             system_prompt = build_delegate_prompt(agent_type, agent_id, parent_id)
 
+        effective_model = model or runtime._config.orchestrator.model or "sonnet"
+        model_tier = get_model_tier(effective_model)
+
+        # Warn if model tier seems low for agent_type
+        tier_warning = None
+        if agent_type in ("general",) and model_tier < 3:
+            tier_warning = (
+                f"Model '{effective_model}' is tier {model_tier} ({get_tier_label(model_tier)}). "
+                f"Agent type '{agent_type}' works best with tier 3+ (autonomous) models."
+            )
+            log.warning("Low capability tier for agent: %s", tier_warning)
+
         defn = AgentDefinition(
             id=agent_id,
             name=input.get("name", "") or input.get("id", agent_id),
             mode=AgentMode.COGNITIVE,
-            provider=model or runtime._config.orchestrator.model or "sonnet",
-            cognitive_model=model or runtime._config.orchestrator.model or "sonnet",
+            provider=effective_model,
+            cognitive_model=effective_model,
             system_prompt=system_prompt,
             task_prompt=prompt,
             agent_type=agent_type,
@@ -984,9 +997,17 @@ async def _create_agent(runtime: Runtime, input: dict[str, Any]) -> dict[str, An
                         data=node.to_dict(),
                     ))
 
-                return {"agent_id": aid, "status": "running", "execution_id": eid}
-
-            return {"agent_id": aid, "status": "registered"}
+                result = {"agent_id": aid, "status": "running", "execution_id": eid,
+                         "capability_tier": model_tier, "tier_label": get_tier_label(model_tier)}
+                if tier_warning:
+                    result["tier_warning"] = tier_warning
+                return result
+
+            result = {"agent_id": aid, "status": "registered",
+                      "capability_tier": model_tier, "tier_label": get_tier_label(model_tier)}
+            if tier_warning:
+                result["tier_warning"] = tier_warning
+            return result
         except Exception as exc:
             return {"error": str(exc)}
 

atn/trace_logger.py

@@ -20,7 +20,7 @@
         }
     }
 
-See C:\\code\\research\\AGENT_TRACE_TRAINING.md for the full specification.
+See docs/AGENT_TRACE_TRAINING.md for the full specification.
 
 Phase B Step 1 — Agent Trace Collection.
 """

atn/ws_server.py

@@ -43,6 +43,7 @@
 from .events import Event, EventBus, EventType
 from .orchestrator.tools import execute_tool
 from .runtime import Runtime
+from .runtime.provider_manager import get_model_tier, get_tier_label
 
 log = logging.getLogger(__name__)
 
@@ -162,9 +163,12 @@ async def _handle_message(self, msg: dict[str, Any]) -> dict[str, Any]:
                 return {"msg_id": msg_id, "ok": False, "error": "Missing 'model' field"}
             try:
                 await self.runtime.set_orchestrator_model(model)
+                tier = get_model_tier(model)
                 return {"msg_id": msg_id, "ok": True, "result": {
                     "model": model,
                     "status": "Model changed",
+                    "capability_tier": tier,
+                    "tier_label": get_tier_label(tier),
                 }}
             except ValueError as exc:
                 return {"msg_id": msg_id, "ok": False, "error": str(exc)}

nodes/common/constitutional_geometry.py

@@ -2,7 +2,7 @@
 Constitutional Geometry: Embedding-Space Constitutional Evaluation
 
 Implements the 3-tier evaluation architecture from the constitutional
-geometry survey (C:\code\research\surveys\constitutional_geometry_survey.md):
+geometry survey:
 
   Tier 1 — Geometric pre-filter (O(1))
     Cosine similarity against principle direction vectors in JEPA embedding

nodes/common/governance.py

@@ -40,7 +40,7 @@
 logger = logging.getLogger(__name__)
 
 # Quorum requirement for constitutional amendments (EvolutionProposal.sol parameter).
-# 95% per the RPB specification (C:\code\rpb\README.md: "requiring 95% quorum").
+# 95% per the RPB specification ("requiring 95% quorum").
 CONSTITUTIONAL_QUORUM_BPS: int = 9500  # 95% in basis points