Files
claudetools/api/routers/coord_workflows.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

84 lines
3.0 KiB
Python

"""Coordination workflows 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_workflow import CoordWorkflowCreate, CoordWorkflowResponse, CoordWorkflowUpdate
from api.schemas.coord_work_item import CoordWorkItemResponse
from api.services import coord_workflow_service, coord_work_item_service
router = APIRouter()
@router.get("", response_model=dict, status_code=status.HTTP_200_OK)
def list_workflows(
project_key: str | None = Query(default=None),
status_filter: str | None = Query(default=None),
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 workflows with optional filters."""
workflows, total = coord_workflow_service.get_workflows(
db, project_key=project_key, status_filter=status_filter, skip=skip, limit=limit
)
return {
"total": total,
"skip": skip,
"limit": limit,
"workflows": [CoordWorkflowResponse.model_validate(w) for w in workflows],
}
@router.post("", response_model=CoordWorkflowResponse, status_code=status.HTTP_201_CREATED)
def create_workflow(
data: CoordWorkflowCreate,
db: Session = Depends(get_db),
current_user: dict = Depends(get_current_user),
):
"""Create a new coordination workflow."""
workflow = coord_workflow_service.create_workflow(db, data)
return CoordWorkflowResponse.model_validate(workflow)
@router.get("/{workflow_id}", response_model=dict, status_code=status.HTTP_200_OK)
def get_workflow(
workflow_id: UUID,
db: Session = Depends(get_db),
current_user: dict = Depends(get_current_user),
):
"""Get a workflow by ID including its work items."""
workflow = coord_workflow_service.get_workflow_by_id(db, workflow_id)
items, _ = coord_work_item_service.get_work_items(db, workflow_id=str(workflow_id))
return {
"workflow": CoordWorkflowResponse.model_validate(workflow),
"work_items": [CoordWorkItemResponse.model_validate(i) for i in items],
}
@router.put("/{workflow_id}", response_model=CoordWorkflowResponse, status_code=status.HTTP_200_OK)
def update_workflow(
workflow_id: UUID,
data: CoordWorkflowUpdate,
db: Session = Depends(get_db),
current_user: dict = Depends(get_current_user),
):
"""Update a workflow."""
workflow = coord_workflow_service.update_workflow(db, workflow_id, data)
return CoordWorkflowResponse.model_validate(workflow)
@router.delete("/{workflow_id}", response_model=dict, status_code=status.HTTP_200_OK)
def delete_workflow(
workflow_id: UUID,
db: Session = Depends(get_db),
current_user: dict = Depends(get_current_user),
):
"""Delete a workflow and its work items (cascade)."""
return coord_workflow_service.delete_workflow(db, workflow_id)