agent/__init__.py

# agent/__init__.py
"""
Operations Agent Package

This package provides the complete operations agent with OMIRL integration,
LangGraph workflow management, and tool execution capabilities.

Main Components:
- OperationsAgent: Main agent interface
- Tool Registry: Available tools and specifications
- Workflow: LangGraph workflow definitions
- State Management: Agent state and data flow

Quick Start:
    from agent import create_operations_agent
    
    agent = create_operations_agent()
    response = await agent.process_request("mostra stazioni meteo genova")

OMIRL Integration:
    The agent provides seamless access to OMIRL weather station data
    through natural language requests or direct API calls.

Dependencies:
- LangGraph: Workflow orchestration
- Tools: OMIRL and other operational tools
- Services: Data processing and artifact generation
"""

from .agent import (
    OperationsAgent,
    create_operations_agent,
    create_debug_agent
)

from .registry import (
    get_tool_registry,
    get_tool_by_name,
    list_available_tools,
    get_omirl_tools,
    get_data_extraction_tools
)

from .state import (
    AgentState,
    ToolResult,
    ToolCall,
    create_initial_state
)

from .graph import (
    get_default_workflow,
    create_simple_workflow,
    create_operations_workflow
)

# Main exports
__all__ = [
    # Main agent classes
    "OperationsAgent",
    
    # Agent factory functions
    "create_operations_agent",
    "create_omirl_agent", 
    "create_debug_agent",
    
    # Tool registry functions
    "get_tool_registry",
    "get_tool_by_name",
    "list_available_tools",
    "get_omirl_tools",
    "get_data_extraction_tools",
    
    # State management
    "AgentState",
    "ToolResult", 
    "ToolCall",
    "create_initial_state",
    
    # Workflow functions
    "get_default_workflow",
    "create_simple_workflow",
    "create_operations_workflow"
]

# Package metadata
__version__ = "1.0.0"
__author__ = "Operations Team"
__description__ = "Operations Agent with OMIRL Integration"