xpander-sdk 2.0.225__tar.gz → 2.0.227__tar.gz

{xpander_sdk-2.0.225 → xpander_sdk-2.0.227}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: xpander-sdk
-Version: 2.0.225
+Version: 2.0.227
 Summary: xpander.ai Backend-as-a-service for AI Agents - SDK
 Home-page: https://www.xpander.ai
 Author: xpanderAI

{xpander_sdk-2.0.225 → xpander_sdk-2.0.227}/setup.py

@@ -5,7 +5,7 @@ with open("README.md", "r", encoding="utf-8") as fh:
 
 setup(
     name="xpander-sdk",
-    version="2.0.225",
+    version="2.0.227",
     author="xpanderAI",
     author_email="dev@xpander.ai",
     description="xpander.ai Backend-as-a-service for AI Agents - SDK",

{xpander_sdk-2.0.225 → xpander_sdk-2.0.227}/src/xpander_sdk/modules/agents/sub_modules/agent.py

@@ -175,6 +175,8 @@ class Agent(XPanderSharedModel):
             use_oidc_pre_auth: Optional[bool] = False
             pre_auth_audiences: Optional[List[str]] = []
             use_oidc_pre_auth_token_for_llm: Optional[bool] = False
+            oidc_pre_auth_token_mcp_audience: Optional[bool] = False
+            oidc_pre_auth_token_llm_audience: Optional[str] = None
 
         Example:
             >>> agent = Agent(id="agent123", name="Example Agent")
@@ -226,6 +228,8 @@ class Agent(XPanderSharedModel):
     use_oidc_pre_auth: Optional[bool] = False
     pre_auth_audiences: Optional[List[str]] = []
     use_oidc_pre_auth_token_for_llm: Optional[bool] = False
+    oidc_pre_auth_token_llm_audience: Optional[str] = None
+    oidc_pre_auth_token_mcp_audience: Optional[str] = None
 
     _connection_string: Optional[DatabaseConnectionString] = None
 
@@ -421,6 +425,7 @@ class Agent(XPanderSharedModel):
         additional_context: Optional[str] = None,
         instructions_override: Optional[str] = None,
         test_run_node_id: Optional[str] = None,
+        user_oidc_token: Optional[str] = None,
         expected_output: Optional[str] = None,
         mcp_servers: Optional[List[MCPServerDetails]] = [],
         triggering_agent_id: Optional[str] = None,
@@ -448,6 +453,7 @@ class Agent(XPanderSharedModel):
             additional_context (Optional[str]): Additional context to be passed to the agent.
             instructions_override (Optional[str]): Additional instructions to be appended to the agent's system prompt.
             test_run_node_id (Optional[str]): Internal test purpose workflow node id to execute.
+            user_oidc_token (Optional[str]): OIDC Token to be used for pre-auth.
             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.
@@ -485,6 +491,7 @@ class Agent(XPanderSharedModel):
                     "additional_context": additional_context,
                     "instructions_override": instructions_override,
                     "test_run_node_id": test_run_node_id,
+                    "user_oidc_token": user_oidc_token,
                     "expected_output": expected_output,
                     "mcp_servers": [server.model_dump() for server in mcp_servers],
                     "triggering_agent_id": triggering_agent_id,

{xpander_sdk-2.0.225 → xpander_sdk-2.0.227}/src/xpander_sdk/modules/backend/frameworks/agno.py

@@ -43,7 +43,7 @@ async def build_agent_args(
     is_async: Optional[bool] = True,
     auth_events_callback: Optional[Callable] = None,
 ) -> Dict[str, Any]:
-    model = _load_llm_model(agent=xpander_agent, override=override)
+    model = _load_llm_model(agent=xpander_agent, override=override, task=task)
     args: Dict[str, Any] = {
         "id": xpander_agent.id,
         "store_events": True
@@ -576,7 +576,7 @@ def _configure_deep_planning_guidance(args: Dict[str, Any], agent: Agent, task:
         plan_str = task.deep_planning.model_dump_json() if task.deep_planning and task.deep_planning.enabled and len(task.deep_planning.tasks) != 0 else "No execution plan, please generate"
         args["additional_context"] += f" \n Current execution plan: {plan_str}"
 
-def _load_llm_model(agent: Agent, override: Optional[Dict[str, Any]] = {}) -> Any:
+def _load_llm_model(agent: Agent, override: Optional[Dict[str, Any]] = {}, task: Optional[Task] = None) -> Any:
     """
     Load and configure the appropriate LLM model based on the agent's provider configuration.
 
@@ -613,6 +613,12 @@ def _load_llm_model(agent: Agent, override: Optional[Dict[str, Any]] = {}) -> An
     has_custom_llm_key = (
         True if agent.llm_credentials and agent.llm_credentials.value else False
     )
+    
+    oidc_llm_token = None
+    
+    # OIDC pre-auth token claim by audience
+    if agent and agent.pre_auth_audiences and agent.use_oidc_pre_auth_token_for_llm and agent.oidc_pre_auth_token_llm_audience and task and task.user_tokens and isinstance(task.user_tokens, dict) and "oidc_tokens" in task.user_tokens and isinstance(task.user_tokens["oidc_tokens"], dict):
+        oidc_llm_token = task.user_tokens["oidc_tokens"].get(agent.oidc_pre_auth_token_llm_audience, None)
 
     def get_llm_key(env_var_name: str) -> Optional[str]:
         """
@@ -624,6 +630,11 @@ def _load_llm_model(agent: Agent, override: Optional[Dict[str, Any]] = {}) -> An
         Returns:
             Optional[str]: The resolved API key or None if not available.
         """
+        
+        # return oidc claimed api key
+        if oidc_llm_token:
+            return oidc_llm_token
+        
         env_llm_key = getenv(env_var_name)
 
         # If no custom key available, use environment variable
@@ -641,6 +652,9 @@ def _load_llm_model(agent: Agent, override: Optional[Dict[str, Any]] = {}) -> An
     
     llm_extra_headers = {}
     
+    if oidc_llm_token:
+        llm_extra_headers["x-oidc-token"] = oidc_llm_token
+    
     # Get organization default LLM extra headers
     api_client = APIClient(configuration=agent.configuration)
     org_default_llm_headers = run_sync(
@@ -975,27 +989,35 @@ async def _resolve_agent_tools(agent: Agent, task: Optional[Task] = None, auth_e
                 else StreamableHTTPClientParams
             )
             
-            # handle mcp auth
-            if mcp.auth_type == MCPServerAuthType.OAuth2:
-                if not task:
-                    raise ValueError("MCP server with OAuth authentication detected but task not sent")
-                
-                # check if we have user tokens for this mcp
-                graph_item = next((gi for gi in agent.graph.items if gi.type == AgentGraphItemType.MCP and gi.settings and gi.settings.mcp_settings and gi.settings.mcp_settings.url and gi.settings.mcp_settings.url == mcp.url), None)
-                if graph_item and task.user_tokens and isinstance(task.user_tokens, dict) and graph_item.id in task.user_tokens:
-                    mcp.api_key = task.user_tokens[graph_item.id]
-                else:
-                    if not task.input.user or not task.input.user.id:
-                        raise ValueError("MCP server with OAuth authentication detected but user id not set on the task (task.input.user.id)")
+            oidc_mcp_token = None
+            # OIDC pre-auth token claim by audience
+            if agent and agent.pre_auth_audiences and agent.oidc_pre_auth_token_mcp_audience and task and task.user_tokens and isinstance(task.user_tokens, dict) and "oidc_tokens" in task.user_tokens and isinstance(task.user_tokens["oidc_tokens"], dict):
+                oidc_mcp_token = task.user_tokens["oidc_tokens"].get(agent.oidc_pre_auth_token_mcp_audience, None)
+                if oidc_mcp_token and oidc_mcp_token != "__none__":
+                    mcp.api_key = oidc_mcp_token
+            
+            if not oidc_mcp_token:
+                # handle mcp auth
+                if mcp.auth_type == MCPServerAuthType.OAuth2:
+                    if not task:
+                        raise ValueError("MCP server with OAuth authentication detected but task not sent")
                     
-                    auth_result: MCPOAuthGetTokenResponse = await authenticate_mcp_server(mcp_server=mcp,task=task,user_id=task.input.user.id, auth_events_callback=auth_events_callback)
-                    if auth_result and auth_result.data and isinstance(auth_result.data, MCPOAuthGetTokenGenericResponse) and auth_result.data.message:
-                        raise ValueError(f"MCP authentication failed: {auth_result.data.message}")
-                    if not auth_result:
-                        raise ValueError("MCP Server authentication failed")
-                    if auth_result.type != MCPOAuthResponseType.TOKEN_READY:
-                        raise ValueError("MCP Server authentication timeout")
-                    mcp.api_key = auth_result.data.access_token
+                    # check if we have user tokens for this mcp
+                    graph_item = next((gi for gi in agent.graph.items if gi.type == AgentGraphItemType.MCP and gi.settings and gi.settings.mcp_settings and gi.settings.mcp_settings.url and gi.settings.mcp_settings.url == mcp.url), None)
+                    if graph_item and task.user_tokens and isinstance(task.user_tokens, dict) and graph_item.id in task.user_tokens:
+                        mcp.api_key = task.user_tokens[graph_item.id]
+                    else:
+                        if not task.input.user or not task.input.user.id:
+                            raise ValueError("MCP server with OAuth authentication detected but user id not set on the task (task.input.user.id)")
+                        
+                        auth_result: MCPOAuthGetTokenResponse = await authenticate_mcp_server(mcp_server=mcp,task=task,user_id=task.input.user.id, auth_events_callback=auth_events_callback)
+                        if auth_result and auth_result.data and isinstance(auth_result.data, MCPOAuthGetTokenGenericResponse) and auth_result.data.message:
+                            raise ValueError(f"MCP authentication failed: {auth_result.data.message}")
+                        if not auth_result:
+                            raise ValueError("MCP Server authentication failed")
+                        if auth_result.type != MCPOAuthResponseType.TOKEN_READY:
+                            raise ValueError("MCP Server authentication timeout")
+                        mcp.api_key = auth_result.data.access_token
             
             if mcp.api_key:
                 
@@ -1007,6 +1029,7 @@ async def _resolve_agent_tools(agent: Agent, task: Optional[Task] = None, auth_e
                 if not mcp.headers:
                     mcp.headers = {}
                 mcp.headers["Authorization"] = f"Bearer {mcp.api_key}"
+            
             mcp_tools.append(
                 MCPTools(
                     transport=transport,

{xpander_sdk-2.0.225 → xpander_sdk-2.0.227}/src/xpander_sdk/modules/tasks/sub_modules/task.py

@@ -134,6 +134,7 @@ class Task(XPanderSharedModel):
         additional_context (Optional[str]): Additional context to be passed to the agent.
         instructions_override (Optional[str]): Additional instructions to be appended to the agent's system prompt.
         test_run_node_id (Optional[str]): Internal test purpose workflow node id to execute.
+        user_oidc_token (Optional[str]): OIDC Token to be used for pre-auth
         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.
@@ -184,6 +185,7 @@ class Task(XPanderSharedModel):
     additional_context: Optional[str] = None
     instructions_override: Optional[str] = None
     test_run_node_id: Optional[str] = None
+    user_oidc_token: Optional[str] = None
     expected_output: Optional[str] = (None,)
     mcp_servers: Optional[List[MCPServerDetails]] = ([],)
     triggering_agent_id: Optional[str] = (None,)

{xpander_sdk-2.0.225 → xpander_sdk-2.0.227}/src/xpander_sdk/modules/tasks/tasks_module.py

@@ -236,6 +236,7 @@ class Tasks(ModuleBase):
         additional_context: Optional[str] = None,
         instructions_override: Optional[str] = None,
         test_run_node_id: Optional[str] = None,
+        user_oidc_token: Optional[str] = None,
         expected_output: Optional[str] = None,
         mcp_servers: Optional[List[MCPServerDetails]] = [],
         triggering_agent_id: Optional[str] = None,
@@ -267,6 +268,7 @@ class Tasks(ModuleBase):
             additional_context (Optional[str]): Additional context to be passed to the agent.
             instructions_override (Optional[str]): Additional instructions to be appended to the agent's system prompt.
             test_run_node_id (Optional[str]): Internal test purpose workflow node id to execute.
+            user_oidc_token (Optional[str]): OIDC Token to be used for pre-auth
             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.
@@ -315,6 +317,7 @@ class Tasks(ModuleBase):
                     "additional_context": additional_context,
                     "instructions_override": instructions_override,
                     "test_run_node_id": test_run_node_id,
+                    "user_oidc_token": user_oidc_token,
                     "expected_output": expected_output,
                     "mcp_servers": [server.model_dump() for server in mcp_servers],
                     "triggering_agent_id": triggering_agent_id,

{xpander_sdk-2.0.225 → xpander_sdk-2.0.227}/src/xpander_sdk.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: xpander-sdk
-Version: 2.0.225
+Version: 2.0.227
 Summary: xpander.ai Backend-as-a-service for AI Agents - SDK
 Home-page: https://www.xpander.ai
 Author: xpanderAI