tasklert-api / src /api /chat.py
hashir-qt's picture
initial deploy
507973e
Raw History Blame Contribute Delete
6.79 kB
"""POST /chat — stateless AI-chatbot endpoint.
Task Reference: T011, T012, T013 - Extended for multi-provider support
"""
from typing import Annotated
from agents import Runner
from fastapi import APIRouter, Depends, Header, HTTPException, status
from pydantic import BaseModel, Field
from sqlalchemy.ext.asyncio import AsyncSession
from sqlmodel import select
from ..core.database import get_session
from ..core.better_auth import get_current_user_from_session
from ..core.config import settings
from ..core.logging import get_logger
from ..models.conversation import Message
from ..core.providers import ProviderName
from ..services import chat_service
from ..services.agent_service import todo_agent
from ..services.router import ProviderRouter
logger = get_logger(__name__)
# Initialize router with policy from config
provider_router = ProviderRouter(
policy=settings.routing_policy, # type: ignore
default_provider=settings.default_provider, # type: ignore
)
router = APIRouter(prefix="/chat", tags=["Chat"])
# ---------------------------------------------------------------------------
# Request / Response DTOs
# ---------------------------------------------------------------------------
class ChatRequest(BaseModel):
conversation_id: int | None = None
message: str = Field(..., min_length=1, max_length=4000)
provider: ProviderName | None = None # T011: optional provider selection
class ChatResponse(BaseModel):
conversation_id: int
response: str
tool_calls: list[str]
provider: str # T012: which provider handled request
# ---------------------------------------------------------------------------
# Endpoints
# ---------------------------------------------------------------------------
@router.get("/conversations")
async def list_conversations(
authorization: Annotated[str | None, Header()] = None,
cookie: Annotated[str | None, Header()] = None,
session: AsyncSession = Depends(get_session),
):
"""List all conversations for the current user, newest first, with first-message preview."""
user = await get_current_user_from_session(authorization, cookie, session)
convs = await chat_service.list_conversations(session, user.id)
# Fetch first user message per conversation in one query
conv_ids = [c.id for c in convs]
first_msg_map: dict[int, str] = {}
if conv_ids:
result = await session.execute(
select(Message)
.where(Message.conversation_id.in_(conv_ids), Message.role == "user")
.order_by(Message.conversation_id, Message.created_at.asc())
)
for m in result.scalars().all():
if m.conversation_id not in first_msg_map:
first_msg_map[m.conversation_id] = m.content
return [
{
"id": c.id,
"created_at": c.created_at.isoformat(),
"updated_at": c.updated_at.isoformat(),
"title": (first_msg_map.get(c.id) or "")[:60] or f"Chat #{c.id}",
}
for c in convs
]
@router.get("/conversations/{conversation_id}")
async def get_conversation_messages(
conversation_id: int,
authorization: Annotated[str | None, Header()] = None,
cookie: Annotated[str | None, Header()] = None,
session: AsyncSession = Depends(get_session),
):
"""Fetch all messages for a conversation."""
user = await get_current_user_from_session(authorization, cookie, session)
conv = await chat_service.get_conversation(session, conversation_id, user.id)
if conv is None:
raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail="Conversation not found")
messages = await chat_service.get_history(session, conversation_id)
return {
"id": conv.id,
"created_at": conv.created_at.isoformat(),
"messages": [
{"id": m.id, "role": m.role, "content": m.content, "created_at": m.created_at.isoformat()}
for m in messages
],
}
@router.post("", response_model=ChatResponse)
async def send_chat_message(
data: ChatRequest,
authorization: Annotated[str | None, Header()] = None,
cookie: Annotated[str | None, Header()] = None,
session: AsyncSession = Depends(get_session),
):
"""Stateless 9-step request cycle: auth → conversation → history → agent → persist → return."""
# 1. Authenticate
user = await get_current_user_from_session(authorization, cookie, session)
logger.info("Chat request: user_id=%s conversation_id=%s", user.id, data.conversation_id)
# 2. Resolve conversation
if data.conversation_id is None:
conv = await chat_service.create_conversation(session, user.id)
cid = conv.id
else:
conv = await chat_service.get_conversation(session, data.conversation_id, user.id)
if conv is None:
raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail="Conversation not found")
cid = conv.id
# 3. Fetch history (for logging / future context injection)
history = await chat_service.get_history(session, cid)
# 4. Persist user message
await chat_service.store_message(session, cid, user.id, "user", data.message)
# 5. Build agent input with security context
input_str = f"[Context] Your user_id is {user.id}.\n\n{data.message}"
# 6. Log pre-run
logger.debug("Running agent with %d history messages", len(history))
# 7-8. Run agent with provider router (T013)
try:
result, provider_used = await provider_router.run_with_failover(
agent=todo_agent,
user_input=input_str,
preferred_provider=data.provider,
)
# _tool_use_tracker_snapshot: dict[agent_name -> [tool_name, ...]]
tool_calls_used: list[str] = [
name
for names in result._tool_use_tracker_snapshot.values() # noqa: SLF001
for name in names
]
except HTTPException:
# Re-raise HTTPException from router (503 when all providers fail)
raise
except Exception as exc:
logger.error("Agent execution failed: %s", exc, exc_info=True)
raise HTTPException(
status_code=status.HTTP_500_INTERNAL_SERVER_ERROR,
detail=f"Agent error: {exc}",
) from exc
# 9. Persist assistant response
response_text = str(result.final_output)
await chat_service.store_message(session, cid, user.id, "assistant", response_text)
# 10. Log post-run
logger.info("Agent response: %s... provider=%s tool_calls=%s", response_text[:80], provider_used, tool_calls_used)
# 11. Return (T013)
return ChatResponse(
conversation_id=cid,
response=response_text,
tool_calls=tool_calls_used,
provider=provider_used,
)