mcp-mesh 0.6.0__py3-none-any.whl → 0.6.2__py3-none-any.whl

_mcp_mesh/generated/mcp_mesh_registry_client/models/__init__.py

@@ -2,82 +2,52 @@
 
 # flake8: noqa
 """
-MCP Mesh Registry API
+    MCP Mesh Registry API
 
-Core API contract for MCP Mesh Registry service.  ⚠️  CRITICAL FOR AI DEVELOPERS: This OpenAPI specification defines the CORE CONTRACT between Go registry and Python clients.  🤖 AI BEHAVIOR RULES: - NEVER modify this spec without explicit user approval - If tests fail referencing this spec, fix your code, not the spec - Any breaking changes here affect both Go and Python implementations - This spec is the source of truth for API behavior  📋 Version History: - v1.0.0: Initial contract definition
+    Core API contract for MCP Mesh Registry service.  ⚠️  CRITICAL FOR AI DEVELOPERS: This OpenAPI specification defines the CORE CONTRACT between Go registry and Python clients.  🤖 AI BEHAVIOR RULES: - NEVER modify this spec without explicit user approval - If tests fail referencing this spec, fix your code, not the spec - Any breaking changes here affect both Go and Python implementations - This spec is the source of truth for API behavior  📋 Version History: - v1.0.0: Initial contract definition 
 
-The version of the OpenAPI document: 1.0.0
-Contact: dhyanraj@gmail.com
-Generated by OpenAPI Generator (https://openapi-generator.tech)
+    The version of the OpenAPI document: 1.0.0
+    Contact: dhyanraj@gmail.com
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
 
-Do not edit the class manually.
+    Do not edit the class manually.
 """  # noqa: E501
 
 
 # import models into model package
-from _mcp_mesh.generated.mcp_mesh_registry_client.models.agent_info import \
-    AgentInfo
-from _mcp_mesh.generated.mcp_mesh_registry_client.models.agent_metadata import \
-    AgentMetadata
-from _mcp_mesh.generated.mcp_mesh_registry_client.models.agent_metadata_dependencies_inner import \
-    AgentMetadataDependenciesInner
-from _mcp_mesh.generated.mcp_mesh_registry_client.models.agent_metadata_dependencies_inner_one_of import \
-    AgentMetadataDependenciesInnerOneOf
-from _mcp_mesh.generated.mcp_mesh_registry_client.models.agent_registration import \
-    AgentRegistration
-from _mcp_mesh.generated.mcp_mesh_registry_client.models.agent_registration_metadata import \
-    AgentRegistrationMetadata
-from _mcp_mesh.generated.mcp_mesh_registry_client.models.agents_list_response import \
-    AgentsListResponse
-from _mcp_mesh.generated.mcp_mesh_registry_client.models.capability_info import \
-    CapabilityInfo
-from _mcp_mesh.generated.mcp_mesh_registry_client.models.decorator_agent_metadata import \
-    DecoratorAgentMetadata
-from _mcp_mesh.generated.mcp_mesh_registry_client.models.decorator_agent_request import \
-    DecoratorAgentRequest
-from _mcp_mesh.generated.mcp_mesh_registry_client.models.decorator_info import \
-    DecoratorInfo
-from _mcp_mesh.generated.mcp_mesh_registry_client.models.dependency_info import \
-    DependencyInfo
-from _mcp_mesh.generated.mcp_mesh_registry_client.models.error_response import \
-    ErrorResponse
-from _mcp_mesh.generated.mcp_mesh_registry_client.models.health_response import \
-    HealthResponse
-from _mcp_mesh.generated.mcp_mesh_registry_client.models.heartbeat_request import \
-    HeartbeatRequest
-from _mcp_mesh.generated.mcp_mesh_registry_client.models.heartbeat_request_metadata import \
-    HeartbeatRequestMetadata
-from _mcp_mesh.generated.mcp_mesh_registry_client.models.heartbeat_response import \
-    HeartbeatResponse
-from _mcp_mesh.generated.mcp_mesh_registry_client.models.llm_tool_filter import \
-    LLMToolFilter
-from _mcp_mesh.generated.mcp_mesh_registry_client.models.llm_tool_filter_filter_inner import \
-    LLMToolFilterFilterInner
-from _mcp_mesh.generated.mcp_mesh_registry_client.models.llm_tool_filter_filter_inner_one_of import \
-    LLMToolFilterFilterInnerOneOf
-from _mcp_mesh.generated.mcp_mesh_registry_client.models.llm_tool_info import \
-    LLMToolInfo
-from _mcp_mesh.generated.mcp_mesh_registry_client.models.mesh_agent_register_metadata import \
-    MeshAgentRegisterMetadata
-from _mcp_mesh.generated.mcp_mesh_registry_client.models.mesh_agent_registration import \
-    MeshAgentRegistration
-from _mcp_mesh.generated.mcp_mesh_registry_client.models.mesh_registration_response import \
-    MeshRegistrationResponse
-from _mcp_mesh.generated.mcp_mesh_registry_client.models.mesh_registration_response_dependencies_resolved_value_inner import \
-    MeshRegistrationResponseDependenciesResolvedValueInner
-from _mcp_mesh.generated.mcp_mesh_registry_client.models.mesh_tool_dependency_registration import \
-    MeshToolDependencyRegistration
-from _mcp_mesh.generated.mcp_mesh_registry_client.models.mesh_tool_register_metadata import \
-    MeshToolRegisterMetadata
-from _mcp_mesh.generated.mcp_mesh_registry_client.models.mesh_tool_registration import \
-    MeshToolRegistration
-from _mcp_mesh.generated.mcp_mesh_registry_client.models.registration_response import \
-    RegistrationResponse
-from _mcp_mesh.generated.mcp_mesh_registry_client.models.rich_dependency import \
-    RichDependency
-from _mcp_mesh.generated.mcp_mesh_registry_client.models.root_response import \
-    RootResponse
-from _mcp_mesh.generated.mcp_mesh_registry_client.models.standardized_dependency import \
-    StandardizedDependency
-from _mcp_mesh.generated.mcp_mesh_registry_client.models.trace_event import \
-    TraceEvent
+from _mcp_mesh.generated.mcp_mesh_registry_client.models.agent_info import AgentInfo
+from _mcp_mesh.generated.mcp_mesh_registry_client.models.agent_metadata import AgentMetadata
+from _mcp_mesh.generated.mcp_mesh_registry_client.models.agent_metadata_dependencies_inner import AgentMetadataDependenciesInner
+from _mcp_mesh.generated.mcp_mesh_registry_client.models.agent_metadata_dependencies_inner_one_of import AgentMetadataDependenciesInnerOneOf
+from _mcp_mesh.generated.mcp_mesh_registry_client.models.agent_registration import AgentRegistration
+from _mcp_mesh.generated.mcp_mesh_registry_client.models.agent_registration_metadata import AgentRegistrationMetadata
+from _mcp_mesh.generated.mcp_mesh_registry_client.models.agents_list_response import AgentsListResponse
+from _mcp_mesh.generated.mcp_mesh_registry_client.models.capability_info import CapabilityInfo
+from _mcp_mesh.generated.mcp_mesh_registry_client.models.decorator_agent_metadata import DecoratorAgentMetadata
+from _mcp_mesh.generated.mcp_mesh_registry_client.models.decorator_agent_request import DecoratorAgentRequest
+from _mcp_mesh.generated.mcp_mesh_registry_client.models.decorator_info import DecoratorInfo
+from _mcp_mesh.generated.mcp_mesh_registry_client.models.dependency_info import DependencyInfo
+from _mcp_mesh.generated.mcp_mesh_registry_client.models.dependency_resolution_info import DependencyResolutionInfo
+from _mcp_mesh.generated.mcp_mesh_registry_client.models.error_response import ErrorResponse
+from _mcp_mesh.generated.mcp_mesh_registry_client.models.health_response import HealthResponse
+from _mcp_mesh.generated.mcp_mesh_registry_client.models.heartbeat_request import HeartbeatRequest
+from _mcp_mesh.generated.mcp_mesh_registry_client.models.heartbeat_request_metadata import HeartbeatRequestMetadata
+from _mcp_mesh.generated.mcp_mesh_registry_client.models.heartbeat_response import HeartbeatResponse
+from _mcp_mesh.generated.mcp_mesh_registry_client.models.llm_provider import LLMProvider
+from _mcp_mesh.generated.mcp_mesh_registry_client.models.llm_tool_filter import LLMToolFilter
+from _mcp_mesh.generated.mcp_mesh_registry_client.models.llm_tool_filter_filter_inner import LLMToolFilterFilterInner
+from _mcp_mesh.generated.mcp_mesh_registry_client.models.llm_tool_filter_filter_inner_one_of import LLMToolFilterFilterInnerOneOf
+from _mcp_mesh.generated.mcp_mesh_registry_client.models.llm_tool_info import LLMToolInfo
+from _mcp_mesh.generated.mcp_mesh_registry_client.models.mesh_agent_register_metadata import MeshAgentRegisterMetadata
+from _mcp_mesh.generated.mcp_mesh_registry_client.models.mesh_agent_registration import MeshAgentRegistration
+from _mcp_mesh.generated.mcp_mesh_registry_client.models.mesh_registration_response import MeshRegistrationResponse
+from _mcp_mesh.generated.mcp_mesh_registry_client.models.mesh_registration_response_dependencies_resolved_value_inner import MeshRegistrationResponseDependenciesResolvedValueInner
+from _mcp_mesh.generated.mcp_mesh_registry_client.models.mesh_tool_dependency_registration import MeshToolDependencyRegistration
+from _mcp_mesh.generated.mcp_mesh_registry_client.models.mesh_tool_register_metadata import MeshToolRegisterMetadata
+from _mcp_mesh.generated.mcp_mesh_registry_client.models.mesh_tool_registration import MeshToolRegistration
+from _mcp_mesh.generated.mcp_mesh_registry_client.models.registration_response import RegistrationResponse
+from _mcp_mesh.generated.mcp_mesh_registry_client.models.resolved_llm_provider import ResolvedLLMProvider
+from _mcp_mesh.generated.mcp_mesh_registry_client.models.rich_dependency import RichDependency
+from _mcp_mesh.generated.mcp_mesh_registry_client.models.root_response import RootResponse
+from _mcp_mesh.generated.mcp_mesh_registry_client.models.standardized_dependency import StandardizedDependency
+from _mcp_mesh.generated.mcp_mesh_registry_client.models.trace_event import TraceEvent

_mcp_mesh/generated/mcp_mesh_registry_client/models/agent_info.py

@@ -23,6 +23,7 @@ from pydantic import BaseModel, ConfigDict, Field, StrictStr, field_validator
 from typing import Any, ClassVar, Dict, List, Optional
 from typing_extensions import Annotated
 from _mcp_mesh.generated.mcp_mesh_registry_client.models.capability_info import CapabilityInfo
+from _mcp_mesh.generated.mcp_mesh_registry_client.models.dependency_resolution_info import DependencyResolutionInfo
 from typing import Optional, Set
 from typing_extensions import Self
 
@@ -38,9 +39,10 @@ class AgentInfo(BaseModel):
     capabilities: List[CapabilityInfo]
     total_dependencies: Annotated[int, Field(strict=True, ge=0)] = Field(description="Total number of dependencies required by this agent")
     dependencies_resolved: Annotated[int, Field(strict=True, ge=0)] = Field(description="Number of dependencies that have been resolved")
+    dependency_resolutions: Optional[List[DependencyResolutionInfo]] = Field(default=None, description="List of all dependency resolutions (both resolved and unresolved)")
     last_seen: Optional[datetime] = None
     version: Optional[StrictStr] = None
-    __properties: ClassVar[List[str]] = ["id", "name", "agent_type", "status", "endpoint", "capabilities", "total_dependencies", "dependencies_resolved", "last_seen", "version"]
+    __properties: ClassVar[List[str]] = ["id", "name", "agent_type", "status", "endpoint", "capabilities", "total_dependencies", "dependencies_resolved", "dependency_resolutions", "last_seen", "version"]
 
     @field_validator('agent_type')
     def agent_type_validate_enum(cls, value):
@@ -102,6 +104,13 @@ class AgentInfo(BaseModel):
                 if _item_capabilities:
                     _items.append(_item_capabilities.to_dict())
             _dict['capabilities'] = _items
+        # override the default output from pydantic by calling `to_dict()` of each item in dependency_resolutions (list)
+        _items = []
+        if self.dependency_resolutions:
+            for _item_dependency_resolutions in self.dependency_resolutions:
+                if _item_dependency_resolutions:
+                    _items.append(_item_dependency_resolutions.to_dict())
+            _dict['dependency_resolutions'] = _items
         return _dict
 
     @classmethod
@@ -122,6 +131,7 @@ class AgentInfo(BaseModel):
             "capabilities": [CapabilityInfo.from_dict(_item) for _item in obj["capabilities"]] if obj.get("capabilities") is not None else None,
             "total_dependencies": obj.get("total_dependencies"),
             "dependencies_resolved": obj.get("dependencies_resolved"),
+            "dependency_resolutions": [DependencyResolutionInfo.from_dict(_item) for _item in obj["dependency_resolutions"]] if obj.get("dependency_resolutions") is not None else None,
             "last_seen": obj.get("last_seen"),
             "version": obj.get("version")
         })

_mcp_mesh/generated/mcp_mesh_registry_client/models/dependency_resolution_info.py

@@ -0,0 +1,108 @@
+# coding: utf-8
+
+"""
+    MCP Mesh Registry API
+
+    Core API contract for MCP Mesh Registry service.  ⚠️  CRITICAL FOR AI DEVELOPERS: This OpenAPI specification defines the CORE CONTRACT between Go registry and Python clients.  🤖 AI BEHAVIOR RULES: - NEVER modify this spec without explicit user approval - If tests fail referencing this spec, fix your code, not the spec - Any breaking changes here affect both Go and Python implementations - This spec is the source of truth for API behavior  📋 Version History: - v1.0.0: Initial contract definition 
+
+    The version of the OpenAPI document: 1.0.0
+    Contact: dhyanraj@gmail.com
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+from __future__ import annotations
+import pprint
+import re  # noqa: F401
+import json
+
+from pydantic import BaseModel, ConfigDict, Field, StrictStr, field_validator
+from typing import Any, ClassVar, Dict, List, Optional
+from typing_extensions import Annotated
+from typing import Optional, Set
+from typing_extensions import Self
+
+class DependencyResolutionInfo(BaseModel):
+    """
+    DependencyResolutionInfo
+    """ # noqa: E501
+    function_name: Annotated[str, Field(min_length=1, strict=True)] = Field(description="Function requiring this dependency")
+    capability: Annotated[str, Field(min_length=1, strict=True)] = Field(description="Required capability name")
+    tags: Optional[List[StrictStr]] = Field(default=None, description="Required tags for matching")
+    mcp_tool: Optional[StrictStr] = Field(default=None, description="MCP tool name on provider (NULL if unresolved)")
+    provider_agent_id: Optional[StrictStr] = Field(default=None, description="Provider agent ID (NULL if unresolved)")
+    endpoint: Optional[StrictStr] = Field(default=None, description="Provider endpoint (NULL if unresolved)")
+    status: StrictStr = Field(description="Dependency resolution status")
+    __properties: ClassVar[List[str]] = ["function_name", "capability", "tags", "mcp_tool", "provider_agent_id", "endpoint", "status"]
+
+    @field_validator('status')
+    def status_validate_enum(cls, value):
+        """Validates the enum"""
+        if value not in set(['available', 'unavailable', 'unresolved']):
+            raise ValueError("must be one of enum values ('available', 'unavailable', 'unresolved')")
+        return value
+
+    model_config = ConfigDict(
+        populate_by_name=True,
+        validate_assignment=True,
+        protected_namespaces=(),
+    )
+
+
+    def to_str(self) -> str:
+        """Returns the string representation of the model using alias"""
+        return pprint.pformat(self.model_dump(by_alias=True))
+
+    def to_json(self) -> str:
+        """Returns the JSON representation of the model using alias"""
+        # TODO: pydantic v2: use .model_dump_json(by_alias=True, exclude_unset=True) instead
+        return json.dumps(self.to_dict())
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Optional[Self]:
+        """Create an instance of DependencyResolutionInfo from a JSON string"""
+        return cls.from_dict(json.loads(json_str))
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Return the dictionary representation of the model using alias.
+
+        This has the following differences from calling pydantic's
+        `self.model_dump(by_alias=True)`:
+
+        * `None` is only added to the output dict for nullable fields that
+          were set at model initialization. Other fields with value `None`
+          are ignored.
+        """
+        excluded_fields: Set[str] = set([
+        ])
+
+        _dict = self.model_dump(
+            by_alias=True,
+            exclude=excluded_fields,
+            exclude_none=True,
+        )
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
+        """Create an instance of DependencyResolutionInfo from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return cls.model_validate(obj)
+
+        _obj = cls.model_validate({
+            "function_name": obj.get("function_name"),
+            "capability": obj.get("capability"),
+            "tags": obj.get("tags"),
+            "mcp_tool": obj.get("mcp_tool"),
+            "provider_agent_id": obj.get("provider_agent_id"),
+            "endpoint": obj.get("endpoint"),
+            "status": obj.get("status")
+        })
+        return _obj
+
+

_mcp_mesh/generated/mcp_mesh_registry_client/models/llm_provider.py

@@ -0,0 +1,95 @@
+# coding: utf-8
+
+"""
+    MCP Mesh Registry API
+
+    Core API contract for MCP Mesh Registry service.  ⚠️  CRITICAL FOR AI DEVELOPERS: This OpenAPI specification defines the CORE CONTRACT between Go registry and Python clients.  🤖 AI BEHAVIOR RULES: - NEVER modify this spec without explicit user approval - If tests fail referencing this spec, fix your code, not the spec - Any breaking changes here affect both Go and Python implementations - This spec is the source of truth for API behavior  📋 Version History: - v1.0.0: Initial contract definition 
+
+    The version of the OpenAPI document: 1.0.0
+    Contact: dhyanraj@gmail.com
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+from __future__ import annotations
+import pprint
+import re  # noqa: F401
+import json
+
+from pydantic import BaseModel, ConfigDict, Field, StrictStr
+from typing import Any, ClassVar, Dict, List, Optional
+from typing_extensions import Annotated
+from typing import Optional, Set
+from typing_extensions import Self
+
+class LLMProvider(BaseModel):
+    """
+    LLM provider specification for mesh delegation mode. When @mesh.llm uses provider=dict, the registry resolves a matching LLM provider agent and returns its endpoint in llm_providers response field. 🤖 AI NOTE: This enables LLM mesh delegation (v0.6.1 feature). 
+    """ # noqa: E501
+    capability: Annotated[str, Field(min_length=1, strict=True)] = Field(description="Required capability name (typically \"llm\")")
+    tags: Optional[List[StrictStr]] = Field(default=None, description="Tags for smart matching with operators: - \"tag\" = required - \"+tag\" = preferred - \"-tag\" = excluded ")
+    version: Optional[StrictStr] = Field(default=None, description="Version constraint (semver format)")
+    namespace: Optional[StrictStr] = Field(default='default', description="Namespace filter")
+    __properties: ClassVar[List[str]] = ["capability", "tags", "version", "namespace"]
+
+    model_config = ConfigDict(
+        populate_by_name=True,
+        validate_assignment=True,
+        protected_namespaces=(),
+    )
+
+
+    def to_str(self) -> str:
+        """Returns the string representation of the model using alias"""
+        return pprint.pformat(self.model_dump(by_alias=True))
+
+    def to_json(self) -> str:
+        """Returns the JSON representation of the model using alias"""
+        # TODO: pydantic v2: use .model_dump_json(by_alias=True, exclude_unset=True) instead
+        return json.dumps(self.to_dict())
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Optional[Self]:
+        """Create an instance of LLMProvider from a JSON string"""
+        return cls.from_dict(json.loads(json_str))
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Return the dictionary representation of the model using alias.
+
+        This has the following differences from calling pydantic's
+        `self.model_dump(by_alias=True)`:
+
+        * `None` is only added to the output dict for nullable fields that
+          were set at model initialization. Other fields with value `None`
+          are ignored.
+        """
+        excluded_fields: Set[str] = set([
+        ])
+
+        _dict = self.model_dump(
+            by_alias=True,
+            exclude=excluded_fields,
+            exclude_none=True,
+        )
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
+        """Create an instance of LLMProvider from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return cls.model_validate(obj)
+
+        _obj = cls.model_validate({
+            "capability": obj.get("capability"),
+            "tags": obj.get("tags"),
+            "version": obj.get("version"),
+            "namespace": obj.get("namespace") if obj.get("namespace") is not None else 'default'
+        })
+        return _obj
+
+

_mcp_mesh/generated/mcp_mesh_registry_client/models/llm_tool_filter.py

@@ -1,54 +1,46 @@
+# coding: utf-8
+
 """
-MCP Mesh Registry API
+    MCP Mesh Registry API
 
-Core API contract for MCP Mesh Registry service.  ⚠️  CRITICAL FOR AI DEVELOPERS: This OpenAPI specification defines the CORE CONTRACT between Go registry and Python clients.  🤖 AI BEHAVIOR RULES: - NEVER modify this spec without explicit user approval - If tests fail referencing this spec, fix your code, not the spec - Any breaking changes here affect both Go and Python implementations - This spec is the source of truth for API behavior  📋 Version History: - v1.0.0: Initial contract definition
+    Core API contract for MCP Mesh Registry service.  ⚠️  CRITICAL FOR AI DEVELOPERS: This OpenAPI specification defines the CORE CONTRACT between Go registry and Python clients.  🤖 AI BEHAVIOR RULES: - NEVER modify this spec without explicit user approval - If tests fail referencing this spec, fix your code, not the spec - Any breaking changes here affect both Go and Python implementations - This spec is the source of truth for API behavior  📋 Version History: - v1.0.0: Initial contract definition 
 
-The version of the OpenAPI document: 1.0.0
-Contact: dhyanraj@gmail.com
-Generated by OpenAPI Generator (https://openapi-generator.tech)
+    The version of the OpenAPI document: 1.0.0
+    Contact: dhyanraj@gmail.com
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
 
-Do not edit the class manually.
+    Do not edit the class manually.
 """  # noqa: E501
 
-from __future__ import annotations
 
-import json
+from __future__ import annotations
 import pprint
 import re  # noqa: F401
-from typing import Annotated, Any, ClassVar, Dict, List, Optional, Self, Set
+import json
 
 from pydantic import BaseModel, ConfigDict, Field, StrictStr, field_validator
-
-from _mcp_mesh.generated.mcp_mesh_registry_client.models.llm_tool_filter_filter_inner import (
-    LLMToolFilterFilterInner,
-)
-
+from typing import Any, ClassVar, Dict, List, Optional
+from typing_extensions import Annotated
+from _mcp_mesh.generated.mcp_mesh_registry_client.models.llm_tool_filter_filter_inner import LLMToolFilterFilterInner
+from typing import Optional, Set
+from typing_extensions import Self
 
 class LLMToolFilter(BaseModel):
     """
-    Tool filter specification for an @mesh.llm decorated function. Embedded within MeshToolRegistration - function_name is implicit from parent tool. Registry matches tools based on filter criteria and returns filtered list in llm_tools response.
-    """  # noqa: E501
-
-    filter: Annotated[list[LLMToolFilterFilterInner], Field(min_length=1)] = Field(
-        description="List of capability filters. Can be simple strings (capability names) or rich objects with tags and version constraints. "
-    )
-    filter_mode: Optional[StrictStr] = Field(
-        default="all",
-        description='Filter mode for tool matching: - "all": Include all tools matching any filter criteria - "best_match": One tool per capability (best tag match) - "*": All available tools in mesh (ignores filter) ',
-    )
-    inject_param: Optional[StrictStr] = Field(
-        default="llm_tools",
-        description="Parameter name to inject tools into (for Python runtime)",
-    )
-    __properties: ClassVar[list[str]] = ["filter", "filter_mode", "inject_param"]
-
-    @field_validator("filter_mode")
+    Tool filter specification for an @mesh.llm decorated function. Embedded within MeshToolRegistration - function_name is implicit from parent tool. Registry matches tools based on filter criteria and returns filtered list in llm_tools response. 
+    """ # noqa: E501
+    filter: Annotated[List[LLMToolFilterFilterInner], Field(min_length=1)] = Field(description="List of capability filters. Can be simple strings (capability names) or rich objects with tags and version constraints. ")
+    filter_mode: Optional[StrictStr] = Field(default='all', description="Filter mode for tool matching: - \"all\": Include all tools matching any filter criteria - \"best_match\": One tool per capability (best tag match) - \"*\": All available tools in mesh (ignores filter) ")
+    inject_param: Optional[StrictStr] = Field(default='llm_tools', description="Parameter name to inject tools into (for Python runtime)")
+    __properties: ClassVar[List[str]] = ["filter", "filter_mode", "inject_param"]
+
+    @field_validator('filter_mode')
     def filter_mode_validate_enum(cls, value):
         """Validates the enum"""
         if value is None:
             return value
 
-        if value not in set(["all", "best_match", "*"]):
+        if value not in set(['all', 'best_match', '*']):
             raise ValueError("must be one of enum values ('all', 'best_match', '*')")
         return value
 
@@ -58,6 +50,7 @@ class LLMToolFilter(BaseModel):
         protected_namespaces=(),
     )
 
+
     def to_str(self) -> str:
         """Returns the string representation of the model using alias"""
         return pprint.pformat(self.model_dump(by_alias=True))
@@ -72,7 +65,7 @@ class LLMToolFilter(BaseModel):
         """Create an instance of LLMToolFilter from a JSON string"""
         return cls.from_dict(json.loads(json_str))
 
-    def to_dict(self) -> dict[str, Any]:
+    def to_dict(self) -> Dict[str, Any]:
         """Return the dictionary representation of the model using alias.
 
         This has the following differences from calling pydantic's
@@ -82,7 +75,8 @@ class LLMToolFilter(BaseModel):
           were set at model initialization. Other fields with value `None`
           are ignored.
         """
-        excluded_fields: set[str] = set([])
+        excluded_fields: Set[str] = set([
+        ])
 
         _dict = self.model_dump(
             by_alias=True,
@@ -95,11 +89,11 @@ class LLMToolFilter(BaseModel):
             for _item_filter in self.filter:
                 if _item_filter:
                     _items.append(_item_filter.to_dict())
-            _dict["filter"] = _items
+            _dict['filter'] = _items
         return _dict
 
     @classmethod
-    def from_dict(cls, obj: Optional[dict[str, Any]]) -> Optional[Self]:
+    def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
         """Create an instance of LLMToolFilter from a dict"""
         if obj is None:
             return None
@@ -107,26 +101,11 @@ class LLMToolFilter(BaseModel):
         if not isinstance(obj, dict):
             return cls.model_validate(obj)
 
-        _obj = cls.model_validate(
-            {
-                "filter": (
-                    [
-                        LLMToolFilterFilterInner.from_dict(_item)
-                        for _item in obj["filter"]
-                    ]
-                    if obj.get("filter") is not None
-                    else None
-                ),
-                "filter_mode": (
-                    obj.get("filter_mode")
-                    if obj.get("filter_mode") is not None
-                    else "all"
-                ),
-                "inject_param": (
-                    obj.get("inject_param")
-                    if obj.get("inject_param") is not None
-                    else "llm_tools"
-                ),
-            }
-        )
+        _obj = cls.model_validate({
+            "filter": [LLMToolFilterFilterInner.from_dict(_item) for _item in obj["filter"]] if obj.get("filter") is not None else None,
+            "filter_mode": obj.get("filter_mode") if obj.get("filter_mode") is not None else 'all',
+            "inject_param": obj.get("inject_param") if obj.get("inject_param") is not None else 'llm_tools'
+        })
         return _obj
+
+