feat(agent): add metacognitive thinking agent

- add metacognitive to thinkingdirection enum
- create metacognitivethinkingcapability with bias detection focus
- add timing config (90s) and message history config (5)
- update full_exploration_sequence to include metacognitive
- update test to reflect new thinking sequence

Metacognitive agent analyzes thinking process itself, identifies
cognitive biases, evaluates mental models, and suggests alternative
framing - complementing the existing synthesis agent.

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

Author: FradSer

src/mcp_server_mas_sequential_thinking/processors/multi_thinking_core.py

@@ -51,6 +51,7 @@ class ThinkingDirection(Enum):
     OPTIMISTIC = "optimistic"  # Optimism and value
     CREATIVE = "creative"  # Creativity and innovation
     SYNTHESIS = "synthesis"  # Metacognition and integration
+    METACOGNITIVE = "metacognitive"  # Thinking about thinking
 
 
 class ProcessingDepth(Enum):
@@ -95,6 +96,9 @@ class ThinkingTimingConfig:
     ThinkingDirection.SYNTHESIS: ThinkingTimingConfig(
         ThinkingDirection.SYNTHESIS, 60, 30, 120, False
     ),
+    ThinkingDirection.METACOGNITIVE: ThinkingTimingConfig(
+        ThinkingDirection.METACOGNITIVE, 90, 45, 180, False
+    ),
 }
 
 
@@ -471,6 +475,78 @@ def _get_specific_instructions(self) -> list[str]:
         return instructions
 
 
+class MetaCognitiveThinkingCapability(ThinkingCapability):
+    """Meta-Cognitive thinking capability: thinking about thinking."""
+
+    def __init__(self) -> None:
+        super().__init__(
+            thinking_direction=ThinkingDirection.METACOGNITIVE,
+            role="Cognitive Process Analyst",
+            description="Analyze thinking process, identify cognitive biases, evaluate mental models",
+            role_description="I analyze HOW we think about the problem, not WHAT we think. I examine cognitive biases, evaluate our reasoning approach, and identify how our mental models shape our conclusions.",
+            thinking_mode="metacognitive_analysis",
+            cognitive_focus="Process awareness, bias detection, mental model evaluation",
+            output_style="Self-aware analysis, bias identification, reasoning evaluation",
+            timing_config=THINKING_TIMING_CONFIGS[ThinkingDirection.METACOGNITIVE],
+            reasoning_level=3,
+            memory_enabled=True,
+        )
+
+    def _get_specific_instructions(self) -> list[str]:
+        instructions = [
+            "",
+            "METACOGNITIVE ANALYSIS GUIDELINES:",
+            "• Analyze the thinking process itself, not just the content",
+            "• Identify cognitive biases that may be influencing reasoning",
+            "• Evaluate whether the approach being taken is appropriate",
+            "• Question assumptions about how we frame the problem",
+            "• Consider alternative framing that might yield different insights",
+            "",
+            "BIAS DETECTION FOCUS AREAS:",
+            "• Confirmation bias: Are we only seeing evidence that supports existing views?",
+            "• Anchoring bias: Are we overly influenced by initial information?",
+            "• Availability bias: Are we relying on easily recalled examples?",
+            "• Sunk cost fallacy: Are we continuing down a path because of past investment?",
+            "• Dunning-Kruger effect: Are we overestimating our understanding?",
+            "",
+            "PROCESS EVALUATION:",
+            "- Is the current thinking strategy appropriate for this problem?",
+            "- What mental models are we using, and are they fitting the problem?",
+            "- How might someone with different expertise approach this differently?",
+            "- What information gaps exist in our reasoning approach?",
+        ]
+
+        # Add research capabilities if ExaTools is available
+        if EXA_AVAILABLE and ExaTools is not None:
+            instructions.extend(
+                [
+                    "",
+                    "RESEARCH CAPABILITIES:",
+                    "• Use search_exa() to research cognitive biases and thinking fallacies",
+                    "• Search for academic insights on meta-cognition and reasoning",
+                    "• Find examples of how similar problems were reframed successfully",
+                ]
+            )
+
+        instructions.extend(
+            [
+                "",
+                "FORBIDDEN in metacognitive analysis:",
+                "- Making the final decision (that's Synthesis's job)",
+                "- Providing the actual answer to the question",
+                "- Focusing only on content rather than process",
+                "",
+                "YOUR OUTPUT SHOULD:",
+                "• Describe the thinking process being used",
+                "• Identify potential biases and limitations",
+                "• Suggest alternative framing if beneficial",
+                "• Evaluate if the current approach is optimal",
+            ]
+        )
+
+        return instructions
+
+
 class SynthesisThinkingCapability(ThinkingCapability):
     """Synthesis thinking capability: metacognition and integration."""
 
@@ -531,6 +607,7 @@ class MultiThinkingAgentFactory:
         ThinkingDirection.OPTIMISTIC: OptimisticThinkingCapability(),
         ThinkingDirection.CREATIVE: CreativeThinkingCapability(),
         ThinkingDirection.SYNTHESIS: SynthesisThinkingCapability(),
+        ThinkingDirection.METACOGNITIVE: MetaCognitiveThinkingCapability(),
     }
     _default_learning_resources: ClassVar[LearningResources | None] = None
 

src/mcp_server_mas_sequential_thinking/processors/multi_thinking_processor.py

@@ -47,6 +47,7 @@
     ThinkingDirection.OPTIMISTIC: 3,  # Focused opportunity analysis
     ThinkingDirection.CREATIVE: 8,  # Broader context for creative connections
     ThinkingDirection.SYNTHESIS: 10,  # Maximum context for comprehensive integration
+    ThinkingDirection.METACOGNITIVE: 5,  # Process analysis needs moderate context
 }
 
 
@@ -309,7 +310,7 @@ async def _process_full_direction_sequence(
         non_synthesis_agents = [
             direction
             for direction in thinking_sequence
-            if direction != ThinkingDirection.SYNTHESIS
+            if direction not in (ThinkingDirection.SYNTHESIS, ThinkingDirection.METACOGNITIVE)
         ]
 
         if non_synthesis_agents:

src/mcp_server_mas_sequential_thinking/routing/multi_thinking_router.py

@@ -29,6 +29,7 @@
     ThinkingDirection.OPTIMISTIC,
     ThinkingDirection.CRITICAL,
     ThinkingDirection.CREATIVE,
+    ThinkingDirection.METACOGNITIVE,
     ThinkingDirection.SYNTHESIS,
 )
 

tests/unit/test_multi_thinking_router.py

@@ -56,6 +56,7 @@ async def test_route_thought_defaults_to_full_exploration(
         "optimistic",
         "critical",
         "creative",
+        "metacognitive",
         "synthesis",
     ]