Files
claudetools/api/routers/coord_messages.py
Mike Swanson 63975284f4 feat: agent coordination system (workflows, locks, components, messages)
Adds /api/coord/* endpoints for real-time cross-session coordination:
- coord_workflows: named units of work per project
- coord_work_items: tasks within workflows with dependency chains
- coord_session_locks: exclusive resource locks with auto-expiry (TTL)
- coord_component_states: live component state per project (upsert)
- coord_messages: cross-session messaging and broadcasts
- /api/coord/status: cross-project snapshot endpoint

Replaces PROJECT_STATE.md as the coordination layer for Claude sessions.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-12 08:25:33 -07:00

78 lines
2.5 KiB
Python

"""Coordination inter-session messages router."""
from uuid import UUID
from fastapi import APIRouter, Depends, Query, status
from sqlalchemy.orm import Session
from api.database import get_db
from api.middleware.auth import get_current_user
from api.schemas.coord_message import CoordMessageCreate, CoordMessageResponse
from api.services import coord_message_service
router = APIRouter()
@router.get("", response_model=dict, status_code=status.HTTP_200_OK)
def list_messages(
to_session: str | None = Query(default=None),
unread_only: bool = Query(default=False),
skip: int = Query(default=0, ge=0),
limit: int = Query(default=100, ge=1, le=1000),
db: Session = Depends(get_db),
current_user: dict = Depends(get_current_user),
):
"""List messages with optional filters."""
messages, total = coord_message_service.get_messages(
db, to_session=to_session, unread_only=unread_only, skip=skip, limit=limit
)
return {
"total": total,
"skip": skip,
"limit": limit,
"messages": [CoordMessageResponse.model_validate(m) for m in messages],
}
@router.get("/unread-count", response_model=dict, status_code=status.HTTP_200_OK)
def get_unread_count(
session_id: str = Query(...),
db: Session = Depends(get_db),
current_user: dict = Depends(get_current_user),
):
"""Return the count of unread messages for a session."""
count = coord_message_service.get_unread_count(db, session_id)
return {"count": count}
@router.post("", response_model=CoordMessageResponse, status_code=status.HTTP_201_CREATED)
def send_message(
data: CoordMessageCreate,
db: Session = Depends(get_db),
current_user: dict = Depends(get_current_user),
):
"""Send a message to a session or broadcast."""
msg = coord_message_service.send_message(db, data)
return CoordMessageResponse.model_validate(msg)
@router.put("/{message_id}/read", response_model=CoordMessageResponse, status_code=status.HTTP_200_OK)
def mark_message_read(
message_id: UUID,
db: Session = Depends(get_db),
current_user: dict = Depends(get_current_user),
):
"""Mark a message as read."""
msg = coord_message_service.mark_read(db, message_id)
return CoordMessageResponse.model_validate(msg)
@router.delete("/{message_id}", response_model=dict, status_code=status.HTTP_200_OK)
def delete_message(
message_id: UUID,
db: Session = Depends(get_db),
current_user: dict = Depends(get_current_user),
):
"""Delete a message."""
return coord_message_service.delete_message(db, message_id)