xpander-sdk 2.0.161__py3-none-any.whl → 2.0.192__py3-none-any.whl

xpander_sdk/modules/tools_repository/sub_modules/tool.py

@@ -41,6 +41,7 @@ from xpander_sdk.modules.tools_repository.utils.schemas import (
     schema_enforcement_block_and_descriptions,
 )
 from xpander_sdk.utils.event_loop import run_sync
+from xpander_sdk.modules.events.decorators.on_tool import ToolHooksRegistry
 
 
 class Tool(XPanderSharedModel):
@@ -376,6 +377,15 @@ class Tool(XPanderSharedModel):
             task_id=task_id,
         )
 
+        # Execute before hooks
+        await ToolHooksRegistry.execute_before_hooks(
+            tool=self,
+            payload=payload,
+            payload_extension=payload_extension,
+            tool_call_id=tool_call_id,
+            agent_version=agent_version
+        )
+
         try:
             if self.schema and payload:
                 try:
@@ -386,32 +396,43 @@ class Tool(XPanderSharedModel):
                     ) from validation_error
 
             if self.is_local:
-                await self.agraph_preflight_check(
-                    agent_id=agent_id,
-                    agent_version=agent_version,
-                    configuration=configuration,
-                    task_id=task_id,
-                )
-
                 if self.fn is None:
                     raise RuntimeError(
                         f"No local function provided for this tool ({self.id})."
                     )
 
                 result = await invoke_local_fn(fn=self.fn, payload=payload)
+                
+                await self.agraph_preflight_check(
+                    agent_id=agent_id,
+                    agent_version=agent_version,
+                    configuration=configuration,
+                    task_id=task_id,
+                    payload={"input": payload, "output": result.model_dump() if isinstance(result, BaseModel) else result}
+                )
+                
                 tool_invocation_result.result = result
                 tool_invocation_result.is_success = True
-                return tool_invocation_result
-
-            tool_invocation_result.result = await self.acall_remote_tool(
-                agent_id=agent_id,
-                agent_version=agent_version,
+            else:
+                tool_invocation_result.result = await self.acall_remote_tool(
+                    agent_id=agent_id,
+                    agent_version=agent_version,
+                    payload=payload,
+                    payload_extension=payload_extension,
+                    configuration=configuration,
+                    task_id=task_id,
+                )
+                tool_invocation_result.is_success = True
+            
+            # Execute after hooks on success
+            await ToolHooksRegistry.execute_after_hooks(
+                tool=self,
                 payload=payload,
                 payload_extension=payload_extension,
-                configuration=configuration,
-                task_id=task_id,
+                tool_call_id=tool_call_id,
+                agent_version=agent_version,
+                result=tool_invocation_result.result
             )
-            tool_invocation_result.is_success = True
 
         except Exception as e:
             tool_invocation_result.is_error = True
@@ -421,6 +442,16 @@ class Tool(XPanderSharedModel):
             else:
                 tool_invocation_result.status_code = 500
                 tool_invocation_result.result = str(e)
+            
+            # Execute error hooks on failure
+            await ToolHooksRegistry.execute_error_hooks(
+                tool=self,
+                payload=payload,
+                payload_extension=payload_extension,
+                tool_call_id=tool_call_id,
+                agent_version=agent_version,
+                error=e
+            )
 
         return tool_invocation_result
 

xpander_sdk/modules/tools_repository/utils/generic.py

@@ -38,6 +38,9 @@ def json_type_to_python(json_type: str, prop_schema: dict = None):
         item_type = json_type_to_python(items.get("type"), items)
         return List[item_type]
     
+    if isinstance(json_type, list) and len(json_type) > 1:
+        json_type = next((t for t in json_type if t != "null"), None)
+    
     return {
         "string": str,
         "integer": int,

xpander_sdk/utils/agents/compactization_agent.py

@@ -0,0 +1,257 @@
+from typing import TYPE_CHECKING, List, Union
+from agno.agent import Agent as AgnoAgent
+from loguru import logger
+import json
+from xpander_sdk.models.compactization import TaskCompactizationEvent, TaskCompactizationOutput, TaskCompactizationInput, TaskCompactizationRetryEvent
+from xpander_sdk.models.deep_planning import DeepPlanningItem
+from xpander_sdk.models.events import TaskUpdateEventType
+from xpander_sdk.models.frameworks import Framework
+from xpander_sdk.models.shared import Tokens
+from xpander_sdk.modules.agents.agents_module import Agents
+from xpander_sdk.modules.backend.backend_module import Backend
+from xpander_sdk.modules.backend.utils.mcp_oauth import push_event
+from xpander_sdk.modules.tasks.sub_modules.task import TaskUpdateEvent
+from xpander_sdk.utils.event_loop import run_sync
+
+if TYPE_CHECKING:
+    from xpander_sdk.modules.tasks.sub_modules.task import Task
+
+def run_task_compactization(message: str, task: "Task", uncompleted_tasks: List[DeepPlanningItem]) -> Union[str, TaskCompactizationOutput]:
+    try:
+        
+        # report retry event
+        try:
+            run_sync(
+                push_event(
+                    task=task,
+                    event=TaskCompactizationEvent(type="retry", data=TaskCompactizationRetryEvent(is_retry=True)),
+                    event_type=TaskUpdateEventType.TaskCompactization
+                )
+            )
+        except Exception as e:
+            pass
+        
+        # get agent to identify framework
+        agent = Agents(configuration=task.configuration).get(agent_id=task.agent_id,version=task.agent_version)
+        
+        # non agno, let the same agent handle it
+        if agent.framework != Framework.Agno:
+            return "\n".join([
+                "Task not finished, uncompleted tasks detected:",
+                f"Uncompleted tasks: {[task.model_dump_json() for task in uncompleted_tasks]}",
+                "You must complete tasks if fulfilled",
+                f"User's original request: \"{message}\""
+            ])
+        
+        # load backend args for consistency of model provider and settings
+        agno_args = Backend(configuration=agent.configuration).get_args(agent_id=agent.id, agent_version=agent.version, task=task)
+        
+        if agent.model_provider == "openai":
+            agno_args["model"].id = "gpt-5-mini"
+        
+        # create compacitzation agent
+        compactization_agent = AgnoAgent(
+            output_schema=TaskCompactizationOutput,
+            name="Task Compactization Agent",
+            model=agno_args.get("model"),
+            description="""
+                You are a system component that handles early/unapproved agent task exits.
+                
+                When an agent stops execution with uncompleted tasks, you analyze the state and generate a continuation prompt
+                that will be sent DIRECTLY to that agent to resume its work.
+                
+                Your output becomes the agent's next input - it must guide the agent to:
+                1. Continue from where it stopped (seamlessly, no restart)
+                2. Complete ALL remaining uncompleted tasks
+                3. Use correct tools (especially xpask_for_information for questions)
+                4. NOT expose internal orchestration (xp* tools, task IDs) to the user
+                
+                You are a bridge between system orchestration and agent execution.
+            """,
+            role="""
+                You are the **Compactization Agent** - a system component for handling early agent exits.
+                
+                **The Flow:**
+                1. Agent A (e.g., researcher) starts task and creates plan
+                2. Agent A executes but stops/exits early with uncompleted tasks
+                3. System detects uncompleted tasks and triggers YOU
+                4. You analyze Agent A's execution state and generate continuation guidance
+                5. Your output goes DIRECTLY to Agent A as its next prompt
+                6. Agent A resumes and completes remaining work
+                
+                **Your Mission:**
+                Generate a prompt that Agent A will receive to continue its work. This prompt must:
+                - Guide Agent A on what's been done and what remains
+                - Correct any protocol violations (e.g., asking questions without tool)
+                - Instruct Agent A to NOT expose internal xp* tools to the user
+                - Make Agent A's continuation feel seamless to the user
+                
+                You are NOT talking to the user. You are talking to Agent A.
+            """,
+            instructions="""
+            ## Your Role: Agent-to-Agent Handoff
+            
+            You are writing a message that will be sent TO the agent (Agent A) to continue its task.
+            
+            **Key Understanding:**
+            - Your `new_task_prompt` = The message Agent A will receive
+            - Agent A will see this message and continue working
+            - The user will see Agent A's response, not your message directly
+            - You must guide Agent A to work seamlessly without exposing internals
+            
+            ## Core Principles
+            
+            * **You are guiding Agent A**, not the user
+            * **Agent A must complete ALL uncompleted tasks** - tell it what remains
+            * **Stay factual** - Use "Unknown" for missing info
+            * **Preserve exact state** - Keep IDs, names, paths, outputs unchanged in context
+            * **Correct violations** - If Agent A asked questions without tool, tell it to use the tool
+            * **Hide orchestration** - Instruct Agent A to NOT mention xp* tools, task IDs, or internals to user
+            
+            ## What You Must Capture
+            
+            * **Tool call history.** For each tool: name/id, purpose, inputs (high-level), outputs (high-level), errors. Include plan tools (xpcreate_agent_plan, xpcomplete_agent_plan_item, etc.).
+            * **Artifacts and state.** All created files, IDs, URLs, variables, decisions, and configurations.
+            * **What worked / what didn't.** Successes, failures, blockers, missing info, wrong assumptions.
+            * **Task completion status.** For each uncompleted task: exact ID, title, and specific reason it's incomplete.
+            * **PROTOCOL VIOLATIONS.** Check if agent asked questions in response text AFTER calling xpstart_execution_plan (violates protocol).
+            
+            ## Detecting Protocol Violations
+            
+            If the agent's last message contains questions to the user AFTER the plan was started (after xpstart_execution_plan was called):
+            - This is a PROTOCOL VIOLATION
+            - The agent should have used xpask_for_information tool instead
+            
+            When violation is detected, you MUST make it SUPER CLEAR in BOTH output fields:
+            
+            **In `new_task_prompt`:**
+            - START with: "CRITICAL PROTOCOL VIOLATION DETECTED: You asked questions directly after starting the plan."
+            - Explicitly state: "You MUST use xpask_for_information tool to ask questions once plan is running."
+            - Include: "NEVER write questions in your response text after calling xpstart_execution_plan."
+            - Then provide the continuation instructions
+            
+            **In `task_context`:**
+            - Add a dedicated section at the TOP before section 1: "**PROTOCOL VIOLATION DETECTED**"
+            - State clearly: "Agent asked questions in response text after calling xpstart_execution_plan. This violates execution protocol."
+            - Remind: "Rule: After xpstart_execution_plan is called, questions MUST be asked using xpask_for_information tool, NOT written in response text."
+            
+            Signs of protocol violation in messages:
+            - Phrases like "Before I proceed", "I need clarification", "Please choose", "Which option"
+            - Questions written in response text after xpstart_execution_plan was called
+            
+            ## Continuation Prompt: Your Message TO Agent A
+            
+            Your `new_task_prompt` is what Agent A will read. Structure it as guidance TO the agent:
+            
+            1. **IF protocol violation:** "You asked questions without using xpask_for_information tool. Use the tool for questions."
+            2. **Orient Agent A:** "You were working on [task]. You've completed [X, Y, Z]."
+            3. **State what remains:** "You still need to complete: [list remaining work in plain language]."
+            4. **Guide next steps:** "Continue by: [step-by-step what to do next]."
+            5. **Hide internals instruction:** "Important: Do NOT mention xp* tools, task IDs, or internal workflow to the user. Present your work naturally."
+            6. **Enforce protocol:** "Mark each task complete immediately after finishing using xpcomplete_agent_plan_item."
+            7. **Natural tone:** "Continue your response to the user seamlessly, as if you never stopped."
+            
+            You are INSTRUCTING Agent A on how to continue, not writing the user-facing response yourself.
+            
+            ## Task Context Requirements
+            
+            Your `task_context` must:
+            1. **IF protocol violation detected:** Add "PROTOCOL VIOLATION DETECTED" section at the TOP before section 1
+            2. Follow the exact 9-heading structure specified in the output schema (or 10 if violation detected)
+            3. Be deterministic and parseable by downstream systems
+            4. Focus on actionable continuation steps in section 9 (NEXT ACTIONS)
+            5. Include task IDs for all uncompleted tasks
+            6. Emphasize that ALL tasks must be completed and marked complete
+            
+            ## Critical Rules
+            
+            ❌ **NEVER:**
+            - Suggest restarting or creating a new plan
+            - Mark tasks as complete that aren't actually done
+            - Invent details or speculate
+            - Write a "fresh start" prompt
+            
+            ✅ **ALWAYS:**
+            - Write as instructions TO Agent A (you're guiding it, not doing its work)
+            - Tell Agent A what it's done and what remains
+            - Instruct Agent A to complete remaining tasks
+            - Tell Agent A to use correct tools (xpask_for_information for questions)
+            - Instruct Agent A to hide xp* tools and internals from user
+            - Include technical details (task IDs, tool names) in task_context for Agent A's reference
+            - Correct any protocol violations Agent A made
+            """,
+            expected_output="""
+            Return a JSON object with exactly these two fields:
+
+            - new_task_prompt (string): Instructions TO Agent A for continuing its task.
+              
+              This message will be sent directly to Agent A. Write it as guidance:
+              
+              IF PROTOCOL VIOLATION:
+                "You asked questions without using xpask_for_information tool. Use the tool for questions after plan starts."
+              
+              Then:
+              "You were working on [task name]. You've completed [work done in plain language].
+              
+              You still need to complete: [list remaining uncompleted work naturally].
+              
+              Continue by: [specific steps for Agent A to take].
+              
+              IMPORTANT: When responding to the user, do NOT mention xp* tools, task IDs, or internal workflow.
+              Present your work naturally as if execution never stopped. The user should not see any interruption.
+              
+              Mark each task complete immediately after finishing using xpcomplete_agent_plan_item."
+
+            - task_context (string): Comprehensive context for continuation.
+              IF PROTOCOL VIOLATION DETECTED:
+                - Add section at TOP: "**PROTOCOL VIOLATION DETECTED**\nAgent asked questions in response text after calling xpstart_execution_plan. This violates execution protocol. Rule: After xpstart_execution_plan is called, questions MUST be asked using xpask_for_information tool, NOT written in response text.\n\n"
+              Then follow the EXACT 9-section structure defined in TaskCompactizationOutput.task_context.
+              Must be deterministic, actionable, and focused on completing ALL remaining tasks and marking them as completed.
+
+            Important:
+            - Do NOT invent details; write 'Unknown' when information is missing.
+            - Preserve exact IDs, names, file paths, numbers, and user phrasing.
+            - Final actions must include marking each remaining task as completed with the plan tools.
+            - IF protocol violation: Make it SUPER CLEAR in both fields that tool must be used for questions.
+            """
+        )
+        
+        session = agent.get_session(session_id=task.id)
+        
+        # run compactization
+        run_result = compactization_agent.run(
+            input=TaskCompactizationInput(
+                user_input=task.input,
+                agent_instructions=agent.instructions,
+                task_context_and_messages=json.dumps({"messages": [message.model_dump() for message in session.get_messages() if message.role != "system"]}),
+                uncompleted_tasks=uncompleted_tasks
+            )
+        )
+        
+        # reset old session
+        agent.delete_session(session_id=task.id)
+        
+        # report LLM Metrics
+        task.tokens = Tokens(
+            completion_tokens=run_result.metrics.output_tokens,
+            prompt_tokens=run_result.metrics.input_tokens
+        )
+        
+        task.report_metrics(configuration=task.configuration)
+        
+        # report compactization event
+        try:
+            run_sync(
+                push_event(
+                    task=task,
+                    event=TaskCompactizationEvent(type="summarization", data=run_result.content),
+                    event_type=TaskUpdateEventType.TaskCompactization
+                )
+            )
+        except Exception as e:
+            pass
+        
+        return run_result.content
+    except Exception as e:
+        logger.warning(f"Failed to run task compactization - {str(e)}")
+        return message

xpander_sdk/utils/generic.py

@@ -0,0 +1,5 @@
+from datetime import datetime, timezone
+
+
+def get_current_timestamp() -> str:
+    return datetime.now(timezone.utc).isoformat()

{xpander_sdk-2.0.161.dist-info → xpander_sdk-2.0.192.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: xpander-sdk
-Version: 2.0.161
+Version: 2.0.192
 Summary: xpander.ai Backend-as-a-service for AI Agents - SDK
 Home-page: https://www.xpander.ai
 Author: xpanderAI
@@ -11,15 +11,16 @@ Classifier: Operating System :: OS Independent
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: python-dotenv
-Requires-Dist: packaging
-Requires-Dist: pydantic
-Requires-Dist: loguru
-Requires-Dist: httpx
-Requires-Dist: httpx_sse
-Requires-Dist: nest-asyncio
-Requires-Dist: strands-agents
-Requires-Dist: openai-agents
+Requires-Dist: python-dotenv>=1.2.1
+Requires-Dist: packaging>=25.0
+Requires-Dist: pydantic>=2.12.5
+Requires-Dist: loguru>=0.7.3
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: httpx_sse>=0.4.3
+Requires-Dist: nest-asyncio>=1.6.0
+Requires-Dist: strands-agents>=1.20.0
+Requires-Dist: openai-agents>=0.6.4
+Requires-Dist: python-toon>=0.1.3
 Provides-Extra: agno
 Requires-Dist: agno; extra == "agno"
 Requires-Dist: sqlalchemy; extra == "agno"
@@ -47,7 +48,7 @@ Dynamic: requires-dist
 Dynamic: requires-python
 Dynamic: summary
 
-# xpander.ai SDK
+# xpander.ai SDK 
 
 [![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![Documentation](https://img.shields.io/badge/docs-available-brightgreen.svg)](https://docs.xpander.ai) [![PyPI Version](https://img.shields.io/pypi/v/xpander-sdk?label=PyPI)](https://pypi.org/project/xpander-sdk/) [![Downloads](https://pepy.tech/badge/xpander-sdk)](https://pepy.tech/project/xpander-sdk)
 
@@ -292,6 +293,89 @@ async for event in task.aevents():
     print(f"Event Data: {event.data}")
 ```
 
+### Authentication Events Callback
+
+Handle authentication events in real-time. This callback is triggered only for authentication flows (e.g., MCP OAuth requiring user login).
+
+**You can use both approaches simultaneously** - decorated handlers will always be invoked, and you can also pass an explicit callback for additional handling.
+
+You can provide the callback in two ways:
+
+#### Option 1: Direct Function
+
+```python
+from xpander_sdk import Backend
+from xpander_sdk.modules.agents.sub_modules.agent import Agent
+from xpander_sdk.modules.tasks.sub_modules.task import Task, TaskUpdateEvent
+from agno.agent import Agent as AgnoAgent
+
+# Define event callback (async or sync)
+async def my_event_callback(agent: Agent, task: Task, event: TaskUpdateEvent):
+    """Called for authentication events only"""
+    # event.type will always be "auth_event"
+    print(f"Authentication required: {event.data}")
+    # Display login URL or handle OAuth flow
+
+# Get args with callback
+backend = Backend(configuration=config)
+args = await backend.aget_args(
+    agent_id="agent-123",
+    task=my_task,
+    auth_events_callback=my_event_callback
+)
+```
+
+#### Option 2: Decorator (Auto-registered)
+
+```python
+from xpander_sdk import Backend, on_auth_event
+from xpander_sdk.modules.agents.sub_modules.agent import Agent
+from xpander_sdk.modules.tasks.sub_modules.task import Task, TaskUpdateEvent
+from agno.agent import Agent as AgnoAgent
+
+# Use decorator - auto-registers globally
+@on_auth_event
+async def handle_auth(agent: Agent, task: Task, event: TaskUpdateEvent):
+    # event.type will always be "auth_event"
+    print(f"Authentication required for {agent.name}")
+    print(f"Auth data: {event.data}")
+
+# Decorated handler is automatically invoked - no need to pass it
+backend = Backend(configuration=config)
+args = await backend.aget_args(
+    agent_id="agent-123",
+    task=my_task
+)
+```
+
+#### Option 3: Combine Both
+
+```python
+from xpander_sdk import Backend, on_auth_event
+
+# Global handler for all auth events
+@on_auth_event
+async def log_auth(agent, task, event):
+    print(f"[GLOBAL] Auth event for {agent.name}")
+
+# Additional one-time handler
+async def custom_handler(agent, task, event):
+    print(f"[CUSTOM] Specific handling for this call")
+
+# Both handlers will be invoked
+args = await backend.aget_args(
+    agent_id="agent-123",
+    auth_events_callback=custom_handler  # Optional additional callback
+)
+
+# Use with Agno
+agno_agent = AgnoAgent(**args)
+result = await agno_agent.arun(
+    input="Process this data",
+    stream=True
+)
+```
+
 ### Task Activity Monitoring
 
 ```python
@@ -483,11 +567,11 @@ async def main():
         organization_id="your-org-id",
         base_url="https://agent-controller.my-company.com"
     )
-    
+
     # Load agent from self-hosted deployment
     agent = await Agent.aload("agent-123", configuration=config)
     print(f"Agent: {agent.name}")
-    
+
     # Create and execute task
     task = await agent.acreate_task(
         prompt="Analyze Q4 sales data",

{xpander_sdk-2.0.161.dist-info → xpander_sdk-2.0.192.dist-info}/RECORD

@@ -1,6 +1,6 @@
-xpander_sdk/__init__.py,sha256=subqRII3DHqi4FYdWS11fuliCXiOttOrd57m6zTW7pY,2671
+xpander_sdk/__init__.py,sha256=34l3YcvIdkj81DTfMp_bgZgXpj2U1lTKpHQ0shwnc_8,2927
 xpander_sdk/consts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-xpander_sdk/consts/api_routes.py,sha256=dKUruLanvprTxZO15fR4OWe6ck8JQ8y64XmUJxsbeJY,2278
+xpander_sdk/consts/api_routes.py,sha256=jRIxZqqufz14FOwE9gcFMURtm99vQ5g4uw6QLEAS6ks,2621
 xpander_sdk/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 xpander_sdk/core/module_base.py,sha256=YiUonUBXnXqa9wms5O8C9tEfQeWBJCIZg6xzEorV8gI,5480
 xpander_sdk/core/state.py,sha256=GKGJaMALpTGVV2-iPV3cPrQW4dNdFoZPv3oXBjHDhIY,214
@@ -9,36 +9,44 @@ xpander_sdk/exceptions/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3
 xpander_sdk/exceptions/module_exception.py,sha256=2Urni1QEdzOrCdYSRc5eLpuz8aDlvRcn8KNejo_2nGc,1687
 xpander_sdk/models/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 xpander_sdk/models/activity.py,sha256=I3CxOzUNbrKwHqynCbm7FJja6vanVkCzwwBwET7qvzA,2085
+xpander_sdk/models/compactization.py,sha256=I0tfDQZKaaKvWHIg1O07oJUPUrbwvr4Q0azDsx5OfAE,5596
 xpander_sdk/models/configuration.py,sha256=Un8p3C3p3eMiqKK5VsHaZdWhZTRYHbrw2aPUMV8lJSc,3370
 xpander_sdk/models/deep_planning.py,sha256=pCFV5iNSfT99ap1-09k7oO_DIwXx2vPJ3aVM472xL4w,554
-xpander_sdk/models/events.py,sha256=2vIkuPGAbntN_7xggJRw5sMJ1_EzcXyljxPH0ekISlw,2235
-xpander_sdk/models/frameworks.py,sha256=Ptf4aMjZ44L_x8WsCc5X0kjsJObv4dwgSM61no0aW6E,2937
+xpander_sdk/models/events.py,sha256=HnootQSUIIRM4BIdaTbuPUEJ55hLVtA7KDCSsnHeBKw,2313
+xpander_sdk/models/frameworks.py,sha256=-7W_m5cvgS1qLp0gGAFP4noNWT82IT1ZqtQv5WuOC2k,2939
+xpander_sdk/models/generic.py,sha256=yw5rBRdZ-6ucTI4AwtskenddepOooiFRM--9xx5jrL8,681
+xpander_sdk/models/notifications.py,sha256=3tK4Z2gmA6YxRtqsWgzjiVISgJyHvmjTooiRgzrj5zY,3373
+xpander_sdk/models/orchestrations.py,sha256=uMXkTZ_tdE10rbVUy8H8vxfh71HZGZcaJUEy61wwz2k,9898
 xpander_sdk/models/shared.py,sha256=gW88kA_UslNinUjtQKpLVF0sHDZnckwLWexRapxPivU,3125
 xpander_sdk/models/user.py,sha256=_FTG0JO6iTrbcvJp-BBJ6nuj281zhyQB5ldQkBCyYDU,749
 xpander_sdk/modules/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 xpander_sdk/modules/agents/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 xpander_sdk/modules/agents/agents_module.py,sha256=3EhKOIPb4c39GOrNt4zU4V6WbsGj7W_yWwRNSJBKmfc,6419
 xpander_sdk/modules/agents/models/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-xpander_sdk/modules/agents/models/agent.py,sha256=tJXNogRjvwlxzJPzesdHm-NBhMOzDnWImC0ndWhyjx4,14969
+xpander_sdk/modules/agents/models/agent.py,sha256=lHWz37a4_qB9Hq4sZhvjILjj566hJHZbDlj7JJ6iO68,15340
 xpander_sdk/modules/agents/models/agent_list.py,sha256=byEayS2uLwDKaVT3lAHltrFocQFKpr8XEwQ6NTEEEMo,4081
 xpander_sdk/modules/agents/models/knowledge_bases.py,sha256=YimpjVJxWe8YTbGMD6oGQOA_YV8ztHQHTTBOaBB44ZM,1037
 xpander_sdk/modules/agents/sub_modules/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-xpander_sdk/modules/agents/sub_modules/agent.py,sha256=HHVz00hrRCFZV9uj8Q5TvZHO_ObijMwQw5Gqdwa_nDY,36298
+xpander_sdk/modules/agents/sub_modules/agent.py,sha256=O3y2qKAFb19yO7gt2Ey6BNJGwA9cMHMuKG4_iNjqKL0,36841
 xpander_sdk/modules/agents/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 xpander_sdk/modules/agents/utils/generic.py,sha256=XbG4OeHMQo4gVYCsasMlW_b8OoqS1xL3MlUZSjXivu0,81
-xpander_sdk/modules/backend/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-xpander_sdk/modules/backend/backend_module.py,sha256=wYghMuNXEtXgoyMXBgbMhgE7wYcbRwXJcpEyybF30kA,18927
+xpander_sdk/modules/backend/__init__.py,sha256=-NjikuZgHBhOM9xHML2vKsG0ICX9S2RKHktrWaODCBE,171
+xpander_sdk/modules/backend/backend_module.py,sha256=A8NW5QqVy28O-E5eL1VU2iUHgtxyz7rFN7Ih0Jnv-TE,21713
+xpander_sdk/modules/backend/events_registry.py,sha256=d0V-lsz3I3G1QB643EM1i-a5oJCiHnEfqBY_SmN2WrE,5983
+xpander_sdk/modules/backend/decorators/__init__.py,sha256=ub9c8G0Ll6AuCvfcFB6rqR8iamMJxtcW7QjWw3WSkPU,106
+xpander_sdk/modules/backend/decorators/on_auth_event.py,sha256=Xt_x9nncujMcF_SgM5hG6M-iZ6B-rDS97EPmgZkGdMk,4715
 xpander_sdk/modules/backend/frameworks/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-xpander_sdk/modules/backend/frameworks/agno.py,sha256=VDrNb2M2RaKDPjlmc-yQeXJZVDpTifF4zl2xaLXvDeg,32538
-xpander_sdk/modules/backend/frameworks/dispatch.py,sha256=5dP4c37C42U53VjM2kkwIRwEw1i0IN3G0YESHH7J3OE,1557
+xpander_sdk/modules/backend/frameworks/agno.py,sha256=djHGWFGaMOetKfD6XNKEYxYzBm8GwPlhuPFRkB8PFkg,41712
+xpander_sdk/modules/backend/frameworks/dispatch.py,sha256=ht9hT5-cHATofQbWsbWeTARx51Hne3TNNNjw6KECRtA,1814
 xpander_sdk/modules/backend/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-xpander_sdk/modules/backend/utils/mcp_oauth.py,sha256=a4xQGQwRGf2T9h38Vc9VNUwpIeY9y7Mn6B4D2G3tMQM,4387
+xpander_sdk/modules/backend/utils/mcp_oauth.py,sha256=5sYJcw557V3pSgutxUFzkBp5YxUJFUoB1V1rEe814pc,5430
 xpander_sdk/modules/events/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-xpander_sdk/modules/events/events_module.py,sha256=WJcSdmShGmEhd-Qw0R2fWp4OOlefjLs5_WsQlfJ-UrQ,25317
-xpander_sdk/modules/events/decorators/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+xpander_sdk/modules/events/events_module.py,sha256=tAjfc6kfjgmswQkgm-rcVs8wVpOYYPv03kqZHTVE8Uo,25737
+xpander_sdk/modules/events/decorators/__init__.py,sha256=8GhR9afoLiS83a0OMLpn7TN2W6iTnlcVqos6bM34nac,129
 xpander_sdk/modules/events/decorators/on_boot.py,sha256=VGtoQcgs3g5bmx3Ze4QB_-ZwBESATYYVR0oZe35eCww,3076
 xpander_sdk/modules/events/decorators/on_shutdown.py,sha256=rFgChspnLDnZm9FS1K636dvZSQDkeugf2e3M83SDgAY,3127
 xpander_sdk/modules/events/decorators/on_task.py,sha256=G3jk0xzi3pqH96Bbut_GMJKExIlyyMYk4PbKfc6koa4,8551
+xpander_sdk/modules/events/decorators/on_tool.py,sha256=ZacZ6tADjvl79ISqKxTSH1P0nZUS8C3mRwOL2SyLeZE,13750
 xpander_sdk/modules/events/models/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 xpander_sdk/modules/events/models/deployments.py,sha256=6uwxFsybrZ-eHeohJzkm2RtQq4Eo_0xjHk7QouvszxU,1335
 xpander_sdk/modules/events/models/events.py,sha256=T_89pq48e7fMIbJcCbtM9Ocb6YKXQP7pbF6VbECiGcI,1550
@@ -56,10 +64,10 @@ xpander_sdk/modules/knowledge_bases/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-
 xpander_sdk/modules/tasks/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 xpander_sdk/modules/tasks/tasks_module.py,sha256=wOMegfNQ4qoY7PEII5828SjWrP0Jocg2TRsFOaaCmW0,20444
 xpander_sdk/modules/tasks/models/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-xpander_sdk/modules/tasks/models/task.py,sha256=B0_fwzQEkRE_pZMSLnWuXsUBMdy8HEIxm1FfRpCQma0,5000
+xpander_sdk/modules/tasks/models/task.py,sha256=pYzXg0jnE6ft4pVFvxiVexO5eMUFkg1VxXybzFtL1ys,4483
 xpander_sdk/modules/tasks/models/tasks_list.py,sha256=8V1T0vCtGN79qLMPwe37pOA7Wvuf8pbJNOhWL0BPo-8,5126
 xpander_sdk/modules/tasks/sub_modules/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-xpander_sdk/modules/tasks/sub_modules/task.py,sha256=RlYe4XAhWeUGk2JwlRC__SWP7OFoym8fnCTluYrhHLg,36135
+xpander_sdk/modules/tasks/sub_modules/task.py,sha256=zRDHsE_LnYYa3OC79wVQqeRnpAogddHVI2R6-3IepJ4,37920
 xpander_sdk/modules/tasks/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 xpander_sdk/modules/tasks/utils/files.py,sha256=KqqwSQSrwim2-H3XP5wOadDDfngAyEI034tA7Oon-vc,3631
 xpander_sdk/modules/tools_repository/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -70,17 +78,20 @@ xpander_sdk/modules/tools_repository/models/__init__.py,sha256=47DEQpj8HBSa-_TIm
 xpander_sdk/modules/tools_repository/models/mcp.py,sha256=qGpaiXKiuXw6gAcK8CW6ek6FkZNbBxDXUf1PWF6Tenw,1863
 xpander_sdk/modules/tools_repository/models/tool_invocation_result.py,sha256=Dhowt_fv8v8xWv7xMRJxo6hA8DawXKbWIrsJFMpt5H4,447
 xpander_sdk/modules/tools_repository/sub_modules/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-xpander_sdk/modules/tools_repository/sub_modules/tool.py,sha256=YUf267PRXtctpPydpQTTnaO3aliSJwapM3WsdGG06Pw,22365
+xpander_sdk/modules/tools_repository/sub_modules/tool.py,sha256=rivnznxi6CrrOWE1rukkBRmad2H-rthhrelC7ei1IXM,23617
 xpander_sdk/modules/tools_repository/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-xpander_sdk/modules/tools_repository/utils/generic.py,sha256=m9FRaVGzRUj23tB52rP9K4O-nTsMSt9iwMxMcYsqfiY,1770
+xpander_sdk/modules/tools_repository/utils/generic.py,sha256=bQ31-RoAq12lpDoIWsgmqAt7NL5YdzW1j3WKqZtYb2A,1904
 xpander_sdk/modules/tools_repository/utils/local_tools.py,sha256=zp5P8hVnRUJQb-w-2jCEMV5eUB_awmvYfY_rin5qvEw,1875
 xpander_sdk/modules/tools_repository/utils/schemas.py,sha256=EUi35h7CRrOVXV-TH-lyCpOdK5pu1uODDxvGB1JGDXY,13734
 xpander_sdk/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 xpander_sdk/utils/env.py,sha256=U_zIhqWgKs5fk2-HXjAaODj4oWMc5dRQ0fvw6fqVcFk,1522
 xpander_sdk/utils/event_loop.py,sha256=kJrN0upgBhyI86tkTdfHeajznrIZl44Rl6WDiDG3GHE,2516
+xpander_sdk/utils/generic.py,sha256=XrRj2-L8c0YWpfPdDyXE-pVL-6lKF9VpyZzKHQ4wuCc,127
 xpander_sdk/utils/tools.py,sha256=lyFkq2yP7DxBkyXYVlnFRwDhQCvf0fZZMDm5fBycze4,1244
-xpander_sdk-2.0.161.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-xpander_sdk-2.0.161.dist-info/METADATA,sha256=I0vEmwVDjrE9TM2CKj1HTmCFU35l3Zm5nfhSWX_vMI4,15312
-xpander_sdk-2.0.161.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-xpander_sdk-2.0.161.dist-info/top_level.txt,sha256=UCjnxQpsMy5Zoe7lmRuVDO6DI2V_6PgRFfm4oizRbVs,12
-xpander_sdk-2.0.161.dist-info/RECORD,,
+xpander_sdk/utils/agents/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+xpander_sdk/utils/agents/compactization_agent.py,sha256=S_U1dSmDC7I0JUsp_THUYjfutEI5QMBaMPJEXGp0_Sw,14389
+xpander_sdk-2.0.192.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+xpander_sdk-2.0.192.dist-info/METADATA,sha256=NM6k5GsEGHR8qvT1GWi7H9s3C4R_5OvE-Pwm1eWnh0g,17945
+xpander_sdk-2.0.192.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+xpander_sdk-2.0.192.dist-info/top_level.txt,sha256=UCjnxQpsMy5Zoe7lmRuVDO6DI2V_6PgRFfm4oizRbVs,12
+xpander_sdk-2.0.192.dist-info/RECORD,,