xpander-sdk 2.0.108__tar.gz → 2.0.145__tar.gz

{xpander_sdk-2.0.108 → xpander_sdk-2.0.145}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: xpander-sdk
-Version: 2.0.108
+Version: 2.0.145
 Summary: xpander.ai Backend-as-a-service for AI Agents - SDK
 Home-page: https://www.xpander.ai
 Author: xpanderAI
@@ -18,6 +18,8 @@ Requires-Dist: loguru
 Requires-Dist: httpx
 Requires-Dist: httpx_sse
 Requires-Dist: nest-asyncio
+Requires-Dist: strands-agents
+Requires-Dist: openai-agents
 Provides-Extra: agno
 Requires-Dist: agno; extra == "agno"
 Requires-Dist: sqlalchemy; extra == "agno"
@@ -31,6 +33,8 @@ Requires-Dist: anthropic; extra == "dev"
 Requires-Dist: mcp; extra == "dev"
 Requires-Dist: openai; extra == "dev"
 Requires-Dist: fireworks-ai; extra == "dev"
+Requires-Dist: aioboto3; extra == "dev"
+Requires-Dist: google-genai; extra == "dev"
 Dynamic: author
 Dynamic: author-email
 Dynamic: classifier
@@ -47,7 +51,6 @@ Dynamic: summary
 
 [![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)
 
-
 The official Python SDK for xpander.ai - a powerful Backend-as-a-Service (BaaS) platform for building, deploying, and managing AI agents at scale.
 
 ## 🚀 Overview
@@ -304,7 +307,7 @@ async def handle_test_task(task):
     task.result = {
         "capabilities": [
             "Data analysis",
-            "Text processing", 
+            "Text processing",
             "API integration"
         ]
     }
@@ -402,7 +405,7 @@ This project is licensed under the MIT License - see the LICENSE file for detail
 
 - **Documentation**: [https://docs.xpander.ai](https://docs.xpander.ai)
 - **Issues**: [GitHub Issues](https://github.com/xpander-ai/xpander-sdk/issues)
-- **Email**: dev@xpander.ai
+- **Email**: support@xpander.ai
 
 ---
 

{xpander_sdk-2.0.108 → xpander_sdk-2.0.145}/README.md

@@ -2,7 +2,6 @@
 
 [![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)
 
-
 The official Python SDK for xpander.ai - a powerful Backend-as-a-Service (BaaS) platform for building, deploying, and managing AI agents at scale.
 
 ## 🚀 Overview
@@ -259,7 +258,7 @@ async def handle_test_task(task):
     task.result = {
         "capabilities": [
             "Data analysis",
-            "Text processing", 
+            "Text processing",
             "API integration"
         ]
     }
@@ -357,7 +356,7 @@ This project is licensed under the MIT License - see the LICENSE file for detail
 
 - **Documentation**: [https://docs.xpander.ai](https://docs.xpander.ai)
 - **Issues**: [GitHub Issues](https://github.com/xpander-ai/xpander-sdk/issues)
-- **Email**: dev@xpander.ai
+- **Email**: support@xpander.ai
 
 ---
 

{xpander_sdk-2.0.108 → xpander_sdk-2.0.145}/setup.py

@@ -5,7 +5,7 @@ with open("README.md", "r", encoding="utf-8") as fh:
 
 setup(
     name="xpander-sdk",
-    version="2.0.108",
+    version="2.0.145",
     author="xpanderAI",
     author_email="dev@xpander.ai",
     description="xpander.ai Backend-as-a-service for AI Agents - SDK",
@@ -22,10 +22,12 @@ setup(
         "httpx",
         "httpx_sse",
         "nest-asyncio",
+        "strands-agents",
+        "openai-agents",
     ],
     extras_require={
         "agno": ["agno", "sqlalchemy" ,"psycopg[binary,pool]", "greenlet"],
-        "dev": ["black", "pre-commit", "pytest", "anthropic", "mcp", "openai", "fireworks-ai"],
+        "dev": ["black", "pre-commit", "pytest", "anthropic", "mcp", "openai", "fireworks-ai", "aioboto3", "google-genai"],
     },
     classifiers=[
         "Programming Language :: Python :: 3",

{xpander_sdk-2.0.108 → xpander_sdk-2.0.145}/src/xpander_sdk/consts/api_routes.py

@@ -39,6 +39,7 @@ and deleting resources.
     UpdateTask = "/agent-execution/{task_id}/update"
     ReportExternalTask = "/agent-execution/{agent_id}/report_task"
     ReportExecutionMetrics = "/agents-metrics/{agent_id}/execution"
+    PushExecutionEventToQueue = "/agent-execution/{task_id}/events/push"
     
     # Knowledge Bases Endpoints
     ListKnowledgeBases = "/knowledge_bases"
@@ -48,6 +49,9 @@ and deleting resources.
     KnowledgeBaseDocumentsCrud = "/knowledge_bases/{knowledge_base_id}"
     GetKnowledgeBaseDetails = "/knowledge_bases/{knowledge_base_id}/details"
     
+    # MCP Auth
+    GetUserMCPAuthToken = "/mcp_auth/{agent_id}/{user_id}/get_token"
+    
     # Tools
     GetOrInvokeToolById = "/tools/{tool_id}"
 

{xpander_sdk-2.0.108 → xpander_sdk-2.0.145}/src/xpander_sdk/core/xpander_api_client.py

@@ -8,6 +8,7 @@ requests to the xpander.ai Backend-as-a-Service platform.
 from abc import ABC
 from typing import Optional, Any, Literal, Dict
 import httpx
+from pydantic import BaseModel
 
 from xpander_sdk.models.configuration import Configuration
 
@@ -67,6 +68,7 @@ class APIClient(ABC):
         query: Optional[Dict[str, Any]] = None,
         headers: Optional[Dict[str, Any]] = None,
         configuration: Optional[Configuration] = None,
+        model: Optional[BaseModel] = None,
     ) -> Any:
         """
         Make an authenticated HTTP request to the xpander.ai API.
@@ -78,6 +80,7 @@ class APIClient(ABC):
             query (Optional[Dict[str, Any]]): Query string parameters.
             headers (Optional[Dict[str, Any]]): Extra headers.
             configuration (Optional[Configuration]): Overrides self.configuration.
+            model (Optional[BaseModel]): pydantic model to use when constructing the result.
         
         Returns:
             Any: Parsed response body (JSON or text).
@@ -110,7 +113,7 @@ class APIClient(ABC):
             content_type = response.headers.get("Content-Type", "")
             if "application/json" in content_type:
                 try:
-                    return response.json()
+                    return response.json() if not model else model(**response.json())
                 except Exception:
                     return response.text
             return response.text

{xpander_sdk-2.0.108 → xpander_sdk-2.0.145}/src/xpander_sdk/models/configuration.py

@@ -47,6 +47,11 @@ class Configuration(BaseModel):
         description="Base URL for xpander.ai API endpoints"
     )
     
+    agent_id: Optional[str] = Field(
+        default= None, 
+        description="Agent ID To work on"
+    )
+    
     organization_id: Optional[str] = Field(
         default_factory=lambda: getenv(key="XPANDER_ORGANIZATION_ID"),
         description="Organization identifier for xpander.ai account",

{xpander_sdk-2.0.108 → xpander_sdk-2.0.145}/src/xpander_sdk/models/events.py

@@ -54,6 +54,9 @@ class TaskUpdateEventType(str, Enum):
     
     # streaming
     Chunk = "chunk"
+    
+    # MCP Auth
+    AuthEvent = "auth_event"
 
     # tool calls
     ToolCallRequest = "tool_call_request"

{xpander_sdk-2.0.108 → xpander_sdk-2.0.145}/src/xpander_sdk/models/frameworks.py

@@ -12,7 +12,15 @@ class Framework(str, Enum):
     """
 
     Agno = "agno"
+    GoogleADK = "google-adk"
+    LangChain = "langchain"
+    OpenAIAgents = "open-ai-agents"
+    Strands = "strands-agents"
 
+class AgnoToolCallsCompressionSettings(BaseModel):
+    enabled: Optional[bool] = False
+    threshold: Optional[int] = 3
+    instructions: Optional[str] = ""
 
 class AgnoSettings(BaseModel):
     """
@@ -34,7 +42,13 @@ class AgnoSettings(BaseModel):
     """
 
     session_storage: Optional[bool] = True
-    user_memories: Optional[bool] = True
+    
+    user_memories: Optional[bool] = False
+    agentic_memory: Optional[bool] = False
+    
+    agent_memories: Optional[bool] = False
+    agentic_culture: Optional[bool] = False
+    
     session_summaries: Optional[bool] = False
     num_history_runs: Optional[int] = 3
     max_tool_calls_from_history: Optional[int] = 0
@@ -46,3 +60,5 @@ class AgnoSettings(BaseModel):
     openai_moderation_enabled: Optional[bool] = False
     openai_moderation_categories: Optional[List[str]] = None
     reasoning_tools_enabled: Optional[bool] = False
+    
+    tool_calls_compression: Optional[AgnoToolCallsCompressionSettings] = None

{xpander_sdk-2.0.108 → xpander_sdk-2.0.145}/src/xpander_sdk/models/shared.py

@@ -96,3 +96,7 @@ class Tokens(BaseModel):
 class ExecutionTokens(BaseModel):
     inner: Optional[Tokens] = Tokens()
     worker: Optional[Tokens] = Tokens()
+
+class ThinkMode(str, Enum):
+    Default = "default"
+    Harder = "harder"

{xpander_sdk-2.0.108 → xpander_sdk-2.0.145}/src/xpander_sdk/modules/agents/agents_module.py

@@ -6,7 +6,7 @@ within the xpander.ai Backend-as-a-Service platform.
 """
 
 from typing import List, Optional
-
+from os import getenv
 from httpx import HTTPStatusError
 
 from xpander_sdk.consts.api_routes import APIRoute
@@ -99,7 +99,7 @@ class Agents(ModuleBase):
         """
         return run_sync(self.alist())
 
-    async def aget(self, agent_id: str, version: Optional[int] = None) -> Agent:
+    async def aget(self, agent_id: Optional[str] = None, version: Optional[int] = None) -> Agent:
         """
         Asynchronously retrieve a specific agent by ID.
         
@@ -108,7 +108,7 @@ class Agents(ModuleBase):
         a specific version of the agent.
         
         Args:
-            agent_id (str): Unique identifier of the agent to retrieve.
+            agent_id (Optional[str]): Unique identifier of the agent to retrieve, Fallback to XPANDER_AGENT_ID.
             version (Optional[int]): Specific version number to load. If None,
                 loads the latest version.
                 
@@ -127,9 +127,12 @@ class Agents(ModuleBase):
             >>> # Load specific version
             >>> agent_v2 = await agents.aget("agent-123", version=2)
         """
-        return await Agent.aload(agent_id=agent_id, configuration=self.configuration, version=version)
+        return await Agent.aload(
+            agent_id=agent_id or self.configuration.agent_id or getenv("XPANDER_AGENT_ID"),
+            configuration=self.configuration, version=version
+        )
 
-    def get(self, agent_id: str, version: Optional[int] = None) -> Agent:
+    def get(self, agent_id: Optional[str] = None, version: Optional[int] = None) -> Agent:
         """
         Synchronously retrieve a specific agent by ID.
         
@@ -137,7 +140,7 @@ class Agents(ModuleBase):
         asynchronous method and waits for completion.
         
         Args:
-            agent_id (str): Unique identifier of the agent to retrieve.
+            agent_id (Optional[str]): Unique identifier of the agent to retrieve, Fallback to XPANDER_AGENT_ID.
             version (Optional[int]): Specific version number to load. If None,
                 loads the latest version.
                 
@@ -153,4 +156,9 @@ class Agents(ModuleBase):
             >>> agent = agents.get("agent-123")
             >>> result = agent.execute("What is the weather today?")
         """
-        return run_sync(self.aget(agent_id=agent_id, version=version))
+        return run_sync(
+            self.aget(
+            agent_id=agent_id,
+            version=version
+            )
+        )

{xpander_sdk-2.0.108 → xpander_sdk-2.0.145}/src/xpander_sdk/modules/agents/models/agent.py

@@ -72,7 +72,7 @@ class AgentInstructions(BaseModel):
     
     @computed_field
     @property
-    def instructions(self) -> List[str]:
+    def instructions(self) -> str:
         """
         Get the role-specific instructions for the agent.
         
@@ -87,6 +87,27 @@ class AgentInstructions(BaseModel):
             {self.goal_str}
         </goals>
         """
+    
+    @computed_field
+    @property
+    def full(self) -> str:
+        """
+        Get the role-specific instructions for the agent.
+        
+        Returns:
+            List[str]: List of role instructions.
+        """
+        return f"""
+        <description>
+            {self.description}
+        </description>
+        <instructions>
+            {self.role}
+        </instructions>
+        <goals>
+            {self.goal_str}
+        </goals>
+        """
 
     @computed_field
     @property
@@ -363,6 +384,30 @@ class AgentGraphItem(BaseModel):
     is_first: Optional[bool] = False
 
 
+
+class AIAgentConnectivityDetailsA2AAuthType(str, Enum):
+    NoAuth = "none"
+    ApiKey = "api_key"
+    Basic = "basic"
+    Bearer = "bearer"
+
+class AIAgentConnectivityDetailsBase(XPanderSharedModel):
+    custom_headers: Optional[Dict[str, str]] = {}
+    auth_type: Optional[AIAgentConnectivityDetailsA2AAuthType] = AIAgentConnectivityDetailsA2AAuthType.NoAuth
+    api_key_header_name: Optional[str] = "X-API-Key"
+    auth_value: Optional[str] = None
+
+class AIAgentConnectivityDetailsA2A(AIAgentConnectivityDetailsBase):
+    agent_url: str
+
+class AIAgentConnectivityDetailsCurl(AIAgentConnectivityDetailsBase):
+    curl_command: str
+    invoke_url: Optional[str] = None # post analysis (auto populate by llm)
+    method: Optional[str] = "POST" # post analysis (auto populate by llm)
+    prompt_field_name: Optional[str] = "" # post analysis (auto populate by llm) - CAN BE SET BY THE USER
+    files_field_name: Optional[str] = "" # post analysis (auto populate by llm) - CAN BE SET BY THE USER
+    task_id_field_name: Optional[str] = "" # post analysis (auto populate by llm) - CAN BE SET BY THE USER
+
 class AgentType(str, Enum):
     """
     Enumeration of agent types.
@@ -370,10 +415,14 @@ class AgentType(str, Enum):
     Values:
         Manager: Agent that manages and coordinates other agents.
         Regular: Standard agent for individual task execution.
+        A2A: Agent that is used via A2A protocol.
+        Curl: Custom Agent that is used via curl.
     """
 
     Manager = "manager"
     Regular = "regular"
+    A2A = "a2a"
+    Curl = "curl"
 
 
 @dataclass

{xpander_sdk-2.0.108 → xpander_sdk-2.0.145}/src/xpander_sdk/modules/agents/sub_modules/agent.py

@@ -8,11 +8,12 @@ agents in the xpander.ai Backend-as-a-Service platform.
 import asyncio
 from datetime import datetime
 import heapq
-from typing import Any, Callable, Dict, List, Optional, Type, TypeVar
+import re
+from typing import Any, Callable, Dict, List, Optional, Type, TypeVar, Union
 from httpx import HTTPStatusError
 from loguru import logger
 from pydantic import ConfigDict, computed_field
-
+from strands import tool as strands_tool
 from xpander_sdk.consts.api_routes import APIRoute
 from xpander_sdk.core.xpander_api_client import APIClient
 from xpander_sdk.exceptions.module_exception import ModuleException
@@ -23,9 +24,11 @@ from xpander_sdk.modules.knowledge_bases.models.knowledge_bases import (
     KnowledgeBaseSearchResult,
 )
 from xpander_sdk.modules.tools_repository.models.mcp import MCPServerDetails
-from xpander_sdk.models.shared import LLMModelT, OutputFormat, XPanderSharedModel
+from xpander_sdk.models.shared import LLMModelT, OutputFormat, ThinkMode, XPanderSharedModel
 from xpander_sdk.models.user import User
 from xpander_sdk.modules.agents.models.agent import (
+    AIAgentConnectivityDetailsA2A,
+    AIAgentConnectivityDetailsCurl,
     AgentAccessScope,
     AgentDeploymentType,
     AgentGraphItem,
@@ -50,6 +53,7 @@ from xpander_sdk.modules.tools_repository.sub_modules.tool import Tool
 from xpander_sdk.modules.tools_repository.tools_repository_module import ToolsRepository
 from xpander_sdk.modules.tools_repository.utils.schemas import build_model_from_schema
 from xpander_sdk.utils.event_loop import run_sync
+from xpander_sdk.utils.tools import get_openai_agents_sdk_tools
 
 
 class AgentGraph(XPanderSharedModel):
@@ -151,6 +155,7 @@ class Agent(XPanderSharedModel):
             webhook_url: Optional[str]
             created_at: Optional[datetime]
             type: Optional[AgentType]
+            connectivity_details: Optional[Union[AIAgentConnectivityDetailsA2A,AIAgentConnectivityDetailsCurl, Dict]] = {}
             output_format: Optional[OutputFormat]
             output_schema: Optional[Dict]
             llm_credentials: Optional[LLMCredentials]
@@ -171,6 +176,7 @@ class Agent(XPanderSharedModel):
     environment_id: str = None
     tools: Optional[ToolsRepository] = None
     icon: Optional[str] = "🚀"
+    connectivity_details: Optional[Union[AIAgentConnectivityDetailsA2A,AIAgentConnectivityDetailsCurl, Dict]] = {}
     deployment_type: Optional[AgentDeploymentType] = AgentDeploymentType.Serverless
     source_nodes: Optional[List[AgentSourceNode]] = []
     access_scope: Optional[AgentAccessScope] = AgentAccessScope.Organizational
@@ -393,6 +399,8 @@ class Agent(XPanderSharedModel):
         mcp_servers: Optional[List[MCPServerDetails]] = [],
         triggering_agent_id: Optional[str] = None,
         title: Optional[str] = None,
+        think_mode: Optional[ThinkMode] = ThinkMode.Default,
+        disable_attachment_injection: Optional[bool] = False,
     ) -> Task:
         """
         Asynchronously create a new task and link it to this agent.
@@ -414,7 +422,9 @@ class Agent(XPanderSharedModel):
             expected_output (Optional[str]): Expected output of the execution.
             mcp_servers (Optional[List[MCPServerDetails]]): Optional list of mcp servers to use.
             triggering_agent_id (Optional[str]): Optional triggering agent id.
-        title (Optional[str]): Optional task title.
+            title (Optional[str]): Optional task title.
+            think_mode (Optional[ThinkMode]): Optional task think mode, defaults to "default".
+            disable_attachment_injection (Optional[bool]): Optional selection if to disable attachment injection to the context window.
 
         Returns:
             Task: Created Task object linked to this agent.
@@ -447,6 +457,8 @@ class Agent(XPanderSharedModel):
                     "mcp_servers": [server.model_dump() for server in mcp_servers],
                     "triggering_agent_id": triggering_agent_id,
                     "title": title,
+                    "think_mode": think_mode.value,
+                    "disable_attachment_injection": disable_attachment_injection,
                 },
             )
             return Task(**created_task, configuration=self.configuration)
@@ -583,7 +595,8 @@ class Agent(XPanderSharedModel):
             ImportError: If required dependencies are missing.
             ValueError: If the connection string for storage is invalid.
         """
-        if self.framework != Framework.Agno:
+        framework = Framework.Agno # will be removed
+        if self.framework != framework:
             raise NotImplementedError(
                 f"Storage for framework '{self.framework}' is not supported."
             )
@@ -877,3 +890,61 @@ class Agent(XPanderSharedModel):
 
         if not any(kb.id == knowledge_base_id for kb in self.knowledge_bases):
             self.knowledge_bases.append(AgentKnowledgeBase(id=knowledge_base_id))
+
+    @computed_field
+    @property
+    def strands_tools(self) -> List[Any]:
+        tools = []
+        for _tool in self.tools.list:
+            def make_tool(_tool_def: Tool):
+                async def invoke(payload: dict):
+                    return await _tool_def.ainvoke(
+                        task_id=self.configuration.state.task.id
+                            if self.configuration.state.task
+                            else None,
+                        agent_id=self.id,
+                        agent_version=self.version,
+                        payload=payload,
+                        configuration=_tool.configuration
+                    )
+                return invoke
+            
+            tools.append(
+                strands_tool(
+                    func=make_tool(_tool),
+                    name=_tool.id,
+                    description=_tool.description,
+                    inputSchema={
+                        "json": {
+                            "type": "object",
+                            "properties":{
+                                "payload": _tool.parameters
+                            },
+                            "required": ["payload"]
+                        }
+                    }
+                )
+            )
+        
+        return tools
+    
+    @computed_field
+    @property
+    def sanitized_name(self) -> str:
+        # Replace invalid characters with underscores
+        sanitized = re.sub(r'[^A-Za-z0-9_]', '_', self.name)
+
+        # If the first character is invalid, prefix with underscore
+        if not re.match(r'[A-Za-z_]', sanitized):
+            sanitized = '_' + sanitized
+
+        # Prevent empty result
+        if not sanitized:
+            sanitized = '_agent'
+
+        return sanitized
+    
+    @computed_field
+    @property
+    def openai_agents_sdk_tools(self) -> List[Any]:
+        return get_openai_agents_sdk_tools(self)

{xpander_sdk-2.0.108 → xpander_sdk-2.0.145}/src/xpander_sdk/modules/backend/backend_module.py

@@ -1,6 +1,6 @@
 import json
 from os import getenv
-from typing import Any, Callable, Dict, List, Optional, Union
+from typing import Any, Callable, Dict, List, Optional
 
 from xpander_sdk.core.module_base import ModuleBase
 from xpander_sdk.models.configuration import Configuration
@@ -230,7 +230,7 @@ class Backend(ModuleBase):
         task: Optional[Task] = None,
         override: Optional[Dict[str, Any]] = None,
         tools: Optional[List[Callable]] = None,
-        is_async: Optional[bool] = True
+        is_async: Optional[bool] = True,
     ) -> Dict[str, Any]:
         """
         Asynchronously resolve runtime arguments for the specified agent.