solace-agent-mesh 1.6.1__py3-none-any.whl → 1.13.2__py3-none-any.whl

solace_agent_mesh/gateway/http_sse/repository/repository_llm.txt

@@ -1,340 +0,0 @@
-## Quick Summary
-
-The repository directory implements the data access layer for the HTTP SSE gateway using the Repository pattern. It provides a clean separation between domain entities and database persistence through SQLAlchemy ORM models. The architecture consists of abstract interfaces, concrete implementations, domain entities with business logic, and SQLAlchemy models for database operations. The two main subdirectories (entities and models) work together to provide a complete data persistence solution for chat sessions, messages, tasks, feedback, and events.
-
-## Files and Subdirectories Overview
-
-**Direct files:**
-- `__init__.py` - Main package exports for repository interfaces, implementations, entities, and models
-- `interfaces.py` - Abstract repository interfaces defining data access contracts for sessions, messages, tasks, and feedback
-- `message_repository.py` - SQLAlchemy implementation of message data access operations
-- `session_repository.py` - SQLAlchemy implementation of session data access operations
-- `feedback_repository.py` - SQLAlchemy implementation of feedback data access operations
-- `task_repository.py` - SQLAlchemy implementation of task data access operations
-
-**Subdirectories:**
-- `entities/` - Domain entities with business logic for sessions, messages, tasks, feedback, and events
-- `models/` - SQLAlchemy ORM models for database persistence and schema definition
-
-## Developer API Reference
-
-### Direct Files
-
-#### __init__.py
-**Purpose:** Central package exports for all repository components
-**Import:** `from solace_agent_mesh.gateway.http_sse.repository import IMessageRepository, ISessionRepository, MessageRepository, SessionRepository, Session, Message, SessionHistory, Base, MessageModel, SessionModel`
-
-**Exports:**
-- `IMessageRepository` - Message repository interface
-- `ISessionRepository` - Session repository interface  
-- `MessageRepository` - Message repository implementation
-- `SessionRepository` - Session repository implementation
-- `Message` - Message domain entity
-- `Session` - Session domain entity
-- `SessionHistory` - Session with messages composite entity
-- `Base` - SQLAlchemy declarative base
-- `MessageModel` - SQLAlchemy message model
-- `SessionModel` - SQLAlchemy session model
-
-#### interfaces.py
-**Purpose:** Defines abstract repository interfaces for data access contracts
-**Import:** `from solace_agent_mesh.gateway.http_sse.repository.interfaces import ISessionRepository, IMessageRepository, ITaskRepository, IFeedbackRepository`
-
-**Classes:**
-- `ISessionRepository(ABC)` - Abstract interface for session data operations
-  - `find_by_user(user_id: UserId, pagination: PaginationInfo | None = None) -> list[Session]` - Find all sessions for a user
-  - `count_by_user(user_id: UserId) -> int` - Count total sessions for a user
-  - `find_user_session(session_id: SessionId, user_id: UserId) -> Session | None` - Find specific user session
-  - `save(session: Session) -> Session` - Save or update a session
-  - `delete(session_id: SessionId, user_id: UserId) -> bool` - Delete user session
-  - `find_user_session_with_messages(session_id: SessionId, user_id: UserId, pagination: PaginationInfo | None = None) -> tuple[Session, list[Message]] | None` - Find session with messages
-
-- `IMessageRepository(ABC)` - Abstract interface for message data operations
-  - `find_by_session(session_id: SessionId, pagination: PaginationInfo | None = None) -> list[Message]` - Find messages in session
-  - `save(message: Message) -> Message` - Save or update a message
-  - `delete_by_session(session_id: SessionId) -> bool` - Delete all session messages
-
-- `ITaskRepository(ABC)` - Abstract interface for task data operations
-  - `save_task(task: Task) -> Task` - Create or update a task
-  - `save_event(event: TaskEvent) -> TaskEvent` - Save a task event
-  - `find_by_id(task_id: str) -> Task | None` - Find a task by its ID
-  - `find_by_id_with_events(task_id: str) -> tuple[Task, list[TaskEvent]] | None` - Find a task with all its events
-  - `search(user_id: UserId, start_date: int | None = None, end_date: int | None = None, search_query: str | None = None, pagination: PaginationParams | None = None) -> list[Task]` - Search for tasks with filters
-  - `delete_tasks_older_than(cutoff_time_ms: int, batch_size: int) -> int` - Delete tasks older than cutoff time
-
-- `IFeedbackRepository(ABC)` - Abstract interface for feedback data operations
-  - `save(feedback: Feedback) -> Feedback` - Save feedback
-  - `delete_feedback_older_than(cutoff_time_ms: int, batch_size: int) -> int` - Delete feedback older than cutoff time
-
-#### message_repository.py
-**Purpose:** SQLAlchemy implementation of message repository interface
-**Import:** `from solace_agent_mesh.gateway.http_sse.repository.message_repository import MessageRepository`
-
-**Classes:**
-- `MessageRepository(IMessageRepository)` - SQLAlchemy message repository implementation
-  - `__init__(db: DBSession)` - Initialize with database session
-  - `find_by_session(session_id: SessionId, pagination: PaginationInfo | None = None) -> list[Message]` - Find messages in session with pagination
-  - `save(message: Message) -> Message` - Save or update message in database
-  - `delete_by_session(session_id: SessionId) -> bool` - Delete all messages in session
-  - `_convert_model_to_entity(model: MessageModel) -> Message` - Convert SQLAlchemy model to domain entity
-
-#### session_repository.py
-**Purpose:** SQLAlchemy implementation of session repository interface
-**Import:** `from solace_agent_mesh.gateway.http_sse.repository.session_repository import SessionRepository`
-
-**Classes:**
-- `SessionRepository(ISessionRepository)` - SQLAlchemy session repository implementation
-  - `__init__(db: DBSession)` - Initialize with database session
-  - `find_by_user(user_id: UserId, pagination: PaginationInfo | None = None) -> list[Session]` - Find user sessions with pagination
-  - `count_by_user(user_id: UserId) -> int` - Count total sessions for a user
-  - `find_user_session(session_id: SessionId, user_id: UserId) -> Session | None` - Find specific user session
-  - `save(session: Session) -> Session` - Save or update session in database
-  - `delete(session_id: SessionId, user_id: UserId) -> bool` - Delete user session
-  - `find_user_session_with_messages(session_id: SessionId, user_id: UserId, pagination: PaginationInfo | None = None) -> tuple[Session, list[Message]] | None` - Find session with messages
-  - `_message_model_to_entity(model: MessageModel) -> Message` - Convert message model to entity
-
-#### feedback_repository.py
-**Purpose:** SQLAlchemy implementation of feedback repository interface
-**Import:** `from solace_agent_mesh.gateway.http_sse.repository.feedback_repository import FeedbackRepository`
-
-**Classes:**
-- `FeedbackRepository(IFeedbackRepository)` - SQLAlchemy feedback repository implementation
-  - `__init__(db: DBSession)` - Initialize with database session
-  - `save(feedback: Feedback) -> Feedback` - Save feedback to database
-  - `delete_feedback_older_than(cutoff_time_ms: int, batch_size: int) -> int` - Delete feedback older than cutoff time using batch deletion
-  - `_model_to_entity(model: FeedbackModel) -> Feedback` - Convert SQLAlchemy model to domain entity
-
-#### task_repository.py
-**Purpose:** SQLAlchemy implementation of task repository interface
-**Import:** `from solace_agent_mesh.gateway.http_sse.repository.task_repository import TaskRepository`
-
-**Classes:**
-- `TaskRepository(ITaskRepository)` - SQLAlchemy task repository implementation
-  - `__init__(db: DBSession)` - Initialize with database session
-  - `save_task(task: Task) -> Task` - Create or update a task
-  - `save_event(event: TaskEvent) -> TaskEvent` - Save a task event
-  - `find_by_id(task_id: str) -> Task | None` - Find a task by its ID
-  - `find_by_id_with_events(task_id: str) -> tuple[Task, list[TaskEvent]] | None` - Find a task with all its events
-  - `search(user_id: UserId, start_date: int | None = None, end_date: int | None = None, search_query: str | None = None, pagination: PaginationParams | None = None) -> list[Task]` - Search for tasks with filters
-  - `delete_tasks_older_than(cutoff_time_ms: int, batch_size: int) -> int` - Delete tasks older than cutoff time using batch deletion
-  - `_task_model_to_entity(model: TaskModel) -> Task` - Convert SQLAlchemy task model to domain entity
-  - `_event_model_to_entity(model: TaskEventModel) -> TaskEvent` - Convert SQLAlchemy event model to domain entity
-
-### Subdirectory APIs
-
-#### entities/
-**Purpose:** Provides domain entities with business logic for sessions, messages, tasks, feedback, and events
-**Key Exports:** Message, Session, SessionHistory, Task, TaskEvent, Feedback
-**Import Examples:**
-```python
-from solace_agent_mesh.gateway.http_sse.repository.entities import Message, Session, SessionHistory, Task, TaskEvent, Feedback
-```
-
-#### models/
-**Purpose:** Provides SQLAlchemy ORM models for database persistence and schema definition
-**Key Exports:** Base, MessageModel, SessionModel, TaskModel, TaskEventModel, FeedbackModel
-**Import Examples:**
-```python
-from solace_agent_mesh.gateway.http_sse.repository.models import Base, MessageModel, SessionModel, TaskModel, TaskEventModel, FeedbackModel
-```
-
-## Complete Usage Guide
-
-### 1. Setting Up the Repository Layer
-
-```python
-from sqlalchemy import create_engine
-from sqlalchemy.orm import sessionmaker
-from solace_agent_mesh.gateway.http_sse.repository import (
-    Base, MessageRepository, SessionRepository, TaskRepository, FeedbackRepository
-)
-
-# Create database engine and session
-engine = create_engine("sqlite:///chat.db")
-Base.metadata.create_all(engine)
-Session = sessionmaker(bind=engine)
-db_session = Session()
-
-# Initialize repositories
-message_repo = MessageRepository(db_session)
-session_repo = SessionRepository(db_session)
-task_repo = TaskRepository(db_session)
-feedback_repo = FeedbackRepository(db_session)
-```
-
-### 2. Working with Sessions
-
-```python
-from solace_agent_mesh.gateway.http_sse.repository.entities import Session
-from solace_agent_mesh.gateway.http_sse.shared.types import PaginationInfo
-import time
-
-# Create a new session
-session = Session(
-    id="session_123",
-    user_id="user_456",
-    name="Customer Support Chat",
-    agent_id="agent_789",
-    created_time=int(time.time() * 1000)
-)
-
-# Save session
-saved_session = session_repo.save(session)
-
-# Find user sessions with pagination
-pagination = PaginationInfo(page=1, page_size=10)
-user_sessions = session_repo.find_by_user("user_456", pagination)
-
-# Count total sessions for user
-total_sessions = session_repo.count_by_user("user_456")
-
-# Find specific session
-found_session = session_repo.find_user_session("session_123", "user_456")
-
-# Update session
-if found_session:
-    found_session.update_name("Updated Chat Name")
-    session_repo.save(found_session)
-```
-
-### 3. Working with Messages
-
-```python
-from solace_agent_mesh.gateway.http_sse.repository.entities import Message
-from solace_agent_mesh.gateway.http_sse.shared.enums import SenderType, MessageType
-
-# Create a new message
-message = Message(
-    id="msg_123",
-    session_id="session_123",
-    message="Hello, how can I help you today?",
-    sender_type=SenderType.AGENT,
-    sender_name="Support Agent",
-    message_type=MessageType.TEXT,
-    created_time=int(time.time() * 1000)
-)
-
-# Validate and save message
-message.validate_message_content()
-saved_message = message_repo.save(message)
-
-# Find messages in session
-session_messages = message_repo.find_by_session("session_123", pagination)
-
-# Check message properties
-if message.is_from_agent():
-    print("Message from agent")
-```
-
-### 4. Working with Tasks and Events
-
-```python
-from solace_agent_mesh.gateway.http_sse.repository.entities import Task, TaskEvent
-
-# Create a new task
-task = Task(
-    id="task_123",
-    user_id="user_456",
-    start_time=int(time.time() * 1000),
-    status="in_progress",
-    initial_request_text="Help me with my order"
-)
-
-# Save task
-saved_task = task_repo.save_task(task)
-
-# Create task event
-event = TaskEvent(
-    id="event_123",
-    task_id="task_123",
-    user_id="user_456",
-    created_time=int(time.time() * 1000),
-    topic="task.status.changed",
-    direction="outbound",
-    payload={"status": "completed", "result": "success"}
-)
-
-# Save event
-saved_event = task_repo.save_event(event)
-
-# Find task with events
-result = task_repo.find_by_id_with_events("task_123")
-if result:
-    task, events = result
-    print(f"Task {task.id} has {len(events)} events")
-
-# Search tasks
-from solace_agent_mesh.gateway.http_sse.shared.types import PaginationParams
-pagination_params = PaginationParams(page=1, page_size=10)
-tasks = task_repo.search(
-    user_id="user_456",
-    search_query="order",
-    pagination=pagination_params
-)
-```
-
-### 5. Working with Feedback
-
-```python
-from solace_agent_mesh.gateway.http_sse.repository.entities import Feedback
-
-# Create feedback
-feedback = Feedback(
-    id="feedback_123",
-    session_id="session_123",
-    task_id="task_123",
-    user_id="user_456",
-    rating="up",
-    comment="Great service!",
-    created_time=int(time.time() * 1000)
-)
-
-# Save feedback
-saved_feedback = feedback_repo.save(feedback)
-```
-
-### 6. Working with Session History (Combined Operations)
-
-```python
-from solace_agent_mesh.gateway.http_sse.repository.entities import SessionHistory
-
-# Get session with messages in one operation
-result = session_repo.find_user_session_with_messages(
-    "session_123", "user_456", pagination
-)
-
-if result:
-    session, messages = result
-    
-    # Create session history object
-    history = SessionHistory(
-        session=session,
-        messages=messages,
-        total_message_count=len(messages)
-    )
-    
-    print(f"Session: {history.session.name}")
-    print(f"Messages: {len(history.messages)}")
-```
-
-### 7. Using Repository Interfaces for Dependency Injection
-
-```python
-from solace_agent_mesh.gateway.http_sse.repository.interfaces import (
-    ISessionRepository, IMessageRepository, ITaskRepository, IFeedbackRepository
-)
-
-class ChatService:
-    def __init__(
-        self, 
-        session_repo: ISessionRepository,
-        message_repo: IMessageRepository,
-        task_repo: ITaskRepository,
-        feedback_repo: IFeedbackRepository
-    ):
-        self.session_repo = session_repo
-        self.message_repo = message_repo
-        self.task_repo = task_repo
-        self.feedback_
-
-# content_hash: e4e822acd625d1acce1f4ea0721844e7428a9b110c9e73b6657b8d3adc8ed038

solace_agent_mesh/gateway/http_sse/routers/dto/dto_llm.txt

@@ -1,346 +0,0 @@
-# DEVELOPER GUIDE: dto
-
-## Quick Summary
-The `dto` directory contains Data Transfer Objects (DTOs) for API contract definition and validation in the HTTP SSE gateway. It's organized into two main subdirectories: `requests` for incoming API request validation using Pydantic models, and `responses` for structured API response formatting with automatic timestamp conversion. The DTOs primarily focus on session management operations and provide type-safe interfaces for API endpoints.
-
-## Files and Subdirectories Overview
-- **Direct files:** 
-  - `__init__.py` - Main module exports for requests and responses submodules
-- **Subdirectories:**
-  - `requests/` - Request DTOs for API endpoint validation (session CRUD operations)
-  - `responses/` - Response DTOs with automatic timestamp serialization and field aliasing
-
-## Developer API Reference
-
-### Direct Files
-
-#### __init__.py
-**Purpose:** Main entry point that exports the requests and responses submodules
-**Import:** `from solace_agent_mesh.gateway.http_sse.routers.dto import requests, responses`
-
-**Exports:**
-- `requests` - Module containing all request DTOs
-- `responses` - Module containing all response DTOs
-
-### Subdirectory APIs
-
-#### requests/
-**Purpose:** Provides Pydantic models for validating incoming API requests, specifically for session management operations
-**Key Exports:** GetSessionsRequest, GetSessionRequest, GetSessionHistoryRequest, UpdateSessionRequest, DeleteSessionRequest
-**Import Examples:**
-```python
-from solace_agent_mesh.gateway.http_sse.routers.dto.requests import (
-    GetSessionRequest,
-    GetSessionHistoryRequest,
-    UpdateSessionRequest
-)
-```
-
-#### responses/
-**Purpose:** Provides structured response DTOs with automatic timestamp conversion and field aliasing for API consistency
-**Key Exports:** MessageResponse, SessionResponse, SessionListResponse, BaseTimestampResponse
-**Import Examples:**
-```python
-from solace_agent_mesh.gateway.http_sse.routers.dto.responses import (
-    MessageResponse,
-    SessionResponse,
-    SessionListResponse
-)
-```
-
-## Complete Usage Guide
-
-### 1. Basic Imports and Setup
-
-```python
-# Import the main dto modules
-from solace_agent_mesh.gateway.http_sse.routers.dto import requests, responses
-
-# Or import specific DTOs directly
-from solace_agent_mesh.gateway.http_sse.routers.dto.requests import (
-    GetSessionRequest,
-    GetSessionHistoryRequest,
-    UpdateSessionRequest
-)
-from solace_agent_mesh.gateway.http_sse.routers.dto.responses import (
-    SessionResponse,
-    MessageResponse,
-    SessionListResponse
-)
-```
-
-### 2. Working with Request DTOs
-
-```python
-from solace_agent_mesh.gateway.http_sse.routers.dto.requests import (
-    GetSessionRequest,
-    GetSessionHistoryRequest,
-    UpdateSessionRequest
-)
-from pydantic import ValidationError
-
-# Create a request to get a specific session
-def get_session(session_id: str, user_id: str):
-    try:
-        request = GetSessionRequest(
-            session_id=session_id,
-            user_id=user_id
-        )
-        return request
-    except ValidationError as e:
-        print(f"Invalid request parameters: {e}")
-        return None
-
-# Create a request to get session history with pagination
-def get_session_history(session_id: str, user_id: str, page: int = 1, size: int = 20):
-    try:
-        request = GetSessionHistoryRequest(
-            session_id=session_id,
-            user_id=user_id,
-            pagination={"page": page, "size": size}
-        )
-        return request
-    except ValidationError as e:
-        print(f"Validation failed: {e}")
-        return None
-
-# Create a request to update session name
-def update_session_name(session_id: str, user_id: str, new_name: str):
-    try:
-        request = UpdateSessionRequest(
-            session_id=session_id,
-            user_id=user_id,
-            name=new_name  # Automatically validated (1-255 characters)
-        )
-        return request
-    except ValidationError as e:
-        print(f"Validation failed: {e}")
-        return None
-```
-
-### 3. Working with Response DTOs
-
-```python
-from solace_agent_mesh.gateway.http_sse.routers.dto.responses import (
-    SessionResponse,
-    MessageResponse,
-    SessionListResponse
-)
-from solace_agent_mesh.gateway.http_sse.shared.enums import MessageType, SenderType
-import time
-
-# Create session responses
-def create_session_response(session_data: dict) -> SessionResponse:
-    return SessionResponse(
-        id=session_data["id"],
-        user_id=session_data["user_id"],
-        name=session_data.get("name"),
-        agent_id=session_data.get("agent_id"),
-        created_time=int(time.time() * 1000),  # Current time in epoch ms
-        updated_time=session_data.get("updated_time")
-    )
-
-# Create message responses
-def create_message_response(message_data: dict) -> MessageResponse:
-    return MessageResponse(
-        id=message_data["id"],
-        session_id=message_data["session_id"],
-        message=message_data["message"],
-        sender_type=SenderType.USER,
-        sender_name=message_data["sender_name"],
-        message_type=MessageType.TEXT,
-        created_time=int(time.time() * 1000)
-    )
-
-# Create paginated session list responses
-def create_session_list_response(sessions: list, total: int) -> SessionListResponse:
-    session_responses = [create_session_response(session) for session in sessions]
-    return SessionListResponse(
-        sessions=session_responses,
-        pagination={"page": 1, "size": len(sessions), "total_pages": 1},
-        total_count=total
-    )
-```
-
-### 4. Complete API Endpoint Example
-
-```python
-from fastapi import APIRouter, HTTPException
-from solace_agent_mesh.gateway.http_sse.routers.dto.requests import (
-    GetSessionRequest,
-    GetSessionHistoryRequest,
-    UpdateSessionRequest
-)
-from solace_agent_mesh.gateway.http_sse.routers.dto.responses import (
-    SessionResponse,
-    MessageResponse,
-    SessionListResponse
-)
-
-router = APIRouter()
-
-@router.get("/sessions/{session_id}")
-async def get_session(session_id: str, user_id: str) -> SessionResponse:
-    """Get a specific session"""
-    
-    # Create and validate request DTO
-    request = GetSessionRequest(
-        session_id=session_id,
-        user_id=user_id
-    )
-    
-    # Fetch data (mock implementation)
-    session_data = fetch_session(request)
-    
-    # Return structured response with automatic timestamp conversion
-    return SessionResponse(
-        id=session_data["id"],
-        user_id=session_data["user_id"],
-        name=session_data["name"],
-        created_time=session_data["created_time"]
-    )
-
-@router.get("/sessions/{session_id}/history")
-async def get_session_history(
-    session_id: str,
-    user_id: str,
-    page: int = 1,
-    size: int = 20
-) -> list[MessageResponse]:
-    """Get session message history"""
-    
-    # Validate request using DTO
-    request = GetSessionHistoryRequest(
-        session_id=session_id,
-        user_id=user_id,
-        pagination={"page": page, "size": size}
-    )
-    
-    # Fetch messages (mock implementation)
-    messages_data = fetch_session_messages(request)
-    
-    # Return response DTOs with automatic field aliasing
-    return [
-        MessageResponse(
-            id=msg["id"],
-            session_id=msg["session_id"],
-            message=msg["message"],
-            sender_type=msg["sender_type"],
-            sender_name=msg["sender_name"],
-            message_type=msg["message_type"],
-            created_time=msg["created_time"]
-        )
-        for msg in messages_data
-    ]
-
-@router.put("/sessions/{session_id}")
-async def update_session(
-    session_id: str,
-    user_id: str,
-    name: str
-) -> SessionResponse:
-    """Update session name"""
-    
-    # Validate request using DTO
-    try:
-        request = UpdateSessionRequest(
-            session_id=session_id,
-            user_id=user_id,
-            name=name
-        )
-    except ValidationError as e:
-        raise HTTPException(status_code=400, detail=str(e))
-    
-    # Update session (mock implementation)
-    updated_session = update_session_in_db(request)
-    
-    # Return response DTO with automatic field aliasing
-    return SessionResponse(
-        id=updated_session["id"],
-        user_id=updated_session["user_id"],
-        name=updated_session["name"],
-        created_time=updated_session["created_time"],
-        updated_time=updated_session["updated_time"]
-    )
-```
-
-### 5. JSON Serialization with Automatic Timestamp Conversion
-
-```python
-from solace_agent_mesh.gateway.http_sse.routers.dto.responses import SessionResponse, MessageResponse
-from solace_agent_mesh.gateway.http_sse.shared.enums import MessageType, SenderType
-import json
-
-# Create a session response
-session = SessionResponse(
-    id="sess_123",
-    user_id="user_456",
-    name="My Session",
-    created_time=1640995200000,  # Epoch milliseconds
-    updated_time=1640995260000
-)
-
-# Automatic conversion to ISO strings in JSON output
-json_output = session.model_dump_json()
-print(json_output)
-# Output: {
-#   "id": "sess_123",
-#   "userId": "user_456",  # Note the camelCase aliasing
-#   "name": "My Session",
-#   "createdTime": "2022-01-01T00:00:00Z",  # Converted to ISO string
-#   "updatedTime": "2022-01-01T00:01:00Z"
-# }
-
-# Create a message response with field aliasing
-message = MessageResponse(
-    id="msg_789",
-    session_id="sess_123",
-    message="Hello world",
-    sender_type=SenderType.USER,
-    sender_name="John Doe",
-    message_type=MessageType.TEXT,
-    created_time=1640995200000
-)
-
-# Get dict with converted timestamps and aliased fields
-dict_output = message.model_dump()
-print(dict_output["sessionId"])  # "sess_123" (camelCase alias)
-print(dict_output["senderType"])  # SenderType.USER (camelCase alias)
-print(dict_output["createdTime"])  # "2022-01-01T00:00:00Z" (converted timestamp)
-```
-
-### 6. Custom Response Classes Using Base
-
-```python
-from solace_agent_mesh.gateway.http_sse.routers.dto.responses.base_responses import BaseTimestampResponse
-
-class CustomResponse(BaseTimestampResponse):
-    """Custom response with automatic timestamp handling"""
-    name: str
-    status: str
-    created_time: int
-    last_accessed: int | None = None
-    
-    class Config:
-        # Add field aliases if needed
-        alias_generator = lambda field_name: ''.join(
-            word.capitalize() if i > 0 else word 
-            for i, word in enumerate(field_name.split('_'))
-        )
-
-# Usage
-custom_response = CustomResponse(
-    name="Test Item",
-    status="active",
-    created_time=1640995200000,
-    last_accessed=1640995300000
-)
-
-# Automatic timestamp conversion in JSON
-json_data = custom_response.model_dump_json()
-# Fields like created_time become ISO strings automatically
-```
-
-This comprehensive guide shows how the `dto` directory provides a complete type-safe API contract system with automatic validation for requests and structured responses with timestamp conversion for the HTTP SSE gateway.
-
-# content_hash: 3bb29d4c46b962221fc3034560b7e0da75b5a41f7f8f4d4f25aecf26e10f83f5