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

_mcp_mesh/generated/mcp_mesh_registry_client/models/llm_tool_filter_filter_inner.py

@@ -1,71 +1,58 @@
+# 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
 
+from __future__ import annotations
 import json
 import pprint
-from typing import Any, Dict, List, Literal, Optional, Self, Set, Union
-
-from pydantic import (
-    BaseModel,
-    ConfigDict,
-    Field,
-    StrictStr,
-    ValidationError,
-    field_validator,
-)
-
-from _mcp_mesh.generated.mcp_mesh_registry_client.models.llm_tool_filter_filter_inner_one_of import (
-    LLMToolFilterFilterInnerOneOf,
-)
+from pydantic import BaseModel, ConfigDict, Field, StrictStr, ValidationError, field_validator
+from typing import Any, List, Optional
+from _mcp_mesh.generated.mcp_mesh_registry_client.models.llm_tool_filter_filter_inner_one_of import LLMToolFilterFilterInnerOneOf
+from pydantic import StrictStr, Field
+from typing import Union, List, Set, Optional, Dict
+from typing_extensions import Literal, Self
 
 LLMTOOLFILTERFILTERINNER_ONE_OF_SCHEMAS = ["LLMToolFilterFilterInnerOneOf", "str"]
 
-
 class LLMToolFilterFilterInner(BaseModel):
     """
     LLMToolFilterFilterInner
     """
-
     # data type: str
-    oneof_schema_1_validator: Optional[StrictStr] = Field(
-        default=None, description="Simple capability name filter"
-    )
+    oneof_schema_1_validator: Optional[StrictStr] = Field(default=None, description="Simple capability name filter")
     # data type: LLMToolFilterFilterInnerOneOf
     oneof_schema_2_validator: Optional[LLMToolFilterFilterInnerOneOf] = None
     actual_instance: Optional[Union[LLMToolFilterFilterInnerOneOf, str]] = None
-    one_of_schemas: set[str] = {"LLMToolFilterFilterInnerOneOf", "str"}
+    one_of_schemas: Set[str] = { "LLMToolFilterFilterInnerOneOf", "str" }
 
     model_config = ConfigDict(
         validate_assignment=True,
         protected_namespaces=(),
     )
 
+
     def __init__(self, *args, **kwargs) -> None:
         if args:
             if len(args) > 1:
-                raise ValueError(
-                    "If a position argument is used, only 1 is allowed to set `actual_instance`"
-                )
+                raise ValueError("If a position argument is used, only 1 is allowed to set `actual_instance`")
             if kwargs:
-                raise ValueError(
-                    "If a position argument is used, keyword arguments cannot be used."
-                )
+                raise ValueError("If a position argument is used, keyword arguments cannot be used.")
             super().__init__(actual_instance=args[0])
         else:
             super().__init__(**kwargs)
 
-    @field_validator("actual_instance")
+    @field_validator('actual_instance')
     def actual_instance_must_validate_oneof(cls, v):
         instance = LLMToolFilterFilterInner.model_construct()
         error_messages = []
@@ -78,28 +65,20 @@ class LLMToolFilterFilterInner(BaseModel):
             error_messages.append(str(e))
         # validate data type: LLMToolFilterFilterInnerOneOf
         if not isinstance(v, LLMToolFilterFilterInnerOneOf):
-            error_messages.append(
-                f"Error! Input type `{type(v)}` is not `LLMToolFilterFilterInnerOneOf`"
-            )
+            error_messages.append(f"Error! Input type `{type(v)}` is not `LLMToolFilterFilterInnerOneOf`")
         else:
             match += 1
         if match > 1:
             # more than 1 match
-            raise ValueError(
-                "Multiple matches found when setting `actual_instance` in LLMToolFilterFilterInner with oneOf schemas: LLMToolFilterFilterInnerOneOf, str. Details: "
-                + ", ".join(error_messages)
-            )
+            raise ValueError("Multiple matches found when setting `actual_instance` in LLMToolFilterFilterInner with oneOf schemas: LLMToolFilterFilterInnerOneOf, str. Details: " + ", ".join(error_messages))
         elif match == 0:
             # no match
-            raise ValueError(
-                "No match found when setting `actual_instance` in LLMToolFilterFilterInner with oneOf schemas: LLMToolFilterFilterInnerOneOf, str. Details: "
-                + ", ".join(error_messages)
-            )
+            raise ValueError("No match found when setting `actual_instance` in LLMToolFilterFilterInner with oneOf schemas: LLMToolFilterFilterInnerOneOf, str. Details: " + ", ".join(error_messages))
         else:
             return v
 
     @classmethod
-    def from_dict(cls, obj: Union[str, dict[str, Any]]) -> Self:
+    def from_dict(cls, obj: Union[str, Dict[str, Any]]) -> Self:
         return cls.from_json(json.dumps(obj))
 
     @classmethod
@@ -127,16 +106,10 @@ class LLMToolFilterFilterInner(BaseModel):
 
         if match > 1:
             # more than 1 match
-            raise ValueError(
-                "Multiple matches found when deserializing the JSON string into LLMToolFilterFilterInner with oneOf schemas: LLMToolFilterFilterInnerOneOf, str. Details: "
-                + ", ".join(error_messages)
-            )
+            raise ValueError("Multiple matches found when deserializing the JSON string into LLMToolFilterFilterInner with oneOf schemas: LLMToolFilterFilterInnerOneOf, str. Details: " + ", ".join(error_messages))
         elif match == 0:
             # no match
-            raise ValueError(
-                "No match found when deserializing the JSON string into LLMToolFilterFilterInner with oneOf schemas: LLMToolFilterFilterInnerOneOf, str. Details: "
-                + ", ".join(error_messages)
-            )
+            raise ValueError("No match found when deserializing the JSON string into LLMToolFilterFilterInner with oneOf schemas: LLMToolFilterFilterInnerOneOf, str. Details: " + ", ".join(error_messages))
         else:
             return instance
 
@@ -145,23 +118,17 @@ class LLMToolFilterFilterInner(BaseModel):
         if self.actual_instance is None:
             return "null"
 
-        if hasattr(self.actual_instance, "to_json") and callable(
-            self.actual_instance.to_json
-        ):
+        if hasattr(self.actual_instance, "to_json") and callable(self.actual_instance.to_json):
             return self.actual_instance.to_json()
         else:
             return json.dumps(self.actual_instance)
 
-    def to_dict(
-        self,
-    ) -> Optional[Union[dict[str, Any], LLMToolFilterFilterInnerOneOf, str]]:
+    def to_dict(self) -> Optional[Union[Dict[str, Any], LLMToolFilterFilterInnerOneOf, str]]:
         """Returns the dict representation of the actual instance"""
         if self.actual_instance is None:
             return None
 
-        if hasattr(self.actual_instance, "to_dict") and callable(
-            self.actual_instance.to_dict
-        ):
+        if hasattr(self.actual_instance, "to_dict") and callable(self.actual_instance.to_dict):
             return self.actual_instance.to_dict()
         else:
             # primitive type
@@ -170,3 +137,5 @@ class LLMToolFilterFilterInner(BaseModel):
     def to_str(self) -> str:
         """Returns the string representation of the actual instance"""
         return pprint.pformat(self.model_dump())
+
+

_mcp_mesh/generated/mcp_mesh_registry_client/models/llm_tool_filter_filter_inner_one_of.py

@@ -1,38 +1,37 @@
+# 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
-
+from typing import Any, ClassVar, Dict, List, Optional
+from typing_extensions import Annotated
+from typing import Optional, Set
+from typing_extensions import Self
 
 class LLMToolFilterFilterInnerOneOf(BaseModel):
     """
     Rich filter with capability, tags, and version
-    """  # noqa: E501
-
-    capability: Annotated[str, Field(min_length=1, strict=True)] = Field(
-        description="Capability name to match"
-    )
-    tags: Optional[list[StrictStr]] = Field(
-        default=None, description="Tags for tag-based filtering (subset matching)"
-    )
+    """ # noqa: E501
+    capability: Annotated[str, Field(min_length=1, strict=True)] = Field(description="Capability name to match")
+    tags: Optional[List[StrictStr]] = Field(default=None, description="Tags for tag-based filtering (subset matching)")
     version: Optional[StrictStr] = Field(default=None, description="Version constraint")
-    __properties: ClassVar[list[str]] = ["capability", "tags", "version"]
+    __properties: ClassVar[List[str]] = ["capability", "tags", "version"]
 
     model_config = ConfigDict(
         populate_by_name=True,
@@ -40,6 +39,7 @@ class LLMToolFilterFilterInnerOneOf(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))
@@ -54,7 +54,7 @@ class LLMToolFilterFilterInnerOneOf(BaseModel):
         """Create an instance of LLMToolFilterFilterInnerOneOf 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
@@ -64,7 +64,8 @@ class LLMToolFilterFilterInnerOneOf(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,
@@ -74,7 +75,7 @@ class LLMToolFilterFilterInnerOneOf(BaseModel):
         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 LLMToolFilterFilterInnerOneOf from a dict"""
         if obj is None:
             return None
@@ -82,11 +83,11 @@ class LLMToolFilterFilterInnerOneOf(BaseModel):
         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"),
-            }
-        )
+        _obj = cls.model_validate({
+            "capability": obj.get("capability"),
+            "tags": obj.get("tags"),
+            "version": obj.get("version")
+        })
         return _obj
+
+

_mcp_mesh/generated/mcp_mesh_registry_client/models/llm_tool_info.py

@@ -1,60 +1,42 @@
+# 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
-
+from typing import Any, ClassVar, Dict, List, Optional
+from typing_extensions import Annotated
+from typing import Optional, Set
+from typing_extensions import Self
 
 class LLMToolInfo(BaseModel):
     """
-    Complete tool information for LLM consumption. Includes everything an LLM needs to understand and call the tool via MCP protocol.
-    """  # noqa: E501
-
-    name: Annotated[str, Field(min_length=1, strict=True)] = Field(
-        description="Function name (MCP protocol level)"
-    )
-    capability: Annotated[str, Field(min_length=1, strict=True)] = Field(
-        description="Capability name this tool provides"
-    )
-    description: StrictStr = Field(
-        description="Human-readable tool description for LLM context"
-    )
-    input_schema: dict[str, Any] = Field(
-        description="JSON Schema for tool parameters (MCP format). LLM uses this to understand required and optional parameters. ",
-        alias="inputSchema",
-    )
-    tags: Optional[list[StrictStr]] = Field(default=None, description="Capability tags")
-    version: Optional[StrictStr] = Field(default="1.0.0", description="Tool version")
+    Complete tool information for LLM consumption. Includes everything an LLM needs to understand and call the tool via MCP protocol. 
+    """ # noqa: E501
+    name: Annotated[str, Field(min_length=1, strict=True)] = Field(description="Function name (MCP protocol level)")
+    capability: Annotated[str, Field(min_length=1, strict=True)] = Field(description="Capability name this tool provides")
+    description: StrictStr = Field(description="Human-readable tool description for LLM context")
+    input_schema: Dict[str, Any] = Field(description="JSON Schema for tool parameters (MCP format). LLM uses this to understand required and optional parameters. ", alias="inputSchema")
+    tags: Optional[List[StrictStr]] = Field(default=None, description="Capability tags")
+    version: Optional[StrictStr] = Field(default='1.0.0', description="Tool version")
     endpoint: StrictStr = Field(description="Agent endpoint for MCP protocol calls")
-    kwargs: Optional[dict[str, Any]] = Field(
-        default=None,
-        description="Proxy configuration for tool execution (timeout, retry, streaming, etc.). Passed to UnifiedMCPProxy for enhanced client behavior. ",
-    )
-    __properties: ClassVar[list[str]] = [
-        "name",
-        "capability",
-        "description",
-        "inputSchema",
-        "tags",
-        "version",
-        "endpoint",
-        "kwargs",
-    ]
+    kwargs: Optional[Dict[str, Any]] = Field(default=None, description="Proxy configuration for tool execution (timeout, retry, streaming, etc.). Passed to UnifiedMCPProxy for enhanced client behavior. ")
+    __properties: ClassVar[List[str]] = ["name", "capability", "description", "inputSchema", "tags", "version", "endpoint", "kwargs"]
 
     model_config = ConfigDict(
         populate_by_name=True,
@@ -62,6 +44,7 @@ class LLMToolInfo(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))
@@ -76,7 +59,7 @@ class LLMToolInfo(BaseModel):
         """Create an instance of LLMToolInfo 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
@@ -86,7 +69,8 @@ class LLMToolInfo(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,
@@ -96,7 +80,7 @@ class LLMToolInfo(BaseModel):
         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 LLMToolInfo from a dict"""
         if obj is None:
             return None
@@ -104,18 +88,16 @@ class LLMToolInfo(BaseModel):
         if not isinstance(obj, dict):
             return cls.model_validate(obj)
 
-        _obj = cls.model_validate(
-            {
-                "name": obj.get("name"),
-                "capability": obj.get("capability"),
-                "description": obj.get("description"),
-                "inputSchema": obj.get("inputSchema"),
-                "tags": obj.get("tags"),
-                "version": (
-                    obj.get("version") if obj.get("version") is not None else "1.0.0"
-                ),
-                "endpoint": obj.get("endpoint"),
-                "kwargs": obj.get("kwargs"),
-            }
-        )
+        _obj = cls.model_validate({
+            "name": obj.get("name"),
+            "capability": obj.get("capability"),
+            "description": obj.get("description"),
+            "inputSchema": obj.get("inputSchema"),
+            "tags": obj.get("tags"),
+            "version": obj.get("version") if obj.get("version") is not None else '1.0.0',
+            "endpoint": obj.get("endpoint"),
+            "kwargs": obj.get("kwargs")
+        })
         return _obj
+
+

_mcp_mesh/generated/mcp_mesh_registry_client/models/mesh_agent_registration.py

@@ -1,89 +1,60 @@
+# 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 datetime import datetime
-from typing import Annotated, Any, ClassVar, Dict, List, Optional, Self, Set
+import json
 
+from datetime import datetime
 from pydantic import BaseModel, ConfigDict, Field, StrictInt, StrictStr, field_validator
-
-from _mcp_mesh.generated.mcp_mesh_registry_client.models.mesh_tool_registration import (
-    MeshToolRegistration,
-)
-
+from typing import Any, ClassVar, Dict, List, Optional
+from typing_extensions import Annotated
+from _mcp_mesh.generated.mcp_mesh_registry_client.models.mesh_tool_registration import MeshToolRegistration
+from typing import Optional, Set
+from typing_extensions import Self
 
 class MeshAgentRegistration(BaseModel):
     """
-    Service registration request with flattened structure. Used by both /agents/register and /heartbeat endpoints. Supports both agents (agent_type=mcp_agent) and API services (agent_type=api).
-    """  # noqa: E501
-
-    agent_id: Annotated[str, Field(min_length=1, strict=True, max_length=64)] = Field(
-        description="Unique identifier for the agent"
-    )
-    agent_type: Optional[StrictStr] = Field(
-        default="mcp_agent",
-        description="Type of service - mcp_agent provides capabilities, api consumes them",
-    )
-    name: Optional[Annotated[str, Field(min_length=1, strict=True, max_length=64)]] = (
-        Field(
-            default=None, description="Human-readable agent name (defaults to agent_id)"
-        )
-    )
-    version: Optional[StrictStr] = Field(default="1.0.0", description="Agent version")
-    http_host: Optional[StrictStr] = Field(
-        default="0.0.0.0", description="HTTP host for agent endpoint"
-    )
-    http_port: Optional[StrictInt] = Field(
-        default=0, description="HTTP port for agent endpoint (0 for stdio)"
-    )
-    timestamp: Optional[datetime] = Field(
-        default=None, description="Registration/heartbeat timestamp"
-    )
-    namespace: Optional[StrictStr] = Field(
-        default="default", description="Agent namespace for organization"
-    )
-    tools: Annotated[list[MeshToolRegistration], Field(min_length=1)] = Field(
-        description="Array of tools provided by this agent (@mesh.tool functions). Tools can optionally include llm_filter if decorated with @mesh.llm. "
-    )
-    __properties: ClassVar[list[str]] = [
-        "agent_id",
-        "agent_type",
-        "name",
-        "version",
-        "http_host",
-        "http_port",
-        "timestamp",
-        "namespace",
-        "tools",
-    ]
-
-    @field_validator("agent_id")
+    Service registration request with flattened structure. Used by both /agents/register and /heartbeat endpoints. Supports both agents (agent_type=mcp_agent) and API services (agent_type=api). 
+    """ # noqa: E501
+    agent_id: Annotated[str, Field(min_length=1, strict=True, max_length=64)] = Field(description="Unique identifier for the agent")
+    agent_type: Optional[StrictStr] = Field(default='mcp_agent', description="Type of service - mcp_agent provides capabilities, api consumes them")
+    name: Optional[Annotated[str, Field(min_length=1, strict=True, max_length=64)]] = Field(default=None, description="Human-readable agent name (defaults to agent_id)")
+    version: Optional[StrictStr] = Field(default='1.0.0', description="Agent version")
+    http_host: Optional[StrictStr] = Field(default='0.0.0.0', description="HTTP host for agent endpoint")
+    http_port: Optional[StrictInt] = Field(default=0, description="HTTP port for agent endpoint (0 for stdio)")
+    timestamp: Optional[datetime] = Field(default=None, description="Registration/heartbeat timestamp")
+    namespace: Optional[StrictStr] = Field(default='default', description="Agent namespace for organization")
+    tools: Annotated[List[MeshToolRegistration], Field(min_length=1)] = Field(description="Array of tools provided by this agent (@mesh.tool functions). Tools can optionally include llm_filter if decorated with @mesh.llm. ")
+    __properties: ClassVar[List[str]] = ["agent_id", "agent_type", "name", "version", "http_host", "http_port", "timestamp", "namespace", "tools"]
+
+    @field_validator('agent_id')
     def agent_id_validate_regular_expression(cls, value):
         """Validates the regular expression"""
         if not re.match(r"^[a-zA-Z0-9_-]+$", value):
             raise ValueError(r"must validate the regular expression /^[a-zA-Z0-9_-]+$/")
         return value
 
-    @field_validator("agent_type")
+    @field_validator('agent_type')
     def agent_type_validate_enum(cls, value):
         """Validates the enum"""
         if value is None:
             return value
 
-        if value not in set(["mcp_agent", "api"]):
+        if value not in set(['mcp_agent', 'api']):
             raise ValueError("must be one of enum values ('mcp_agent', 'api')")
         return value
 
@@ -93,6 +64,7 @@ class MeshAgentRegistration(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))
@@ -107,7 +79,7 @@ class MeshAgentRegistration(BaseModel):
         """Create an instance of MeshAgentRegistration 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
@@ -117,7 +89,8 @@ class MeshAgentRegistration(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,
@@ -130,11 +103,11 @@ class MeshAgentRegistration(BaseModel):
             for _item_tools in self.tools:
                 if _item_tools:
                     _items.append(_item_tools.to_dict())
-            _dict["tools"] = _items
+            _dict['tools'] = _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 MeshAgentRegistration from a dict"""
         if obj is None:
             return None
@@ -142,37 +115,17 @@ class MeshAgentRegistration(BaseModel):
         if not isinstance(obj, dict):
             return cls.model_validate(obj)
 
-        _obj = cls.model_validate(
-            {
-                "agent_id": obj.get("agent_id"),
-                "agent_type": (
-                    obj.get("agent_type")
-                    if obj.get("agent_type") is not None
-                    else "mcp_agent"
-                ),
-                "name": obj.get("name"),
-                "version": (
-                    obj.get("version") if obj.get("version") is not None else "1.0.0"
-                ),
-                "http_host": (
-                    obj.get("http_host")
-                    if obj.get("http_host") is not None
-                    else "0.0.0.0"
-                ),
-                "http_port": (
-                    obj.get("http_port") if obj.get("http_port") is not None else 0
-                ),
-                "timestamp": obj.get("timestamp"),
-                "namespace": (
-                    obj.get("namespace")
-                    if obj.get("namespace") is not None
-                    else "default"
-                ),
-                "tools": (
-                    [MeshToolRegistration.from_dict(_item) for _item in obj["tools"]]
-                    if obj.get("tools") is not None
-                    else None
-                ),
-            }
-        )
+        _obj = cls.model_validate({
+            "agent_id": obj.get("agent_id"),
+            "agent_type": obj.get("agent_type") if obj.get("agent_type") is not None else 'mcp_agent',
+            "name": obj.get("name"),
+            "version": obj.get("version") if obj.get("version") is not None else '1.0.0',
+            "http_host": obj.get("http_host") if obj.get("http_host") is not None else '0.0.0.0',
+            "http_port": obj.get("http_port") if obj.get("http_port") is not None else 0,
+            "timestamp": obj.get("timestamp"),
+            "namespace": obj.get("namespace") if obj.get("namespace") is not None else 'default',
+            "tools": [MeshToolRegistration.from_dict(_item) for _item in obj["tools"]] if obj.get("tools") is not None else None
+        })
         return _obj
+
+