hanzo-mcp 0.6.13__py3-none-any.whl → 0.7.1__py3-none-any.whl

hanzo_mcp/tools/agent/grok_cli_tool.py

@@ -0,0 +1,128 @@
+"""Grok CLI agent tool.
+
+This tool provides integration with xAI's Grok CLI,
+allowing programmatic execution of Grok models for code tasks.
+"""
+
+from typing import List, Optional, override, final
+from mcp.server import FastMCP
+from mcp.server.fastmcp import Context as MCPContext
+
+from hanzo_mcp.tools.agent.cli_agent_base import CLIAgentBase
+from hanzo_mcp.tools.common.permissions import PermissionManager
+
+
+@final
+class GrokCLITool(CLIAgentBase):
+    """Tool for executing Grok CLI."""
+    
+    def __init__(
+        self,
+        permission_manager: PermissionManager,
+        model: Optional[str] = None,
+        **kwargs
+    ):
+        """Initialize Grok CLI tool.
+        
+        Args:
+            permission_manager: Permission manager for access control
+            model: Optional model override (defaults to grok-2)
+            **kwargs: Additional arguments
+        """
+        super().__init__(
+            permission_manager=permission_manager,
+            command_name="grok",
+            provider_name="xAI Grok",
+            default_model=model or "grok-2",
+            env_vars=["XAI_API_KEY", "GROK_API_KEY"],
+            **kwargs
+        )
+    
+    @property
+    @override
+    def name(self) -> str:
+        """Get the tool name."""
+        return "grok_cli"
+    
+    @property
+    @override
+    def description(self) -> str:
+        """Get the tool description."""
+        return """Execute xAI Grok CLI for code tasks.
+
+This tool runs the Grok CLI for code generation, analysis,
+and reasoning tasks. It uses Grok-2 by default.
+
+Features:
+- Grok-2 with advanced reasoning capabilities
+- Real-time information access
+- Code generation and analysis
+- Humor and personality in responses
+
+Usage:
+grok_cli(prompts="Write a Python web scraper with async support")
+grok_cli(prompts="Explain quantum computing like I'm a programmer", model="grok-1")
+
+Requirements:
+- Grok CLI must be installed
+- XAI_API_KEY or GROK_API_KEY environment variable
+"""
+    
+    @override
+    def get_cli_args(self, prompt: str, **kwargs) -> List[str]:
+        """Get CLI arguments for Grok.
+        
+        Args:
+            prompt: The prompt to send
+            **kwargs: Additional arguments (model, temperature, etc.)
+            
+        Returns:
+            List of command arguments
+        """
+        args = ["chat"]
+        
+        # Add model
+        model = kwargs.get("model", self.default_model)
+        args.extend(["--model", model])
+        
+        # Add temperature if specified
+        if "temperature" in kwargs:
+            args.extend(["--temperature", str(kwargs["temperature"])])
+        
+        # Add max tokens if specified
+        if "max_tokens" in kwargs:
+            args.extend(["--max-tokens", str(kwargs["max_tokens"])])
+        
+        # Add system prompt if specified
+        if "system_prompt" in kwargs:
+            args.extend(["--system", kwargs["system_prompt"]])
+        
+        # Add the prompt
+        args.append(prompt)
+        
+        return args
+    
+    @override
+    def register(self, mcp_server: FastMCP) -> None:
+        """Register this tool with the MCP server."""
+        tool_self = self
+        
+        @mcp_server.tool(name=self.name, description=self.description)
+        async def grok_cli(
+            ctx: MCPContext,
+            prompts: str,
+            model: Optional[str] = None,
+            temperature: Optional[float] = None,
+            max_tokens: Optional[int] = None,
+            working_dir: Optional[str] = None,
+            system_prompt: Optional[str] = None,
+        ) -> str:
+            return await tool_self.call(
+                ctx,
+                prompts=prompts,
+                model=model,
+                temperature=temperature,
+                max_tokens=max_tokens,
+                working_dir=working_dir,
+                system_prompt=system_prompt,
+            )

hanzo_mcp/tools/agent/iching_tool.py

@@ -0,0 +1,380 @@
+"""I Ching tool for creative problem solving using Hanzo principles."""
+
+import random
+from typing import Any, Dict, List, Optional, override
+from enum import Enum
+
+from hanzo_mcp.tools.common.base import BaseTool
+from mcp.server.fastmcp import Context as MCPContext
+from mcp.server import FastMCP
+
+
+class HanzoPrinciple(Enum):
+    """Hanzo principles organized by category."""
+    # Empathy
+    AUTONOMY = ("Autonomy", "Trust fully; freedom fuels genius", "🦅")
+    BALANCE = ("Balance", "Steady wins; burnout loses every time", "⚖️")
+    CUSTOMER_OBSESSION = ("Customer Obsession", "Coach relentlessly; their victories yours", "🎓")
+    HUMILITY = ("Humility", "Quiet confidence; greatness emerges naturally", "🧘")
+    INTEGRITY = ("Integrity", "Principles never break; reputation never fades", "🛡️")
+    SELFLESSNESS = ("Selflessness", "Elevate others; personal success follows", "🤝")
+    
+    # Science
+    CURIOSITY = ("Curiosity", "Question always; truth never ends", "🌱")
+    EMPIRICISM = ("Empiricism", "Hypothesize, measure; reality defines truth", "🔬")
+    PRECISION = ("Precision", "Discipline in data; eliminate guesswork completely", "🎯")
+    VALIDATION = ("Validation", "Test assumptions hard; illusions crumble fast", "✅")
+    OBJECTIVITY = ("Objectivity", "Ego out; results speak plainly", "🧊")
+    REPEATABILITY = ("Repeatability", "Do it again; success repeats systematically", "🔄")
+    
+    # Design
+    ACCESSIBILITY = ("Accessibility", "Open doors wide; adoption thrives naturally", "🌐")
+    BEAUTY = ("Beauty", "Form speaks louder; aesthetics lift utility", "🎨")
+    CLARITY = ("Clarity", "Obvious is perfect; complexity hidden cleanly", "🔍")
+    CONSISTENCY = ("Consistency", "Uniform patterns; predictable results always", "🎯")
+    SIMPLICITY = ("Simplicity", "Cut ruthlessly; essential alone remains", "🪶")
+    FLOW = ("Flow", "Remove friction; natural motion prevails", "🌊")
+    
+    # Engineering
+    BATTERIES_INCLUDED = ("Batteries Included", "Ready instantly; everything you need to start", "🔋")
+    CONCURRENCY = ("Concurrency", "Parallel flows; frictionless scale", "⚡")
+    COMPOSABLE = ("Composable", "Modular magic; pieces multiply power", "🧩")
+    INTEROPERABLE = ("Interoperable", "Integrate effortlessly; value compounds infinitely", "🔗")
+    ORTHOGONAL = ("Orthogonal", "Each tool exact; no overlap, no waste", "⚙️")
+    SCALABLE = ("Scalable", "Growth limitless; obstacles removed at inception", "📈")
+    
+    # Scale
+    DISRUPTION = ("Disruption", "Reinvent boldly; transcend competition entirely", "💥")
+    EXPERIMENTATION = ("Experimentation", "Test quickly; iterate endlessly", "🧪")
+    EXPONENTIALITY = ("Exponentiality", "Compound constantly; incremental fades", "📈")
+    VELOCITY = ("Velocity", "Ship fast; refine faster", "🚀")
+    URGENCY = ("Urgency", "Act now; delays destroy opportunity", "⏱️")
+    
+    # Wisdom
+    ADAPTABILITY = ("Adaptability", "Pivot sharply; fluid response accelerates evolution", "🌊")
+    DECENTRALIZATION = ("Decentralization", "Distribute power; resilience born from autonomy", "🕸️")
+    FREEDOM = ("Freedom", "Democratize creativity; tools liberated, gatekeepers removed", "🗽")
+    LONGEVITY = ("Longevity", "Build timelessly; greatness endures beyond lifetimes", "⏳")
+    SECURITY = ("Security", "Encryption first; privacy non-negotiable", "🔐")
+    ZEN = ("Zen", "Calm mastery; effortless excellence every moment", "☯️")
+
+
+class Hexagram:
+    """I Ching hexagram with interpretation."""
+    
+    HEXAGRAMS = {
+        "111111": ("乾 (Qián)", "Creative", "Initiating force, pure yang energy. Time for bold action."),
+        "000000": ("坤 (Kūn)", "Receptive", "Pure receptivity, yielding. Time to listen and adapt."),
+        "100010": ("屯 (Zhūn)", "Initial Difficulty", "Growing pains. Persevere through early challenges."),
+        "010001": ("蒙 (Méng)", "Youthful Folly", "Beginner's mind. Learn humbly, question assumptions."),
+        "111010": ("需 (Xū)", "Waiting", "Strategic patience. Prepare while waiting for the right moment."),
+        "010111": ("訟 (Sòng)", "Conflict", "Address conflicts directly but seek resolution, not victory."),
+        "010000": ("師 (Shī)", "Army", "Organize resources, build strong teams, lead by example."),
+        "000010": ("比 (Bǐ)", "Holding Together", "Unity and collaboration. Strengthen bonds."),
+        "111011": ("小畜 (Xiǎo Chù)", "Small Accumulation", "Small consistent improvements compound over time."),
+        "110111": ("履 (Lǚ)", "Treading", "Careful progress. Mind the details while moving forward."),
+        "111000": ("泰 (Tài)", "Peace", "Harmony achieved. Maintain balance while building."),
+        "000111": ("否 (Pǐ)", "Standstill", "Blockage present. Pause, reassess, find new paths."),
+        "101111": ("同人 (Tóng Rén)", "Fellowship", "Community strength. Build alliances and share knowledge."),
+        "111101": ("大有 (Dà Yǒu)", "Great Possession", "Abundance available. Share generously to multiply value."),
+        "001000": ("謙 (Qiān)", "Modesty", "Humble confidence. Let work speak for itself."),
+        "000100": ("豫 (Yù)", "Enthusiasm", "Infectious energy. Channel excitement into action."),
+        "100110": ("隨 (Suí)", "Following", "Adaptive leadership. Know when to lead and when to follow."),
+        "011001": ("蠱 (Gǔ)", "Work on Decay", "Fix technical debt. Address root causes."),
+        "110000": ("臨 (Lín)", "Approach", "Opportunity approaching. Prepare to receive it."),
+        "000011": ("觀 (Guān)", "Contemplation", "Step back for perspective. See the whole system."),
+        "100101": ("噬嗑 (Shì Kè)", "Biting Through", "Remove obstacles decisively. Clear blockages."),
+        "101001": ("賁 (Bì)", "Grace", "Polish and refine. Beauty enhances function."),
+        "000001": ("剝 (Bō)", "Splitting Apart", "Decay phase. Let go of what's not working."),
+        "100000": ("復 (Fù)", "Return", "New cycle begins. Start fresh with lessons learned."),
+        "100111": ("無妄 (Wú Wàng)", "Innocence", "Act with pure intention. Avoid overthinking."),
+        "111001": ("大畜 (Dà Chù)", "Great Accumulation", "Build reserves. Invest in infrastructure."),
+        "100001": ("頤 (Yí)", "Nourishment", "Feed growth. Provide resources teams need."),
+        "011110": ("大過 (Dà Guò)", "Great Excess", "Extraordinary measures needed. Bold action required."),
+        "010010": ("坎 (Kǎn)", "Abysmal", "Navigate danger carefully. Trust your training."),
+        "101101": ("離 (Lí)", "Clinging Fire", "Clarity and vision. Illuminate the path forward."),
+        "001110": ("咸 (Xián)", "Influence", "Mutual attraction. Build on natural affinities."),
+        "011100": ("恆 (Héng)", "Duration", "Persistence pays. Maintain steady effort."),
+        "001111": ("遯 (Dùn)", "Retreat", "Strategic withdrawal. Regroup and refocus."),
+        "111100": ("大壯 (Dà Zhuàng)", "Great Power", "Strength available. Use power responsibly."),
+        "000101": ("晉 (Jìn)", "Progress", "Advance steadily. Each step builds momentum."),
+        "101000": ("明夷 (Míng Yí)", "Darkening Light", "Work quietly. Keep brilliance hidden for now."),
+        "101011": ("家人 (Jiā Rén)", "Family", "Team harmony. Strengthen internal culture."),
+        "110101": ("睽 (Kuí)", "Opposition", "Creative tension. Find synthesis in differences."),
+        "001010": ("蹇 (Jiǎn)", "Obstruction", "Difficulty ahead. Find alternative routes."),
+        "010100": ("解 (Xiè)", "Deliverance", "Breakthrough achieved. Consolidate gains."),
+        "110001": ("損 (Sǔn)", "Decrease", "Simplify ruthlessly. Less is more."),
+        "100011": ("益 (Yì)", "Increase", "Multiply value. Invest in growth."),
+        "111110": ("夬 (Guài)", "Breakthrough", "Decisive moment. Act with conviction."),
+        "011111": ("姤 (Gòu)", "Coming to Meet", "Unexpected encounter. Stay alert to opportunity."),
+        "000110": ("萃 (Cuì)", "Gathering", "Convergence point. Bring elements together."),
+        "011000": ("升 (Shēng)", "Pushing Upward", "Gradual ascent. Build systematically."),
+        "010110": ("困 (Kùn)", "Exhaustion", "Resources depleted. Rest and recharge."),
+        "011010": ("井 (Jǐng)", "The Well", "Deep resources. Draw from fundamentals."),
+        "101110": ("革 (Gé)", "Revolution", "Transform completely. Embrace radical change."),
+        "011101": ("鼎 (Dǐng)", "The Cauldron", "Transformation vessel. Cook new solutions."),
+        "100100": ("震 (Zhèn)", "Thunder", "Shocking awakening. Respond to wake-up calls."),
+        "001001": ("艮 (Gèn)", "Mountain", "Stillness and stability. Find solid ground."),
+        "001011": ("漸 (Jiàn)", "Gradual Progress", "Step by step. Patient development."),
+        "110100": ("歸妹 (Guī Mèi)", "Marrying Maiden", "New partnerships. Align expectations."),
+        "101100": ("豐 (Fēng)", "Abundance", "Peak achievement. Prepare for cycles."),
+        "001101": ("旅 (Lǚ)", "The Wanderer", "Explorer mindset. Learn from journey."),
+        "011011": ("巽 (Xùn)", "Gentle Wind", "Subtle influence. Persistent gentle pressure."),
+        "110110": ("兌 (Duì)", "Joy", "Infectious happiness. Celebrate progress."),
+        "010011": ("渙 (Huàn)", "Dispersion", "Break up rigidity. Dissolve barriers."),
+        "110010": ("節 (Jié)", "Limitation", "Healthy constraints. Focus through limits."),
+        "110011": ("中孚 (Zhōng Fú)", "Inner Truth", "Authentic core. Build from truth."),
+        "001100": ("小過 (Xiǎo Guò)", "Small Excess", "Minor adjustments. Fine-tune carefully."),
+        "101010": ("既濟 (Jì Jì)", "After Completion", "Success achieved. Maintain vigilance."),
+        "010101": ("未濟 (Wèi Jì)", "Before Completion", "Almost there. Final push needed."),
+    }
+    
+    def __init__(self, lines: str):
+        self.lines = lines
+        self.name, self.title, self.meaning = self.HEXAGRAMS.get(
+            lines, 
+            ("Unknown", "Mystery", "The pattern is unclear. Trust your intuition.")
+        )
+    
+    def get_changing_lines(self) -> List[int]:
+        """Identify which lines are changing (would be 6 or 9 in traditional I Ching)."""
+        # For simplicity, randomly select 0-2 changing lines
+        num_changes = random.choice([0, 1, 1, 2])
+        if num_changes == 0:
+            return []
+        positions = list(range(6))
+        return sorted(random.sample(positions, num_changes))
+
+
+class IChing:
+    """I Ching oracle for engineering guidance."""
+    
+    def __init__(self):
+        self.principles = list(HanzoPrinciple)
+    
+    def cast_hexagram(self) -> Hexagram:
+        """Cast a hexagram using virtual coins."""
+        lines = ""
+        for _ in range(6):
+            # Three coin tosses: heads=3, tails=2
+            coins = sum(random.choice([2, 3]) for _ in range(3))
+            # 6=old yin(changing 0), 7=young yang(1), 8=young yin(0), 9=old yang(changing 1)
+            if coins in [6, 8]:
+                lines += "0"
+            else:
+                lines += "1"
+        return Hexagram(lines)
+    
+    def select_principles(self, hexagram: Hexagram, challenge: str) -> List[HanzoPrinciple]:
+        """Select relevant Hanzo principles based on hexagram and challenge."""
+        # Use hexagram pattern to deterministically but creatively select principles
+        selected = []
+        
+        # Primary principle based on hexagram pattern
+        primary_index = sum(int(bit) * (2**i) for i, bit in enumerate(hexagram.lines)) % len(self.principles)
+        selected.append(self.principles[primary_index])
+        
+        # Supporting principles based on challenge keywords
+        keywords = challenge.lower().split()
+        keyword_matches = {
+            "scale": [HanzoPrinciple.SCALABLE, HanzoPrinciple.EXPONENTIALITY],
+            "speed": [HanzoPrinciple.VELOCITY, HanzoPrinciple.URGENCY],
+            "quality": [HanzoPrinciple.PRECISION, HanzoPrinciple.VALIDATION],
+            "team": [HanzoPrinciple.AUTONOMY, HanzoPrinciple.BALANCE],
+            "design": [HanzoPrinciple.SIMPLICITY, HanzoPrinciple.BEAUTY],
+            "bug": [HanzoPrinciple.EMPIRICISM, HanzoPrinciple.OBJECTIVITY],
+            "refactor": [HanzoPrinciple.CLARITY, HanzoPrinciple.COMPOSABLE],
+            "security": [HanzoPrinciple.SECURITY, HanzoPrinciple.INTEGRITY],
+            "performance": [HanzoPrinciple.CONCURRENCY, HanzoPrinciple.ORTHOGONAL],
+            "user": [HanzoPrinciple.CUSTOMER_OBSESSION, HanzoPrinciple.ACCESSIBILITY],
+        }
+        
+        for keyword, principles in keyword_matches.items():
+            if keyword in keywords:
+                selected.extend(principles)
+        
+        # Add complementary principle based on changing lines
+        changing_lines = hexagram.get_changing_lines()
+        if changing_lines:
+            complement_index = (primary_index + sum(changing_lines)) % len(self.principles)
+            selected.append(self.principles[complement_index])
+        
+        # Ensure uniqueness and limit to 3-5 principles
+        seen = set()
+        unique_selected = []
+        for principle in selected:
+            if principle not in seen:
+                seen.add(principle)
+                unique_selected.append(principle)
+        
+        return unique_selected[:5]
+    
+    def generate_guidance(
+        self,
+        hexagram: Hexagram,
+        principles: List[HanzoPrinciple],
+        challenge: str
+    ) -> str:
+        """Generate creative guidance combining I Ching wisdom and Hanzo principles."""
+        guidance = f"☯️ I CHING GUIDANCE FOR ENGINEERING CHALLENGE ☯️\n\n"
+        guidance += f"**Your Challenge:** {challenge}\n\n"
+        
+        guidance += f"**Hexagram Cast:** {hexagram.name} - {hexagram.title}\n"
+        guidance += f"**Pattern:** {''.join('━━━' if l == '1' else '━ ━' for l in hexagram.lines[::-1])}\n"
+        guidance += f"**Ancient Wisdom:** {hexagram.meaning}\n\n"
+        
+        guidance += "**Hanzo Principles to Apply:**\n\n"
+        
+        for principle in principles:
+            name, wisdom, emoji = principle.value
+            guidance += f"{emoji} **{name}**\n"
+            guidance += f"   *{wisdom}*\n\n"
+        
+        # Generate specific actionable advice
+        guidance += "**Synthesized Approach:**\n\n"
+        
+        # Hexagram-specific guidance
+        if "Creative" in hexagram.title:
+            guidance += "• This is a time for bold innovation. Don't hold back on ambitious ideas.\n"
+        elif "Receptive" in hexagram.title:
+            guidance += "• Listen deeply to user needs and system constraints before acting.\n"
+        elif "Difficulty" in hexagram.title:
+            guidance += "• Challenges are teachers. Each obstacle reveals the path forward.\n"
+        elif "Waiting" in hexagram.title:
+            guidance += "• Strategic patience required. Prepare thoroughly before implementation.\n"
+        elif "Conflict" in hexagram.title:
+            guidance += "• Technical disagreements? Seek data-driven resolution.\n"
+        elif "Peace" in hexagram.title:
+            guidance += "• Harmony achieved. Now build sustainably on this foundation.\n"
+        
+        # Principle-specific actionable advice
+        principle_actions = {
+            HanzoPrinciple.SCALABLE: "• Design for 10x growth from day one. Remove scaling bottlenecks now.",
+            HanzoPrinciple.VELOCITY: "• Ship an MVP today. Perfect is the enemy of shipped.",
+            HanzoPrinciple.SIMPLICITY: "• Delete half your code. The best code is no code.",
+            HanzoPrinciple.EMPIRICISM: "• Measure everything. Let data guide your decisions.",
+            HanzoPrinciple.CUSTOMER_OBSESSION: "• Talk to users now. Their pain is your roadmap.",
+            HanzoPrinciple.CONCURRENCY: "• Parallelize everything possible. Sequential is slow.",
+            HanzoPrinciple.SECURITY: "• Security is not optional. Encrypt by default.",
+            HanzoPrinciple.ZEN: "• Find calm in the chaos. Clear mind writes better code.",
+        }
+        
+        for principle in principles:
+            if principle in principle_actions:
+                guidance += principle_actions[principle] + "\n"
+        
+        # Changing lines wisdom
+        changing_lines = hexagram.get_changing_lines()
+        if changing_lines:
+            guidance += f"\n**Lines in Transition:** {', '.join(str(i+1) for i in changing_lines)}\n"
+            guidance += "• Change is imminent in these areas. Prepare for transformation.\n"
+        
+        # Final synthesis
+        guidance += "\n**The Way Forward:**\n"
+        guidance += self._synthesize_action_plan(hexagram, principles, challenge)
+        
+        guidance += "\n\n*Remember: The I Ching reveals patterns, not prescriptions. "
+        guidance += "Let this wisdom guide your intuition as you craft your solution.*"
+        
+        return guidance
+    
+    def _synthesize_action_plan(
+        self,
+        hexagram: Hexagram,
+        principles: List[HanzoPrinciple],
+        challenge: str
+    ) -> str:
+        """Create a specific action plan based on the reading."""
+        plan = ""
+        
+        # Determine the nature of the challenge
+        if any(word in challenge.lower() for word in ["bug", "error", "fix", "broken"]):
+            plan += "1. **Diagnose systematically** - Use empirical debugging, not guesswork\n"
+            plan += "2. **Fix root cause** - Address the source, not just symptoms\n"
+            plan += "3. **Prevent recurrence** - Add tests and monitoring\n"
+        elif any(word in challenge.lower() for word in ["scale", "performance", "slow"]):
+            plan += "1. **Measure first** - Profile to find actual bottlenecks\n"
+            plan += "2. **Parallelize** - Use concurrency where possible\n"
+            plan += "3. **Simplify** - Remove complexity before optimizing\n"
+        elif any(word in challenge.lower() for word in ["design", "architect", "structure"]):
+            plan += "1. **Start simple** - MVP first, elaborate later\n"
+            plan += "2. **Stay flexible** - Design for change\n"
+            plan += "3. **Think holistically** - Consider entire system\n"
+        elif any(word in challenge.lower() for word in ["team", "collaborate", "people"]):
+            plan += "1. **Enable autonomy** - Trust your team\n"
+            plan += "2. **Maintain balance** - Sustainable pace wins\n"
+            plan += "3. **Share knowledge** - Elevate everyone\n"
+        else:
+            plan += "1. **Clarify intent** - What problem are you really solving?\n"
+            plan += "2. **Start small** - Build incrementally\n"
+            plan += "3. **Iterate rapidly** - Fast feedback loops\n"
+        
+        return plan
+
+
+class IChingTool(BaseTool):
+    """Tool for applying I Ching wisdom to engineering challenges."""
+    
+    name = "iching"
+    
+    @property
+    @override
+    def description(self) -> str:
+        """Get the tool description."""
+        return """Apply I Ching wisdom and Hanzo principles to engineering challenges.
+
+This tool casts an I Ching hexagram and selects relevant Hanzo principles
+to provide creative guidance for your engineering challenge.
+
+Parameters:
+- challenge: Description of the engineering challenge or question
+
+The oracle will:
+1. Cast a hexagram representing the current situation
+2. Select relevant Hanzo principles
+3. Synthesize actionable guidance
+4. Provide specific recommendations
+
+Example:
+iching(
+    challenge="How should I approach refactoring this legacy codebase?"
+)
+
+Use this when you need:
+- Fresh perspective on a problem
+- Creative approach to challenges
+- Wisdom for difficult decisions
+- Alignment with Hanzo principles"""
+    
+    def __init__(self):
+        """Initialize the I Ching tool."""
+        super().__init__()
+        self.oracle = IChing()
+    
+    async def call(
+        self,
+        ctx: MCPContext,
+        challenge: str
+    ) -> str:
+        """Cast I Ching and provide guidance."""
+        # Cast hexagram
+        hexagram = self.oracle.cast_hexagram()
+        
+        # Select relevant principles
+        principles = self.oracle.select_principles(hexagram, challenge)
+        
+        # Generate guidance
+        guidance = self.oracle.generate_guidance(hexagram, principles, challenge)
+        
+        return guidance
+    
+    def register(self, server: FastMCP) -> None:
+        """Register the tool with the MCP server."""
+        tool_self = self
+        
+        @server.tool(name=self.name, description=self.description)
+        async def iching(
+            ctx: MCPContext,
+            challenge: str
+        ) -> str:
+            return await tool_self.call(ctx, challenge)