pygeai-orchestration 0.1.0b5__py3-none-any.whl → 0.1.0b7__py3-none-any.whl

pygeai_orchestration/__init__.py

@@ -3,10 +3,10 @@ import logging
 __author__ = "Globant"
 __version__ = "0.1.0b1"
 
-logger = logging.getLogger("pygeai-orchestration")
+logger = logging.getLogger("pygeai_orchestration")
 logger.addHandler(logging.NullHandler())
 
-from .core import (
+from pygeai_orchestration.core import (
     BaseAgent,
     AgentConfig,
     BaseOrchestrator,
@@ -32,7 +32,6 @@ from .core import (
     Memory,
     MemoryEntry,
     MemoryStore,
-    get_logger,
     get_config,
     OrchestrationError,
     PatternExecutionError,
@@ -43,7 +42,7 @@ from .core import (
     ValidationError,
 )
 
-from .patterns import (
+from pygeai_orchestration.patterns import (
     ReflectionPattern,
     ToolUsePattern,
     ReActPattern,
@@ -55,6 +54,7 @@ from .patterns import (
 
 __all__ = [
     "__version__",
+    "logger",
     "BaseAgent",
     "AgentConfig",
     "BaseOrchestrator",
@@ -80,7 +80,6 @@ __all__ = [
     "Memory",
     "MemoryEntry",
     "MemoryStore",
-    "get_logger",
     "get_config",
     "OrchestrationError",
     "PatternExecutionError",

pygeai_orchestration/core/__init__.py

@@ -30,8 +30,6 @@ from .common import (
 )
 
 from .utils import (
-    OrchestrationLogger,
-    get_logger,
     ConfigManager,
     get_config,
     ValidationResult,
@@ -97,8 +95,6 @@ __all__ = [
     "Memory",
     "MemoryEntry",
     "MemoryStore",
-    "OrchestrationLogger",
-    "get_logger",
     "ConfigManager",
     "get_config",
     "ValidationResult",

pygeai_orchestration/core/base/__init__.py

@@ -1,9 +1,9 @@
-from .agent import BaseAgent, AgentConfig
-from .orchestrator import BaseOrchestrator, OrchestratorConfig
-from .pattern import BasePattern, PatternConfig, PatternResult, PatternType
-from .tool import BaseTool, ToolConfig, ToolResult, ToolCategory
-from .geai_agent import GEAIAgent
-from .geai_orchestrator import GEAIOrchestrator
+from pygeai_orchestration.core.base.agent import BaseAgent, AgentConfig
+from pygeai_orchestration.core.base.orchestrator import BaseOrchestrator, OrchestratorConfig
+from pygeai_orchestration.core.base.pattern import BasePattern, PatternConfig, PatternResult, PatternType
+from pygeai_orchestration.core.base.tool import BaseTool, ToolConfig, ToolResult, ToolCategory
+from pygeai_orchestration.core.base.geai_agent import GEAIAgent
+from pygeai_orchestration.core.base.geai_orchestrator import GEAIOrchestrator
 
 __all__ = [
     "BaseAgent",

pygeai_orchestration/core/base/geai_agent.py

@@ -5,19 +5,16 @@ This module provides a concrete agent implementation using the PyGEAI SDK,
 enabling AI-powered task execution with GeneXus Enterprise AI.
 """
 
+import logging
 from typing import Any, Dict, Optional
-from .agent import BaseAgent, AgentConfig
-from ..utils import get_logger
 
-logger = get_logger()
+from pygeai_orchestration.core.base.agent import BaseAgent, AgentConfig
+from pygeai.core.base.session import Session
+from pygeai.chat.managers import ChatManager
+from pygeai.core.models import LlmSettings, ChatMessageList, ChatMessage
+from pygeai.core.common.config import get_settings
 
-try:
-    from pygeai import Session
-
-    PYGEAI_AVAILABLE = True
-except ImportError:
-    PYGEAI_AVAILABLE = False
-    logger.warning("PyGEAI not available. GEAIAgent will have limited functionality.")
+logger = logging.getLogger("pygeai_orchestration")
 
 
 class GEAIAgent(BaseAgent):
@@ -28,10 +25,10 @@ class GEAIAgent(BaseAgent):
     Enterprise AI models, providing AI-powered reasoning and generation.
 
     The agent:
-    - Integrates with PyGEAI Session and Agent resources
+    - Integrates with PyGEAI Session and ChatManager
     - Supports custom system prompts and model configuration
-    - Automatically manages agent resource creation
     - Maintains execution history
+    - Automatically loads credentials from ~/.geai/credentials
     """
 
     def __init__(self, config: AgentConfig, session=None, alias: Optional[str] = None):
@@ -40,14 +37,20 @@ class GEAIAgent(BaseAgent):
 
         :param config: AgentConfig - Agent configuration.
         :param session: Optional PyGEAI Session - Existing session to use.
-        :param alias: Optional[str] - Session alias if creating new session.
-        :raises ImportError: If PyGEAI is not installed.
+        :param alias: Optional[str] - Credentials alias (default: 'default').
         """
         super().__init__(config)
-        if not PYGEAI_AVAILABLE:
-            raise ImportError("PyGEAI is required for GEAIAgent but is not installed")
-        self._session = session or Session(alias=alias)
-        self._agent_resource = None
+        
+        if session:
+            self._session = session
+        else:
+            alias = alias or 'default'
+            settings = get_settings()
+            api_key = settings.get_api_key(alias)
+            base_url = settings.get_base_url(alias)
+            self._session = Session(api_key=api_key, base_url=base_url)
+        
+        self._chat_manager = ChatManager(self._session)
 
     async def execute(self, task: str, context: Optional[Dict[str, Any]] = None) -> Dict[str, Any]:
         """
@@ -88,8 +91,6 @@ class GEAIAgent(BaseAgent):
         :raises Exception: If generation fails.
         """
         try:
-            self._get_or_create_agent()
-
             messages = kwargs.get("messages", [])
             if not messages:
                 messages = [{"role": "user", "content": prompt}]
@@ -97,48 +98,24 @@ class GEAIAgent(BaseAgent):
             if self.config.system_prompt:
                 messages.insert(0, {"role": "system", "content": self.config.system_prompt})
 
-            chat = self._session.chats.create(
-                messages=messages,
-                model=self.config.model,
-                temperature=self.config.temperature,
-                max_tokens=self.config.max_tokens,
+            chat_messages = ChatMessageList(
+                messages=[ChatMessage(role=msg["role"], content=msg["content"]) for msg in messages]
+            )
+
+            llm_settings = LlmSettings(
+                temperature=self.config.temperature, max_tokens=self.config.max_tokens
+            )
+
+            response = self._chat_manager.chat_completion(
+                model=self.config.model, messages=chat_messages, llm_settings=llm_settings
             )
 
-            response = chat.choices[0].message.content
+            response_text = response.choices[0].message.content
 
-            self.add_to_history({"type": "generation", "prompt": prompt, "response": response})
+            self.add_to_history({"type": "generation", "prompt": prompt, "response": response_text})
 
-            return response
+            return response_text
 
         except Exception as e:
             logger.error(f"Generation failed: {str(e)}")
             raise
-
-    def _get_or_create_agent(self):
-        """
-        Get or create PyGEAI agent resource.
-
-        Lazily creates an agent resource in PyGEAI if not already created,
-        or reuses existing agent with matching name.
-
-        :return: PyGEAI Agent resource.
-        """
-        if self._agent_resource is None:
-            try:
-                agents = self._session.agents.list()
-                for agent in agents.data:
-                    if agent.name == self.name:
-                        self._agent_resource = agent
-                        break
-
-                if self._agent_resource is None:
-                    logger.debug(f"Creating new agent resource: {self.name}")
-                    self._agent_resource = self._session.agents.create(
-                        name=self.name,
-                        model=self.config.model,
-                        description=self.config.description or f"Orchestration agent: {self.name}",
-                    )
-            except Exception as e:
-                logger.warning(f"Could not create agent resource: {str(e)}")
-
-        return self._agent_resource

pygeai_orchestration/core/base/geai_orchestrator.py

@@ -1,9 +1,10 @@
+import logging
 from typing import Any, Dict, List, Optional
-from .orchestrator import BaseOrchestrator, OrchestratorConfig
-from .pattern import PatternResult
-from ..utils import get_logger
 
-logger = get_logger()
+from pygeai_orchestration.core.base.orchestrator import BaseOrchestrator, OrchestratorConfig
+from pygeai_orchestration.core.base.pattern import PatternResult
+
+logger = logging.getLogger("pygeai_orchestration")
 
 
 class GEAIOrchestrator(BaseOrchestrator):
@@ -48,30 +49,7 @@ class GEAIOrchestrator(BaseOrchestrator):
 
     async def coordinate_agents(self, agents: List[str], task: str) -> Dict[str, Any]:
         logger.info(f"Coordinating {len(agents)} agents for task: {task[:50]}...")
-
-        results = {}
-
-        for agent_name in agents:
-            agent = self.get_agent(agent_name)
-            if agent is None:
-                logger.warning(f"Agent '{agent_name}' not found, skipping")
-                continue
-
-            try:
-                result = await agent.execute(task)
-                results[agent_name] = result
-            except Exception as e:
-                logger.error(f"Agent '{agent_name}' failed: {str(e)}")
-                results[agent_name] = {"success": False, "error": str(e)}
-
-        return {
-            "success": len(results) > 0,
-            "results": results,
-            "agents_executed": list(results.keys()),
-        }
+        return {"status": "not_implemented", "agents": agents, "task": task}
 
     def get_execution_history(self) -> List[Dict[str, Any]]:
         return self._execution_history.copy()
-
-    def clear_history(self) -> None:
-        self._execution_history.clear()

pygeai_orchestration/core/base/orchestrator.py

@@ -9,8 +9,8 @@ from abc import ABC, abstractmethod
 from typing import Any, Dict, List, Optional
 from pydantic import BaseModel, Field
 
-from .agent import BaseAgent
-from .pattern import BasePattern, PatternResult
+from pygeai_orchestration.core.base.agent import BaseAgent
+from pygeai_orchestration.core.base.pattern import BasePattern, PatternResult
 
 
 class OrchestratorConfig(BaseModel):

pygeai_orchestration/core/utils/__init__.py

@@ -1,14 +1,13 @@
-from .logging import OrchestrationLogger, get_logger
-from .config import ConfigManager, get_config
-from .validators import (
+from pygeai_orchestration.core.utils.config import ConfigManager, get_config
+from pygeai_orchestration.core.utils.validators import (
     ValidationResult,
     validate_agent_config,
     validate_pattern_config,
     validate_tool_config,
     validate_pydantic_model,
 )
-from .cache import CacheEntry, LRUCache, PatternCache
-from .metrics import (
+from pygeai_orchestration.core.utils.cache import CacheEntry, LRUCache, PatternCache
+from pygeai_orchestration.core.utils.metrics import (
     Metric,
     MetricType,
     MetricsCollector,
@@ -17,8 +16,6 @@ from .metrics import (
 )
 
 __all__ = [
-    "OrchestrationLogger",
-    "get_logger",
     "ConfigManager",
     "get_config",
     "ValidationResult",

pygeai_orchestration/patterns/multi_agent.py

@@ -1,9 +1,9 @@
 from typing import Any, Dict, List, Optional
-from ..core.base import BasePattern, PatternConfig, PatternResult, PatternType
-from ..core.common import Message, MessageRole, Conversation, State, StateStatus
-from ..core.utils import get_logger
+from pygeai_orchestration.core.base import BasePattern, PatternConfig, PatternResult, PatternType
+from pygeai_orchestration.core.common import Message, MessageRole, Conversation, State, StateStatus
+import logging
 
-logger = get_logger()
+logger = logging.getLogger("pygeai_orchestration")
 
 
 class AgentRole:

pygeai_orchestration/patterns/planning.py

@@ -1,9 +1,9 @@
 from typing import Any, Dict, List, Optional
-from ..core.base import BasePattern, PatternConfig, PatternResult, PatternType
-from ..core.common import Message, MessageRole, Conversation, State, StateStatus
-from ..core.utils import get_logger
+from pygeai_orchestration.core.base import BasePattern, PatternConfig, PatternResult, PatternType
+from pygeai_orchestration.core.common import Message, MessageRole, Conversation, State, StateStatus
+import logging
 
-logger = get_logger()
+logger = logging.getLogger("pygeai_orchestration")
 
 
 class PlanStep:

pygeai_orchestration/patterns/react.py

@@ -1,9 +1,9 @@
 from typing import Any, Dict, List, Optional
-from ..core.base import BasePattern, BaseTool, PatternConfig, PatternResult, PatternType
-from ..core.common import Message, MessageRole, Conversation, State, StateStatus
-from ..core.utils import get_logger
+from pygeai_orchestration.core.base import BasePattern, BaseTool, PatternConfig, PatternResult, PatternType
+from pygeai_orchestration.core.common import Message, MessageRole, Conversation, State, StateStatus
+import logging
 
-logger = get_logger()
+logger = logging.getLogger("pygeai_orchestration")
 
 
 class ReActPattern(BasePattern):

pygeai_orchestration/patterns/reflection.py

@@ -1,9 +1,9 @@
 from typing import Any, Dict, Optional
-from ..core.base import BasePattern, PatternConfig, PatternResult, PatternType
-from ..core.common import Message, MessageRole, Conversation, State, StateStatus
-from ..core.utils import get_logger
+from pygeai_orchestration.core.base import BasePattern, PatternConfig, PatternResult, PatternType
+from pygeai_orchestration.core.common import Message, MessageRole, Conversation, State, StateStatus
+import logging
 
-logger = get_logger()
+logger = logging.getLogger("pygeai_orchestration")
 
 
 class ReflectionPattern(BasePattern):

pygeai_orchestration/patterns/tool_use.py

@@ -1,9 +1,9 @@
 from typing import Any, Dict, List, Optional
-from ..core.base import BasePattern, BaseTool, PatternConfig, PatternResult, PatternType
-from ..core.common import Message, MessageRole, Conversation, State, StateStatus
-from ..core.utils import get_logger
+from pygeai_orchestration.core.base import BasePattern, BaseTool, PatternConfig, PatternResult, PatternType
+from pygeai_orchestration.core.common import Message, MessageRole, Conversation, State, StateStatus
+import logging
 
-logger = get_logger()
+logger = logging.getLogger("pygeai_orchestration")
 
 
 class ToolUsePattern(BasePattern):

{pygeai_orchestration-0.1.0b5.dist-info → pygeai_orchestration-0.1.0b7.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pygeai-orchestration
-Version: 0.1.0b5
+Version: 0.1.0b7
 Summary: Agentic AI orchestration patterns built on Globant Enterprise AI
 Author-email: Globant <geai-sdk@globant.com>
 Keywords: geai,pygeai,orchestration,agents,ai,multi-agent,autogen,crewai
@@ -88,27 +88,37 @@ import asyncio
 from pygeai_orchestration import (
     GEAIAgent,
     AgentConfig,
+    PatternConfig,
+    PatternType,
     ReflectionPattern
 )
 
 async def main():
-    # Create an agent
-    config = AgentConfig(
+    # Create agent configuration
+    agent_config = AgentConfig(
         name="my-agent",
-        model="gpt-4",
+        model="openai/gpt-4o-mini",
         temperature=0.7
     )
-    agent = GEAIAgent(config)
+    agent = GEAIAgent(config=agent_config)
+    
+    # Create pattern configuration
+    pattern_config = PatternConfig(
+        name="reflection-example",
+        pattern_type=PatternType.REFLECTION,
+        max_iterations=3
+    )
     
     # Create and execute pattern
-    pattern = ReflectionPattern(agent=agent)
-    result = await pattern.execute("Improve this text: Hello world")
+    pattern = ReflectionPattern(agent=agent, config=pattern_config)
+    result = await pattern.execute("Explain quantum computing in simple terms")
     
     print(f"Success: {result.success}")
-    print(f"Result: {result.result}")
     print(f"Iterations: {result.iterations}")
+    print(f"Result: {result.result[:200]}...")  # First 200 chars
 
-asyncio.run(main())
+if __name__ == "__main__":
+    asyncio.run(main())
 ```
 
 ## Configuration
@@ -137,10 +147,24 @@ See [PyGEAI Configuration](https://docs.globant.ai/en/wiki?1149,Getting+started+
 Enables agents to self-critique and iteratively improve their outputs.
 
 ```python
-from pygeai_orchestration.patterns.reflection import ReflectionAgent
+from pygeai_orchestration import GEAIAgent, AgentConfig, PatternConfig, PatternType, ReflectionPattern
+
+agent = GEAIAgent(config=AgentConfig(
+    name="reflector",
+    model="openai/gpt-4o-mini",
+    temperature=0.7
+))
+
+pattern = ReflectionPattern(
+    agent=agent,
+    config=PatternConfig(
+        name="reflection",
+        pattern_type=PatternType.REFLECTION,
+        max_iterations=3
+    )
+)
 
-agent = ReflectionAgent(session=session, agent_id="critic-agent")
-result = agent.reflect_and_improve("Initial output", iterations=3)
+result = await pattern.execute("Explain quantum computing in simple terms")
 ```
 
 **Use Cases:**
@@ -148,30 +172,28 @@ result = agent.reflect_and_improve("Initial output", iterations=3)
 - Code review and refinement
 - Self-correcting responses
 
-### 2. Tool Use Pattern
-Integrates function calling and tool execution into agent workflows.
-
-```python
-from pygeai_orchestration.patterns.tool_use import ToolUseAgent
-
-agent = ToolUseAgent(session=session)
-agent.register_tool("search", search_function)
-result = agent.execute("Search for information about AI")
-```
-
-**Use Cases:**
-- API integration
-- External data retrieval
-- Action execution
-
-### 3. ReAct Pattern
+### 2. ReAct Pattern
 Implements the Reasoning + Acting loop for step-by-step problem solving.
 
 ```python
-from pygeai_orchestration.patterns.react import ReActAgent
+from pygeai_orchestration import GEAIAgent, AgentConfig, PatternConfig, PatternType, ReActPattern
+
+agent = GEAIAgent(config=AgentConfig(
+    name="reasoner",
+    model="openai/gpt-4o-mini",
+    temperature=0.7
+))
+
+pattern = ReActPattern(
+    agent=agent,
+    config=PatternConfig(
+        name="react",
+        pattern_type=PatternType.REACT,
+        max_iterations=5
+    )
+)
 
-agent = ReActAgent(session=session, agent_id="reasoning-agent")
-result = agent.solve("Complex multi-step problem")
+result = await pattern.execute("Research and summarize renewable energy benefits")
 ```
 
 **Use Cases:**
@@ -179,15 +201,28 @@ result = agent.solve("Complex multi-step problem")
 - Research tasks
 - Multi-step workflows
 
-### 4. Planning Pattern
+### 3. Planning Pattern
 Creates and executes multi-step plans with adaptive execution.
 
 ```python
-from pygeai_orchestration.patterns.planning import PlanningAgent
+from pygeai_orchestration import GEAIAgent, AgentConfig, PatternConfig, PatternType, PlanningPattern
+
+agent = GEAIAgent(config=AgentConfig(
+    name="planner",
+    model="openai/gpt-4o-mini",
+    temperature=0.5
+))
+
+pattern = PlanningPattern(
+    agent=agent,
+    config=PatternConfig(
+        name="planning",
+        pattern_type=PatternType.PLANNING,
+        max_iterations=1
+    )
+)
 
-agent = PlanningAgent(session=session, planner_id="planner")
-plan = agent.create_plan("Build a web application")
-result = agent.execute_plan(plan)
+result = await pattern.execute("Create a project plan for building a REST API")
 ```
 
 **Use Cases:**
@@ -195,16 +230,92 @@ result = agent.execute_plan(plan)
 - Task decomposition
 - Workflow automation
 
+### 4. Tool Use Pattern
+Integrates function calling and tool execution into agent workflows.
+
+```python
+from pygeai_orchestration import (
+    GEAIAgent, AgentConfig, PatternConfig, PatternType,
+    ToolUsePattern, BaseTool, ToolConfig, ToolResult, ToolCategory
+)
+
+class CalculatorTool(BaseTool):
+    def __init__(self):
+        super().__init__(ToolConfig(
+            name="calculator",
+            description="Performs calculations",
+            category=ToolCategory.COMPUTATION,
+            parameters_schema={"operation": "string", "values": "list"}
+        ))
+    
+    def validate_parameters(self, parameters):
+        return "operation" in parameters and "values" in parameters
+    
+    async def execute(self, operation, values, **kwargs):
+        if operation == "average":
+            result = sum(values) / len(values)
+            return ToolResult(success=True, result=result)
+        return ToolResult(success=False, error="Unknown operation")
+
+agent = GEAIAgent(config=AgentConfig(name="calculator", model="openai/gpt-4o-mini"))
+pattern = ToolUsePattern(
+    agent=agent,
+    config=PatternConfig(name="tools", pattern_type=PatternType.TOOL_USE),
+    tools=[CalculatorTool()]
+)
+
+result = await pattern.execute("Calculate average of: 10, 20, 30")
+```
+
+**Use Cases:**
+- API integration
+- External data retrieval
+- Action execution
+
 ### 5. Multi-Agent Pattern
 Coordinates multiple agents working collaboratively on complex tasks.
 
 ```python
-from pygeai_orchestration.patterns.multi_agent import MultiAgentCoordinator
+from pygeai_orchestration import (
+    GEAIAgent, AgentConfig, PatternConfig, PatternType, MultiAgentPattern, AgentRole
+)
+
+# Create specialized agents
+researcher = GEAIAgent(config=AgentConfig(
+    name="researcher",
+    model="openai/gpt-4o-mini",
+    system_prompt="You are a research specialist."
+))
+
+writer = GEAIAgent(config=AgentConfig(
+    name="writer",
+    model="openai/gpt-4o-mini",
+    system_prompt="You are a technical writer."
+))
+
+coordinator = GEAIAgent(config=AgentConfig(
+    name="coordinator",
+    model="openai/gpt-4o-mini",
+    system_prompt="You coordinate tasks and synthesize results."
+))
+
+# Create agent roles
+agent_roles = [
+    AgentRole(name="researcher", agent=researcher, role_description="Researches topics"),
+    AgentRole(name="writer", agent=writer, role_description="Writes reports")
+]
+
+# Create multi-agent pattern
+pattern = MultiAgentPattern(
+    agents=agent_roles,
+    coordinator_agent=coordinator,
+    config=PatternConfig(
+        name="collaboration",
+        pattern_type=PatternType.MULTI_AGENT
+    )
+)
 
-coordinator = MultiAgentCoordinator(session=session)
-coordinator.add_agent("researcher", researcher_agent)
-coordinator.add_agent("writer", writer_agent)
-result = coordinator.execute("Create research report")
+result = await pattern.execute("Create a report on AI in healthcare")
 ```
 
 **Use Cases:**
@@ -217,14 +328,13 @@ result = coordinator.execute("Create research report")
 - [Getting Started Guide](docs/getting-started.md)
 - [Pattern Documentation](docs/patterns/)
 - [API Reference](docs/api-reference/)
-- [Examples](snippets/)
+- [Code Snippets](snippets/)
 
 ## Development
 
 ### Setup Development Environment
 
 ```bash
-git clone https://docs.globant.ai/en/wiki?1149,Getting+started+with+PyGEAI-orchestration.git
 cd pygeai-orchestration
 python -m venv venv
 source venv/bin/activate  # On Windows: venv\Scripts\activate
@@ -247,15 +357,35 @@ python testing.py --coverage
 
 See [CONTRIBUTING.md](CONTRIBUTING.md) for detailed development guidelines.
 
-## Examples
+## Code Snippets
+
+Check the [snippets/](snippets/) directory for working code examples:
 
-Check the [snippets/](snippets/) directory for working examples of each pattern:
+### Reflection Pattern
+- [reflection_explanation.py](snippets/reflection_explanation.py) - Iterative explanation improvement
+- [reflection_code_review.py](snippets/reflection_code_review.py) - Code review with self-critique
 
-- [Reflection Pattern Example](snippets/reflection/basic_reflection.py)
-- [Tool Use Pattern Example](snippets/tool_use/function_calling.py)
-- [ReAct Pattern Example](snippets/react/simple_react_loop.py)
-- [Planning Pattern Example](snippets/planning/multi_step_plan.py)
-- [Multi-Agent Pattern Example](snippets/multi_agent/collaborative_agents.py)
+### ReAct Pattern
+- [react_research.py](snippets/react_research.py) - Structured research tasks
+- [react_problem_solving.py](snippets/react_problem_solving.py) - Step-by-step problem solving
+
+### Planning Pattern
+- [planning_project.py](snippets/planning_project.py) - Project planning and breakdown
+- [planning_analysis.py](snippets/planning_analysis.py) - Data analysis planning
+
+### Tool Use Pattern
+- [tool_use_calculator.py](snippets/tool_use_calculator.py) - Mathematical operations with tools
+- [tool_use_data_processing.py](snippets/tool_use_data_processing.py) - Data validation and transformation
+
+### Multi-Agent Pattern
+- [multi_agent_collaboration.py](snippets/multi_agent_collaboration.py) - Collaborative multi-agent workflow
+
+Run any snippet:
+```bash
+python snippets/reflection_explanation.py
+python snippets/react_research.py
+python snippets/planning_project.py
+```
 
 ## Contributing
 

{pygeai_orchestration-0.1.0b5.dist-info → pygeai_orchestration-0.1.0b7.dist-info}/RECORD

@@ -1,4 +1,4 @@
-pygeai_orchestration/__init__.py,sha256=phPtSd0SgtSOicRoZAbgkSQCPv0wPeWHWz-lpcEujx0,1820
+pygeai_orchestration/__init__.py,sha256=ZSKEjVRjkUzQtanmdtpFuXimNXShI-eqli8Lq52Cq8M,1840
 pygeai_orchestration/cli/__init__.py,sha256=d6wFWuMlcMLng3lBfjSOfhnO_tZINHfNUOmA7-zwPX4,134
 pygeai_orchestration/cli/__main__.py,sha256=2AmJiRvdlVSu3T6FmFAzQuu4a5llrUeMfUX8ShQxhus,157
 pygeai_orchestration/cli/error_handler.py,sha256=ReeeeX2TvJZBgdCc0hzvLZd8LYSQVqYI5hAEqJ4FCCM,3862
@@ -8,16 +8,16 @@ pygeai_orchestration/cli/interactive.py,sha256=KVZzgjMS89dDQM25XohcFb3dTbjpMsWV_
 pygeai_orchestration/cli/commands/__init__.py,sha256=PLWgWUXomwNCqR-wrl_-fWOYFN8PeIAvPnYvmzvzg0w,232
 pygeai_orchestration/cli/commands/base.py,sha256=BWjuxk06KkRVozCMbwjD_pkzrsAHWE9TgVKQegkIHoM,6558
 pygeai_orchestration/cli/texts/help.py,sha256=vHAA-2SSrSYpQLfLp3Ruz0-WEVb8UmCahgDkOZEcGGI,5423
-pygeai_orchestration/core/__init__.py,sha256=muVm1M6yfTgYDL6Fe1h6hdKB8QLJKQrWBgRj3svOSlk,2380
+pygeai_orchestration/core/__init__.py,sha256=33I1phMJ3skCMBAsOHVKd3pQ8cBzCjaPR95DWxs8RRE,2294
 pygeai_orchestration/core/composition.py,sha256=j_mV0iNJfPkCO8h1rrzKY0eL00g77C8D_Hy6qPnDaMw,6654
 pygeai_orchestration/core/config.py,sha256=m2dbBejao9ku0od4jYo4Xn-HmDvq_d44EYJkZKGgd4I,11493
 pygeai_orchestration/core/exceptions.py,sha256=nZWQlPFQtyGmx-qtErydXvIfiqkXuBlsxoofDyDoRLQ,13282
 pygeai_orchestration/core/handlers.py,sha256=6OMo3xZvHwITdn8J4kX7Wi65iWGRwnL0ioHLNmFWwBQ,13474
-pygeai_orchestration/core/base/__init__.py,sha256=VuUeoAVxKN1DOXMLKwkhPSkfMFVcKPwU0LP5M9jKeaM,622
+pygeai_orchestration/core/base/__init__.py,sha256=8w_BBaGo3x4_5xO_3H3DtfjF1i1AZYQ98ynfdtoZXNg,802
 pygeai_orchestration/core/base/agent.py,sha256=J_xRVE1MXPbXWC1ndwMHMVWY44S0myIzNfVPJzoE7Lo,4446
-pygeai_orchestration/core/base/geai_agent.py,sha256=PG0X8gmKiU0MxkRKJchvcBOztcVCk_eXwJ3kmcRi4aU,5097
-pygeai_orchestration/core/base/geai_orchestrator.py,sha256=sGEdUc4TeKJ_WiPw91FBkXCkEWO986WOXbm9LMp6CL8,2730
-pygeai_orchestration/core/base/orchestrator.py,sha256=83BIjYerW1ADnzWG_GGIzLTZF_nS93cb4uXp9KWryAU,4835
+pygeai_orchestration/core/base/geai_agent.py,sha256=ZS_flu4CQK2orxvctGW-GWKFiUqwchWIAOwVkjgDDpU,4371
+pygeai_orchestration/core/base/geai_orchestrator.py,sha256=QGkH1ovkpyrFPCIq_61E_-d-jSRGmiQ4dK0q02iVSkY,2120
+pygeai_orchestration/core/base/orchestrator.py,sha256=ZA5pvtbLqsK5yfTYCLLoEUmtoTgc8ceiHqXkhxqVmyc,4895
 pygeai_orchestration/core/base/pattern.py,sha256=vuj1UXLuaZvbhjiifwqThnQ_4uaRBkv2VQ5FBrY8Xxs,6114
 pygeai_orchestration/core/base/tool.py,sha256=sypjwrMKiiuwi6VmbXIVoIOkQ4RZWpZD0aSlOCKYOSs,5491
 pygeai_orchestration/core/common/__init__.py,sha256=akhDVqt8uFH0u2k4w_STrKZJ3ndjtpRDkp46baxCn6U,416
@@ -25,10 +25,9 @@ pygeai_orchestration/core/common/context.py,sha256=mMch8-9mLReYglBMbIB2RCDYn7EGj
 pygeai_orchestration/core/common/memory.py,sha256=1jYrqc1sPJujuIcNQLITXbKnQ_WMGjkvcNTMDkoQU9o,5841
 pygeai_orchestration/core/common/message.py,sha256=4JB3ZPeegaRvEYf1MKy7NBHm76oCBYf8V6cuNIf9kzw,1732
 pygeai_orchestration/core/common/state.py,sha256=mHo7ozjvPdHZfd-sbVg6t9HLND7ll1xD6sm6v8nCrb4,5690
-pygeai_orchestration/core/utils/__init__.py,sha256=-DVGUjf1t4XeWNk4SPrMTJcVI1Nf87-j-QJ_7EagsPI,819
+pygeai_orchestration/core/utils/__init__.py,sha256=X_CJGxoZM4ptt5aRS4SJr74r8TfHTLfpONkVNEb5DkI,845
 pygeai_orchestration/core/utils/cache.py,sha256=TJLtj115EXqlLrKLMoK7JCT-fZ1TGSjVxmJyW6n2p8c,4108
 pygeai_orchestration/core/utils/config.py,sha256=S2gzAsL20-h_AEFDj0izjlXhWucBLwbE7Vv4ovUiJIM,2775
-pygeai_orchestration/core/utils/logging.py,sha256=BPi0s9dU4i6e4E2HZU1omqI79JhaJ9js533RG_BFAtE,1812
 pygeai_orchestration/core/utils/metrics.py,sha256=Kw8hA-PS6UHMLf0pEG2XQZvcBbuIFhHdo1kWEMf6Vz8,6359
 pygeai_orchestration/core/utils/validators.py,sha256=EoVQSrJDmM8dGlqAoM_1q3B7SBAyI3yuLfcj3weZuio,5146
 pygeai_orchestration/dev/__init__.py,sha256=e-GSMmpkN1cINRDtInrjKTQogSJ2h-Q1ya_YaaMRF5s,476
@@ -36,11 +35,11 @@ pygeai_orchestration/dev/debug.py,sha256=0RJed1TCreaSm7HC9ijbd9EeMoh3zFn4osjrYDc
 pygeai_orchestration/dev/templates.py,sha256=J57-8Stg_m-f-cj_Zl9Yz_VNEZA-trGM8SKdsdzH7NQ,8143
 pygeai_orchestration/dev/testing.py,sha256=_zXvj3JHJNFEbZJnK-OdtL_tD-3xQeCHMrJ39UYqaqg,7826
 pygeai_orchestration/patterns/__init__.py,sha256=W5qROE1pbeVOgPx6xiKZtQp0eQPL9kEhL6Et3t6kBA8,376
-pygeai_orchestration/patterns/multi_agent.py,sha256=fe_9AS2L7b_M0-ahcwCgBjh_s8zYUi1nz7nS6OD5E6I,9857
-pygeai_orchestration/patterns/planning.py,sha256=JITIexKfmc1H2KTVCxbq9EhMGbwbYo4xwfVttW5zsc0,8885
-pygeai_orchestration/patterns/react.py,sha256=P1aNgjgrEPP-zUO5OfUx0q2GO9J_yvRakirRFiPJfho,9320
-pygeai_orchestration/patterns/reflection.py,sha256=KRthEpuGKH3LM0ceY0cahpC9kAmmH8HqXeF63r_kqUY,5728
-pygeai_orchestration/patterns/tool_use.py,sha256=trJPV_SzXOD6mXIAivJASHaahxYQZjBZcVmV57QQUv4,7594
+pygeai_orchestration/patterns/multi_agent.py,sha256=Rn1HJUeNRav--zsn075IC9tka6oYbn7lC1-583__Eiw,9903
+pygeai_orchestration/patterns/planning.py,sha256=rBDiX_DH5hE1HgOJt4MF6WOtOksoXH6JkbfaIFaYH8A,8931
+pygeai_orchestration/patterns/react.py,sha256=hNKh9EgdfUGLsO7sUi3AK8lq2EJL9QrhYXF-xsxqyto,9366
+pygeai_orchestration/patterns/reflection.py,sha256=MsjYlA4xHoZbs6wpI84ov_l-miXhHvO2W3Hy-CJcx4E,5774
+pygeai_orchestration/patterns/tool_use.py,sha256=ET0Sa8R-a2RcHzRY60voSf1TRVt9geiVzihCKtCFh1o,7640
 pygeai_orchestration/tests/__init__.py,sha256=nzx1KsiYalL_YuXKE6acW8Dj5flmMg0-i4gyYO0gV54,22
 pygeai_orchestration/tests/test_base_classes.py,sha256=9VcME1C1fY1cijblzh639ZQhV6-iWGuEx80kDRpDr6k,5673
 pygeai_orchestration/tests/test_cache.py,sha256=t_iYB_La1mkKBEnFinl10kNa1IVtW_yWjKq0dz8-Z4w,5705
@@ -53,9 +52,9 @@ pygeai_orchestration/tests/test_exceptions.py,sha256=l_YlVxZguM-xcUNlOl8u9R3vx_O
 pygeai_orchestration/tests/test_handlers.py,sha256=t3ZCbif4npxsgoYM6vpCrxOru0q-7f0ARjYAE1SuK7Y,12166
 pygeai_orchestration/tests/test_metrics.py,sha256=GP36BuTxp7ydptG4nGo804yB91UkBHuskEfJuZwkZvE,6078
 pygeai_orchestration/tests/test_patterns.py,sha256=9qarHU_9R70nfWf98TzMiJO_XCfz9-kOn9Ju2RQnogs,5051
-pygeai_orchestration-0.1.0b5.dist-info/licenses/LICENSE,sha256=HrOw5fbeVfHobmqgadP4r7dOPCMDA4uOfFX8pE3MDT0,1072
-pygeai_orchestration-0.1.0b5.dist-info/METADATA,sha256=2-mOXNUKIch8AaNw25Ni8VMNupeBGI0_49eDrhjub6k,8311
-pygeai_orchestration-0.1.0b5.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-pygeai_orchestration-0.1.0b5.dist-info/entry_points.txt,sha256=p8ODRFqLwrrhoS6FlQW330_J59-0ZjSd6x8kAYYLm7E,69
-pygeai_orchestration-0.1.0b5.dist-info/top_level.txt,sha256=8gLeyR8RXLump7AkakhU7kFBh6O7XTvrJi1bKK4e39g,21
-pygeai_orchestration-0.1.0b5.dist-info/RECORD,,
+pygeai_orchestration-0.1.0b7.dist-info/licenses/LICENSE,sha256=HrOw5fbeVfHobmqgadP4r7dOPCMDA4uOfFX8pE3MDT0,1072
+pygeai_orchestration-0.1.0b7.dist-info/METADATA,sha256=kVYrupmNerxCJVa12LqrR80SPbofje58N-_nnOOLE-Q,11933
+pygeai_orchestration-0.1.0b7.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+pygeai_orchestration-0.1.0b7.dist-info/entry_points.txt,sha256=p8ODRFqLwrrhoS6FlQW330_J59-0ZjSd6x8kAYYLm7E,69
+pygeai_orchestration-0.1.0b7.dist-info/top_level.txt,sha256=8gLeyR8RXLump7AkakhU7kFBh6O7XTvrJi1bKK4e39g,21
+pygeai_orchestration-0.1.0b7.dist-info/RECORD,,

pygeai_orchestration/core/utils/logging.py

@@ -1,57 +0,0 @@
-import logging
-import sys
-from typing import Optional
-
-
-class OrchestrationLogger:
-    _instance: Optional["OrchestrationLogger"] = None
-
-    def __new__(cls):
-        if cls._instance is None:
-            cls._instance = super().__new__(cls)
-        return cls._instance
-
-    def __init__(self):
-        if not hasattr(self, "_initialized"):
-            self._logger = logging.getLogger("pygeai_orchestration")
-            self._logger.setLevel(logging.INFO)
-
-            if not self._logger.handlers:
-                handler = logging.StreamHandler(sys.stdout)
-                formatter = logging.Formatter(
-                    "%(asctime)s - %(name)s - %(levelname)s - %(message)s",
-                    datefmt="%Y-%m-%d %H:%M:%S",
-                )
-                handler.setFormatter(formatter)
-                self._logger.addHandler(handler)
-
-            self._initialized = True
-
-    def set_level(self, level: str) -> None:
-        level_map = {
-            "debug": logging.DEBUG,
-            "info": logging.INFO,
-            "warning": logging.WARNING,
-            "error": logging.ERROR,
-            "critical": logging.CRITICAL,
-        }
-        self._logger.setLevel(level_map.get(level.lower(), logging.INFO))
-
-    def debug(self, message: str, **kwargs) -> None:
-        self._logger.debug(message, **kwargs)
-
-    def info(self, message: str, **kwargs) -> None:
-        self._logger.info(message, **kwargs)
-
-    def warning(self, message: str, **kwargs) -> None:
-        self._logger.warning(message, **kwargs)
-
-    def error(self, message: str, **kwargs) -> None:
-        self._logger.error(message, **kwargs)
-
-    def critical(self, message: str, **kwargs) -> None:
-        self._logger.critical(message, **kwargs)
-
-
-def get_logger() -> OrchestrationLogger:
-    return OrchestrationLogger()