Add relationships to server, start with task agents

[declan-scale]

Changes

• Base code to allow related objects to be fetched via the API
• Specifically allow GET task API routes to have their associated agents

[Copilot]

Pull Request Overview

This PR implements relationship loading functionality for the API, specifically enabling task endpoints to include associated agent data when requested via query parameters.

Key Changes:

• Added BaseModel.extract_sqlalchemy_relationships() validator to handle ORM relationship extraction
• Introduced TaskRelationships enum and relationships query parameter to task API endpoints
• Extended PostgresCRUDRepository with generic relationship loading support

Reviewed Changes

Copilot reviewed 10 out of 11 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
agentex/tests/unit/utils/test_model_utils.py	Comprehensive unit tests for SQLAlchemy relationship extraction functionality
agentex/tests/integration/api/tasks/test_tasks_api.py	Integration tests verifying task API endpoints correctly load and return agent relationships
agentex/src/utils/model_utils.py	Added SQLAlchemy relationship extraction validator to BaseModel
agentex/src/domain/use_cases/tasks_use_case.py	Updated task use case methods to accept and pass through relationships parameter
agentex/src/domain/services/task_service.py	Updated task service methods to accept and pass through relationships parameter
agentex/src/domain/repositories/task_repository.py	Configured TaskRepository with relationship loading support
agentex/src/domain/entities/tasks.py	Added TaskRelationships enum and configured TaskEntity to allow extra fields
agentex/src/api/schemas/tasks.py	Added TaskRelationships enum and TaskResponse schema with optional agents field
agentex/src/api/routes/tasks.py	Updated task endpoints to accept relationships query parameter and return TaskResponse
agentex/src/adapters/crud_store/adapter_postgres.py	Extended PostgresCRUDRepository with generic relationship loading infrastructure

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.