hostel-protocol-python 0.1.0__py3-none-any.whl

hostel_protocol/__init__.py

@@ -0,0 +1,76 @@
+"""hostel_protocol — Pydantic convenience layer for the Hostel protocol."""
+
+from hostel_protocol.converter import proto_to_pydantic, pydantic_to_proto
+from hostel_protocol.models import (
+    AIChatMessage,
+    ChatMessage,
+    ChatRequest,
+    ChatResponse,
+    CreateComponentRequest,
+    CreateComponentResponse,
+    CreateTaskRequest,
+    CreateTaskResponse,
+    DeleteComponentRequest,
+    DeleteComponentResponse,
+    DeleteTaskRequest,
+    DeleteTaskResponse,
+    GetComponentRequest,
+    GetComponentResponse,
+    GetTaskRequest,
+    GetTaskResponse,
+    HostelMessage,
+    HumanChatMessage,
+    ListAgentsRequest,
+    ListAgentsResponse,
+    ListComponentsRequest,
+    ListComponentsResponse,
+    ListTasksRequest,
+    ListTasksResponse,
+    TaskData,
+    ToolChatMessage,
+    UpdateComponentRequest,
+    UpdateComponentResponse,
+    UpdateTaskRequest,
+    UpdateTaskResponse,
+)
+
+__all__ = [
+    # Converter
+    "pydantic_to_proto",
+    "proto_to_pydantic",
+    # Chat
+    "HumanChatMessage",
+    "AIChatMessage",
+    "ToolChatMessage",
+    "ChatMessage",
+    "ChatRequest",
+    "ChatResponse",
+    # Agent
+    "ListAgentsRequest",
+    "ListAgentsResponse",
+    # Component
+    "CreateComponentRequest",
+    "CreateComponentResponse",
+    "GetComponentRequest",
+    "GetComponentResponse",
+    "ListComponentsRequest",
+    "ListComponentsResponse",
+    "UpdateComponentRequest",
+    "UpdateComponentResponse",
+    "DeleteComponentRequest",
+    "DeleteComponentResponse",
+    # Task
+    "TaskData",
+    "CreateTaskRequest",
+    "CreateTaskResponse",
+    "ListTasksRequest",
+    "ListTasksResponse",
+    "GetTaskRequest",
+    "GetTaskResponse",
+    "UpdateTaskRequest",
+    "UpdateTaskResponse",
+    "DeleteTaskRequest",
+    "DeleteTaskResponse",
+    # Envelope
+    "HostelMessage",
+]

hostel_protocol/converter.py

@@ -0,0 +1,368 @@
+"""Bidirectional converter between Pydantic models and Protobuf messages."""
+
+from __future__ import annotations
+
+from typing import Any
+
+from google.protobuf import struct_pb2, wrappers_pb2
+from google.protobuf.json_format import MessageToDict, ParseDict
+from google.protobuf.message import Message
+from hostel.protocol.v1 import (
+    agent_pb2,
+    chat_pb2,
+    component_pb2,
+    message_pb2,
+    task_pb2,
+)
+from pydantic import BaseModel
+
+from hostel_protocol import models
+
+# ---------------------------------------------------------------------------
+# Registry: Pydantic model class  <->  Protobuf message class
+# ---------------------------------------------------------------------------
+
+_PYDANTIC_TO_PROTO: dict[type[BaseModel], type[Message]] = {
+    # Chat
+    models.HumanChatMessage: chat_pb2.HumanChatMessage,
+    models.AIChatMessage: chat_pb2.AIChatMessage,
+    models.ToolChatMessage: chat_pb2.ToolChatMessage,
+    models.ChatMessage: chat_pb2.ChatMessage,
+    models.ChatRequest: chat_pb2.ChatRequest,
+    models.ChatResponse: chat_pb2.ChatResponse,
+    # Agent
+    models.ListAgentsRequest: agent_pb2.ListAgentsRequest,
+    models.ListAgentsResponse: agent_pb2.ListAgentsResponse,
+    # Component
+    models.CreateComponentRequest: component_pb2.CreateComponentRequest,
+    models.CreateComponentResponse: component_pb2.CreateComponentResponse,
+    models.GetComponentRequest: component_pb2.GetComponentRequest,
+    models.GetComponentResponse: component_pb2.GetComponentResponse,
+    models.ListComponentsRequest: component_pb2.ListComponentsRequest,
+    models.ListComponentsResponse: component_pb2.ListComponentsResponse,
+    models.UpdateComponentRequest: component_pb2.UpdateComponentRequest,
+    models.UpdateComponentResponse: component_pb2.UpdateComponentResponse,
+    models.DeleteComponentRequest: component_pb2.DeleteComponentRequest,
+    models.DeleteComponentResponse: component_pb2.DeleteComponentResponse,
+    # Task
+    models.TaskData: task_pb2.TaskData,
+    models.CreateTaskRequest: task_pb2.CreateTaskRequest,
+    models.CreateTaskResponse: task_pb2.CreateTaskResponse,
+    models.ListTasksRequest: task_pb2.ListTasksRequest,
+    models.ListTasksResponse: task_pb2.ListTasksResponse,
+    models.GetTaskRequest: task_pb2.GetTaskRequest,
+    models.GetTaskResponse: task_pb2.GetTaskResponse,
+    models.UpdateTaskRequest: task_pb2.UpdateTaskRequest,
+    models.UpdateTaskResponse: task_pb2.UpdateTaskResponse,
+    models.DeleteTaskRequest: task_pb2.DeleteTaskRequest,
+    models.DeleteTaskResponse: task_pb2.DeleteTaskResponse,
+    # Envelope
+    models.HostelMessage: message_pb2.HostelMessage,
+}
+
+_PROTO_TO_PYDANTIC: dict[type[Message], type[BaseModel]] = {v: k for k, v in _PYDANTIC_TO_PROTO.items()}
+
+# Fields in each proto that use google.protobuf.StringValue (nullable strings)
+_STRING_VALUE_FIELDS: dict[type[Message], set[str]] = {
+    task_pb2.TaskData: {"webhook_url", "status", "response", "created_at", "updated_at", "executed_at"},
+    task_pb2.CreateTaskRequest: {"webhook_url"},
+    task_pb2.UpdateTaskRequest: {"agent_name", "prompt", "start_datetime", "webhook_url", "status"},
+}
+
+# Fields that hold google.protobuf.Struct (dict[str, Any])
+_STRUCT_FIELDS: dict[type[Message], set[str]] = {
+    chat_pb2.ChatResponse: {"content"},
+    component_pb2.CreateComponentRequest: {"data"},
+    component_pb2.GetComponentResponse: {"data"},
+    component_pb2.UpdateComponentRequest: {"data"},
+    message_pb2.HostelMessage: {"meta", "system_payload", "generic_payload"},
+}
+
+# Fields that hold google.protobuf.Value
+_VALUE_FIELDS: dict[type[Message], set[str]] = {
+    chat_pb2.ChatResponse: {"content"},
+}
+
+# Fields that hold repeated sub-messages
+_REPEATED_MSG_FIELDS: dict[type[Message], dict[str, type[Message]]] = {
+    agent_pb2.ListAgentsResponse: {"agents": struct_pb2.Struct},
+    chat_pb2.ChatRequest: {"messages": chat_pb2.ChatMessage},
+    component_pb2.ListComponentsResponse: {"components": struct_pb2.Struct},
+    task_pb2.ListTasksResponse: {"tasks": task_pb2.TaskData},
+}
+
+# Fields that hold a single sub-message (non-oneof)
+_SUB_MSG_FIELDS: dict[type[Message], dict[str, type[Message]]] = {
+    task_pb2.CreateTaskResponse: {"task": task_pb2.TaskData},
+    task_pb2.GetTaskResponse: {"task": task_pb2.TaskData},
+    task_pb2.UpdateTaskResponse: {"task": task_pb2.TaskData},
+}
+
+# oneof groups: proto class -> {field_name: proto sub-message class}
+_ONEOF_FIELDS: dict[type[Message], dict[str, type[Message]]] = {
+    chat_pb2.ChatMessage: {
+        "human": chat_pb2.HumanChatMessage,
+        "ai": chat_pb2.AIChatMessage,
+        "tool": chat_pb2.ToolChatMessage,
+    },
+}
+
+# HostelMessage payload oneof (special handling due to breadth)
+_HOSTEL_MESSAGE_PAYLOAD_FIELDS: dict[str, type[Message]] = {
+    "agent_list_request": agent_pb2.ListAgentsRequest,
+    "agent_list_response": agent_pb2.ListAgentsResponse,
+    "system_payload": struct_pb2.Struct,
+    "chat_request": chat_pb2.ChatRequest,
+    "chat_response_chunk": chat_pb2.ChatResponse,
+    "task_create": task_pb2.CreateTaskRequest,
+    "task_create_response": task_pb2.CreateTaskResponse,
+    "task_list": task_pb2.ListTasksRequest,
+    "task_list_response": task_pb2.ListTasksResponse,
+    "task_get": task_pb2.GetTaskRequest,
+    "task_get_response": task_pb2.GetTaskResponse,
+    "task_update": task_pb2.UpdateTaskRequest,
+    "task_update_response": task_pb2.UpdateTaskResponse,
+    "task_delete": task_pb2.DeleteTaskRequest,
+    "task_delete_response": task_pb2.DeleteTaskResponse,
+    "component_create": component_pb2.CreateComponentRequest,
+    "component_create_response": component_pb2.CreateComponentResponse,
+    "component_get": component_pb2.GetComponentRequest,
+    "component_get_response": component_pb2.GetComponentResponse,
+    "component_list": component_pb2.ListComponentsRequest,
+    "component_list_response": component_pb2.ListComponentsResponse,
+    "component_update": component_pb2.UpdateComponentRequest,
+    "component_update_response": component_pb2.UpdateComponentResponse,
+    "component_delete": component_pb2.DeleteComponentRequest,
+    "component_delete_response": component_pb2.DeleteComponentResponse,
+    "generic_payload": struct_pb2.Struct,
+}
+
+
+# ---------------------------------------------------------------------------
+# Helpers
+# ---------------------------------------------------------------------------
+
+
+def _struct_to_dict(s: struct_pb2.Struct) -> dict[str, Any]:
+    return dict(MessageToDict(s))
+
+
+def _dict_to_struct(d: dict[str, Any]) -> struct_pb2.Struct:
+    s = struct_pb2.Struct()
+    s.update(d)
+    return s
+
+
+def _value_to_python(v: struct_pb2.Value) -> Any:
+    return MessageToDict(v)
+
+
+def _python_to_value(v: Any) -> struct_pb2.Value:
+    val = struct_pb2.Value()
+    if v is None:
+        val.null_value = 0  # type: ignore[assignment]
+    elif isinstance(v, bool):
+        val.bool_value = v
+    elif isinstance(v, (int, float)):
+        val.number_value = float(v)
+    elif isinstance(v, str):
+        val.string_value = v
+    elif isinstance(v, dict):
+        ParseDict(v, val.struct_value)
+    elif isinstance(v, list):
+        for item in v:
+            val.list_value.values.append(_python_to_value(item))
+    return val
+
+
+# ---------------------------------------------------------------------------
+# Pydantic  →  Protobuf
+# ---------------------------------------------------------------------------
+
+
+def pydantic_to_proto(model: BaseModel) -> Message:
+    """Convert a Pydantic model instance to the corresponding Protobuf message."""
+    proto_cls = _PYDANTIC_TO_PROTO.get(type(model))
+    if proto_cls is None:
+        raise TypeError(f"No protobuf mapping registered for {type(model).__name__}")
+    return _pydantic_to_proto_inner(model, proto_cls)
+
+
+def _pydantic_to_proto_inner(model: BaseModel, proto_cls: type[Message]) -> Message:
+    proto = proto_cls()
+    string_value_fields = _STRING_VALUE_FIELDS.get(proto_cls, set())
+    struct_fields = _STRUCT_FIELDS.get(proto_cls, set())
+    value_fields = _VALUE_FIELDS.get(proto_cls, set())
+    repeated_fields = _REPEATED_MSG_FIELDS.get(proto_cls, {})
+    sub_msg_fields = _SUB_MSG_FIELDS.get(proto_cls, {})
+    oneof_fields = _ONEOF_FIELDS.get(proto_cls, {})
+
+    # Special handling for HostelMessage payload oneof
+    is_envelope = proto_cls is message_pb2.HostelMessage
+
+    for field_name, value in model:
+        if value is None:
+            continue
+
+        # StringValue wrapper fields
+        if field_name in string_value_fields:
+            wrapper = wrappers_pb2.StringValue(value=value)
+            getattr(proto, field_name).CopyFrom(wrapper)
+
+        # google.protobuf.Value fields
+        elif field_name in value_fields:
+            getattr(proto, field_name).CopyFrom(_python_to_value(value))
+
+        # Struct fields (dict)
+        elif field_name in struct_fields:
+            if isinstance(value, dict):
+                getattr(proto, field_name).CopyFrom(_dict_to_struct(value))
+            # repeated Struct handled below
+
+        # Repeated Struct (list[dict])
+        elif field_name in repeated_fields and repeated_fields[field_name] is struct_pb2.Struct:
+            for item in value:
+                getattr(proto, field_name).append(_dict_to_struct(item))
+
+        # Repeated sub-messages
+        elif field_name in repeated_fields:
+            child_proto_cls = repeated_fields[field_name]
+            child_pydantic_cls = _PROTO_TO_PYDANTIC.get(child_proto_cls)
+            for item in value:
+                if child_pydantic_cls and isinstance(item, child_pydantic_cls):
+                    getattr(proto, field_name).append(_pydantic_to_proto_inner(item, child_proto_cls))
+
+        # Single sub-message fields
+        elif field_name in sub_msg_fields:
+            child_proto_cls = sub_msg_fields[field_name]
+            getattr(proto, field_name).CopyFrom(_pydantic_to_proto_inner(value, child_proto_cls))
+
+        # Oneof sub-message fields
+        elif field_name in oneof_fields:
+            child_proto_cls = oneof_fields[field_name]
+            getattr(proto, field_name).CopyFrom(_pydantic_to_proto_inner(value, child_proto_cls))
+
+        # HostelMessage payload oneof
+        elif is_envelope and field_name in _HOSTEL_MESSAGE_PAYLOAD_FIELDS:
+            child_proto_cls = _HOSTEL_MESSAGE_PAYLOAD_FIELDS[field_name]
+            if child_proto_cls is struct_pb2.Struct:
+                getattr(proto, field_name).CopyFrom(_dict_to_struct(value))
+            else:
+                child_pydantic_cls = _PROTO_TO_PYDANTIC.get(child_proto_cls)
+                if child_pydantic_cls and isinstance(value, child_pydantic_cls):
+                    getattr(proto, field_name).CopyFrom(_pydantic_to_proto_inner(value, child_proto_cls))
+
+        # Scalar fields
+        else:
+            setattr(proto, field_name, value)
+
+    return proto
+
+
+# ---------------------------------------------------------------------------
+# Protobuf  →  Pydantic
+# ---------------------------------------------------------------------------
+
+
+def proto_to_pydantic(proto: Message) -> BaseModel:
+    """Convert a Protobuf message to the corresponding Pydantic model."""
+    pydantic_cls = _PROTO_TO_PYDANTIC.get(type(proto))
+    if pydantic_cls is None:
+        raise TypeError(f"No pydantic mapping registered for {type(proto).__name__}")
+    return _proto_to_pydantic_inner(proto, pydantic_cls)
+
+
+def _proto_to_pydantic_inner(proto: Message, pydantic_cls: type[BaseModel]) -> BaseModel:
+    proto_cls = type(proto)
+    string_value_fields = _STRING_VALUE_FIELDS.get(proto_cls, set())
+    struct_fields = _STRUCT_FIELDS.get(proto_cls, set())
+    value_fields = _VALUE_FIELDS.get(proto_cls, set())
+    repeated_fields = _REPEATED_MSG_FIELDS.get(proto_cls, {})
+    sub_msg_fields = _SUB_MSG_FIELDS.get(proto_cls, {})
+    oneof_fields = _ONEOF_FIELDS.get(proto_cls, {})
+
+    is_envelope = proto_cls is message_pb2.HostelMessage
+
+    kwargs: dict[str, Any] = {}
+
+    for field_desc in proto.DESCRIPTOR.fields:
+        field_name = field_desc.name
+
+        # StringValue wrapper fields
+        if field_name in string_value_fields:
+            if proto.HasField(field_name):
+                kwargs[field_name] = getattr(proto, field_name).value
+            else:
+                kwargs[field_name] = None
+
+        # google.protobuf.Value fields
+        elif field_name in value_fields:
+            if proto.HasField(field_name):
+                kwargs[field_name] = _value_to_python(getattr(proto, field_name))
+            else:
+                kwargs[field_name] = None
+
+        # Struct fields (dict)
+        elif field_name in struct_fields and field_name not in repeated_fields:
+            if is_envelope and field_name in {"system_payload", "generic_payload"}:
+                # These are oneof payload members
+                if proto.HasField(field_name):
+                    kwargs[field_name] = _struct_to_dict(getattr(proto, field_name))
+                else:
+                    kwargs[field_name] = None
+            elif proto.HasField(field_name):
+                kwargs[field_name] = _struct_to_dict(getattr(proto, field_name))
+            else:
+                kwargs[field_name] = {}
+
+        # Repeated Struct (list[dict])
+        elif field_name in repeated_fields and repeated_fields[field_name] is struct_pb2.Struct:
+            kwargs[field_name] = [_struct_to_dict(item) for item in getattr(proto, field_name)]
+
+        # Repeated sub-messages
+        elif field_name in repeated_fields:
+            child_proto_cls = repeated_fields[field_name]
+            child_pydantic_cls = _PROTO_TO_PYDANTIC.get(child_proto_cls)
+            if child_pydantic_cls:
+                kwargs[field_name] = [
+                    _proto_to_pydantic_inner(item, child_pydantic_cls) for item in getattr(proto, field_name)
+                ]
+
+        # Single sub-message fields
+        elif field_name in sub_msg_fields:
+            if proto.HasField(field_name):
+                child_proto_cls = sub_msg_fields[field_name]
+                child_pydantic_cls = _PROTO_TO_PYDANTIC.get(child_proto_cls)
+                if child_pydantic_cls:
+                    kwargs[field_name] = _proto_to_pydantic_inner(getattr(proto, field_name), child_pydantic_cls)
+            else:
+                kwargs[field_name] = None
+
+        # Oneof sub-message fields
+        elif field_name in oneof_fields:
+            if proto.HasField(field_name):
+                child_proto_cls = oneof_fields[field_name]
+                child_pydantic_cls = _PROTO_TO_PYDANTIC.get(child_proto_cls)
+                if child_pydantic_cls:
+                    kwargs[field_name] = _proto_to_pydantic_inner(getattr(proto, field_name), child_pydantic_cls)
+            else:
+                kwargs[field_name] = None
+
+        # HostelMessage payload oneof
+        elif is_envelope and field_name in _HOSTEL_MESSAGE_PAYLOAD_FIELDS:
+            if proto.HasField(field_name):
+                child_proto_cls = _HOSTEL_MESSAGE_PAYLOAD_FIELDS[field_name]
+                if child_proto_cls is struct_pb2.Struct:
+                    kwargs[field_name] = _struct_to_dict(getattr(proto, field_name))
+                else:
+                    child_pydantic_cls = _PROTO_TO_PYDANTIC.get(child_proto_cls)
+                    if child_pydantic_cls:
+                        kwargs[field_name] = _proto_to_pydantic_inner(getattr(proto, field_name), child_pydantic_cls)
+            else:
+                kwargs[field_name] = None
+
+        # Scalar fields
+        else:
+            kwargs[field_name] = getattr(proto, field_name)
+
+    return pydantic_cls(**kwargs)

hostel_protocol/models.py

@@ -0,0 +1,267 @@
+"""Pydantic models mirroring the Hostel protocol protobuf definitions."""
+
+from __future__ import annotations
+
+from typing import Any
+
+from pydantic import BaseModel, ConfigDict
+
+# ---------------------------------------------------------------------------
+# Chat
+# ---------------------------------------------------------------------------
+
+
+class HumanChatMessage(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+    content: str
+
+
+class AIChatMessage(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+    content: str
+
+
+class ToolChatMessage(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+    content: str
+    tool_name: str
+
+
+class ChatMessage(BaseModel):
+    """Wrapper matching the protobuf ``oneof message`` in ``ChatMessage``."""
+
+    model_config = ConfigDict(populate_by_name=True)
+    human: HumanChatMessage | None = None
+    ai: AIChatMessage | None = None
+    tool: ToolChatMessage | None = None
+
+
+class ChatRequest(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+    agent_name: str
+    messages: list[ChatMessage] = []
+
+
+class ChatResponse(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+    role: str = ""
+    scope: str = ""
+    content: Any = None
+
+
+# ---------------------------------------------------------------------------
+# Agent
+# ---------------------------------------------------------------------------
+
+
+class ListAgentsRequest(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+
+class ListAgentsResponse(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+    agents: list[dict[str, Any]] = []
+
+
+# ---------------------------------------------------------------------------
+# Component
+# ---------------------------------------------------------------------------
+
+
+class CreateComponentRequest(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+    component_type: str
+    data: dict[str, Any] = {}
+
+
+class CreateComponentResponse(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+    component_type: str = ""
+    name: str = ""
+    success: bool = False
+
+
+class GetComponentRequest(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+    component_type: str
+    name: str
+
+
+class GetComponentResponse(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+    component_type: str = ""
+    data: dict[str, Any] = {}
+
+
+class ListComponentsRequest(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+    component_type: str
+
+
+class ListComponentsResponse(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+    component_type: str = ""
+    components: list[dict[str, Any]] = []
+
+
+class UpdateComponentRequest(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+    component_type: str
+    name: str
+    data: dict[str, Any] = {}
+
+
+class UpdateComponentResponse(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+    component_type: str = ""
+    name: str = ""
+    success: bool = False
+
+
+class DeleteComponentRequest(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+    component_type: str
+    name: str
+
+
+class DeleteComponentResponse(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+    component_type: str = ""
+    name: str = ""
+    success: bool = False
+
+
+# ---------------------------------------------------------------------------
+# Task
+# ---------------------------------------------------------------------------
+
+
+class TaskData(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+    id: str = ""
+    agent_name: str = ""
+    prompt: str = ""
+    start_datetime: str = ""
+    webhook_url: str | None = None
+    status: str | None = None
+    response: str | None = None
+    created_at: str | None = None
+    updated_at: str | None = None
+    executed_at: str | None = None
+
+
+class CreateTaskRequest(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+    agent_name: str
+    prompt: str
+    start_datetime: str
+    webhook_url: str | None = None
+
+
+class CreateTaskResponse(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+    task: TaskData | None = None
+
+
+class ListTasksRequest(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+
+class ListTasksResponse(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+    tasks: list[TaskData] = []
+
+
+class GetTaskRequest(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+    task_id: str
+
+
+class GetTaskResponse(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+    task: TaskData | None = None
+
+
+class UpdateTaskRequest(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+    task_id: str
+    agent_name: str | None = None
+    prompt: str | None = None
+    start_datetime: str | None = None
+    webhook_url: str | None = None
+    status: str | None = None
+
+
+class UpdateTaskResponse(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+    task: TaskData | None = None
+
+
+class DeleteTaskRequest(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+    task_id: str
+
+
+class DeleteTaskResponse(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+    success: bool = False
+
+
+# ---------------------------------------------------------------------------
+# Envelope  (HostelMessage)
+# ---------------------------------------------------------------------------
+
+
+class HostelMessage(BaseModel):
+    """Unified envelope mirroring ``hostel.protocol.v1.HostelMessage``.
+
+    The ``oneof payload`` is modelled as a set of optional fields – exactly one
+    should be set at a time, matching the protobuf semantics.
+    """
+
+    model_config = ConfigDict(populate_by_name=True)
+
+    # Header
+    version: str = ""
+    id: str = ""
+    type: str = ""
+    action: str = ""
+    meta: dict[str, Any] = {}
+
+    # oneof payload – Agent
+    agent_list_request: ListAgentsRequest | None = None
+    agent_list_response: ListAgentsResponse | None = None
+
+    # oneof payload – System
+    system_payload: dict[str, Any] | None = None
+
+    # oneof payload – Chat
+    chat_request: ChatRequest | None = None
+    chat_response_chunk: ChatResponse | None = None
+
+    # oneof payload – Task
+    task_create: CreateTaskRequest | None = None
+    task_create_response: CreateTaskResponse | None = None
+    task_list: ListTasksRequest | None = None
+    task_list_response: ListTasksResponse | None = None
+    task_get: GetTaskRequest | None = None
+    task_get_response: GetTaskResponse | None = None
+    task_update: UpdateTaskRequest | None = None
+    task_update_response: UpdateTaskResponse | None = None
+    task_delete: DeleteTaskRequest | None = None
+    task_delete_response: DeleteTaskResponse | None = None
+
+    # oneof payload – Component
+    component_create: CreateComponentRequest | None = None
+    component_create_response: CreateComponentResponse | None = None
+    component_get: GetComponentRequest | None = None
+    component_get_response: GetComponentResponse | None = None
+    component_list: ListComponentsRequest | None = None
+    component_list_response: ListComponentsResponse | None = None
+    component_update: UpdateComponentRequest | None = None
+    component_update_response: UpdateComponentResponse | None = None
+    component_delete: DeleteComponentRequest | None = None
+    component_delete_response: DeleteComponentResponse | None = None
+
+    # oneof payload – Generic
+    generic_payload: dict[str, Any] | None = None

hostel_protocol_python-0.1.0.dist-info/METADATA

@@ -0,0 +1,16 @@
+Metadata-Version: 2.4
+Name: hostel-protocol-python
+Version: 0.1.0
+Summary: Pydantic convenience layer for the Hostel protocol
+Requires-Python: >=3.12
+Requires-Dist: hostel-protocol>=0.1.0
+Requires-Dist: protobuf>=7.0
+Requires-Dist: pydantic>=2.5.0
+Provides-Extra: dev
+Requires-Dist: black; extra == 'dev'
+Requires-Dist: mypy; extra == 'dev'
+Requires-Dist: pytest; extra == 'dev'
+Requires-Dist: pytest-asyncio; extra == 'dev'
+Requires-Dist: pytest-cov; extra == 'dev'
+Requires-Dist: ruff; extra == 'dev'
+Requires-Dist: types-protobuf; extra == 'dev'

hostel_protocol_python-0.1.0.dist-info/RECORD

@@ -0,0 +1,6 @@
+hostel_protocol/__init__.py,sha256=ctRJ5Y8Yf1hZlm1QXLViBpc_kKaoPCnETb2T2bSHpyM,1795
+hostel_protocol/converter.py,sha256=qwoJE6NFrpcefm8UQdVIFCdvcF99f4lc5aghdIDy4sc,15593
+hostel_protocol/models.py,sha256=AIOuY7Vmz0YVQeZmQNBw9gD3ZFn-3Uc0ZS1dlmbWcmc,7520
+hostel_protocol_python-0.1.0.dist-info/METADATA,sha256=LCwCwkTkp-DScHHMSbX6EXi36KOJ0xUIFvGA9wA8Ym8,549
+hostel_protocol_python-0.1.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+hostel_protocol_python-0.1.0.dist-info/RECORD,,

hostel_protocol_python-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any