feat(tags): add tag management interfaces and update related schemas

2026-02-12 18:35:48 +05:30
parent 2ebdead95b
commit 8d7d9da4e9
146 changed files with 6956 additions and 8645 deletions
--- a/backend/app/api/agent.py
+++ b/backend/app/api/agent.py
@@ -20,8 +20,8 @@ from app.db.pagination import paginate
 from app.db.session import get_session
 from app.models.agents import Agent
 from app.models.boards import Board
+from app.models.tags import Tag
 from app.models.task_dependencies import TaskDependency
-from app.models.task_tags import TaskTag
 from app.models.tasks import Task
 from app.schemas.agents import (
    AgentCreate,
@@ -44,18 +44,18 @@ from app.schemas.gateway_coordination import (
    GatewayMainAskUserResponse,
 )
 from app.schemas.pagination import DefaultLimitOffsetPage
-from app.schemas.task_tags import TaskTagRef
+from app.schemas.tags import TagRef
 from app.schemas.tasks import TaskCommentCreate, TaskCommentRead, TaskCreate, TaskRead, TaskUpdate
 from app.services.activity_log import record_activity
 from app.services.openclaw.coordination_service import GatewayCoordinationService
 from app.services.openclaw.policies import OpenClawAuthorizationPolicy
 from app.services.openclaw.provisioning_db import AgentLifecycleService
+from app.services.tags import replace_tags, validate_tag_ids
 from app.services.task_dependencies import (
    blocked_by_dependency_ids,
    dependency_status_by_id,
    validate_dependency_update,
 )
-from app.services.task_tags import replace_task_tags, validate_task_tag_ids

 if TYPE_CHECKING:
    from collections.abc import Sequence
@@ -214,23 +214,23 @@ async def list_tasks(
    )


-@router.get("/boards/{board_id}/tags", response_model=list[TaskTagRef])
-async def list_task_tags(
+@router.get("/boards/{board_id}/tags", response_model=list[TagRef])
+async def list_tags(
    board: Board = BOARD_DEP,
    session: AsyncSession = SESSION_DEP,
    agent_ctx: AgentAuthContext = AGENT_CTX_DEP,
-) -> list[TaskTagRef]:
-    """List task tags available to the board's organization."""
+) -> list[TagRef]:
+    """List tags available to the board's organization."""
    _guard_board_access(agent_ctx, board)
    tags = (
        await session.exec(
-            select(TaskTag)
-            .where(col(TaskTag.organization_id) == board.organization_id)
-            .order_by(func.lower(col(TaskTag.name)).asc(), col(TaskTag.created_at).asc()),
+            select(Tag)
+            .where(col(Tag.organization_id) == board.organization_id)
+            .order_by(func.lower(col(Tag.name)).asc(), col(Tag.created_at).asc()),
        )
    ).all()
    return [
-        TaskTagRef(
+        TagRef(
            id=tag.id,
            name=tag.name,
            slug=tag.slug,
@@ -265,7 +265,7 @@ async def create_task(
        task_id=task.id,
        depends_on_task_ids=depends_on_task_ids,
    )
-    normalized_tag_ids = await validate_task_tag_ids(
+    normalized_tag_ids = await validate_tag_ids(
        session,
        organization_id=board.organization_id,
        tag_ids=tag_ids,
@@ -310,7 +310,7 @@ async def create_task(
                depends_on_task_id=dep_id,
            ),
        )
-    await replace_task_tags(
+    await replace_tags(
        session,
        task_id=task.id,
        tag_ids=normalized_tag_ids,
--- a/backend/app/api/task_tags.py
+++ b/backend/app/api/task_tags.py
@@ -1,4 +1,4 @@
-"""Task-tag CRUD endpoints for organization-scoped task categorization."""
+"""Tag CRUD endpoints for organization-scoped task categorization."""

 from __future__ import annotations

@@ -14,13 +14,13 @@ from app.core.time import utcnow
 from app.db import crud
 from app.db.pagination import paginate
 from app.db.session import get_session
-from app.models.task_tag_assignments import TaskTagAssignment
-from app.models.task_tags import TaskTag
+from app.models.tag_assignments import TagAssignment
+from app.models.tags import Tag
 from app.schemas.common import OkResponse
 from app.schemas.pagination import DefaultLimitOffsetPage
-from app.schemas.task_tags import TaskTagCreate, TaskTagRead, TaskTagUpdate
+from app.schemas.tags import TagCreate, TagRead, TagUpdate
 from app.services.organizations import OrganizationContext
-from app.services.task_tags import slugify_task_tag, task_counts_for_tags
+from app.services.tags import slugify_tag, task_counts_for_tags

 if TYPE_CHECKING:
    from collections.abc import Sequence
@@ -36,16 +36,16 @@ ORG_ADMIN_DEP = Depends(require_org_admin)

 def _normalize_slug(slug: str | None, *, fallback_name: str) -> str:
    source = (slug or "").strip() or fallback_name
-    return slugify_task_tag(source)
+    return slugify_tag(source)


-async def _require_org_task_tag(
+async def _require_org_tag(
    session: AsyncSession,
    *,
    tag_id: UUID,
    ctx: OrganizationContext,
-) -> TaskTag:
-    tag = await TaskTag.objects.by_id(tag_id).first(session)
+) -> Tag:
+    tag = await Tag.objects.by_id(tag_id).first(session)
    if tag is None:
        raise HTTPException(status_code=status.HTTP_404_NOT_FOUND)
    if tag.organization_id != ctx.organization.id:
@@ -60,7 +60,7 @@ async def _ensure_slug_available(
    slug: str,
    exclude_tag_id: UUID | None = None,
 ) -> None:
-    existing = await TaskTag.objects.filter_by(organization_id=organization_id, slug=slug).first(
+    existing = await Tag.objects.filter_by(organization_id=organization_id, slug=slug).first(
        session
    )
    if existing is None:
@@ -69,15 +69,15 @@ async def _ensure_slug_available(
        return
    raise HTTPException(
        status_code=status.HTTP_409_CONFLICT,
-        detail="Task tag slug already exists in this organization.",
+        detail="Tag slug already exists in this organization.",
    )


 async def _tag_read_page(
    *,
    session: AsyncSession,
-    items: Sequence[TaskTag],
-) -> list[TaskTagRead]:
+    items: Sequence[Tag],
+) -> list[TagRead]:
    if not items:
        return []
    counts = await task_counts_for_tags(
@@ -85,30 +85,30 @@ async def _tag_read_page(
        tag_ids=[item.id for item in items],
    )
    return [
-        TaskTagRead.model_validate(item, from_attributes=True).model_copy(
+        TagRead.model_validate(item, from_attributes=True).model_copy(
            update={"task_count": counts.get(item.id, 0)},
        )
        for item in items
    ]


-@router.get("", response_model=DefaultLimitOffsetPage[TaskTagRead])
-async def list_task_tags(
+@router.get("", response_model=DefaultLimitOffsetPage[TagRead])
+async def list_tags(
    session: AsyncSession = SESSION_DEP,
    ctx: OrganizationContext = ORG_MEMBER_DEP,
-) -> LimitOffsetPage[TaskTagRead]:
-    """List task tags for the active organization."""
+) -> LimitOffsetPage[TagRead]:
+    """List tags for the active organization."""
    statement = (
-        select(TaskTag)
-        .where(col(TaskTag.organization_id) == ctx.organization.id)
-        .order_by(func.lower(col(TaskTag.name)).asc(), col(TaskTag.created_at).asc())
+        select(Tag)
+        .where(col(Tag.organization_id) == ctx.organization.id)
+        .order_by(func.lower(col(Tag.name)).asc(), col(Tag.created_at).asc())
    )

    async def _transform(items: Sequence[object]) -> Sequence[object]:
-        tags: list[TaskTag] = []
+        tags: list[Tag] = []
        for item in items:
-            if not isinstance(item, TaskTag):
-                msg = "Expected TaskTag items from paginated query"
+            if not isinstance(item, Tag):
+                msg = "Expected Tag items from paginated query"
                raise TypeError(msg)
            tags.append(item)
        return await _tag_read_page(session=session, items=tags)
@@ -116,13 +116,13 @@ async def list_task_tags(
    return await paginate(session, statement, transformer=_transform)


-@router.post("", response_model=TaskTagRead)
-async def create_task_tag(
-    payload: TaskTagCreate,
+@router.post("", response_model=TagRead)
+async def create_tag(
+    payload: TagCreate,
    session: AsyncSession = SESSION_DEP,
    ctx: OrganizationContext = ORG_ADMIN_DEP,
-) -> TaskTagRead:
-    """Create a task tag within the active organization."""
+) -> TagRead:
+    """Create a tag within the active organization."""
    slug = _normalize_slug(payload.slug, fallback_name=payload.name)
    await _ensure_slug_available(
        session,
@@ -131,49 +131,49 @@ async def create_task_tag(
    )
    tag = await crud.create(
        session,
-        TaskTag,
+        Tag,
        organization_id=ctx.organization.id,
        name=payload.name,
        slug=slug,
        color=payload.color,
        description=payload.description,
    )
-    return TaskTagRead.model_validate(tag, from_attributes=True)
+    return TagRead.model_validate(tag, from_attributes=True)


-@router.get("/{tag_id}", response_model=TaskTagRead)
-async def get_task_tag(
+@router.get("/{tag_id}", response_model=TagRead)
+async def get_tag(
    tag_id: UUID,
    session: AsyncSession = SESSION_DEP,
    ctx: OrganizationContext = ORG_MEMBER_DEP,
-) -> TaskTagRead:
-    """Get a single task tag in the active organization."""
-    tag = await _require_org_task_tag(
+) -> TagRead:
+    """Get a single tag in the active organization."""
+    tag = await _require_org_tag(
        session,
        tag_id=tag_id,
        ctx=ctx,
    )
    count = (
        await session.exec(
-            select(func.count(col(TaskTagAssignment.task_id))).where(
-                col(TaskTagAssignment.tag_id) == tag.id,
+            select(func.count(col(TagAssignment.task_id))).where(
+                col(TagAssignment.tag_id) == tag.id,
            ),
        )
    ).one()
-    return TaskTagRead.model_validate(tag, from_attributes=True).model_copy(
+    return TagRead.model_validate(tag, from_attributes=True).model_copy(
        update={"task_count": int(count or 0)},
    )


-@router.patch("/{tag_id}", response_model=TaskTagRead)
-async def update_task_tag(
+@router.patch("/{tag_id}", response_model=TagRead)
+async def update_tag(
    tag_id: UUID,
-    payload: TaskTagUpdate,
+    payload: TagUpdate,
    session: AsyncSession = SESSION_DEP,
    ctx: OrganizationContext = ORG_ADMIN_DEP,
-) -> TaskTagRead:
-    """Update a task tag in the active organization."""
-    tag = await _require_org_task_tag(
+) -> TagRead:
+    """Update a tag in the active organization."""
+    tag = await _require_org_tag(
        session,
        tag_id=tag_id,
        ctx=ctx,
@@ -194,25 +194,25 @@ async def update_task_tag(
        )
    updates["updated_at"] = utcnow()
    updated = await crud.patch(session, tag, updates)
-    return TaskTagRead.model_validate(updated, from_attributes=True)
+    return TagRead.model_validate(updated, from_attributes=True)


@router.delete("/{tag_id}", response_model=OkResponse)
-async def delete_task_tag(
+async def delete_tag(
    tag_id: UUID,
    session: AsyncSession = SESSION_DEP,
    ctx: OrganizationContext = ORG_ADMIN_DEP,
 ) -> OkResponse:
-    """Delete a task tag and remove all associated task-tag links."""
-    tag = await _require_org_task_tag(
+    """Delete a tag and remove all associated tag links."""
+    tag = await _require_org_tag(
        session,
        tag_id=tag_id,
        ctx=ctx,
    )
    await crud.delete_where(
        session,
-        TaskTagAssignment,
-        col(TaskTagAssignment.tag_id) == tag.id,
+        TagAssignment,
+        col(TagAssignment.tag_id) == tag.id,
        commit=False,
    )
    await session.delete(tag)
--- a/backend/app/api/tasks.py
+++ b/backend/app/api/tasks.py
@@ -32,9 +32,9 @@ from app.models.agents import Agent
 from app.models.approval_task_links import ApprovalTaskLink
 from app.models.approvals import Approval
 from app.models.boards import Board
+from app.models.tag_assignments import TagAssignment
 from app.models.task_dependencies import TaskDependency
 from app.models.task_fingerprints import TaskFingerprint
-from app.models.task_tag_assignments import TaskTagAssignment
 from app.models.tasks import Task
 from app.schemas.activity_events import ActivityEventRead
 from app.schemas.common import OkResponse
@@ -48,6 +48,12 @@ from app.services.openclaw.gateway_dispatch import GatewayDispatchService
 from app.services.openclaw.gateway_rpc import GatewayConfig as GatewayClientConfig
 from app.services.openclaw.gateway_rpc import OpenClawGatewayError
 from app.services.organizations import require_board_access
+from app.services.tags import (
+    TagState,
+    load_tag_state,
+    replace_tags,
+    validate_tag_ids,
+)
 from app.services.task_dependencies import (
    blocked_by_dependency_ids,
    dependency_ids_by_task_id,
@@ -56,12 +62,6 @@ from app.services.task_dependencies import (
    replace_task_dependencies,
    validate_dependency_update,
 )
-from app.services.task_tags import (
-    TaskTagState,
-    load_task_tag_state,
-    replace_task_tags,
-    validate_task_tag_ids,
-)

 if TYPE_CHECKING:
    from collections.abc import AsyncIterator, Sequence
@@ -583,7 +583,7 @@ async def _task_read_page(
        return []

    task_ids = [task.id for task in tasks]
-    tag_state_by_task_id = await load_task_tag_state(
+    tag_state_by_task_id = await load_tag_state(
        session,
        task_ids=task_ids,
    )
@@ -603,7 +603,7 @@ async def _task_read_page(

    output: list[TaskRead] = []
    for task in tasks:
-        tag_state = tag_state_by_task_id.get(task.id, TaskTagState())
+        tag_state = tag_state_by_task_id.get(task.id, TagState())
        dep_list = deps_map.get(task.id, [])
        blocked_by = blocked_by_dependency_ids(
            dependency_ids=dep_list,
@@ -630,14 +630,14 @@ async def _stream_task_state(
    *,
    board_id: UUID,
    rows: list[tuple[ActivityEvent, Task | None]],
-) -> tuple[dict[UUID, list[UUID]], dict[UUID, str], dict[UUID, TaskTagState]]:
+) -> tuple[dict[UUID, list[UUID]], dict[UUID, str], dict[UUID, TagState]]:
    task_ids = [
        task.id for event, task in rows if task is not None and event.event_type != "task.comment"
    ]
    if not task_ids:
        return {}, {}, {}

-    tag_state_by_task_id = await load_task_tag_state(
+    tag_state_by_task_id = await load_tag_state(
        session,
        task_ids=list({*task_ids}),
    )
@@ -666,7 +666,7 @@ def _task_event_payload(
    *,
    deps_map: dict[UUID, list[UUID]],
    dep_status: dict[UUID, str],
-    tag_state_by_task_id: dict[UUID, TaskTagState],
+    tag_state_by_task_id: dict[UUID, TagState],
 ) -> dict[str, object]:
    payload: dict[str, object] = {
        "type": event.event_type,
@@ -679,7 +679,7 @@ def _task_event_payload(
        payload["task"] = None
        return payload

-    tag_state = tag_state_by_task_id.get(task.id, TaskTagState())
+    tag_state = tag_state_by_task_id.get(task.id, TagState())
    dep_list = deps_map.get(task.id, [])
    blocked_by = blocked_by_dependency_ids(
        dependency_ids=dep_list,
@@ -816,7 +816,7 @@ async def create_task(
        task_id=task.id,
        depends_on_task_ids=depends_on_task_ids,
    )
-    normalized_tag_ids = await validate_task_tag_ids(
+    normalized_tag_ids = await validate_tag_ids(
        session,
        organization_id=board.organization_id,
        tag_ids=tag_ids,
@@ -843,7 +843,7 @@ async def create_task(
                depends_on_task_id=dep_id,
            ),
        )
-    await replace_task_tags(
+    await replace_tags(
        session,
        task_id=task.id,
        tag_ids=normalized_tag_ids,
@@ -994,8 +994,8 @@ async def delete_task(
    )
    await crud.delete_where(
        session,
-        TaskTagAssignment,
-        col(TaskTagAssignment.task_id) == task.id,
+        TagAssignment,
+        col(TagAssignment.task_id) == task.id,
        commit=False,
    )
    await session.delete(task)
@@ -1231,9 +1231,9 @@ async def _task_read_response(
    board_id: UUID,
 ) -> TaskRead:
    dep_ids = await _task_dep_ids(session, board_id=board_id, task_id=task.id)
-    tag_state = (await load_task_tag_state(session, task_ids=[task.id])).get(
+    tag_state = (await load_tag_state(session, task_ids=[task.id])).get(
        task.id,
-        TaskTagState(),
+        TagState(),
    )
    blocked_ids = await _task_blocked_ids(
        session,
@@ -1337,7 +1337,7 @@ async def _normalized_update_tag_ids(
        session,
        board_id=update.board_id,
    )
-    return await validate_task_tag_ids(
+    return await validate_tag_ids(
        session,
        organization_id=organization_id,
        tag_ids=update.tag_ids,
@@ -1449,7 +1449,7 @@ async def _apply_lead_task_update(
        _lead_apply_status(update)

    if normalized_tag_ids is not None:
-        await replace_task_tags(
+        await replace_tags(
            session,
            task_id=update.task.id,
            tag_ids=normalized_tag_ids,
@@ -1723,7 +1723,7 @@ async def _finalize_updated_task(
                update=update,
            )
        )
-        await replace_task_tags(
+        await replace_tags(
            session,
            task_id=update.task.id,
            tag_ids=normalized or [],
--- a/backend/app/main.py
+++ b/backend/app/main.py
@@ -24,7 +24,7 @@ from app.api.gateways import router as gateways_router
 from app.api.metrics import router as metrics_router
 from app.api.organizations import router as organizations_router
 from app.api.souls_directory import router as souls_directory_router
-from app.api.task_tags import router as task_tags_router
+from app.api.tags import router as tags_router
 from app.api.tasks import router as tasks_router
 from app.api.users import router as users_router
 from app.core.config import settings
@@ -108,7 +108,7 @@ api_v1.include_router(board_memory_router)
 api_v1.include_router(board_onboarding_router)
 api_v1.include_router(approvals_router)
 api_v1.include_router(tasks_router)
-api_v1.include_router(task_tags_router)
+api_v1.include_router(tags_router)
 api_v1.include_router(users_router)
 app.include_router(api_v1)

--- a/backend/app/models/init.py
+++ b/backend/app/models/init.py
@@ -15,10 +15,10 @@ from app.models.organization_invite_board_access import OrganizationInviteBoardA
 from app.models.organization_invites import OrganizationInvite
 from app.models.organization_members import OrganizationMember
 from app.models.organizations import Organization
+from app.models.tag_assignments import TagAssignment
+from app.models.tags import Tag
 from app.models.task_dependencies import TaskDependency
 from app.models.task_fingerprints import TaskFingerprint
-from app.models.task_tag_assignments import TaskTagAssignment
-from app.models.task_tags import TaskTag
 from app.models.tasks import Task
 from app.models.users import User

@@ -41,7 +41,7 @@ __all__ = [
    "TaskDependency",
    "Task",
    "TaskFingerprint",
-    "TaskTag",
-    "TaskTagAssignment",
+    "Tag",
+    "TagAssignment",
    "User",
 ]
--- a/backend/app/models/task_tag_assignments.py
+++ b/backend/app/models/task_tag_assignments.py
@@ -14,19 +14,19 @@ from app.models.base import QueryModel
 RUNTIME_ANNOTATION_TYPES = (datetime,)


-class TaskTagAssignment(QueryModel, table=True):
+class TagAssignment(QueryModel, table=True):
    """Association row mapping one task to one tag."""

-    __tablename__ = "task_tag_assignments"  # pyright: ignore[reportAssignmentType]
+    __tablename__ = "tag_assignments"  # pyright: ignore[reportAssignmentType]
    __table_args__ = (
        UniqueConstraint(
            "task_id",
            "tag_id",
-            name="uq_task_tag_assignments_task_id_tag_id",
+            name="uq_tag_assignments_task_id_tag_id",
        ),
    )

    id: UUID = Field(default_factory=uuid4, primary_key=True)
    task_id: UUID = Field(foreign_key="tasks.id", index=True)
-    tag_id: UUID = Field(foreign_key="task_tags.id", index=True)
+    tag_id: UUID = Field(foreign_key="tags.id", index=True)
    created_at: datetime = Field(default_factory=utcnow)
--- a/backend/app/models/task_tags.py
+++ b/backend/app/models/task_tags.py
@@ -1,4 +1,4 @@
-"""Task tag model for organization-scoped task categorization."""
+"""Tag model for organization-scoped task categorization."""

 from __future__ import annotations

@@ -14,15 +14,15 @@ from app.models.tenancy import TenantScoped
 RUNTIME_ANNOTATION_TYPES = (datetime,)


-class TaskTag(TenantScoped, table=True):
-    """Organization-scoped task tag used to classify and group tasks."""
+class Tag(TenantScoped, table=True):
+    """Organization-scoped tag used to classify and group tasks."""

-    __tablename__ = "task_tags"  # pyright: ignore[reportAssignmentType]
+    __tablename__ = "tags"  # pyright: ignore[reportAssignmentType]
    __table_args__ = (
        UniqueConstraint(
            "organization_id",
            "slug",
-            name="uq_task_tags_organization_id_slug",
+            name="uq_tags_organization_id_slug",
        ),
    )

--- a/backend/app/schemas/init.py
+++ b/backend/app/schemas/init.py
@@ -31,7 +31,7 @@ from app.schemas.souls_directory import (
    SoulsDirectorySearchResponse,
    SoulsDirectorySoulRef,
 )
-from app.schemas.task_tags import TaskTagCreate, TaskTagRead, TaskTagRef, TaskTagUpdate
+from app.schemas.tags import TagCreate, TagRead, TagRef, TagUpdate
 from app.schemas.tasks import TaskCreate, TaskRead, TaskUpdate
 from app.schemas.users import UserCreate, UserRead, UserUpdate

@@ -71,10 +71,10 @@ __all__ = [
    "SoulsDirectoryMarkdownResponse",
    "SoulsDirectorySearchResponse",
    "SoulsDirectorySoulRef",
-    "TaskTagCreate",
-    "TaskTagRead",
-    "TaskTagRef",
-    "TaskTagUpdate",
+    "TagCreate",
+    "TagRead",
+    "TagRef",
+    "TagUpdate",
    "TaskCreate",
    "TaskRead",
    "TaskUpdate",
--- a/backend/app/schemas/task_tags.py
+++ b/backend/app/schemas/task_tags.py
@@ -1,4 +1,4 @@
-"""Schemas for task-tag CRUD payloads."""
+"""Schemas for tag CRUD payloads."""

 from __future__ import annotations

@@ -27,8 +27,8 @@ def _normalize_color(value: str | None) -> str | None:
    return cleaned


-class TaskTagBase(SQLModel):
-    """Shared task-tag fields for create/read payloads."""
+class TagBase(SQLModel):
+    """Shared tag fields for create/read payloads."""

    name: str
    slug: str
@@ -36,8 +36,8 @@ class TaskTagBase(SQLModel):
    description: str | None = None


-class TaskTagRef(SQLModel):
-    """Compact task-tag representation embedded in task payloads."""
+class TagRef(SQLModel):
+    """Compact tag representation embedded in task payloads."""

    id: UUID
    name: str
@@ -45,8 +45,8 @@ class TaskTagRef(SQLModel):
    color: str


-class TaskTagCreate(SQLModel):
-    """Payload for creating a task tag."""
+class TagCreate(SQLModel):
+    """Payload for creating a tag."""

    name: NonEmptyStr
    slug: str | None = None
@@ -76,8 +76,8 @@ class TaskTagCreate(SQLModel):
        return value


-class TaskTagUpdate(SQLModel):
-    """Payload for partial task-tag updates."""
+class TagUpdate(SQLModel):
+    """Payload for partial tag updates."""

    name: NonEmptyStr | None = None
    slug: str | None = None
@@ -116,8 +116,8 @@ class TaskTagUpdate(SQLModel):
        return self


-class TaskTagRead(TaskTagBase):
-    """Task-tag payload returned from API endpoints."""
+class TagRead(TagBase):
+    """Tag payload returned from API endpoints."""

    id: UUID
    organization_id: UUID
--- a/backend/app/schemas/tasks.py
+++ b/backend/app/schemas/tasks.py
@@ -10,13 +10,13 @@ from pydantic import field_validator, model_validator
 from sqlmodel import Field, SQLModel

 from app.schemas.common import NonEmptyStr
-from app.schemas.task_tags import TaskTagRef
+from app.schemas.tags import TagRef

 TaskStatus = Literal["inbox", "in_progress", "review", "done"]
 STATUS_REQUIRED_ERROR = "status is required"
 # Keep these symbols as runtime globals so Pydantic can resolve
 # deferred annotations reliably.
-RUNTIME_ANNOTATION_TYPES = (datetime, UUID, NonEmptyStr, TaskTagRef)
+RUNTIME_ANNOTATION_TYPES = (datetime, UUID, NonEmptyStr, TagRef)


 class TaskBase(SQLModel):
@@ -80,7 +80,7 @@ class TaskRead(TaskBase):
    updated_at: datetime
    blocked_by_task_ids: list[UUID] = Field(default_factory=list)
    is_blocked: bool = False
-    tags: list[TaskTagRef] = Field(default_factory=list)
+    tags: list[TagRef] = Field(default_factory=list)


 class TaskCommentCreate(SQLModel):
--- a/backend/app/schemas/view_models.py
+++ b/backend/app/schemas/view_models.py
@@ -12,7 +12,7 @@ from app.schemas.approvals import ApprovalRead
 from app.schemas.board_groups import BoardGroupRead
 from app.schemas.board_memory import BoardMemoryRead
 from app.schemas.boards import BoardRead
-from app.schemas.task_tags import TaskTagRef
+from app.schemas.tags import TagRef
 from app.schemas.tasks import TaskRead

 RUNTIME_ANNOTATION_TYPES = (
@@ -23,7 +23,7 @@ RUNTIME_ANNOTATION_TYPES = (
    BoardGroupRead,
    BoardMemoryRead,
    BoardRead,
-    TaskTagRef,
+    TagRef,
 )


@@ -59,7 +59,7 @@ class BoardGroupTaskSummary(SQLModel):
    assignee: str | None = None
    due_at: datetime | None = None
    in_progress_at: datetime | None = None
-    tags: list[TaskTagRef] = Field(default_factory=list)
+    tags: list[TagRef] = Field(default_factory=list)
    created_at: datetime
    updated_at: datetime

--- a/backend/app/services/board_group_snapshot.py
+++ b/backend/app/services/board_group_snapshot.py
@@ -21,7 +21,7 @@ from app.schemas.view_models import (
    BoardGroupSnapshot,
    BoardGroupTaskSummary,
 )
-from app.services.task_tags import TaskTagState, load_task_tag_state
+from app.services.tags import TagState, load_tag_state

 if TYPE_CHECKING:
    from sqlalchemy.sql.elements import ColumnElement
@@ -123,7 +123,7 @@ def _task_summaries_by_board(
    boards_by_id: dict[UUID, Board],
    tasks: list[Task],
    agent_name_by_id: dict[UUID, str],
-    tag_state_by_task_id: dict[UUID, TaskTagState],
+    tag_state_by_task_id: dict[UUID, TagState],
    per_board_task_limit: int,
 ) -> dict[UUID, list[BoardGroupTaskSummary]]:
    """Build limited per-board task summary lists."""
@@ -156,7 +156,7 @@ def _task_summaries_by_board(
                ),
                due_at=task.due_at,
                in_progress_at=task.in_progress_at,
-                tags=tag_state_by_task_id.get(task.id, TaskTagState()).tags,
+                tags=tag_state_by_task_id.get(task.id, TagState()).tags,
                created_at=task.created_at,
                updated_at=task.updated_at,
            ),
@@ -191,7 +191,7 @@ async def build_group_snapshot(
        include_done=include_done,
    )
    agent_name_by_id = await _agent_names(session, tasks)
-    tag_state_by_task_id = await load_task_tag_state(
+    tag_state_by_task_id = await load_tag_state(
        session,
        task_ids=[task.id for task in tasks],
    )
--- a/backend/app/services/board_snapshot.py
+++ b/backend/app/services/board_snapshot.py
@@ -17,12 +17,12 @@ from app.schemas.boards import BoardRead
 from app.schemas.view_models import BoardSnapshot, TaskCardRead
 from app.services.approval_task_links import load_task_ids_by_approval, task_counts_for_board
 from app.services.openclaw.provisioning_db import AgentLifecycleService
+from app.services.tags import TagState, load_tag_state
 from app.services.task_dependencies import (
    blocked_by_dependency_ids,
    dependency_ids_by_task_id,
    dependency_status_by_id,
 )
-from app.services.task_tags import TaskTagState, load_task_tag_state

 if TYPE_CHECKING:
    from uuid import UUID
@@ -49,13 +49,13 @@ def _task_to_card(
    counts_by_task_id: dict[UUID, tuple[int, int]],
    deps_by_task_id: dict[UUID, list[UUID]],
    dependency_status_by_id_map: dict[UUID, str],
-    tag_state_by_task_id: dict[UUID, TaskTagState],
+    tag_state_by_task_id: dict[UUID, TagState],
 ) -> TaskCardRead:
    card = TaskCardRead.model_validate(task, from_attributes=True)
    approvals_count, approvals_pending_count = counts_by_task_id.get(task.id, (0, 0))
    assignee = agent_name_by_id.get(task.assigned_agent_id) if task.assigned_agent_id else None
    depends_on_task_ids = deps_by_task_id.get(task.id, [])
-    tag_state = tag_state_by_task_id.get(task.id, TaskTagState())
+    tag_state = tag_state_by_task_id.get(task.id, TagState())
    blocked_by_task_ids = blocked_by_dependency_ids(
        dependency_ids=depends_on_task_ids,
        status_by_id=dependency_status_by_id_map,
@@ -86,7 +86,7 @@ async def build_board_snapshot(session: AsyncSession, board: Board) -> BoardSnap
        .all(session),
    )
    task_ids = [task.id for task in tasks]
-    tag_state_by_task_id = await load_task_tag_state(
+    tag_state_by_task_id = await load_tag_state(
        session,
        task_ids=task_ids,
    )
--- a/backend/app/services/task_tags.py
+++ b/backend/app/services/task_tags.py
@@ -1,4 +1,4 @@
-"""Helpers for validating and loading task tags and task-tag mappings."""
+"""Helpers for validating and loading tags and tag mappings."""

 from __future__ import annotations

@@ -13,9 +13,9 @@ from fastapi import HTTPException, status
 from sqlalchemy import delete, func
 from sqlmodel import col, select

-from app.models.task_tag_assignments import TaskTagAssignment
-from app.models.task_tags import TaskTag
-from app.schemas.task_tags import TaskTagRef
+from app.models.tag_assignments import TagAssignment
+from app.models.tags import Tag
+from app.schemas.tags import TagRef

 if TYPE_CHECKING:
    from sqlmodel.ext.asyncio.session import AsyncSession
@@ -23,7 +23,7 @@ if TYPE_CHECKING:
 SLUG_RE = re.compile(r"[^a-z0-9]+")


-def slugify_task_tag(value: str) -> str:
+def slugify_tag(value: str) -> str:
    """Build a slug from arbitrary text using lowercase alphanumeric groups."""
    slug = SLUG_RE.sub("-", value.lower()).strip("-")
    return slug or "tag"
@@ -40,22 +40,22 @@ def _dedupe_uuid_list(values: Sequence[UUID]) -> list[UUID]:
    return deduped


-async def validate_task_tag_ids(
+async def validate_tag_ids(
    session: AsyncSession,
    *,
    organization_id: UUID,
    tag_ids: Sequence[UUID],
 ) -> list[UUID]:
-    """Validate task-tag IDs within an organization and return deduped IDs."""
+    """Validate tag IDs within an organization and return deduped IDs."""
    normalized = _dedupe_uuid_list(tag_ids)
    if not normalized:
        return []

    existing_ids = set(
        await session.exec(
-            select(TaskTag.id)
-            .where(col(TaskTag.organization_id) == organization_id)
-            .where(col(TaskTag.id).in_(normalized)),
+            select(Tag.id)
+            .where(col(Tag.organization_id) == organization_id)
+            .where(col(Tag.id).in_(normalized)),
        ),
    )
    missing = [tag_id for tag_id in normalized if tag_id not in existing_ids]
@@ -63,7 +63,7 @@ async def validate_task_tag_ids(
        raise HTTPException(
            status_code=status.HTTP_404_NOT_FOUND,
            detail={
-                "message": "One or more task tags do not exist in this organization.",
+                "message": "One or more tags do not exist in this organization.",
                "missing_tag_ids": [str(tag_id) for tag_id in missing],
            },
        )
@@ -71,18 +71,18 @@ async def validate_task_tag_ids(


@dataclass(slots=True)
-class TaskTagState:
-    """Ordered task-tag state for a task payload."""
+class TagState:
+    """Ordered tag state for a task payload."""

    tag_ids: list[UUID] = field(default_factory=list)
-    tags: list[TaskTagRef] = field(default_factory=list)
+    tags: list[TagRef] = field(default_factory=list)


-async def load_task_tag_state(
+async def load_tag_state(
    session: AsyncSession,
    *,
    task_ids: Sequence[UUID],
-) -> dict[UUID, TaskTagState]:
+) -> dict[UUID, TagState]:
    """Return ordered tag IDs and refs for each task id."""
    normalized_task_ids = _dedupe_uuid_list(task_ids)
    if not normalized_task_ids:
@@ -91,25 +91,25 @@ async def load_task_tag_state(
    rows = list(
        await session.exec(
            select(
-                col(TaskTagAssignment.task_id),
-                TaskTag,
+                col(TagAssignment.task_id),
+                Tag,
            )
-            .join(TaskTag, col(TaskTag.id) == col(TaskTagAssignment.tag_id))
-            .where(col(TaskTagAssignment.task_id).in_(normalized_task_ids))
+            .join(Tag, col(Tag.id) == col(TagAssignment.tag_id))
+            .where(col(TagAssignment.task_id).in_(normalized_task_ids))
            .order_by(
-                col(TaskTagAssignment.task_id).asc(),
-                col(TaskTagAssignment.created_at).asc(),
+                col(TagAssignment.task_id).asc(),
+                col(TagAssignment.created_at).asc(),
            ),
        ),
    )
-    state_by_task_id: dict[UUID, TaskTagState] = defaultdict(TaskTagState)
+    state_by_task_id: dict[UUID, TagState] = defaultdict(TagState)
    for task_id, tag in rows:
        if task_id is None:
            continue
        state = state_by_task_id[task_id]
        state.tag_ids.append(tag.id)
        state.tags.append(
-            TaskTagRef(
+            TagRef(
                id=tag.id,
                name=tag.name,
                slug=tag.slug,
@@ -119,7 +119,7 @@ async def load_task_tag_state(
    return dict(state_by_task_id)


-async def replace_task_tags(
+async def replace_tags(
    session: AsyncSession,
    *,
    task_id: UUID,
@@ -128,12 +128,12 @@ async def replace_task_tags(
    """Replace all tag-assignment rows for a task."""
    normalized = _dedupe_uuid_list(tag_ids)
    await session.exec(
-        delete(TaskTagAssignment).where(
-            col(TaskTagAssignment.task_id) == task_id,
+        delete(TagAssignment).where(
+            col(TagAssignment.task_id) == task_id,
        ),
    )
    for tag_id in normalized:
-        session.add(TaskTagAssignment(task_id=task_id, tag_id=tag_id))
+        session.add(TagAssignment(task_id=task_id, tag_id=tag_id))


 async def task_counts_for_tags(
@@ -148,11 +148,11 @@ async def task_counts_for_tags(
    rows = list(
        await session.exec(
            select(
-                col(TaskTagAssignment.tag_id),
-                func.count(col(TaskTagAssignment.task_id)),
+                col(TagAssignment.tag_id),
+                func.count(col(TagAssignment.task_id)),
            )
-            .where(col(TaskTagAssignment.tag_id).in_(normalized))
-            .group_by(col(TaskTagAssignment.tag_id)),
+            .where(col(TagAssignment.tag_id).in_(normalized))
+            .group_by(col(TagAssignment.tag_id)),
        ),
    )
    return {tag_id: int(count or 0) for tag_id, count in rows}
--- a/backend/migrations/versions/d8c1e5a4f7b2_add_task_tags_and_assignments.py
+++ b/backend/migrations/versions/d8c1e5a4f7b2_add_task_tags_and_assignments.py
@@ -1,4 +1,4 @@
-"""add task tags and task-tag assignments
+"""add tags and tag assignments

 Revision ID: d8c1e5a4f7b2
 Revises: 99cd6df95f85, b4338be78eec
@@ -38,28 +38,28 @@ def upgrade() -> None:
            sa.UniqueConstraint(
                "organization_id",
                "slug",
-                name="uq_task_tags_organization_id_slug",
+                name="uq_tags_organization_id_slug",
            ),
        )
-    task_tag_indexes = {item.get("name") for item in inspector.get_indexes("tags")}
-    if op.f("ix_task_tags_organization_id") not in task_tag_indexes:
+    tag_indexes = {item.get("name") for item in inspector.get_indexes("tags")}
+    if op.f("ix_tags_organization_id") not in tag_indexes:
        op.create_index(
-            op.f("ix_task_tags_organization_id"),
+            op.f("ix_tags_organization_id"),
            "tags",
            ["organization_id"],
            unique=False,
        )
-    if op.f("ix_task_tags_slug") not in task_tag_indexes:
+    if op.f("ix_tags_slug") not in tag_indexes:
        op.create_index(
-            op.f("ix_task_tags_slug"),
+            op.f("ix_tags_slug"),
            "tags",
            ["slug"],
            unique=False,
        )

-    if not inspector.has_table("task_tag_assignments"):
+    if not inspector.has_table("tag_assignments"):
        op.create_table(
-            "task_tag_assignments",
+            "tag_assignments",
            sa.Column("id", sa.Uuid(), nullable=False),
            sa.Column("task_id", sa.Uuid(), nullable=False),
            sa.Column("tag_id", sa.Uuid(), nullable=False),
@@ -70,32 +70,32 @@ def upgrade() -> None:
            sa.UniqueConstraint(
                "task_id",
                "tag_id",
-                name="uq_task_tag_assignments_task_id_tag_id",
+                name="uq_tag_assignments_task_id_tag_id",
            ),
        )
    assignment_indexes = {
-        item.get("name") for item in inspector.get_indexes("task_tag_assignments")
+        item.get("name") for item in inspector.get_indexes("tag_assignments")
    }
-    if op.f("ix_task_tag_assignments_task_id") not in assignment_indexes:
+    if op.f("ix_tag_assignments_task_id") not in assignment_indexes:
        op.create_index(
-            op.f("ix_task_tag_assignments_task_id"),
-            "task_tag_assignments",
+            op.f("ix_tag_assignments_task_id"),
+            "tag_assignments",
            ["task_id"],
            unique=False,
        )
-    if op.f("ix_task_tag_assignments_tag_id") not in assignment_indexes:
+    if op.f("ix_tag_assignments_tag_id") not in assignment_indexes:
        op.create_index(
-            op.f("ix_task_tag_assignments_tag_id"),
-            "task_tag_assignments",
+            op.f("ix_tag_assignments_tag_id"),
+            "tag_assignments",
            ["tag_id"],
            unique=False,
        )


 def downgrade() -> None:
-    op.drop_index(op.f("ix_task_tag_assignments_tag_id"), table_name="task_tag_assignments")
-    op.drop_index(op.f("ix_task_tag_assignments_task_id"), table_name="task_tag_assignments")
-    op.drop_table("task_tag_assignments")
-    op.drop_index(op.f("ix_task_tags_slug"), table_name="tags")
-    op.drop_index(op.f("ix_task_tags_organization_id"), table_name="tags")
+    op.drop_index(op.f("ix_tag_assignments_tag_id"), table_name="tag_assignments")
+    op.drop_index(op.f("ix_tag_assignments_task_id"), table_name="tag_assignments")
+    op.drop_table("tag_assignments")
+    op.drop_index(op.f("ix_tags_slug"), table_name="tags")
+    op.drop_index(op.f("ix_tags_organization_id"), table_name="tags")
    op.drop_table("tags")
--- a/backend/templates/HEARTBEAT_LEAD.md
+++ b/backend/templates/HEARTBEAT_LEAD.md
@@ -275,7 +275,7 @@ Body: {"depends_on_task_ids":["DEP_TASK_ID_1","DEP_TASK_ID_2"]}
 7) Creating new tasks:
 - Before creating any task or approval, run the de-duplication pass (step 2a). If a similar task already exists, merge/split scope there instead of creating a duplicate.
 - Leads **can** create tasks directly when confidence >= 70 and the action is not risky/external.
- If task tags are configured (`GET /api/v1/agent/boards/$BOARD_ID/tags` returns items), choose the most relevant tags and include their ids in `tag_ids`.
+- If tags are configured (`GET /api/v1/agent/boards/$BOARD_ID/tags` returns items), choose the most relevant tags and include their ids in `tag_ids`.
  - Build and keep a local map: `slug/name -> tag_id`.
  - Prefer 1-3 tags per task; avoid over-tagging.
  - If no existing tag fits, set `tag_ids: []` and leave a short note in your plan/comment so admins can add a missing tag later.
--- a/backend/tests/test_agent_task_tags_api.py
+++ b/backend/tests/test_agent_task_tags_api.py
@@ -10,20 +10,20 @@ from app.api import agent as agent_api
 from app.core.agent_auth import AgentAuthContext
 from app.models.agents import Agent
 from app.models.boards import Board
-from app.models.task_tags import TaskTag
+from app.models.tags import Tag


@dataclass
 class _FakeExecResult:
-    tags: list[TaskTag]
+    tags: list[Tag]

-    def all(self) -> list[TaskTag]:
+    def all(self) -> list[Tag]:
        return self.tags


@dataclass
 class _FakeSession:
-    tags: list[TaskTag]
+    tags: list[Tag]

    async def exec(self, _query: object) -> _FakeExecResult:
        return _FakeExecResult(self.tags)
@@ -52,18 +52,18 @@ def _agent_ctx(*, board_id: UUID | None) -> AgentAuthContext:


@pytest.mark.asyncio
-async def test_list_task_tags_returns_task_tag_refs() -> None:
+async def test_list_tags_returns_tag_refs() -> None:
    board = _board()
    session = _FakeSession(
        tags=[
-            TaskTag(
+            Tag(
                id=uuid4(),
                organization_id=board.organization_id,
                name="Backend",
                slug="backend",
                color="0f172a",
            ),
-            TaskTag(
+            Tag(
                id=uuid4(),
                organization_id=board.organization_id,
                name="Urgent",
@@ -73,7 +73,7 @@ async def test_list_task_tags_returns_task_tag_refs() -> None:
        ],
    )

-    response = await agent_api.list_task_tags(
+    response = await agent_api.list_tags(
        board=board,
        session=session,  # type: ignore[arg-type]
        agent_ctx=_agent_ctx(board_id=board.id),
@@ -85,12 +85,12 @@ async def test_list_task_tags_returns_task_tag_refs() -> None:


@pytest.mark.asyncio
-async def test_list_task_tags_rejects_cross_board_agent() -> None:
+async def test_list_tags_rejects_cross_board_agent() -> None:
    board = _board()
    session = _FakeSession(tags=[])

    with pytest.raises(HTTPException) as exc:
-        await agent_api.list_task_tags(
+        await agent_api.list_tags(
            board=board,
            session=session,  # type: ignore[arg-type]
            agent_ctx=_agent_ctx(board_id=uuid4()),
--- a/backend/tests/test_task_tags_service.py
+++ b/backend/tests/test_task_tags_service.py
@@ -7,8 +7,8 @@ from uuid import uuid4

 import pytest

-from app.models.task_tags import TaskTag
-from app.services import task_tags
+from app.models.tags import Tag
+from app.services import tags


@dataclass
@@ -27,18 +27,18 @@ class _FakeSession:
        self.added.append(value)


-def test_slugify_task_tag_normalizes_text():
-    assert task_tags.slugify_task_tag("Release / QA") == "release-qa"
-    assert task_tags.slugify_task_tag("  ###  ") == "tag"
+def test_slugify_tag_normalizes_text():
+    assert tags.slugify_tag("Release / QA") == "release-qa"
+    assert tags.slugify_tag("  ###  ") == "tag"


@pytest.mark.asyncio
-async def test_validate_task_tag_ids_dedupes_and_preserves_order():
+async def test_validate_tag_ids_dedupes_and_preserves_order():
    org_id = uuid4()
    tag_a = uuid4()
    tag_b = uuid4()
    session = _FakeSession(exec_results=[{tag_a, tag_b}])
-    result = await task_tags.validate_task_tag_ids(
+    result = await tags.validate_tag_ids(
        session,
        organization_id=org_id,
        tag_ids=[tag_a, tag_b, tag_a],
@@ -47,13 +47,13 @@ async def test_validate_task_tag_ids_dedupes_and_preserves_order():


@pytest.mark.asyncio
-async def test_validate_task_tag_ids_rejects_missing_tags():
+async def test_validate_tag_ids_rejects_missing_tags():
    org_id = uuid4()
    tag_a = uuid4()
    missing = uuid4()
    session = _FakeSession(exec_results=[{tag_a}])
-    with pytest.raises(task_tags.HTTPException) as exc:
-        await task_tags.validate_task_tag_ids(
+    with pytest.raises(tags.HTTPException) as exc:
+        await tags.validate_tag_ids(
            session,
            organization_id=org_id,
            tag_ids=[tag_a, missing],
@@ -63,7 +63,7 @@ async def test_validate_task_tag_ids_rejects_missing_tags():


@pytest.mark.asyncio
-async def test_load_task_tag_state_groups_rows_by_task_id():
+async def test_load_tag_state_groups_rows_by_task_id():
    task_a = uuid4()
    task_b = uuid4()
    tag_a = uuid4()
@@ -73,7 +73,7 @@ async def test_load_task_tag_state_groups_rows_by_task_id():
            [
                (
                    task_a,
-                    TaskTag(
+                    Tag(
                        id=tag_a,
                        organization_id=uuid4(),
                        name="Backend",
@@ -83,7 +83,7 @@ async def test_load_task_tag_state_groups_rows_by_task_id():
                ),
                (
                    task_a,
-                    TaskTag(
+                    Tag(
                        id=tag_b,
                        organization_id=uuid4(),
                        name="Urgent",
@@ -93,7 +93,7 @@ async def test_load_task_tag_state_groups_rows_by_task_id():
                ),
                (
                    task_b,
-                    TaskTag(
+                    Tag(
                        id=tag_b,
                        organization_id=uuid4(),
                        name="Urgent",
@@ -104,7 +104,7 @@ async def test_load_task_tag_state_groups_rows_by_task_id():
            ],
        ],
    )
-    state = await task_tags.load_task_tag_state(
+    state = await tags.load_tag_state(
        session,
        task_ids=[task_a, task_b],
    )
@@ -114,12 +114,12 @@ async def test_load_task_tag_state_groups_rows_by_task_id():


@pytest.mark.asyncio
-async def test_replace_task_tags_replaces_existing_links():
+async def test_replace_tags_replaces_existing_links():
    task_id = uuid4()
    tag_a = uuid4()
    tag_b = uuid4()
    session = _FakeSession(exec_results=[None])
-    await task_tags.replace_task_tags(
+    await tags.replace_tags(
        session,
        task_id=task_id,
        tag_ids=[tag_a, tag_b, tag_a],
--- a/frontend/src/api/generated/agent/agent.ts
+++ b/frontend/src/api/generated/agent/agent.ts
--- a/frontend/src/api/generated/agents/agents.ts
+++ b/frontend/src/api/generated/agents/agents.ts
@@ -364,134 +364,6 @@ export const useCreateAgentApiV1AgentsPost = <
    queryClient,
  );
 };
-/**
- * Heartbeat an existing agent or create/provision one if needed.
- * @summary Heartbeat Or Create Agent
- */
-export type heartbeatOrCreateAgentApiV1AgentsHeartbeatPostResponse200 = {
-  data: AgentRead;
-  status: 200;
-};
-
-export type heartbeatOrCreateAgentApiV1AgentsHeartbeatPostResponse422 = {
-  data: HTTPValidationError;
-  status: 422;
-};
-
-export type heartbeatOrCreateAgentApiV1AgentsHeartbeatPostResponseSuccess =
-  heartbeatOrCreateAgentApiV1AgentsHeartbeatPostResponse200 & {
-    headers: Headers;
-  };
-export type heartbeatOrCreateAgentApiV1AgentsHeartbeatPostResponseError =
-  heartbeatOrCreateAgentApiV1AgentsHeartbeatPostResponse422 & {
-    headers: Headers;
-  };
-
-export type heartbeatOrCreateAgentApiV1AgentsHeartbeatPostResponse =
-  | heartbeatOrCreateAgentApiV1AgentsHeartbeatPostResponseSuccess
-  | heartbeatOrCreateAgentApiV1AgentsHeartbeatPostResponseError;
-
-export const getHeartbeatOrCreateAgentApiV1AgentsHeartbeatPostUrl = () => {
-  return `/api/v1/agents/heartbeat`;
-};
-
-export const heartbeatOrCreateAgentApiV1AgentsHeartbeatPost = async (
-  agentHeartbeatCreate: AgentHeartbeatCreate,
-  options?: RequestInit,
-): Promise<heartbeatOrCreateAgentApiV1AgentsHeartbeatPostResponse> => {
-  return customFetch<heartbeatOrCreateAgentApiV1AgentsHeartbeatPostResponse>(
-    getHeartbeatOrCreateAgentApiV1AgentsHeartbeatPostUrl(),
-    {
-      ...options,
-      method: "POST",
-      headers: { "Content-Type": "application/json", ...options?.headers },
-      body: JSON.stringify(agentHeartbeatCreate),
-    },
-  );
-};
-
-export const getHeartbeatOrCreateAgentApiV1AgentsHeartbeatPostMutationOptions =
-  <TError = HTTPValidationError, TContext = unknown>(options?: {
-    mutation?: UseMutationOptions<
-      Awaited<
-        ReturnType<typeof heartbeatOrCreateAgentApiV1AgentsHeartbeatPost>
-      >,
-      TError,
-      { data: AgentHeartbeatCreate },
-      TContext
-    >;
-    request?: SecondParameter<typeof customFetch>;
-  }): UseMutationOptions<
-    Awaited<ReturnType<typeof heartbeatOrCreateAgentApiV1AgentsHeartbeatPost>>,
-    TError,
-    { data: AgentHeartbeatCreate },
-    TContext
-  > => {
-    const mutationKey = ["heartbeatOrCreateAgentApiV1AgentsHeartbeatPost"];
-    const { mutation: mutationOptions, request: requestOptions } = options
-      ? options.mutation &&
-        "mutationKey" in options.mutation &&
-        options.mutation.mutationKey
-        ? options
-        : { ...options, mutation: { ...options.mutation, mutationKey } }
-      : { mutation: { mutationKey }, request: undefined };
-
-    const mutationFn: MutationFunction<
-      Awaited<
-        ReturnType<typeof heartbeatOrCreateAgentApiV1AgentsHeartbeatPost>
-      >,
-      { data: AgentHeartbeatCreate }
-    > = (props) => {
-      const { data } = props ?? {};
-
-      return heartbeatOrCreateAgentApiV1AgentsHeartbeatPost(
-        data,
-        requestOptions,
-      );
-    };
-
-    return { mutationFn, ...mutationOptions };
-  };
-
-export type HeartbeatOrCreateAgentApiV1AgentsHeartbeatPostMutationResult =
-  NonNullable<
-    Awaited<ReturnType<typeof heartbeatOrCreateAgentApiV1AgentsHeartbeatPost>>
-  >;
-export type HeartbeatOrCreateAgentApiV1AgentsHeartbeatPostMutationBody =
-  AgentHeartbeatCreate;
-export type HeartbeatOrCreateAgentApiV1AgentsHeartbeatPostMutationError =
-  HTTPValidationError;
-
-/**
- * @summary Heartbeat Or Create Agent
- */
-export const useHeartbeatOrCreateAgentApiV1AgentsHeartbeatPost = <
-  TError = HTTPValidationError,
-  TContext = unknown,
->(
-  options?: {
-    mutation?: UseMutationOptions<
-      Awaited<
-        ReturnType<typeof heartbeatOrCreateAgentApiV1AgentsHeartbeatPost>
-      >,
-      TError,
-      { data: AgentHeartbeatCreate },
-      TContext
-    >;
-    request?: SecondParameter<typeof customFetch>;
-  },
-  queryClient?: QueryClient,
-): UseMutationResult<
-  Awaited<ReturnType<typeof heartbeatOrCreateAgentApiV1AgentsHeartbeatPost>>,
-  TError,
-  { data: AgentHeartbeatCreate },
-  TContext
-> => {
-  return useMutation(
-    getHeartbeatOrCreateAgentApiV1AgentsHeartbeatPostMutationOptions(options),
-    queryClient,
-  );
-};
 /**
 * Stream agent updates as SSE events.
 * @summary Stream Agents
@@ -704,123 +576,6 @@ export function useStreamAgentsApiV1AgentsStreamGet<
  return { ...query, queryKey: queryOptions.queryKey };
 }

-/**
- * Delete an agent and clean related task state.
- * @summary Delete Agent
- */
-export type deleteAgentApiV1AgentsAgentIdDeleteResponse200 = {
-  data: OkResponse;
-  status: 200;
-};
-
-export type deleteAgentApiV1AgentsAgentIdDeleteResponse422 = {
-  data: HTTPValidationError;
-  status: 422;
-};
-
-export type deleteAgentApiV1AgentsAgentIdDeleteResponseSuccess =
-  deleteAgentApiV1AgentsAgentIdDeleteResponse200 & {
-    headers: Headers;
-  };
-export type deleteAgentApiV1AgentsAgentIdDeleteResponseError =
-  deleteAgentApiV1AgentsAgentIdDeleteResponse422 & {
-    headers: Headers;
-  };
-
-export type deleteAgentApiV1AgentsAgentIdDeleteResponse =
-  | deleteAgentApiV1AgentsAgentIdDeleteResponseSuccess
-  | deleteAgentApiV1AgentsAgentIdDeleteResponseError;
-
-export const getDeleteAgentApiV1AgentsAgentIdDeleteUrl = (agentId: string) => {
-  return `/api/v1/agents/${agentId}`;
-};
-
-export const deleteAgentApiV1AgentsAgentIdDelete = async (
-  agentId: string,
-  options?: RequestInit,
-): Promise<deleteAgentApiV1AgentsAgentIdDeleteResponse> => {
-  return customFetch<deleteAgentApiV1AgentsAgentIdDeleteResponse>(
-    getDeleteAgentApiV1AgentsAgentIdDeleteUrl(agentId),
-    {
-      ...options,
-      method: "DELETE",
-    },
-  );
-};
-
-export const getDeleteAgentApiV1AgentsAgentIdDeleteMutationOptions = <
-  TError = HTTPValidationError,
-  TContext = unknown,
->(options?: {
-  mutation?: UseMutationOptions<
-    Awaited<ReturnType<typeof deleteAgentApiV1AgentsAgentIdDelete>>,
-    TError,
-    { agentId: string },
-    TContext
-  >;
-  request?: SecondParameter<typeof customFetch>;
-}): UseMutationOptions<
-  Awaited<ReturnType<typeof deleteAgentApiV1AgentsAgentIdDelete>>,
-  TError,
-  { agentId: string },
-  TContext
-> => {
-  const mutationKey = ["deleteAgentApiV1AgentsAgentIdDelete"];
-  const { mutation: mutationOptions, request: requestOptions } = options
-    ? options.mutation &&
-      "mutationKey" in options.mutation &&
-      options.mutation.mutationKey
-      ? options
-      : { ...options, mutation: { ...options.mutation, mutationKey } }
-    : { mutation: { mutationKey }, request: undefined };
-
-  const mutationFn: MutationFunction<
-    Awaited<ReturnType<typeof deleteAgentApiV1AgentsAgentIdDelete>>,
-    { agentId: string }
-  > = (props) => {
-    const { agentId } = props ?? {};
-
-    return deleteAgentApiV1AgentsAgentIdDelete(agentId, requestOptions);
-  };
-
-  return { mutationFn, ...mutationOptions };
-};
-
-export type DeleteAgentApiV1AgentsAgentIdDeleteMutationResult = NonNullable<
-  Awaited<ReturnType<typeof deleteAgentApiV1AgentsAgentIdDelete>>
->;
-
-export type DeleteAgentApiV1AgentsAgentIdDeleteMutationError =
-  HTTPValidationError;
-
-/**
- * @summary Delete Agent
- */
-export const useDeleteAgentApiV1AgentsAgentIdDelete = <
-  TError = HTTPValidationError,
-  TContext = unknown,
->(
-  options?: {
-    mutation?: UseMutationOptions<
-      Awaited<ReturnType<typeof deleteAgentApiV1AgentsAgentIdDelete>>,
-      TError,
-      { agentId: string },
-      TContext
-    >;
-    request?: SecondParameter<typeof customFetch>;
-  },
-  queryClient?: QueryClient,
-): UseMutationResult<
-  Awaited<ReturnType<typeof deleteAgentApiV1AgentsAgentIdDelete>>,
-  TError,
-  { agentId: string },
-  TContext
-> => {
-  return useMutation(
-    getDeleteAgentApiV1AgentsAgentIdDeleteMutationOptions(options),
-    queryClient,
-  );
-};
 /**
 * Get a single agent by id.
 * @summary Get Agent
@@ -1182,6 +937,123 @@ export const useUpdateAgentApiV1AgentsAgentIdPatch = <
    queryClient,
  );
 };
+/**
+ * Delete an agent and clean related task state.
+ * @summary Delete Agent
+ */
+export type deleteAgentApiV1AgentsAgentIdDeleteResponse200 = {
+  data: OkResponse;
+  status: 200;
+};
+
+export type deleteAgentApiV1AgentsAgentIdDeleteResponse422 = {
+  data: HTTPValidationError;
+  status: 422;
+};
+
+export type deleteAgentApiV1AgentsAgentIdDeleteResponseSuccess =
+  deleteAgentApiV1AgentsAgentIdDeleteResponse200 & {
+    headers: Headers;
+  };
+export type deleteAgentApiV1AgentsAgentIdDeleteResponseError =
+  deleteAgentApiV1AgentsAgentIdDeleteResponse422 & {
+    headers: Headers;
+  };
+
+export type deleteAgentApiV1AgentsAgentIdDeleteResponse =
+  | deleteAgentApiV1AgentsAgentIdDeleteResponseSuccess
+  | deleteAgentApiV1AgentsAgentIdDeleteResponseError;
+
+export const getDeleteAgentApiV1AgentsAgentIdDeleteUrl = (agentId: string) => {
+  return `/api/v1/agents/${agentId}`;
+};
+
+export const deleteAgentApiV1AgentsAgentIdDelete = async (
+  agentId: string,
+  options?: RequestInit,
+): Promise<deleteAgentApiV1AgentsAgentIdDeleteResponse> => {
+  return customFetch<deleteAgentApiV1AgentsAgentIdDeleteResponse>(
+    getDeleteAgentApiV1AgentsAgentIdDeleteUrl(agentId),
+    {
+      ...options,
+      method: "DELETE",
+    },
+  );
+};
+
+export const getDeleteAgentApiV1AgentsAgentIdDeleteMutationOptions = <
+  TError = HTTPValidationError,
+  TContext = unknown,
+>(options?: {
+  mutation?: UseMutationOptions<
+    Awaited<ReturnType<typeof deleteAgentApiV1AgentsAgentIdDelete>>,
+    TError,
+    { agentId: string },
+    TContext
+  >;
+  request?: SecondParameter<typeof customFetch>;
+}): UseMutationOptions<
+  Awaited<ReturnType<typeof deleteAgentApiV1AgentsAgentIdDelete>>,
+  TError,
+  { agentId: string },
+  TContext
+> => {
+  const mutationKey = ["deleteAgentApiV1AgentsAgentIdDelete"];
+  const { mutation: mutationOptions, request: requestOptions } = options
+    ? options.mutation &&
+      "mutationKey" in options.mutation &&
+      options.mutation.mutationKey
+      ? options
+      : { ...options, mutation: { ...options.mutation, mutationKey } }
+    : { mutation: { mutationKey }, request: undefined };
+
+  const mutationFn: MutationFunction<
+    Awaited<ReturnType<typeof deleteAgentApiV1AgentsAgentIdDelete>>,
+    { agentId: string }
+  > = (props) => {
+    const { agentId } = props ?? {};
+
+    return deleteAgentApiV1AgentsAgentIdDelete(agentId, requestOptions);
+  };
+
+  return { mutationFn, ...mutationOptions };
+};
+
+export type DeleteAgentApiV1AgentsAgentIdDeleteMutationResult = NonNullable<
+  Awaited<ReturnType<typeof deleteAgentApiV1AgentsAgentIdDelete>>
+>;
+
+export type DeleteAgentApiV1AgentsAgentIdDeleteMutationError =
+  HTTPValidationError;
+
+/**
+ * @summary Delete Agent
+ */
+export const useDeleteAgentApiV1AgentsAgentIdDelete = <
+  TError = HTTPValidationError,
+  TContext = unknown,
+>(
+  options?: {
+    mutation?: UseMutationOptions<
+      Awaited<ReturnType<typeof deleteAgentApiV1AgentsAgentIdDelete>>,
+      TError,
+      { agentId: string },
+      TContext
+    >;
+    request?: SecondParameter<typeof customFetch>;
+  },
+  queryClient?: QueryClient,
+): UseMutationResult<
+  Awaited<ReturnType<typeof deleteAgentApiV1AgentsAgentIdDelete>>,
+  TError,
+  { agentId: string },
+  TContext
+> => {
+  return useMutation(
+    getDeleteAgentApiV1AgentsAgentIdDeleteMutationOptions(options),
+    queryClient,
+  );
+};
 /**
 * Record a heartbeat for a specific agent.
 * @summary Heartbeat Agent
@@ -1310,3 +1182,131 @@ export const useHeartbeatAgentApiV1AgentsAgentIdHeartbeatPost = <
    queryClient,
  );
 };
+/**
+ * Heartbeat an existing agent or create/provision one if needed.
+ * @summary Heartbeat Or Create Agent
+ */
+export type heartbeatOrCreateAgentApiV1AgentsHeartbeatPostResponse200 = {
+  data: AgentRead;
+  status: 200;
+};
+
+export type heartbeatOrCreateAgentApiV1AgentsHeartbeatPostResponse422 = {
+  data: HTTPValidationError;
+  status: 422;
+};
+
+export type heartbeatOrCreateAgentApiV1AgentsHeartbeatPostResponseSuccess =
+  heartbeatOrCreateAgentApiV1AgentsHeartbeatPostResponse200 & {
+    headers: Headers;
+  };
+export type heartbeatOrCreateAgentApiV1AgentsHeartbeatPostResponseError =
+  heartbeatOrCreateAgentApiV1AgentsHeartbeatPostResponse422 & {
+    headers: Headers;
+  };
+
+export type heartbeatOrCreateAgentApiV1AgentsHeartbeatPostResponse =
+  | heartbeatOrCreateAgentApiV1AgentsHeartbeatPostResponseSuccess
+  | heartbeatOrCreateAgentApiV1AgentsHeartbeatPostResponseError;
+
+export const getHeartbeatOrCreateAgentApiV1AgentsHeartbeatPostUrl = () => {
+  return `/api/v1/agents/heartbeat`;
+};
+
+export const heartbeatOrCreateAgentApiV1AgentsHeartbeatPost = async (
+  agentHeartbeatCreate: AgentHeartbeatCreate,
+  options?: RequestInit,
+): Promise<heartbeatOrCreateAgentApiV1AgentsHeartbeatPostResponse> => {
+  return customFetch<heartbeatOrCreateAgentApiV1AgentsHeartbeatPostResponse>(
+    getHeartbeatOrCreateAgentApiV1AgentsHeartbeatPostUrl(),
+    {
+      ...options,
+      method: "POST",
+      headers: { "Content-Type": "application/json", ...options?.headers },
+      body: JSON.stringify(agentHeartbeatCreate),
+    },
+  );
+};
+
+export const getHeartbeatOrCreateAgentApiV1AgentsHeartbeatPostMutationOptions =
+  <TError = HTTPValidationError, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<
+      Awaited<
+        ReturnType<typeof heartbeatOrCreateAgentApiV1AgentsHeartbeatPost>
+      >,
+      TError,
+      { data: AgentHeartbeatCreate },
+      TContext
+    >;
+    request?: SecondParameter<typeof customFetch>;
+  }): UseMutationOptions<
+    Awaited<ReturnType<typeof heartbeatOrCreateAgentApiV1AgentsHeartbeatPost>>,
+    TError,
+    { data: AgentHeartbeatCreate },
+    TContext
+  > => {
+    const mutationKey = ["heartbeatOrCreateAgentApiV1AgentsHeartbeatPost"];
+    const { mutation: mutationOptions, request: requestOptions } = options
+      ? options.mutation &&
+        "mutationKey" in options.mutation &&
+        options.mutation.mutationKey
+        ? options
+        : { ...options, mutation: { ...options.mutation, mutationKey } }
+      : { mutation: { mutationKey }, request: undefined };
+
+    const mutationFn: MutationFunction<
+      Awaited<
+        ReturnType<typeof heartbeatOrCreateAgentApiV1AgentsHeartbeatPost>
+      >,
+      { data: AgentHeartbeatCreate }
+    > = (props) => {
+      const { data } = props ?? {};
+
+      return heartbeatOrCreateAgentApiV1AgentsHeartbeatPost(
+        data,
+        requestOptions,
+      );
+    };
+
+    return { mutationFn, ...mutationOptions };
+  };
+
+export type HeartbeatOrCreateAgentApiV1AgentsHeartbeatPostMutationResult =
+  NonNullable<
+    Awaited<ReturnType<typeof heartbeatOrCreateAgentApiV1AgentsHeartbeatPost>>
+  >;
+export type HeartbeatOrCreateAgentApiV1AgentsHeartbeatPostMutationBody =
+  AgentHeartbeatCreate;
+export type HeartbeatOrCreateAgentApiV1AgentsHeartbeatPostMutationError =
+  HTTPValidationError;
+
+/**
+ * @summary Heartbeat Or Create Agent
+ */
+export const useHeartbeatOrCreateAgentApiV1AgentsHeartbeatPost = <
+  TError = HTTPValidationError,
+  TContext = unknown,
+>(
+  options?: {
+    mutation?: UseMutationOptions<
+      Awaited<
+        ReturnType<typeof heartbeatOrCreateAgentApiV1AgentsHeartbeatPost>
+      >,
+      TError,
+      { data: AgentHeartbeatCreate },
+      TContext
+    >;
+    request?: SecondParameter<typeof customFetch>;
+  },
+  queryClient?: QueryClient,
+): UseMutationResult<
+  Awaited<ReturnType<typeof heartbeatOrCreateAgentApiV1AgentsHeartbeatPost>>,
+  TError,
+  { data: AgentHeartbeatCreate },
+  TContext
+> => {
+  return useMutation(
+    getHeartbeatOrCreateAgentApiV1AgentsHeartbeatPostMutationOptions(options),
+    queryClient,
+  );
+};
--- a/frontend/src/api/generated/board-groups/board-groups.ts
+++ b/frontend/src/api/generated/board-groups/board-groups.ts
@@ -369,129 +369,6 @@ export const useCreateBoardGroupApiV1BoardGroupsPost = <
    queryClient,
  );
 };
-/**
- * Delete a board group.
- * @summary Delete Board Group
- */
-export type deleteBoardGroupApiV1BoardGroupsGroupIdDeleteResponse200 = {
-  data: OkResponse;
-  status: 200;
-};
-
-export type deleteBoardGroupApiV1BoardGroupsGroupIdDeleteResponse422 = {
-  data: HTTPValidationError;
-  status: 422;
-};
-
-export type deleteBoardGroupApiV1BoardGroupsGroupIdDeleteResponseSuccess =
-  deleteBoardGroupApiV1BoardGroupsGroupIdDeleteResponse200 & {
-    headers: Headers;
-  };
-export type deleteBoardGroupApiV1BoardGroupsGroupIdDeleteResponseError =
-  deleteBoardGroupApiV1BoardGroupsGroupIdDeleteResponse422 & {
-    headers: Headers;
-  };
-
-export type deleteBoardGroupApiV1BoardGroupsGroupIdDeleteResponse =
-  | deleteBoardGroupApiV1BoardGroupsGroupIdDeleteResponseSuccess
-  | deleteBoardGroupApiV1BoardGroupsGroupIdDeleteResponseError;
-
-export const getDeleteBoardGroupApiV1BoardGroupsGroupIdDeleteUrl = (
-  groupId: string,
-) => {
-  return `/api/v1/board-groups/${groupId}`;
-};
-
-export const deleteBoardGroupApiV1BoardGroupsGroupIdDelete = async (
-  groupId: string,
-  options?: RequestInit,
-): Promise<deleteBoardGroupApiV1BoardGroupsGroupIdDeleteResponse> => {
-  return customFetch<deleteBoardGroupApiV1BoardGroupsGroupIdDeleteResponse>(
-    getDeleteBoardGroupApiV1BoardGroupsGroupIdDeleteUrl(groupId),
-    {
-      ...options,
-      method: "DELETE",
-    },
-  );
-};
-
-export const getDeleteBoardGroupApiV1BoardGroupsGroupIdDeleteMutationOptions = <
-  TError = HTTPValidationError,
-  TContext = unknown,
->(options?: {
-  mutation?: UseMutationOptions<
-    Awaited<ReturnType<typeof deleteBoardGroupApiV1BoardGroupsGroupIdDelete>>,
-    TError,
-    { groupId: string },
-    TContext
-  >;
-  request?: SecondParameter<typeof customFetch>;
-}): UseMutationOptions<
-  Awaited<ReturnType<typeof deleteBoardGroupApiV1BoardGroupsGroupIdDelete>>,
-  TError,
-  { groupId: string },
-  TContext
-> => {
-  const mutationKey = ["deleteBoardGroupApiV1BoardGroupsGroupIdDelete"];
-  const { mutation: mutationOptions, request: requestOptions } = options
-    ? options.mutation &&
-      "mutationKey" in options.mutation &&
-      options.mutation.mutationKey
-      ? options
-      : { ...options, mutation: { ...options.mutation, mutationKey } }
-    : { mutation: { mutationKey }, request: undefined };
-
-  const mutationFn: MutationFunction<
-    Awaited<ReturnType<typeof deleteBoardGroupApiV1BoardGroupsGroupIdDelete>>,
-    { groupId: string }
-  > = (props) => {
-    const { groupId } = props ?? {};
-
-    return deleteBoardGroupApiV1BoardGroupsGroupIdDelete(
-      groupId,
-      requestOptions,
-    );
-  };
-
-  return { mutationFn, ...mutationOptions };
-};
-
-export type DeleteBoardGroupApiV1BoardGroupsGroupIdDeleteMutationResult =
-  NonNullable<
-    Awaited<ReturnType<typeof deleteBoardGroupApiV1BoardGroupsGroupIdDelete>>
-  >;
-
-export type DeleteBoardGroupApiV1BoardGroupsGroupIdDeleteMutationError =
-  HTTPValidationError;
-
-/**
- * @summary Delete Board Group
- */
-export const useDeleteBoardGroupApiV1BoardGroupsGroupIdDelete = <
-  TError = HTTPValidationError,
-  TContext = unknown,
->(
-  options?: {
-    mutation?: UseMutationOptions<
-      Awaited<ReturnType<typeof deleteBoardGroupApiV1BoardGroupsGroupIdDelete>>,
-      TError,
-      { groupId: string },
-      TContext
-    >;
-    request?: SecondParameter<typeof customFetch>;
-  },
-  queryClient?: QueryClient,
-): UseMutationResult<
-  Awaited<ReturnType<typeof deleteBoardGroupApiV1BoardGroupsGroupIdDelete>>,
-  TError,
-  { groupId: string },
-  TContext
-> => {
-  return useMutation(
-    getDeleteBoardGroupApiV1BoardGroupsGroupIdDeleteMutationOptions(options),
-    queryClient,
-  );
-};
 /**
 * Get a board group by id.
 * @summary Get Board Group
@@ -830,161 +707,125 @@ export const useUpdateBoardGroupApiV1BoardGroupsGroupIdPatch = <
  );
 };
 /**
- * Apply heartbeat settings to agents in a board group.
- * @summary Apply Board Group Heartbeat
+ * Delete a board group.
+ * @summary Delete Board Group
 */
-export type applyBoardGroupHeartbeatApiV1BoardGroupsGroupIdHeartbeatPostResponse200 =
-  {
-    data: BoardGroupHeartbeatApplyResult;
-    status: 200;
-  };
+export type deleteBoardGroupApiV1BoardGroupsGroupIdDeleteResponse200 = {
+  data: OkResponse;
+  status: 200;
+};

-export type applyBoardGroupHeartbeatApiV1BoardGroupsGroupIdHeartbeatPostResponse422 =
-  {
-    data: HTTPValidationError;
-    status: 422;
-  };
+export type deleteBoardGroupApiV1BoardGroupsGroupIdDeleteResponse422 = {
+  data: HTTPValidationError;
+  status: 422;
+};

-export type applyBoardGroupHeartbeatApiV1BoardGroupsGroupIdHeartbeatPostResponseSuccess =
-  applyBoardGroupHeartbeatApiV1BoardGroupsGroupIdHeartbeatPostResponse200 & {
+export type deleteBoardGroupApiV1BoardGroupsGroupIdDeleteResponseSuccess =
+  deleteBoardGroupApiV1BoardGroupsGroupIdDeleteResponse200 & {
    headers: Headers;
  };
-export type applyBoardGroupHeartbeatApiV1BoardGroupsGroupIdHeartbeatPostResponseError =
-  applyBoardGroupHeartbeatApiV1BoardGroupsGroupIdHeartbeatPostResponse422 & {
+export type deleteBoardGroupApiV1BoardGroupsGroupIdDeleteResponseError =
+  deleteBoardGroupApiV1BoardGroupsGroupIdDeleteResponse422 & {
    headers: Headers;
  };

-export type applyBoardGroupHeartbeatApiV1BoardGroupsGroupIdHeartbeatPostResponse =
+export type deleteBoardGroupApiV1BoardGroupsGroupIdDeleteResponse =
+  | deleteBoardGroupApiV1BoardGroupsGroupIdDeleteResponseSuccess
+  | deleteBoardGroupApiV1BoardGroupsGroupIdDeleteResponseError;

-    | applyBoardGroupHeartbeatApiV1BoardGroupsGroupIdHeartbeatPostResponseSuccess
-    | applyBoardGroupHeartbeatApiV1BoardGroupsGroupIdHeartbeatPostResponseError;
+export const getDeleteBoardGroupApiV1BoardGroupsGroupIdDeleteUrl = (
+  groupId: string,
+) => {
+  return `/api/v1/board-groups/${groupId}`;
+};

-export const getApplyBoardGroupHeartbeatApiV1BoardGroupsGroupIdHeartbeatPostUrl =
-  (groupId: string) => {
-    return `/api/v1/board-groups/${groupId}/heartbeat`;
-  };
+export const deleteBoardGroupApiV1BoardGroupsGroupIdDelete = async (
+  groupId: string,
+  options?: RequestInit,
+): Promise<deleteBoardGroupApiV1BoardGroupsGroupIdDeleteResponse> => {
+  return customFetch<deleteBoardGroupApiV1BoardGroupsGroupIdDeleteResponse>(
+    getDeleteBoardGroupApiV1BoardGroupsGroupIdDeleteUrl(groupId),
+    {
+      ...options,
+      method: "DELETE",
+    },
+  );
+};

-export const applyBoardGroupHeartbeatApiV1BoardGroupsGroupIdHeartbeatPost =
-  async (
-    groupId: string,
-    boardGroupHeartbeatApply: BoardGroupHeartbeatApply,
-    options?: RequestInit,
-  ): Promise<applyBoardGroupHeartbeatApiV1BoardGroupsGroupIdHeartbeatPostResponse> => {
-    return customFetch<applyBoardGroupHeartbeatApiV1BoardGroupsGroupIdHeartbeatPostResponse>(
-      getApplyBoardGroupHeartbeatApiV1BoardGroupsGroupIdHeartbeatPostUrl(
-        groupId,
-      ),
-      {
-        ...options,
-        method: "POST",
-        headers: { "Content-Type": "application/json", ...options?.headers },
-        body: JSON.stringify(boardGroupHeartbeatApply),
-      },
+export const getDeleteBoardGroupApiV1BoardGroupsGroupIdDeleteMutationOptions = <
+  TError = HTTPValidationError,
+  TContext = unknown,
+>(options?: {
+  mutation?: UseMutationOptions<
+    Awaited<ReturnType<typeof deleteBoardGroupApiV1BoardGroupsGroupIdDelete>>,
+    TError,
+    { groupId: string },
+    TContext
+  >;
+  request?: SecondParameter<typeof customFetch>;
+}): UseMutationOptions<
+  Awaited<ReturnType<typeof deleteBoardGroupApiV1BoardGroupsGroupIdDelete>>,
+  TError,
+  { groupId: string },
+  TContext
+> => {
+  const mutationKey = ["deleteBoardGroupApiV1BoardGroupsGroupIdDelete"];
+  const { mutation: mutationOptions, request: requestOptions } = options
+    ? options.mutation &&
+      "mutationKey" in options.mutation &&
+      options.mutation.mutationKey
+      ? options
+      : { ...options, mutation: { ...options.mutation, mutationKey } }
+    : { mutation: { mutationKey }, request: undefined };
+
+  const mutationFn: MutationFunction<
+    Awaited<ReturnType<typeof deleteBoardGroupApiV1BoardGroupsGroupIdDelete>>,
+    { groupId: string }
+  > = (props) => {
+    const { groupId } = props ?? {};
+
+    return deleteBoardGroupApiV1BoardGroupsGroupIdDelete(
+      groupId,
+      requestOptions,
    );
  };

-export const getApplyBoardGroupHeartbeatApiV1BoardGroupsGroupIdHeartbeatPostMutationOptions =
-  <TError = HTTPValidationError, TContext = unknown>(options?: {
-    mutation?: UseMutationOptions<
-      Awaited<
-        ReturnType<
-          typeof applyBoardGroupHeartbeatApiV1BoardGroupsGroupIdHeartbeatPost
-        >
-      >,
-      TError,
-      { groupId: string; data: BoardGroupHeartbeatApply },
-      TContext
-    >;
-    request?: SecondParameter<typeof customFetch>;
-  }): UseMutationOptions<
-    Awaited<
-      ReturnType<
-        typeof applyBoardGroupHeartbeatApiV1BoardGroupsGroupIdHeartbeatPost
-      >
-    >,
-    TError,
-    { groupId: string; data: BoardGroupHeartbeatApply },
-    TContext
-  > => {
-    const mutationKey = [
-      "applyBoardGroupHeartbeatApiV1BoardGroupsGroupIdHeartbeatPost",
-    ];
-    const { mutation: mutationOptions, request: requestOptions } = options
-      ? options.mutation &&
-        "mutationKey" in options.mutation &&
-        options.mutation.mutationKey
-        ? options
-        : { ...options, mutation: { ...options.mutation, mutationKey } }
-      : { mutation: { mutationKey }, request: undefined };
+  return { mutationFn, ...mutationOptions };
+};

-    const mutationFn: MutationFunction<
-      Awaited<
-        ReturnType<
-          typeof applyBoardGroupHeartbeatApiV1BoardGroupsGroupIdHeartbeatPost
-        >
-      >,
-      { groupId: string; data: BoardGroupHeartbeatApply }
-    > = (props) => {
-      const { groupId, data } = props ?? {};
-
-      return applyBoardGroupHeartbeatApiV1BoardGroupsGroupIdHeartbeatPost(
-        groupId,
-        data,
-        requestOptions,
-      );
-    };
-
-    return { mutationFn, ...mutationOptions };
-  };
-
-export type ApplyBoardGroupHeartbeatApiV1BoardGroupsGroupIdHeartbeatPostMutationResult =
+export type DeleteBoardGroupApiV1BoardGroupsGroupIdDeleteMutationResult =
  NonNullable<
-    Awaited<
-      ReturnType<
-        typeof applyBoardGroupHeartbeatApiV1BoardGroupsGroupIdHeartbeatPost
-      >
-    >
+    Awaited<ReturnType<typeof deleteBoardGroupApiV1BoardGroupsGroupIdDelete>>
  >;
-export type ApplyBoardGroupHeartbeatApiV1BoardGroupsGroupIdHeartbeatPostMutationBody =
-  BoardGroupHeartbeatApply;
-export type ApplyBoardGroupHeartbeatApiV1BoardGroupsGroupIdHeartbeatPostMutationError =
+
+export type DeleteBoardGroupApiV1BoardGroupsGroupIdDeleteMutationError =
  HTTPValidationError;

 /**
- * @summary Apply Board Group Heartbeat
+ * @summary Delete Board Group
 */
-export const useApplyBoardGroupHeartbeatApiV1BoardGroupsGroupIdHeartbeatPost = <
+export const useDeleteBoardGroupApiV1BoardGroupsGroupIdDelete = <
  TError = HTTPValidationError,
  TContext = unknown,
 >(
  options?: {
    mutation?: UseMutationOptions<
-      Awaited<
-        ReturnType<
-          typeof applyBoardGroupHeartbeatApiV1BoardGroupsGroupIdHeartbeatPost
-        >
-      >,
+      Awaited<ReturnType<typeof deleteBoardGroupApiV1BoardGroupsGroupIdDelete>>,
      TError,
-      { groupId: string; data: BoardGroupHeartbeatApply },
+      { groupId: string },
      TContext
    >;
    request?: SecondParameter<typeof customFetch>;
  },
  queryClient?: QueryClient,
 ): UseMutationResult<
-  Awaited<
-    ReturnType<
-      typeof applyBoardGroupHeartbeatApiV1BoardGroupsGroupIdHeartbeatPost
-    >
-  >,
+  Awaited<ReturnType<typeof deleteBoardGroupApiV1BoardGroupsGroupIdDelete>>,
  TError,
-  { groupId: string; data: BoardGroupHeartbeatApply },
+  { groupId: string },
  TContext
 > => {
  return useMutation(
-    getApplyBoardGroupHeartbeatApiV1BoardGroupsGroupIdHeartbeatPostMutationOptions(
-      options,
-    ),
+    getDeleteBoardGroupApiV1BoardGroupsGroupIdDeleteMutationOptions(options),
    queryClient,
  );
 };
@@ -1290,3 +1131,163 @@ export function useGetBoardGroupSnapshotApiV1BoardGroupsGroupIdSnapshotGet<

  return { ...query, queryKey: queryOptions.queryKey };
 }
+
+/**
+ * Apply heartbeat settings to agents in a board group.
+ * @summary Apply Board Group Heartbeat
+ */
+export type applyBoardGroupHeartbeatApiV1BoardGroupsGroupIdHeartbeatPostResponse200 =
+  {
+    data: BoardGroupHeartbeatApplyResult;
+    status: 200;
+  };
+
+export type applyBoardGroupHeartbeatApiV1BoardGroupsGroupIdHeartbeatPostResponse422 =
+  {
+    data: HTTPValidationError;
+    status: 422;
+  };
+
+export type applyBoardGroupHeartbeatApiV1BoardGroupsGroupIdHeartbeatPostResponseSuccess =
+  applyBoardGroupHeartbeatApiV1BoardGroupsGroupIdHeartbeatPostResponse200 & {
+    headers: Headers;
+  };
+export type applyBoardGroupHeartbeatApiV1BoardGroupsGroupIdHeartbeatPostResponseError =
+  applyBoardGroupHeartbeatApiV1BoardGroupsGroupIdHeartbeatPostResponse422 & {
+    headers: Headers;
+  };
+
+export type applyBoardGroupHeartbeatApiV1BoardGroupsGroupIdHeartbeatPostResponse =
+
+    | applyBoardGroupHeartbeatApiV1BoardGroupsGroupIdHeartbeatPostResponseSuccess
+    | applyBoardGroupHeartbeatApiV1BoardGroupsGroupIdHeartbeatPostResponseError;
+
+export const getApplyBoardGroupHeartbeatApiV1BoardGroupsGroupIdHeartbeatPostUrl =
+  (groupId: string) => {
+    return `/api/v1/board-groups/${groupId}/heartbeat`;
+  };
+
+export const applyBoardGroupHeartbeatApiV1BoardGroupsGroupIdHeartbeatPost =
+  async (
+    groupId: string,
+    boardGroupHeartbeatApply: BoardGroupHeartbeatApply,
+    options?: RequestInit,
+  ): Promise<applyBoardGroupHeartbeatApiV1BoardGroupsGroupIdHeartbeatPostResponse> => {
+    return customFetch<applyBoardGroupHeartbeatApiV1BoardGroupsGroupIdHeartbeatPostResponse>(
+      getApplyBoardGroupHeartbeatApiV1BoardGroupsGroupIdHeartbeatPostUrl(
+        groupId,
+      ),
+      {
+        ...options,
+        method: "POST",
+        headers: { "Content-Type": "application/json", ...options?.headers },
+        body: JSON.stringify(boardGroupHeartbeatApply),
+      },
+    );
+  };
+
+export const getApplyBoardGroupHeartbeatApiV1BoardGroupsGroupIdHeartbeatPostMutationOptions =
+  <TError = HTTPValidationError, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<
+      Awaited<
+        ReturnType<
+          typeof applyBoardGroupHeartbeatApiV1BoardGroupsGroupIdHeartbeatPost
+        >
+      >,
+      TError,
+      { groupId: string; data: BoardGroupHeartbeatApply },
+      TContext
+    >;
+    request?: SecondParameter<typeof customFetch>;
+  }): UseMutationOptions<
+    Awaited<
+      ReturnType<
+        typeof applyBoardGroupHeartbeatApiV1BoardGroupsGroupIdHeartbeatPost
+      >
+    >,
+    TError,
+    { groupId: string; data: BoardGroupHeartbeatApply },
+    TContext
+  > => {
+    const mutationKey = [
+      "applyBoardGroupHeartbeatApiV1BoardGroupsGroupIdHeartbeatPost",
+    ];
+    const { mutation: mutationOptions, request: requestOptions } = options
+      ? options.mutation &&
+        "mutationKey" in options.mutation &&
+        options.mutation.mutationKey
+        ? options
+        : { ...options, mutation: { ...options.mutation, mutationKey } }
+      : { mutation: { mutationKey }, request: undefined };
+
+    const mutationFn: MutationFunction<
+      Awaited<
+        ReturnType<
+          typeof applyBoardGroupHeartbeatApiV1BoardGroupsGroupIdHeartbeatPost
+        >
+      >,
+      { groupId: string; data: BoardGroupHeartbeatApply }
+    > = (props) => {
+      const { groupId, data } = props ?? {};
+
+      return applyBoardGroupHeartbeatApiV1BoardGroupsGroupIdHeartbeatPost(
+        groupId,
+        data,
+        requestOptions,
+      );
+    };
+
+    return { mutationFn, ...mutationOptions };
+  };
+
+export type ApplyBoardGroupHeartbeatApiV1BoardGroupsGroupIdHeartbeatPostMutationResult =
+  NonNullable<
+    Awaited<
+      ReturnType<
+        typeof applyBoardGroupHeartbeatApiV1BoardGroupsGroupIdHeartbeatPost
+      >
+    >
+  >;
+export type ApplyBoardGroupHeartbeatApiV1BoardGroupsGroupIdHeartbeatPostMutationBody =
+  BoardGroupHeartbeatApply;
+export type ApplyBoardGroupHeartbeatApiV1BoardGroupsGroupIdHeartbeatPostMutationError =
+  HTTPValidationError;
+
+/**
+ * @summary Apply Board Group Heartbeat
+ */
+export const useApplyBoardGroupHeartbeatApiV1BoardGroupsGroupIdHeartbeatPost = <
+  TError = HTTPValidationError,
+  TContext = unknown,
+>(
+  options?: {
+    mutation?: UseMutationOptions<
+      Awaited<
+        ReturnType<
+          typeof applyBoardGroupHeartbeatApiV1BoardGroupsGroupIdHeartbeatPost
+        >
+      >,
+      TError,
+      { groupId: string; data: BoardGroupHeartbeatApply },
+      TContext
+    >;
+    request?: SecondParameter<typeof customFetch>;
+  },
+  queryClient?: QueryClient,
+): UseMutationResult<
+  Awaited<
+    ReturnType<
+      typeof applyBoardGroupHeartbeatApiV1BoardGroupsGroupIdHeartbeatPost
+    >
+  >,
+  TError,
+  { groupId: string; data: BoardGroupHeartbeatApply },
+  TContext
+> => {
+  return useMutation(
+    getApplyBoardGroupHeartbeatApiV1BoardGroupsGroupIdHeartbeatPostMutationOptions(
+      options,
+    ),
+    queryClient,
+  );
+};
--- a/frontend/src/api/generated/board-onboarding/board-onboarding.ts
+++ b/frontend/src/api/generated/board-onboarding/board-onboarding.ts
@@ -274,6 +274,298 @@ export function useGetOnboardingApiV1BoardsBoardIdOnboardingGet<
  return { ...query, queryKey: queryOptions.queryKey };
 }

+/**
+ * Start onboarding and send instructions to the gateway agent.
+ * @summary Start Onboarding
+ */
+export type startOnboardingApiV1BoardsBoardIdOnboardingStartPostResponse200 = {
+  data: BoardOnboardingRead;
+  status: 200;
+};
+
+export type startOnboardingApiV1BoardsBoardIdOnboardingStartPostResponse422 = {
+  data: HTTPValidationError;
+  status: 422;
+};
+
+export type startOnboardingApiV1BoardsBoardIdOnboardingStartPostResponseSuccess =
+  startOnboardingApiV1BoardsBoardIdOnboardingStartPostResponse200 & {
+    headers: Headers;
+  };
+export type startOnboardingApiV1BoardsBoardIdOnboardingStartPostResponseError =
+  startOnboardingApiV1BoardsBoardIdOnboardingStartPostResponse422 & {
+    headers: Headers;
+  };
+
+export type startOnboardingApiV1BoardsBoardIdOnboardingStartPostResponse =
+  | startOnboardingApiV1BoardsBoardIdOnboardingStartPostResponseSuccess
+  | startOnboardingApiV1BoardsBoardIdOnboardingStartPostResponseError;
+
+export const getStartOnboardingApiV1BoardsBoardIdOnboardingStartPostUrl = (
+  boardId: string,
+) => {
+  return `/api/v1/boards/${boardId}/onboarding/start`;
+};
+
+export const startOnboardingApiV1BoardsBoardIdOnboardingStartPost = async (
+  boardId: string,
+  boardOnboardingStart: BoardOnboardingStart,
+  options?: RequestInit,
+): Promise<startOnboardingApiV1BoardsBoardIdOnboardingStartPostResponse> => {
+  return customFetch<startOnboardingApiV1BoardsBoardIdOnboardingStartPostResponse>(
+    getStartOnboardingApiV1BoardsBoardIdOnboardingStartPostUrl(boardId),
+    {
+      ...options,
+      method: "POST",
+      headers: { "Content-Type": "application/json", ...options?.headers },
+      body: JSON.stringify(boardOnboardingStart),
+    },
+  );
+};
+
+export const getStartOnboardingApiV1BoardsBoardIdOnboardingStartPostMutationOptions =
+  <TError = HTTPValidationError, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<
+      Awaited<
+        ReturnType<typeof startOnboardingApiV1BoardsBoardIdOnboardingStartPost>
+      >,
+      TError,
+      { boardId: string; data: BoardOnboardingStart },
+      TContext
+    >;
+    request?: SecondParameter<typeof customFetch>;
+  }): UseMutationOptions<
+    Awaited<
+      ReturnType<typeof startOnboardingApiV1BoardsBoardIdOnboardingStartPost>
+    >,
+    TError,
+    { boardId: string; data: BoardOnboardingStart },
+    TContext
+  > => {
+    const mutationKey = [
+      "startOnboardingApiV1BoardsBoardIdOnboardingStartPost",
+    ];
+    const { mutation: mutationOptions, request: requestOptions } = options
+      ? options.mutation &&
+        "mutationKey" in options.mutation &&
+        options.mutation.mutationKey
+        ? options
+        : { ...options, mutation: { ...options.mutation, mutationKey } }
+      : { mutation: { mutationKey }, request: undefined };
+
+    const mutationFn: MutationFunction<
+      Awaited<
+        ReturnType<typeof startOnboardingApiV1BoardsBoardIdOnboardingStartPost>
+      >,
+      { boardId: string; data: BoardOnboardingStart }
+    > = (props) => {
+      const { boardId, data } = props ?? {};
+
+      return startOnboardingApiV1BoardsBoardIdOnboardingStartPost(
+        boardId,
+        data,
+        requestOptions,
+      );
+    };
+
+    return { mutationFn, ...mutationOptions };
+  };
+
+export type StartOnboardingApiV1BoardsBoardIdOnboardingStartPostMutationResult =
+  NonNullable<
+    Awaited<
+      ReturnType<typeof startOnboardingApiV1BoardsBoardIdOnboardingStartPost>
+    >
+  >;
+export type StartOnboardingApiV1BoardsBoardIdOnboardingStartPostMutationBody =
+  BoardOnboardingStart;
+export type StartOnboardingApiV1BoardsBoardIdOnboardingStartPostMutationError =
+  HTTPValidationError;
+
+/**
+ * @summary Start Onboarding
+ */
+export const useStartOnboardingApiV1BoardsBoardIdOnboardingStartPost = <
+  TError = HTTPValidationError,
+  TContext = unknown,
+>(
+  options?: {
+    mutation?: UseMutationOptions<
+      Awaited<
+        ReturnType<typeof startOnboardingApiV1BoardsBoardIdOnboardingStartPost>
+      >,
+      TError,
+      { boardId: string; data: BoardOnboardingStart },
+      TContext
+    >;
+    request?: SecondParameter<typeof customFetch>;
+  },
+  queryClient?: QueryClient,
+): UseMutationResult<
+  Awaited<
+    ReturnType<typeof startOnboardingApiV1BoardsBoardIdOnboardingStartPost>
+  >,
+  TError,
+  { boardId: string; data: BoardOnboardingStart },
+  TContext
+> => {
+  return useMutation(
+    getStartOnboardingApiV1BoardsBoardIdOnboardingStartPostMutationOptions(
+      options,
+    ),
+    queryClient,
+  );
+};
+/**
+ * Send a user onboarding answer to the gateway agent.
+ * @summary Answer Onboarding
+ */
+export type answerOnboardingApiV1BoardsBoardIdOnboardingAnswerPostResponse200 =
+  {
+    data: BoardOnboardingRead;
+    status: 200;
+  };
+
+export type answerOnboardingApiV1BoardsBoardIdOnboardingAnswerPostResponse422 =
+  {
+    data: HTTPValidationError;
+    status: 422;
+  };
+
+export type answerOnboardingApiV1BoardsBoardIdOnboardingAnswerPostResponseSuccess =
+  answerOnboardingApiV1BoardsBoardIdOnboardingAnswerPostResponse200 & {
+    headers: Headers;
+  };
+export type answerOnboardingApiV1BoardsBoardIdOnboardingAnswerPostResponseError =
+  answerOnboardingApiV1BoardsBoardIdOnboardingAnswerPostResponse422 & {
+    headers: Headers;
+  };
+
+export type answerOnboardingApiV1BoardsBoardIdOnboardingAnswerPostResponse =
+  | answerOnboardingApiV1BoardsBoardIdOnboardingAnswerPostResponseSuccess
+  | answerOnboardingApiV1BoardsBoardIdOnboardingAnswerPostResponseError;
+
+export const getAnswerOnboardingApiV1BoardsBoardIdOnboardingAnswerPostUrl = (
+  boardId: string,
+) => {
+  return `/api/v1/boards/${boardId}/onboarding/answer`;
+};
+
+export const answerOnboardingApiV1BoardsBoardIdOnboardingAnswerPost = async (
+  boardId: string,
+  boardOnboardingAnswer: BoardOnboardingAnswer,
+  options?: RequestInit,
+): Promise<answerOnboardingApiV1BoardsBoardIdOnboardingAnswerPostResponse> => {
+  return customFetch<answerOnboardingApiV1BoardsBoardIdOnboardingAnswerPostResponse>(
+    getAnswerOnboardingApiV1BoardsBoardIdOnboardingAnswerPostUrl(boardId),
+    {
+      ...options,
+      method: "POST",
+      headers: { "Content-Type": "application/json", ...options?.headers },
+      body: JSON.stringify(boardOnboardingAnswer),
+    },
+  );
+};
+
+export const getAnswerOnboardingApiV1BoardsBoardIdOnboardingAnswerPostMutationOptions =
+  <TError = HTTPValidationError, TContext = unknown>(options?: {
+    mutation?: UseMutationOptions<
+      Awaited<
+        ReturnType<
+          typeof answerOnboardingApiV1BoardsBoardIdOnboardingAnswerPost
+        >
+      >,
+      TError,
+      { boardId: string; data: BoardOnboardingAnswer },
+      TContext
+    >;
+    request?: SecondParameter<typeof customFetch>;
+  }): UseMutationOptions<
+    Awaited<
+      ReturnType<typeof answerOnboardingApiV1BoardsBoardIdOnboardingAnswerPost>
+    >,
+    TError,
+    { boardId: string; data: BoardOnboardingAnswer },
+    TContext
+  > => {
+    const mutationKey = [
+      "answerOnboardingApiV1BoardsBoardIdOnboardingAnswerPost",
+    ];
+    const { mutation: mutationOptions, request: requestOptions } = options
+      ? options.mutation &&
+        "mutationKey" in options.mutation &&
+        options.mutation.mutationKey
+        ? options
+        : { ...options, mutation: { ...options.mutation, mutationKey } }
+      : { mutation: { mutationKey }, request: undefined };
+
+    const mutationFn: MutationFunction<
+      Awaited<
+        ReturnType<
+          typeof answerOnboardingApiV1BoardsBoardIdOnboardingAnswerPost
+        >
+      >,
+      { boardId: string; data: BoardOnboardingAnswer }
+    > = (props) => {
+      const { boardId, data } = props ?? {};
+
+      return answerOnboardingApiV1BoardsBoardIdOnboardingAnswerPost(
+        boardId,
+        data,
+        requestOptions,
+      );
+    };
+
+    return { mutationFn, ...mutationOptions };
+  };
+
+export type AnswerOnboardingApiV1BoardsBoardIdOnboardingAnswerPostMutationResult =
+  NonNullable<
+    Awaited<
+      ReturnType<typeof answerOnboardingApiV1BoardsBoardIdOnboardingAnswerPost>
+    >
+  >;
+export type AnswerOnboardingApiV1BoardsBoardIdOnboardingAnswerPostMutationBody =
+  BoardOnboardingAnswer;
+export type AnswerOnboardingApiV1BoardsBoardIdOnboardingAnswerPostMutationError =
+  HTTPValidationError;
+
+/**
+ * @summary Answer Onboarding
+ */
+export const useAnswerOnboardingApiV1BoardsBoardIdOnboardingAnswerPost = <
+  TError = HTTPValidationError,
+  TContext = unknown,
+>(
+  options?: {
+    mutation?: UseMutationOptions<
+      Awaited<
+        ReturnType<
+          typeof answerOnboardingApiV1BoardsBoardIdOnboardingAnswerPost
+        >
+      >,
+      TError,
+      { boardId: string; data: BoardOnboardingAnswer },
+      TContext
+    >;
+    request?: SecondParameter<typeof customFetch>;
+  },
+  queryClient?: QueryClient,
+): UseMutationResult<
+  Awaited<
+    ReturnType<typeof answerOnboardingApiV1BoardsBoardIdOnboardingAnswerPost>
+  >,
+  TError,
+  { boardId: string; data: BoardOnboardingAnswer },
+  TContext
+> => {
+  return useMutation(
+    getAnswerOnboardingApiV1BoardsBoardIdOnboardingAnswerPostMutationOptions(
+      options,
+    ),
+    queryClient,
+  );
+};
 /**
 * Store onboarding updates submitted by the gateway agent.
 * @summary Agent Onboarding Update
@@ -449,156 +741,6 @@ export const useAgentOnboardingUpdateApiV1BoardsBoardIdOnboardingAgentPost = <
    queryClient,
  );
 };
-/**
- * Send a user onboarding answer to the gateway agent.
- * @summary Answer Onboarding
- */
-export type answerOnboardingApiV1BoardsBoardIdOnboardingAnswerPostResponse200 =
-  {
-    data: BoardOnboardingRead;
-    status: 200;
-  };
-
-export type answerOnboardingApiV1BoardsBoardIdOnboardingAnswerPostResponse422 =
-  {
-    data: HTTPValidationError;
-    status: 422;
-  };
-
-export type answerOnboardingApiV1BoardsBoardIdOnboardingAnswerPostResponseSuccess =
-  answerOnboardingApiV1BoardsBoardIdOnboardingAnswerPostResponse200 & {
-    headers: Headers;
-  };
-export type answerOnboardingApiV1BoardsBoardIdOnboardingAnswerPostResponseError =
-  answerOnboardingApiV1BoardsBoardIdOnboardingAnswerPostResponse422 & {
-    headers: Headers;
-  };
-
-export type answerOnboardingApiV1BoardsBoardIdOnboardingAnswerPostResponse =
-  | answerOnboardingApiV1BoardsBoardIdOnboardingAnswerPostResponseSuccess
-  | answerOnboardingApiV1BoardsBoardIdOnboardingAnswerPostResponseError;
-
-export const getAnswerOnboardingApiV1BoardsBoardIdOnboardingAnswerPostUrl = (
-  boardId: string,
-) => {
-  return `/api/v1/boards/${boardId}/onboarding/answer`;
-};
-
-export const answerOnboardingApiV1BoardsBoardIdOnboardingAnswerPost = async (
-  boardId: string,
-  boardOnboardingAnswer: BoardOnboardingAnswer,
-  options?: RequestInit,
-): Promise<answerOnboardingApiV1BoardsBoardIdOnboardingAnswerPostResponse> => {
-  return customFetch<answerOnboardingApiV1BoardsBoardIdOnboardingAnswerPostResponse>(
-    getAnswerOnboardingApiV1BoardsBoardIdOnboardingAnswerPostUrl(boardId),
-    {
-      ...options,
-      method: "POST",
-      headers: { "Content-Type": "application/json", ...options?.headers },
-      body: JSON.stringify(boardOnboardingAnswer),
-    },
-  );
-};
-
-export const getAnswerOnboardingApiV1BoardsBoardIdOnboardingAnswerPostMutationOptions =
-  <TError = HTTPValidationError, TContext = unknown>(options?: {
-    mutation?: UseMutationOptions<
-      Awaited<
-        ReturnType<
-          typeof answerOnboardingApiV1BoardsBoardIdOnboardingAnswerPost
-        >
-      >,
-      TError,
-      { boardId: string; data: BoardOnboardingAnswer },
-      TContext
-    >;
-    request?: SecondParameter<typeof customFetch>;
-  }): UseMutationOptions<
-    Awaited<
-      ReturnType<typeof answerOnboardingApiV1BoardsBoardIdOnboardingAnswerPost>
-    >,
-    TError,
-    { boardId: string; data: BoardOnboardingAnswer },
-    TContext
-  > => {
-    const mutationKey = [
-      "answerOnboardingApiV1BoardsBoardIdOnboardingAnswerPost",
-    ];
-    const { mutation: mutationOptions, request: requestOptions } = options
-      ? options.mutation &&
-        "mutationKey" in options.mutation &&
-        options.mutation.mutationKey
-        ? options
-        : { ...options, mutation: { ...options.mutation, mutationKey } }
-      : { mutation: { mutationKey }, request: undefined };
-
-    const mutationFn: MutationFunction<
-      Awaited<
-        ReturnType<
-          typeof answerOnboardingApiV1BoardsBoardIdOnboardingAnswerPost
-        >
-      >,
-      { boardId: string; data: BoardOnboardingAnswer }
-    > = (props) => {
-      const { boardId, data } = props ?? {};
-
-      return answerOnboardingApiV1BoardsBoardIdOnboardingAnswerPost(
-        boardId,
-        data,
-        requestOptions,
-      );
-    };
-
-    return { mutationFn, ...mutationOptions };
-  };
-
-export type AnswerOnboardingApiV1BoardsBoardIdOnboardingAnswerPostMutationResult =
-  NonNullable<
-    Awaited<
-      ReturnType<typeof answerOnboardingApiV1BoardsBoardIdOnboardingAnswerPost>
-    >
-  >;
-export type AnswerOnboardingApiV1BoardsBoardIdOnboardingAnswerPostMutationBody =
-  BoardOnboardingAnswer;
-export type AnswerOnboardingApiV1BoardsBoardIdOnboardingAnswerPostMutationError =
-  HTTPValidationError;
-
-/**
- * @summary Answer Onboarding
- */
-export const useAnswerOnboardingApiV1BoardsBoardIdOnboardingAnswerPost = <
-  TError = HTTPValidationError,
-  TContext = unknown,
->(
-  options?: {
-    mutation?: UseMutationOptions<
-      Awaited<
-        ReturnType<
-          typeof answerOnboardingApiV1BoardsBoardIdOnboardingAnswerPost
-        >
-      >,
-      TError,
-      { boardId: string; data: BoardOnboardingAnswer },
-      TContext
-    >;
-    request?: SecondParameter<typeof customFetch>;
-  },
-  queryClient?: QueryClient,
-): UseMutationResult<
-  Awaited<
-    ReturnType<typeof answerOnboardingApiV1BoardsBoardIdOnboardingAnswerPost>
-  >,
-  TError,
-  { boardId: string; data: BoardOnboardingAnswer },
-  TContext
-> => {
-  return useMutation(
-    getAnswerOnboardingApiV1BoardsBoardIdOnboardingAnswerPostMutationOptions(
-      options,
-    ),
-    queryClient,
-  );
-};
 /**
 * Confirm onboarding results and provision the board lead agent.
 * @summary Confirm Onboarding
@@ -753,145 +895,3 @@ export const useConfirmOnboardingApiV1BoardsBoardIdOnboardingConfirmPost = <
    queryClient,
  );
 };
-/**
- * Start onboarding and send instructions to the gateway agent.
- * @summary Start Onboarding
- */
-export type startOnboardingApiV1BoardsBoardIdOnboardingStartPostResponse200 = {
-  data: BoardOnboardingRead;
-  status: 200;
-};
-
-export type startOnboardingApiV1BoardsBoardIdOnboardingStartPostResponse422 = {
-  data: HTTPValidationError;
-  status: 422;
-};
-
-export type startOnboardingApiV1BoardsBoardIdOnboardingStartPostResponseSuccess =
-  startOnboardingApiV1BoardsBoardIdOnboardingStartPostResponse200 & {
-    headers: Headers;
-  };
-export type startOnboardingApiV1BoardsBoardIdOnboardingStartPostResponseError =
-  startOnboardingApiV1BoardsBoardIdOnboardingStartPostResponse422 & {
-    headers: Headers;
-  };
-
-export type startOnboardingApiV1BoardsBoardIdOnboardingStartPostResponse =
-  | startOnboardingApiV1BoardsBoardIdOnboardingStartPostResponseSuccess
-  | startOnboardingApiV1BoardsBoardIdOnboardingStartPostResponseError;
-
-export const getStartOnboardingApiV1BoardsBoardIdOnboardingStartPostUrl = (
-  boardId: string,
-) => {
-  return `/api/v1/boards/${boardId}/onboarding/start`;
-};
-
-export const startOnboardingApiV1BoardsBoardIdOnboardingStartPost = async (
-  boardId: string,
-  boardOnboardingStart: BoardOnboardingStart,
-  options?: RequestInit,
-): Promise<startOnboardingApiV1BoardsBoardIdOnboardingStartPostResponse> => {
-  return customFetch<startOnboardingApiV1BoardsBoardIdOnboardingStartPostResponse>(
-    getStartOnboardingApiV1BoardsBoardIdOnboardingStartPostUrl(boardId),
-    {
-      ...options,
-      method: "POST",
-      headers: { "Content-Type": "application/json", ...options?.headers },
-      body: JSON.stringify(boardOnboardingStart),
-    },
-  );
-};
-
-export const getStartOnboardingApiV1BoardsBoardIdOnboardingStartPostMutationOptions =
-  <TError = HTTPValidationError, TContext = unknown>(options?: {
-    mutation?: UseMutationOptions<
-      Awaited<
-        ReturnType<typeof startOnboardingApiV1BoardsBoardIdOnboardingStartPost>
-      >,
-      TError,
-      { boardId: string; data: BoardOnboardingStart },
-      TContext
-    >;
-    request?: SecondParameter<typeof customFetch>;
-  }): UseMutationOptions<
-    Awaited<
-      ReturnType<typeof startOnboardingApiV1BoardsBoardIdOnboardingStartPost>
-    >,
-    TError,
-    { boardId: string; data: BoardOnboardingStart },
-    TContext
-  > => {
-    const mutationKey = [
-      "startOnboardingApiV1BoardsBoardIdOnboardingStartPost",
-    ];
-    const { mutation: mutationOptions, request: requestOptions } = options
-      ? options.mutation &&
-        "mutationKey" in options.mutation &&
-        options.mutation.mutationKey
-        ? options
-        : { ...options, mutation: { ...options.mutation, mutationKey } }
-      : { mutation: { mutationKey }, request: undefined };
-
-    const mutationFn: MutationFunction<
-      Awaited<
-        ReturnType<typeof startOnboardingApiV1BoardsBoardIdOnboardingStartPost>
-      >,
-      { boardId: string; data: BoardOnboardingStart }
-    > = (props) => {
-      const { boardId, data } = props ?? {};
-
-      return startOnboardingApiV1BoardsBoardIdOnboardingStartPost(
-        boardId,
-        data,
-        requestOptions,
-      );
-    };
-
-    return { mutationFn, ...mutationOptions };
-  };
-
-export type StartOnboardingApiV1BoardsBoardIdOnboardingStartPostMutationResult =
-  NonNullable<
-    Awaited<
-      ReturnType<typeof startOnboardingApiV1BoardsBoardIdOnboardingStartPost>
-    >
-  >;
-export type StartOnboardingApiV1BoardsBoardIdOnboardingStartPostMutationBody =
-  BoardOnboardingStart;
-export type StartOnboardingApiV1BoardsBoardIdOnboardingStartPostMutationError =
-  HTTPValidationError;
-
-/**
- * @summary Start Onboarding
- */
-export const useStartOnboardingApiV1BoardsBoardIdOnboardingStartPost = <
-  TError = HTTPValidationError,
-  TContext = unknown,
->(
-  options?: {
-    mutation?: UseMutationOptions<
-      Awaited<
-        ReturnType<typeof startOnboardingApiV1BoardsBoardIdOnboardingStartPost>
-      >,
-      TError,
-      { boardId: string; data: BoardOnboardingStart },
-      TContext
-    >;
-    request?: SecondParameter<typeof customFetch>;
-  },
-  queryClient?: QueryClient,
-): UseMutationResult<
-  Awaited<
-    ReturnType<typeof startOnboardingApiV1BoardsBoardIdOnboardingStartPost>
-  >,
-  TError,
-  { boardId: string; data: BoardOnboardingStart },
-  TContext
-> => {
-  return useMutation(
-    getStartOnboardingApiV1BoardsBoardIdOnboardingStartPostMutationOptions(
-      options,
-    ),
-    queryClient,
-  );
-};
--- a/frontend/src/api/generated/boards/boards.ts
+++ b/frontend/src/api/generated/boards/boards.ts
@@ -363,123 +363,6 @@ export const useCreateBoardApiV1BoardsPost = <
    queryClient,
  );
 };
-/**
- * Delete a board and all dependent records.
- * @summary Delete Board
- */
-export type deleteBoardApiV1BoardsBoardIdDeleteResponse200 = {
-  data: OkResponse;
-  status: 200;
-};
-
-export type deleteBoardApiV1BoardsBoardIdDeleteResponse422 = {
-  data: HTTPValidationError;
-  status: 422;
-};
-
-export type deleteBoardApiV1BoardsBoardIdDeleteResponseSuccess =
-  deleteBoardApiV1BoardsBoardIdDeleteResponse200 & {
-    headers: Headers;
-  };
-export type deleteBoardApiV1BoardsBoardIdDeleteResponseError =
-  deleteBoardApiV1BoardsBoardIdDeleteResponse422 & {
-    headers: Headers;
-  };
-
-export type deleteBoardApiV1BoardsBoardIdDeleteResponse =
-  | deleteBoardApiV1BoardsBoardIdDeleteResponseSuccess
-  | deleteBoardApiV1BoardsBoardIdDeleteResponseError;
-
-export const getDeleteBoardApiV1BoardsBoardIdDeleteUrl = (boardId: string) => {
-  return `/api/v1/boards/${boardId}`;
-};
-
-export const deleteBoardApiV1BoardsBoardIdDelete = async (
-  boardId: string,
-  options?: RequestInit,
-): Promise<deleteBoardApiV1BoardsBoardIdDeleteResponse> => {
-  return customFetch<deleteBoardApiV1BoardsBoardIdDeleteResponse>(
-    getDeleteBoardApiV1BoardsBoardIdDeleteUrl(boardId),
-    {
-      ...options,
-      method: "DELETE",
-    },
-  );
-};
-
-export const getDeleteBoardApiV1BoardsBoardIdDeleteMutationOptions = <
-  TError = HTTPValidationError,
-  TContext = unknown,
->(options?: {
-  mutation?: UseMutationOptions<
-    Awaited<ReturnType<typeof deleteBoardApiV1BoardsBoardIdDelete>>,
-    TError,
-    { boardId: string },
-    TContext
-  >;
-  request?: SecondParameter<typeof customFetch>;
-}): UseMutationOptions<
-  Awaited<ReturnType<typeof deleteBoardApiV1BoardsBoardIdDelete>>,
-  TError,
-  { boardId: string },
-  TContext
-> => {
-  const mutationKey = ["deleteBoardApiV1BoardsBoardIdDelete"];
-  const { mutation: mutationOptions, request: requestOptions } = options
-    ? options.mutation &&
-      "mutationKey" in options.mutation &&
-      options.mutation.mutationKey
-      ? options
-      : { ...options, mutation: { ...options.mutation, mutationKey } }
-    : { mutation: { mutationKey }, request: undefined };
-
-  const mutationFn: MutationFunction<
-    Awaited<ReturnType<typeof deleteBoardApiV1BoardsBoardIdDelete>>,
-    { boardId: string }
-  > = (props) => {
-    const { boardId } = props ?? {};
-
-    return deleteBoardApiV1BoardsBoardIdDelete(boardId, requestOptions);
-  };
-
-  return { mutationFn, ...mutationOptions };
-};
-
-export type DeleteBoardApiV1BoardsBoardIdDeleteMutationResult = NonNullable<
-  Awaited<ReturnType<typeof deleteBoardApiV1BoardsBoardIdDelete>>
->;
-
-export type DeleteBoardApiV1BoardsBoardIdDeleteMutationError =
-  HTTPValidationError;
-
-/**
- * @summary Delete Board
- */
-export const useDeleteBoardApiV1BoardsBoardIdDelete = <
-  TError = HTTPValidationError,
-  TContext = unknown,
->(
-  options?: {
-    mutation?: UseMutationOptions<
-      Awaited<ReturnType<typeof deleteBoardApiV1BoardsBoardIdDelete>>,
-      TError,
-      { boardId: string },
-      TContext
-    >;
-    request?: SecondParameter<typeof customFetch>;
-  },
-  queryClient?: QueryClient,
-): UseMutationResult<
-  Awaited<ReturnType<typeof deleteBoardApiV1BoardsBoardIdDelete>>,
-  TError,
-  { boardId: string },
-  TContext
-> => {
-  return useMutation(
-    getDeleteBoardApiV1BoardsBoardIdDeleteMutationOptions(options),
-    queryClient,
-  );
-};
 /**
 * Get a board by id.
 * @summary Get Board
@@ -800,6 +683,362 @@ export const useUpdateBoardApiV1BoardsBoardIdPatch = <
    queryClient,
  );
 };
+/**
+ * Delete a board and all dependent records.
+ * @summary Delete Board
+ */
+export type deleteBoardApiV1BoardsBoardIdDeleteResponse200 = {
+  data: OkResponse;
+  status: 200;
+};
+
+export type deleteBoardApiV1BoardsBoardIdDeleteResponse422 = {
+  data: HTTPValidationError;
+  status: 422;
+};
+
+export type deleteBoardApiV1BoardsBoardIdDeleteResponseSuccess =
+  deleteBoardApiV1BoardsBoardIdDeleteResponse200 & {
+    headers: Headers;
+  };
+export type deleteBoardApiV1BoardsBoardIdDeleteResponseError =
+  deleteBoardApiV1BoardsBoardIdDeleteResponse422 & {
+    headers: Headers;
+  };
+
+export type deleteBoardApiV1BoardsBoardIdDeleteResponse =
+  | deleteBoardApiV1BoardsBoardIdDeleteResponseSuccess
+  | deleteBoardApiV1BoardsBoardIdDeleteResponseError;
+
+export const getDeleteBoardApiV1BoardsBoardIdDeleteUrl = (boardId: string) => {
+  return `/api/v1/boards/${boardId}`;
+};
+
+export const deleteBoardApiV1BoardsBoardIdDelete = async (
+  boardId: string,
+  options?: RequestInit,
+): Promise<deleteBoardApiV1BoardsBoardIdDeleteResponse> => {
+  return customFetch<deleteBoardApiV1BoardsBoardIdDeleteResponse>(
+    getDeleteBoardApiV1BoardsBoardIdDeleteUrl(boardId),
+    {
+      ...options,
+      method: "DELETE",
+    },
+  );
+};
+
+export const getDeleteBoardApiV1BoardsBoardIdDeleteMutationOptions = <
+  TError = HTTPValidationError,
+  TContext = unknown,
+>(options?: {
+  mutation?: UseMutationOptions<
+    Awaited<ReturnType<typeof deleteBoardApiV1BoardsBoardIdDelete>>,
+    TError,
+    { boardId: string },
+    TContext
+  >;
+  request?: SecondParameter<typeof customFetch>;
+}): UseMutationOptions<
+  Awaited<ReturnType<typeof deleteBoardApiV1BoardsBoardIdDelete>>,
+  TError,
+  { boardId: string },
+  TContext
+> => {
+  const mutationKey = ["deleteBoardApiV1BoardsBoardIdDelete"];
+  const { mutation: mutationOptions, request: requestOptions } = options
+    ? options.mutation &&
+      "mutationKey" in options.mutation &&
+      options.mutation.mutationKey
+      ? options
+      : { ...options, mutation: { ...options.mutation, mutationKey } }
+    : { mutation: { mutationKey }, request: undefined };
+
+  const mutationFn: MutationFunction<
+    Awaited<ReturnType<typeof deleteBoardApiV1BoardsBoardIdDelete>>,
+    { boardId: string }
+  > = (props) => {
+    const { boardId } = props ?? {};
+
+    return deleteBoardApiV1BoardsBoardIdDelete(boardId, requestOptions);
+  };
+
+  return { mutationFn, ...mutationOptions };
+};
+
+export type DeleteBoardApiV1BoardsBoardIdDeleteMutationResult = NonNullable<
+  Awaited<ReturnType<typeof deleteBoardApiV1BoardsBoardIdDelete>>
+>;
+
+export type DeleteBoardApiV1BoardsBoardIdDeleteMutationError =
+  HTTPValidationError;
+
+/**
+ * @summary Delete Board
+ */
+export const useDeleteBoardApiV1BoardsBoardIdDelete = <
+  TError = HTTPValidationError,
+  TContext = unknown,
+>(
+  options?: {
+    mutation?: UseMutationOptions<
+      Awaited<ReturnType<typeof deleteBoardApiV1BoardsBoardIdDelete>>,
+      TError,
+      { boardId: string },
+      TContext
+    >;
+    request?: SecondParameter<typeof customFetch>;
+  },
+  queryClient?: QueryClient,
+): UseMutationResult<
+  Awaited<ReturnType<typeof deleteBoardApiV1BoardsBoardIdDelete>>,
+  TError,
+  { boardId: string },
+  TContext
+> => {
+  return useMutation(
+    getDeleteBoardApiV1BoardsBoardIdDeleteMutationOptions(options),
+    queryClient,
+  );
+};
+/**
+ * Get a board snapshot view model.
+ * @summary Get Board Snapshot
+ */
+export type getBoardSnapshotApiV1BoardsBoardIdSnapshotGetResponse200 = {
+  data: BoardSnapshot;
+  status: 200;
+};
+
+export type getBoardSnapshotApiV1BoardsBoardIdSnapshotGetResponse422 = {
+  data: HTTPValidationError;
+  status: 422;
+};
+
+export type getBoardSnapshotApiV1BoardsBoardIdSnapshotGetResponseSuccess =
+  getBoardSnapshotApiV1BoardsBoardIdSnapshotGetResponse200 & {
+    headers: Headers;
+  };
+export type getBoardSnapshotApiV1BoardsBoardIdSnapshotGetResponseError =
+  getBoardSnapshotApiV1BoardsBoardIdSnapshotGetResponse422 & {
+    headers: Headers;
+  };
+
+export type getBoardSnapshotApiV1BoardsBoardIdSnapshotGetResponse =
+  | getBoardSnapshotApiV1BoardsBoardIdSnapshotGetResponseSuccess
+  | getBoardSnapshotApiV1BoardsBoardIdSnapshotGetResponseError;
+
+export const getGetBoardSnapshotApiV1BoardsBoardIdSnapshotGetUrl = (
+  boardId: string,
+) => {
+  return `/api/v1/boards/${boardId}/snapshot`;
+};
+
+export const getBoardSnapshotApiV1BoardsBoardIdSnapshotGet = async (
+  boardId: string,
+  options?: RequestInit,
+): Promise<getBoardSnapshotApiV1BoardsBoardIdSnapshotGetResponse> => {
+  return customFetch<getBoardSnapshotApiV1BoardsBoardIdSnapshotGetResponse>(
+    getGetBoardSnapshotApiV1BoardsBoardIdSnapshotGetUrl(boardId),
+    {
+      ...options,
+      method: "GET",
+    },
+  );
+};
+
+export const getGetBoardSnapshotApiV1BoardsBoardIdSnapshotGetQueryKey = (
+  boardId: string,
+) => {
+  return [`/api/v1/boards/${boardId}/snapshot`] as const;
+};
+
+export const getGetBoardSnapshotApiV1BoardsBoardIdSnapshotGetQueryOptions = <
+  TData = Awaited<
+    ReturnType<typeof getBoardSnapshotApiV1BoardsBoardIdSnapshotGet>
+  >,
+  TError = HTTPValidationError,
+>(
+  boardId: string,
+  options?: {
+    query?: Partial<
+      UseQueryOptions<
+        Awaited<
+          ReturnType<typeof getBoardSnapshotApiV1BoardsBoardIdSnapshotGet>
+        >,
+        TError,
+        TData
+      >
+    >;
+    request?: SecondParameter<typeof customFetch>;
+  },
+) => {
+  const { query: queryOptions, request: requestOptions } = options ?? {};
+
+  const queryKey =
+    queryOptions?.queryKey ??
+    getGetBoardSnapshotApiV1BoardsBoardIdSnapshotGetQueryKey(boardId);
+
+  const queryFn: QueryFunction<
+    Awaited<ReturnType<typeof getBoardSnapshotApiV1BoardsBoardIdSnapshotGet>>
+  > = ({ signal }) =>
+    getBoardSnapshotApiV1BoardsBoardIdSnapshotGet(boardId, {
+      signal,
+      ...requestOptions,
+    });
+
+  return {
+    queryKey,
+    queryFn,
+    enabled: !!boardId,
+    ...queryOptions,
+  } as UseQueryOptions<
+    Awaited<ReturnType<typeof getBoardSnapshotApiV1BoardsBoardIdSnapshotGet>>,
+    TError,
+    TData
+  > & { queryKey: DataTag<QueryKey, TData, TError> };
+};
+
+export type GetBoardSnapshotApiV1BoardsBoardIdSnapshotGetQueryResult =
+  NonNullable<
+    Awaited<ReturnType<typeof getBoardSnapshotApiV1BoardsBoardIdSnapshotGet>>
+  >;
+export type GetBoardSnapshotApiV1BoardsBoardIdSnapshotGetQueryError =
+  HTTPValidationError;
+
+export function useGetBoardSnapshotApiV1BoardsBoardIdSnapshotGet<
+  TData = Awaited<
+    ReturnType<typeof getBoardSnapshotApiV1BoardsBoardIdSnapshotGet>
+  >,
+  TError = HTTPValidationError,
+>(
+  boardId: string,
+  options: {
+    query: Partial<
+      UseQueryOptions<
+        Awaited<
+          ReturnType<typeof getBoardSnapshotApiV1BoardsBoardIdSnapshotGet>
+        >,
+        TError,
+        TData
+      >
+    > &
+      Pick<
+        DefinedInitialDataOptions<
+          Awaited<
+            ReturnType<typeof getBoardSnapshotApiV1BoardsBoardIdSnapshotGet>
+          >,
+          TError,
+          Awaited<
+            ReturnType<typeof getBoardSnapshotApiV1BoardsBoardIdSnapshotGet>
+          >
+        >,
+        "initialData"
+      >;
+    request?: SecondParameter<typeof customFetch>;
+  },
+  queryClient?: QueryClient,
+): DefinedUseQueryResult<TData, TError> & {
+  queryKey: DataTag<QueryKey, TData, TError>;
+};
+export function useGetBoardSnapshotApiV1BoardsBoardIdSnapshotGet<
+  TData = Awaited<
+    ReturnType<typeof getBoardSnapshotApiV1BoardsBoardIdSnapshotGet>
+  >,
+  TError = HTTPValidationError,
+>(
+  boardId: string,
+  options?: {
+    query?: Partial<
+      UseQueryOptions<
+        Awaited<
+          ReturnType<typeof getBoardSnapshotApiV1BoardsBoardIdSnapshotGet>
+        >,
+        TError,
+        TData
+      >
+    > &
+      Pick<
+        UndefinedInitialDataOptions<
+          Awaited<
+            ReturnType<typeof getBoardSnapshotApiV1BoardsBoardIdSnapshotGet>
+          >,
+          TError,
+          Awaited<
+            ReturnType<typeof getBoardSnapshotApiV1BoardsBoardIdSnapshotGet>
+          >
+        >,
+        "initialData"
+      >;
+    request?: SecondParameter<typeof customFetch>;
+  },
+  queryClient?: QueryClient,
+): UseQueryResult<TData, TError> & {
+  queryKey: DataTag<QueryKey, TData, TError>;
+};
+export function useGetBoardSnapshotApiV1BoardsBoardIdSnapshotGet<
+  TData = Awaited<
+    ReturnType<typeof getBoardSnapshotApiV1BoardsBoardIdSnapshotGet>
+  >,
+  TError = HTTPValidationError,
+>(
+  boardId: string,
+  options?: {
+    query?: Partial<
+      UseQueryOptions<
+        Awaited<
+          ReturnType<typeof getBoardSnapshotApiV1BoardsBoardIdSnapshotGet>
+        >,
+        TError,
+        TData
+      >
+    >;
+    request?: SecondParameter<typeof customFetch>;
+  },
+  queryClient?: QueryClient,
+): UseQueryResult<TData, TError> & {
+  queryKey: DataTag<QueryKey, TData, TError>;
+};
+/**
+ * @summary Get Board Snapshot
+ */
+
+export function useGetBoardSnapshotApiV1BoardsBoardIdSnapshotGet<
+  TData = Awaited<
+    ReturnType<typeof getBoardSnapshotApiV1BoardsBoardIdSnapshotGet>
+  >,
+  TError = HTTPValidationError,
+>(
+  boardId: string,
+  options?: {
+    query?: Partial<
+      UseQueryOptions<
+        Awaited<
+          ReturnType<typeof getBoardSnapshotApiV1BoardsBoardIdSnapshotGet>
+        >,
+        TError,
+        TData
+      >
+    >;
+    request?: SecondParameter<typeof customFetch>;
+  },
+  queryClient?: QueryClient,
+): UseQueryResult<TData, TError> & {
+  queryKey: DataTag<QueryKey, TData, TError>;
+} {
+  const queryOptions =
+    getGetBoardSnapshotApiV1BoardsBoardIdSnapshotGetQueryOptions(
+      boardId,
+      options,
+    );
+
+  const query = useQuery(queryOptions, queryClient) as UseQueryResult<
+    TData,
+    TError
+  > & { queryKey: DataTag<QueryKey, TData, TError> };
+
+  return { ...query, queryKey: queryOptions.queryKey };
+}
+
 /**
 * Get a grouped snapshot across related boards.
 * @summary Get Board Group Snapshot
@@ -1102,242 +1341,3 @@ export function useGetBoardGroupSnapshotApiV1BoardsBoardIdGroupSnapshotGet<

  return { ...query, queryKey: queryOptions.queryKey };
 }
-
-/**
- * Get a board snapshot view model.
- * @summary Get Board Snapshot
- */
-export type getBoardSnapshotApiV1BoardsBoardIdSnapshotGetResponse200 = {
-  data: BoardSnapshot;
-  status: 200;
-};
-
-export type getBoardSnapshotApiV1BoardsBoardIdSnapshotGetResponse422 = {
-  data: HTTPValidationError;
-  status: 422;
-};
-
-export type getBoardSnapshotApiV1BoardsBoardIdSnapshotGetResponseSuccess =
-  getBoardSnapshotApiV1BoardsBoardIdSnapshotGetResponse200 & {
-    headers: Headers;
-  };
-export type getBoardSnapshotApiV1BoardsBoardIdSnapshotGetResponseError =
-  getBoardSnapshotApiV1BoardsBoardIdSnapshotGetResponse422 & {
-    headers: Headers;
-  };
-
-export type getBoardSnapshotApiV1BoardsBoardIdSnapshotGetResponse =
-  | getBoardSnapshotApiV1BoardsBoardIdSnapshotGetResponseSuccess
-  | getBoardSnapshotApiV1BoardsBoardIdSnapshotGetResponseError;
-
-export const getGetBoardSnapshotApiV1BoardsBoardIdSnapshotGetUrl = (
-  boardId: string,
-) => {
-  return `/api/v1/boards/${boardId}/snapshot`;
-};
-
-export const getBoardSnapshotApiV1BoardsBoardIdSnapshotGet = async (
-  boardId: string,
-  options?: RequestInit,
-): Promise<getBoardSnapshotApiV1BoardsBoardIdSnapshotGetResponse> => {
-  return customFetch<getBoardSnapshotApiV1BoardsBoardIdSnapshotGetResponse>(
-    getGetBoardSnapshotApiV1BoardsBoardIdSnapshotGetUrl(boardId),
-    {
-      ...options,
-      method: "GET",
-    },
-  );
-};
-
-export const getGetBoardSnapshotApiV1BoardsBoardIdSnapshotGetQueryKey = (
-  boardId: string,
-) => {
-  return [`/api/v1/boards/${boardId}/snapshot`] as const;
-};
-
-export const getGetBoardSnapshotApiV1BoardsBoardIdSnapshotGetQueryOptions = <
-  TData = Awaited<
-    ReturnType<typeof getBoardSnapshotApiV1BoardsBoardIdSnapshotGet>
-  >,
-  TError = HTTPValidationError,
->(
-  boardId: string,
-  options?: {
-    query?: Partial<
-      UseQueryOptions<
-        Awaited<
-          ReturnType<typeof getBoardSnapshotApiV1BoardsBoardIdSnapshotGet>
-        >,
-        TError,
-        TData
-      >
-    >;
-    request?: SecondParameter<typeof customFetch>;
-  },
-) => {
-  const { query: queryOptions, request: requestOptions } = options ?? {};
-
-  const queryKey =
-    queryOptions?.queryKey ??
-    getGetBoardSnapshotApiV1BoardsBoardIdSnapshotGetQueryKey(boardId);
-
-  const queryFn: QueryFunction<
-    Awaited<ReturnType<typeof getBoardSnapshotApiV1BoardsBoardIdSnapshotGet>>
-  > = ({ signal }) =>
-    getBoardSnapshotApiV1BoardsBoardIdSnapshotGet(boardId, {
-      signal,
-      ...requestOptions,
-    });
-
-  return {
-    queryKey,
-    queryFn,
-    enabled: !!boardId,
-    ...queryOptions,
-  } as UseQueryOptions<
-    Awaited<ReturnType<typeof getBoardSnapshotApiV1BoardsBoardIdSnapshotGet>>,
-    TError,
-    TData
-  > & { queryKey: DataTag<QueryKey, TData, TError> };
-};
-
-export type GetBoardSnapshotApiV1BoardsBoardIdSnapshotGetQueryResult =
-  NonNullable<
-    Awaited<ReturnType<typeof getBoardSnapshotApiV1BoardsBoardIdSnapshotGet>>
-  >;
-export type GetBoardSnapshotApiV1BoardsBoardIdSnapshotGetQueryError =
-  HTTPValidationError;
-
-export function useGetBoardSnapshotApiV1BoardsBoardIdSnapshotGet<
-  TData = Awaited<
-    ReturnType<typeof getBoardSnapshotApiV1BoardsBoardIdSnapshotGet>
-  >,
-  TError = HTTPValidationError,
->(
-  boardId: string,
-  options: {
-    query: Partial<
-      UseQueryOptions<
-        Awaited<
-          ReturnType<typeof getBoardSnapshotApiV1BoardsBoardIdSnapshotGet>
-        >,
-        TError,
-        TData
-      >
-    > &
-      Pick<
-        DefinedInitialDataOptions<
-          Awaited<
-            ReturnType<typeof getBoardSnapshotApiV1BoardsBoardIdSnapshotGet>
-          >,
-          TError,
-          Awaited<
-            ReturnType<typeof getBoardSnapshotApiV1BoardsBoardIdSnapshotGet>
-          >
-        >,
-        "initialData"
-      >;
-    request?: SecondParameter<typeof customFetch>;
-  },
-  queryClient?: QueryClient,
-): DefinedUseQueryResult<TData, TError> & {
-  queryKey: DataTag<QueryKey, TData, TError>;
-};
-export function useGetBoardSnapshotApiV1BoardsBoardIdSnapshotGet<
-  TData = Awaited<
-    ReturnType<typeof getBoardSnapshotApiV1BoardsBoardIdSnapshotGet>
-  >,
-  TError = HTTPValidationError,
->(
-  boardId: string,
-  options?: {
-    query?: Partial<
-      UseQueryOptions<
-        Awaited<
-          ReturnType<typeof getBoardSnapshotApiV1BoardsBoardIdSnapshotGet>
-        >,
-        TError,
-        TData
-      >
-    > &
-      Pick<
-        UndefinedInitialDataOptions<
-          Awaited<
-            ReturnType<typeof getBoardSnapshotApiV1BoardsBoardIdSnapshotGet>
-          >,
-          TError,
-          Awaited<
-            ReturnType<typeof getBoardSnapshotApiV1BoardsBoardIdSnapshotGet>
-          >
-        >,
-        "initialData"
-      >;
-    request?: SecondParameter<typeof customFetch>;
-  },
-  queryClient?: QueryClient,
-): UseQueryResult<TData, TError> & {
-  queryKey: DataTag<QueryKey, TData, TError>;
-};
-export function useGetBoardSnapshotApiV1BoardsBoardIdSnapshotGet<
-  TData = Awaited<
-    ReturnType<typeof getBoardSnapshotApiV1BoardsBoardIdSnapshotGet>
-  >,
-  TError = HTTPValidationError,
->(
-  boardId: string,
-  options?: {
-    query?: Partial<
-      UseQueryOptions<
-        Awaited<
-          ReturnType<typeof getBoardSnapshotApiV1BoardsBoardIdSnapshotGet>
-        >,
-        TError,
-        TData
-      >
-    >;
-    request?: SecondParameter<typeof customFetch>;
-  },
-  queryClient?: QueryClient,
-): UseQueryResult<TData, TError> & {
-  queryKey: DataTag<QueryKey, TData, TError>;
-};
-/**
- * @summary Get Board Snapshot
- */
-
-export function useGetBoardSnapshotApiV1BoardsBoardIdSnapshotGet<
-  TData = Awaited<
-    ReturnType<typeof getBoardSnapshotApiV1BoardsBoardIdSnapshotGet>
-  >,
-  TError = HTTPValidationError,
->(
-  boardId: string,
-  options?: {
-    query?: Partial<
-      UseQueryOptions<
-        Awaited<
-          ReturnType<typeof getBoardSnapshotApiV1BoardsBoardIdSnapshotGet>
-        >,
-        TError,
-        TData
-      >
-    >;
-    request?: SecondParameter<typeof customFetch>;
-  },
-  queryClient?: QueryClient,
-): UseQueryResult<TData, TError> & {
-  queryKey: DataTag<QueryKey, TData, TError>;
-} {
-  const queryOptions =
-    getGetBoardSnapshotApiV1BoardsBoardIdSnapshotGetQueryOptions(
-      boardId,
-      options,
-    );
-
-  const query = useQuery(queryOptions, queryClient) as UseQueryResult<
-    TData,
-    TError
-  > & { queryKey: DataTag<QueryKey, TData, TError> };
-
-  return { ...query, queryKey: queryOptions.queryKey };
-}
--- a/frontend/src/api/generated/gateway/gateway.ts
+++ b/frontend/src/api/generated/gateway/gateway.ts
--- a/frontend/src/api/generated/gateways/gateways.ts
+++ b/frontend/src/api/generated/gateways/gateways.ts
--- a/frontend/src/api/generated/model/activityEventRead.ts
+++ b/frontend/src/api/generated/model/activityEventRead.ts
@@ -9,10 +9,10 @@
 * Serialized activity event payload returned by activity endpoints.
 */
 export interface ActivityEventRead {
-  agent_id: string | null;
-  created_at: string;
-  event_type: string;
  id: string;
+  event_type: string;
  message: string | null;
+  agent_id: string | null;
  task_id: string | null;
+  created_at: string;
 }
--- a/frontend/src/api/generated/model/activityTaskCommentFeedItemRead.ts
+++ b/frontend/src/api/generated/model/activityTaskCommentFeedItemRead.ts
@@ -9,14 +9,14 @@
 * Denormalized task-comment feed item enriched with task and board fields.
 */
 export interface ActivityTaskCommentFeedItemRead {
+  id: string;
+  created_at: string;
+  message: string | null;
  agent_id: string | null;
  agent_name?: string | null;
  agent_role?: string | null;
-  board_id: string;
-  board_name: string;
-  created_at: string;
-  id: string;
-  message: string | null;
  task_id: string;
  task_title: string;
+  board_id: string;
+  board_name: string;
 }
--- a/frontend/src/api/generated/model/agentCreate.ts
+++ b/frontend/src/api/generated/model/agentCreate.ts
@@ -12,11 +12,11 @@ import type { AgentCreateIdentityProfile } from "./agentCreateIdentityProfile";
 */
 export interface AgentCreate {
  board_id?: string | null;
+  /** @minLength 1 */
+  name: string;
+  status?: string;
  heartbeat_config?: AgentCreateHeartbeatConfig;
  identity_profile?: AgentCreateIdentityProfile;
  identity_template?: string | null;
-  /** @minLength 1 */
-  name: string;
  soul_template?: string | null;
-  status?: string;
 }
--- a/frontend/src/api/generated/model/agentDeleteConfirm.ts
+++ b/frontend/src/api/generated/model/agentDeleteConfirm.ts
@@ -1,10 +0,0 @@
-/**
- * Generated by orval v8.2.0 🍺
- * Do not edit manually.
- * Mission Control API
- * OpenAPI spec version: 0.1.0
- */
-
-export interface AgentDeleteConfirm {
-  token: string;
-}
--- a/frontend/src/api/generated/model/agentHeartbeatCreate.ts
+++ b/frontend/src/api/generated/model/agentHeartbeatCreate.ts
@@ -9,8 +9,8 @@
 * Heartbeat payload used to create an agent lazily.
 */
 export interface AgentHeartbeatCreate {
-  board_id?: string | null;
+  status?: string | null;
  /** @minLength 1 */
  name: string;
-  status?: string | null;
+  board_id?: string | null;
 }
--- a/frontend/src/api/generated/model/agentProvisionConfirm.ts
+++ b/frontend/src/api/generated/model/agentProvisionConfirm.ts
@@ -1,11 +0,0 @@
-/**
- * Generated by orval v8.2.0 🍺
- * Do not edit manually.
- * Mission Control API
- * OpenAPI spec version: 0.1.0
- */
-
-export interface AgentProvisionConfirm {
-  token: string;
-  action?: string | null;
-}
--- a/frontend/src/api/generated/model/agentRead.ts
+++ b/frontend/src/api/generated/model/agentRead.ts
@@ -12,19 +12,19 @@ import type { AgentReadIdentityProfile } from "./agentReadIdentityProfile";
 */
 export interface AgentRead {
  board_id?: string | null;
-  created_at: string;
-  gateway_id: string;
-  heartbeat_config?: AgentReadHeartbeatConfig;
-  id: string;
-  identity_profile?: AgentReadIdentityProfile;
-  identity_template?: string | null;
-  is_board_lead?: boolean;
-  is_gateway_main?: boolean;
-  last_seen_at: string | null;
  /** @minLength 1 */
  name: string;
-  openclaw_session_id?: string | null;
-  soul_template?: string | null;
  status?: string;
+  heartbeat_config?: AgentReadHeartbeatConfig;
+  identity_profile?: AgentReadIdentityProfile;
+  identity_template?: string | null;
+  soul_template?: string | null;
+  id: string;
+  gateway_id: string;
+  is_board_lead?: boolean;
+  is_gateway_main?: boolean;
+  openclaw_session_id?: string | null;
+  last_seen_at: string | null;
+  created_at: string;
  updated_at: string;
 }
--- a/frontend/src/api/generated/model/agentUpdate.ts
+++ b/frontend/src/api/generated/model/agentUpdate.ts
@@ -12,11 +12,11 @@ import type { AgentUpdateIdentityProfile } from "./agentUpdateIdentityProfile";
 */
 export interface AgentUpdate {
  board_id?: string | null;
+  is_gateway_main?: boolean | null;
+  name?: string | null;
+  status?: string | null;
  heartbeat_config?: AgentUpdateHeartbeatConfig;
  identity_profile?: AgentUpdateIdentityProfile;
  identity_template?: string | null;
-  is_gateway_main?: boolean | null;
-  name?: string | null;
  soul_template?: string | null;
-  status?: string | null;
 }
--- a/frontend/src/api/generated/model/approvalCreate.ts
+++ b/frontend/src/api/generated/model/approvalCreate.ts
@@ -13,11 +13,11 @@ import type { ApprovalCreateStatus } from "./approvalCreateStatus";
 */
 export interface ApprovalCreate {
  action_type: string;
-  agent_id?: string | null;
-  confidence: number;
-  payload?: ApprovalCreatePayload;
-  rubric_scores?: ApprovalCreateRubricScores;
-  status?: ApprovalCreateStatus;
  task_id?: string | null;
  task_ids?: string[];
+  payload?: ApprovalCreatePayload;
+  confidence: number;
+  rubric_scores?: ApprovalCreateRubricScores;
+  status?: ApprovalCreateStatus;
+  agent_id?: string | null;
 }
--- a/frontend/src/api/generated/model/approvalRead.ts
+++ b/frontend/src/api/generated/model/approvalRead.ts
@@ -13,15 +13,15 @@ import type { ApprovalReadStatus } from "./approvalReadStatus";
 */
 export interface ApprovalRead {
  action_type: string;
-  agent_id?: string | null;
-  board_id: string;
-  confidence: number;
-  created_at: string;
-  id: string;
-  payload?: ApprovalReadPayload;
-  resolved_at?: string | null;
-  rubric_scores?: ApprovalReadRubricScores;
-  status?: ApprovalReadStatus;
  task_id?: string | null;
  task_ids?: string[];
+  payload?: ApprovalReadPayload;
+  confidence: number;
+  rubric_scores?: ApprovalReadRubricScores;
+  status?: ApprovalReadStatus;
+  id: string;
+  board_id: string;
+  agent_id?: string | null;
+  created_at: string;
+  resolved_at?: string | null;
 }
--- a/frontend/src/api/generated/model/blockedTaskDetail.ts
+++ b/frontend/src/api/generated/model/blockedTaskDetail.ts
@@ -9,6 +9,6 @@
 * Error detail payload listing blocking dependency task identifiers.
 */
 export interface BlockedTaskDetail {
-  blocked_by_task_ids?: string[];
  message: string;
+  blocked_by_task_ids?: string[];
 }
--- a/frontend/src/api/generated/model/boardCreate.ts
+++ b/frontend/src/api/generated/model/boardCreate.ts
@@ -10,15 +10,15 @@ import type { BoardCreateSuccessMetrics } from "./boardCreateSuccessMetrics";
 * Payload for creating a board.
 */
 export interface BoardCreate {
-  board_group_id?: string | null;
-  board_type?: string;
+  name: string;
+  slug: string;
  description: string;
  gateway_id?: string | null;
-  goal_confirmed?: boolean;
-  goal_source?: string | null;
-  name: string;
+  board_group_id?: string | null;
+  board_type?: string;
  objective?: string | null;
-  slug: string;
  success_metrics?: BoardCreateSuccessMetrics;
  target_date?: string | null;
+  goal_confirmed?: boolean;
+  goal_source?: string | null;
 }
--- a/frontend/src/api/generated/model/boardGroupCreate.ts
+++ b/frontend/src/api/generated/model/boardGroupCreate.ts
@@ -9,7 +9,7 @@
 * Payload for creating a board group.
 */
 export interface BoardGroupCreate {
-  description?: string | null;
  name: string;
  slug: string;
+  description?: string | null;
 }
--- a/frontend/src/api/generated/model/boardGroupHeartbeatApply.ts
+++ b/frontend/src/api/generated/model/boardGroupHeartbeatApply.ts
@@ -10,6 +10,6 @@
 */
 export interface BoardGroupHeartbeatApply {
  every: string;
-  include_board_leads?: boolean;
  target?: string | null;
+  include_board_leads?: boolean;
 }
--- a/frontend/src/api/generated/model/boardGroupHeartbeatApplyResult.ts
+++ b/frontend/src/api/generated/model/boardGroupHeartbeatApplyResult.ts
@@ -11,7 +11,7 @@ import type { BoardGroupHeartbeatApplyResultRequested } from "./boardGroupHeartb
 */
 export interface BoardGroupHeartbeatApplyResult {
  board_group_id: string;
-  failed_agent_ids: string[];
  requested: BoardGroupHeartbeatApplyResultRequested;
  updated_agent_ids: string[];
+  failed_agent_ids: string[];
 }
--- a/frontend/src/api/generated/model/boardGroupMemoryCreate.ts
+++ b/frontend/src/api/generated/model/boardGroupMemoryCreate.ts
@@ -11,6 +11,6 @@
 export interface BoardGroupMemoryCreate {
  /** @minLength 1 */
  content: string;
-  source?: string | null;
  tags?: string[] | null;
+  source?: string | null;
 }
--- a/frontend/src/api/generated/model/boardGroupMemoryRead.ts
+++ b/frontend/src/api/generated/model/boardGroupMemoryRead.ts
@@ -9,11 +9,11 @@
 * Serialized board-group memory entry returned from read endpoints.
 */
 export interface BoardGroupMemoryRead {
+  id: string;
  board_group_id: string;
  content: string;
-  created_at: string;
-  id: string;
-  is_chat?: boolean;
-  source?: string | null;
  tags?: string[] | null;
+  source?: string | null;
+  is_chat?: boolean;
+  created_at: string;
 }
--- a/frontend/src/api/generated/model/boardGroupRead.ts
+++ b/frontend/src/api/generated/model/boardGroupRead.ts
@@ -9,11 +9,11 @@
 * Board-group payload returned from read endpoints.
 */
 export interface BoardGroupRead {
-  created_at: string;
+  name: string;
+  slug: string;
  description?: string | null;
  id: string;
-  name: string;
  organization_id: string;
-  slug: string;
+  created_at: string;
  updated_at: string;
 }
--- a/frontend/src/api/generated/model/boardGroupSnapshot.ts
+++ b/frontend/src/api/generated/model/boardGroupSnapshot.ts
@@ -11,6 +11,6 @@ import type { BoardGroupRead } from "./boardGroupRead";
 * Top-level board-group snapshot response payload.
 */
 export interface BoardGroupSnapshot {
-  boards?: BoardGroupBoardSnapshot[];
  group?: BoardGroupRead | null;
+  boards?: BoardGroupBoardSnapshot[];
 }
--- a/frontend/src/api/generated/model/boardGroupTaskSummary.ts
+++ b/frontend/src/api/generated/model/boardGroupTaskSummary.ts
@@ -4,23 +4,23 @@
 * Mission Control API
 * OpenAPI spec version: 0.1.0
 */
-import type { TaskTagRef } from "./taskTagRef";
+import type { TagRef } from "./tagRef";

 /**
 * Task summary row used inside board-group snapshot responses.
 */
 export interface BoardGroupTaskSummary {
-  assigned_agent_id?: string | null;
-  assignee?: string | null;
+  id: string;
  board_id: string;
  board_name: string;
-  created_at: string;
-  due_at?: string | null;
-  id: string;
-  in_progress_at?: string | null;
-  priority: string;
-  status: string;
-  tags?: TaskTagRef[];
  title: string;
+  status: string;
+  priority: string;
+  assigned_agent_id?: string | null;
+  assignee?: string | null;
+  due_at?: string | null;
+  in_progress_at?: string | null;
+  tags?: TagRef[];
+  created_at: string;
  updated_at: string;
 }
--- a/frontend/src/api/generated/model/boardGroupUpdate.ts
+++ b/frontend/src/api/generated/model/boardGroupUpdate.ts
@@ -9,7 +9,7 @@
 * Payload for partial board-group updates.
 */
 export interface BoardGroupUpdate {
-  description?: string | null;
  name?: string | null;
  slug?: string | null;
+  description?: string | null;
 }
--- a/frontend/src/api/generated/model/boardMemoryCreate.ts
+++ b/frontend/src/api/generated/model/boardMemoryCreate.ts
@@ -11,6 +11,6 @@
 export interface BoardMemoryCreate {
  /** @minLength 1 */
  content: string;
-  source?: string | null;
  tags?: string[] | null;
+  source?: string | null;
 }
--- a/frontend/src/api/generated/model/boardMemoryRead.ts
+++ b/frontend/src/api/generated/model/boardMemoryRead.ts
@@ -9,11 +9,11 @@
 * Serialized board memory entry returned from read endpoints.
 */
 export interface BoardMemoryRead {
+  id: string;
  board_id: string;
  content: string;
-  created_at: string;
-  id: string;
-  is_chat?: boolean;
-  source?: string | null;
  tags?: string[] | null;
+  source?: string | null;
+  is_chat?: boolean;
+  created_at: string;
 }
--- a/frontend/src/api/generated/model/boardOnboardingAgentComplete.ts
+++ b/frontend/src/api/generated/model/boardOnboardingAgentComplete.ts
@@ -13,10 +13,10 @@ import type { BoardOnboardingUserProfile } from "./boardOnboardingUserProfile";
 */
 export interface BoardOnboardingAgentComplete {
  board_type: string;
-  lead_agent?: BoardOnboardingLeadAgentDraft | null;
  objective?: string | null;
-  status: "complete";
  success_metrics?: BoardOnboardingAgentCompleteSuccessMetrics;
  target_date?: string | null;
+  status: "complete";
  user_profile?: BoardOnboardingUserProfile | null;
+  lead_agent?: BoardOnboardingLeadAgentDraft | null;
 }
--- a/frontend/src/api/generated/model/boardOnboardingAgentCompleteStatus.ts
+++ b/frontend/src/api/generated/model/boardOnboardingAgentCompleteStatus.ts
@@ -1,13 +0,0 @@
-/**
- * Generated by orval v8.2.0 🍺
- * Do not edit manually.
- * Mission Control API
- * OpenAPI spec version: 0.1.0
- */
-
-export type BoardOnboardingAgentCompleteStatus =
-  (typeof BoardOnboardingAgentCompleteStatus)[keyof typeof BoardOnboardingAgentCompleteStatus];
-
-export const BoardOnboardingAgentCompleteStatus = {
-  complete: "complete",
-} as const;
--- a/frontend/src/api/generated/model/boardOnboardingAgentQuestion.ts
+++ b/frontend/src/api/generated/model/boardOnboardingAgentQuestion.ts
@@ -10,8 +10,8 @@ import type { BoardOnboardingQuestionOption } from "./boardOnboardingQuestionOpt
 * Question payload emitted by the onboarding assistant.
 */
 export interface BoardOnboardingAgentQuestion {
-  /** @minItems 1 */
-  options: BoardOnboardingQuestionOption[];
  /** @minLength 1 */
  question: string;
+  /** @minItems 1 */
+  options: BoardOnboardingQuestionOption[];
 }
--- a/frontend/src/api/generated/model/boardOnboardingLeadAgentDraft.ts
+++ b/frontend/src/api/generated/model/boardOnboardingLeadAgentDraft.ts
@@ -10,11 +10,11 @@ import type { BoardOnboardingLeadAgentDraftIdentityProfile } from "./boardOnboar
 * Editable lead-agent draft configuration.
 */
 export interface BoardOnboardingLeadAgentDraft {
-  autonomy_level?: "ask_first" | "balanced" | "autonomous" | null;
-  custom_instructions?: string | null;
-  identity_profile?: BoardOnboardingLeadAgentDraftIdentityProfile;
  name?: string | null;
+  identity_profile?: BoardOnboardingLeadAgentDraftIdentityProfile;
+  autonomy_level?: "ask_first" | "balanced" | "autonomous" | null;
+  verbosity?: "concise" | "balanced" | "detailed" | null;
  output_format?: "bullets" | "mixed" | "narrative" | null;
  update_cadence?: "asap" | "hourly" | "daily" | "weekly" | null;
-  verbosity?: "concise" | "balanced" | "detailed" | null;
+  custom_instructions?: string | null;
 }
--- a/frontend/src/api/generated/model/boardOnboardingRead.ts
+++ b/frontend/src/api/generated/model/boardOnboardingRead.ts
@@ -11,12 +11,12 @@ import type { BoardOnboardingReadMessages } from "./boardOnboardingReadMessages"
 * Stored onboarding session state returned by API endpoints.
 */
 export interface BoardOnboardingRead {
-  board_id: string;
-  created_at: string;
-  draft_goal?: BoardOnboardingAgentComplete | null;
  id: string;
-  messages?: BoardOnboardingReadMessages;
+  board_id: string;
  session_key: string;
  status: string;
+  messages?: BoardOnboardingReadMessages;
+  draft_goal?: BoardOnboardingAgentComplete | null;
+  created_at: string;
  updated_at: string;
 }
--- a/frontend/src/api/generated/model/boardOnboardingReadDraftGoal.ts
+++ b/frontend/src/api/generated/model/boardOnboardingReadDraftGoal.ts
@@ -1,8 +0,0 @@
-/**
- * Generated by orval v8.2.0 🍺
- * Do not edit manually.
- * Mission Control API
- * OpenAPI spec version: 0.1.0
- */
-
-export type BoardOnboardingReadDraftGoal = { [key: string]: unknown } | null;
--- a/frontend/src/api/generated/model/boardOnboardingUserProfile.ts
+++ b/frontend/src/api/generated/model/boardOnboardingUserProfile.ts
@@ -9,9 +9,9 @@
 * User-profile preferences gathered during onboarding.
 */
 export interface BoardOnboardingUserProfile {
-  context?: string | null;
-  notes?: string | null;
  preferred_name?: string | null;
  pronouns?: string | null;
  timezone?: string | null;
+  notes?: string | null;
+  context?: string | null;
 }
--- a/frontend/src/api/generated/model/boardRead.ts
+++ b/frontend/src/api/generated/model/boardRead.ts
@@ -10,19 +10,19 @@ import type { BoardReadSuccessMetrics } from "./boardReadSuccessMetrics";
 * Board payload returned from read endpoints.
 */
 export interface BoardRead {
-  board_group_id?: string | null;
-  board_type?: string;
-  created_at: string;
+  name: string;
+  slug: string;
  description: string;
  gateway_id?: string | null;
+  board_group_id?: string | null;
+  board_type?: string;
+  objective?: string | null;
+  success_metrics?: BoardReadSuccessMetrics;
+  target_date?: string | null;
  goal_confirmed?: boolean;
  goal_source?: string | null;
  id: string;
-  name: string;
-  objective?: string | null;
  organization_id: string;
-  slug: string;
-  success_metrics?: BoardReadSuccessMetrics;
-  target_date?: string | null;
+  created_at: string;
  updated_at: string;
 }
--- a/frontend/src/api/generated/model/boardSnapshot.ts
+++ b/frontend/src/api/generated/model/boardSnapshot.ts
@@ -14,10 +14,10 @@ import type { TaskCardRead } from "./taskCardRead";
 * Aggregated board payload used by board snapshot endpoints.
 */
 export interface BoardSnapshot {
+  board: BoardRead;
+  tasks: TaskCardRead[];
  agents: AgentRead[];
  approvals: ApprovalRead[];
-  board: BoardRead;
  chat_messages: BoardMemoryRead[];
  pending_approvals_count?: number;
-  tasks: TaskCardRead[];
 }
--- a/frontend/src/api/generated/model/boardUpdate.ts
+++ b/frontend/src/api/generated/model/boardUpdate.ts
@@ -10,15 +10,15 @@ import type { BoardUpdateSuccessMetrics } from "./boardUpdateSuccessMetrics";
 * Payload for partial board updates.
 */
 export interface BoardUpdate {
-  board_group_id?: string | null;
-  board_type?: string | null;
+  name?: string | null;
+  slug?: string | null;
  description?: string | null;
  gateway_id?: string | null;
-  goal_confirmed?: boolean | null;
-  goal_source?: string | null;
-  name?: string | null;
+  board_group_id?: string | null;
+  board_type?: string | null;
  objective?: string | null;
-  slug?: string | null;
  success_metrics?: BoardUpdateSuccessMetrics;
  target_date?: string | null;
+  goal_confirmed?: boolean | null;
+  goal_source?: string | null;
 }
--- a/frontend/src/api/generated/model/confirmDeleteAgentApiV1AgentsAgentIdDeleteConfirmPost200.ts
+++ b/frontend/src/api/generated/model/confirmDeleteAgentApiV1AgentsAgentIdDeleteConfirmPost200.ts
@@ -1,10 +0,0 @@
-/**
- * Generated by orval v8.2.0 🍺
- * Do not edit manually.
- * Mission Control API
- * OpenAPI spec version: 0.1.0
- */
-
-export type ConfirmDeleteAgentApiV1AgentsAgentIdDeleteConfirmPost200 = {
-  [key: string]: boolean;
-};
--- a/frontend/src/api/generated/model/confirmProvisionAgentApiV1AgentsAgentIdProvisionConfirmPost200.ts
+++ b/frontend/src/api/generated/model/confirmProvisionAgentApiV1AgentsAgentIdProvisionConfirmPost200.ts
@@ -1,10 +0,0 @@
-/**
- * Generated by orval v8.2.0 🍺
- * Do not edit manually.
- * Mission Control API
- * OpenAPI spec version: 0.1.0
- */
-
-export type ConfirmProvisionAgentApiV1AgentsAgentIdProvisionConfirmPost200 = {
-  [key: string]: boolean;
-};
--- a/frontend/src/api/generated/model/dashboardKpis.ts
+++ b/frontend/src/api/generated/model/dashboardKpis.ts
@@ -10,7 +10,7 @@
 */
 export interface DashboardKpis {
  active_agents: number;
+  tasks_in_progress: number;
  error_rate_pct: number;
  median_cycle_time_hours_7d: number | null;
-  tasks_in_progress: number;
 }
--- a/frontend/src/api/generated/model/dashboardMetrics.ts
+++ b/frontend/src/api/generated/model/dashboardMetrics.ts
@@ -13,11 +13,11 @@ import type { DashboardWipSeriesSet } from "./dashboardWipSeriesSet";
 * Complete dashboard metrics response payload.
 */
 export interface DashboardMetrics {
-  cycle_time: DashboardSeriesSet;
-  error_rate: DashboardSeriesSet;
+  range: DashboardMetricsRange;
  generated_at: string;
  kpis: DashboardKpis;
-  range: DashboardMetricsRange;
  throughput: DashboardSeriesSet;
+  cycle_time: DashboardSeriesSet;
+  error_rate: DashboardSeriesSet;
  wip: DashboardWipSeriesSet;
 }
--- a/frontend/src/api/generated/model/dashboardMetricsApiV1MetricsDashboardGetRange.ts
+++ b/frontend/src/api/generated/model/dashboardMetricsApiV1MetricsDashboardGetRange.ts
@@ -1,14 +0,0 @@
-/**
- * Generated by orval v8.2.0 🍺
- * Do not edit manually.
- * Mission Control API
- * OpenAPI spec version: 0.1.0
- */
-
-export type DashboardMetricsApiV1MetricsDashboardGetRange =
-  (typeof DashboardMetricsApiV1MetricsDashboardGetRange)[keyof typeof DashboardMetricsApiV1MetricsDashboardGetRange];
-
-export const DashboardMetricsApiV1MetricsDashboardGetRange = {
-  "24h": "24h",
-  "7d": "7d",
-} as const;
--- a/frontend/src/api/generated/model/dashboardRangeSeries.ts
+++ b/frontend/src/api/generated/model/dashboardRangeSeries.ts
@@ -12,7 +12,7 @@ import type { DashboardSeriesPoint } from "./dashboardSeriesPoint";
 * Series payload for a single range/bucket combination.
 */
 export interface DashboardRangeSeries {
+  range: DashboardRangeSeriesRange;
  bucket: DashboardRangeSeriesBucket;
  points: DashboardSeriesPoint[];
-  range: DashboardRangeSeriesRange;
 }
--- a/frontend/src/api/generated/model/dashboardSeriesSet.ts
+++ b/frontend/src/api/generated/model/dashboardSeriesSet.ts
@@ -10,6 +10,6 @@ import type { DashboardRangeSeries } from "./dashboardRangeSeries";
 * Primary vs comparison pair for generic series metrics.
 */
 export interface DashboardSeriesSet {
-  comparison: DashboardRangeSeries;
  primary: DashboardRangeSeries;
+  comparison: DashboardRangeSeries;
 }
--- a/frontend/src/api/generated/model/dashboardWipPoint.ts
+++ b/frontend/src/api/generated/model/dashboardWipPoint.ts
@@ -9,8 +9,8 @@
 * Work-in-progress point split by task status buckets.
 */
 export interface DashboardWipPoint {
-  in_progress: number;
-  inbox: number;
  period: string;
+  inbox: number;
+  in_progress: number;
  review: number;
 }
--- a/frontend/src/api/generated/model/dashboardWipRangeSeries.ts
+++ b/frontend/src/api/generated/model/dashboardWipRangeSeries.ts
@@ -12,7 +12,7 @@ import type { DashboardWipRangeSeriesRange } from "./dashboardWipRangeSeriesRang
 * WIP series payload for a single range/bucket combination.
 */
 export interface DashboardWipRangeSeries {
+  range: DashboardWipRangeSeriesRange;
  bucket: DashboardWipRangeSeriesBucket;
  points: DashboardWipPoint[];
-  range: DashboardWipRangeSeriesRange;
 }
--- a/frontend/src/api/generated/model/dashboardWipSeriesSet.ts
+++ b/frontend/src/api/generated/model/dashboardWipSeriesSet.ts
@@ -10,6 +10,6 @@ import type { DashboardWipRangeSeries } from "./dashboardWipRangeSeries";
 * Primary vs comparison pair for WIP status series metrics.
 */
 export interface DashboardWipSeriesSet {
-  comparison: DashboardWipRangeSeries;
  primary: DashboardWipRangeSeries;
+  comparison: DashboardWipRangeSeries;
 }
--- a/frontend/src/api/generated/model/deleteAgentApiV1AgentsAgentIdDelete200.ts
+++ b/frontend/src/api/generated/model/deleteAgentApiV1AgentsAgentIdDelete200.ts
@@ -1,8 +0,0 @@
-/**
- * Generated by orval v8.2.0 🍺
- * Do not edit manually.
- * Mission Control API
- * OpenAPI spec version: 0.1.0
- */
-
-export type DeleteAgentApiV1AgentsAgentIdDelete200 = { [key: string]: boolean };
--- a/frontend/src/api/generated/model/deleteBoardApiV1BoardsBoardIdDelete200.ts
+++ b/frontend/src/api/generated/model/deleteBoardApiV1BoardsBoardIdDelete200.ts
@@ -1,8 +0,0 @@
-/**
- * Generated by orval v8.2.0 🍺
- * Do not edit manually.
- * Mission Control API
- * OpenAPI spec version: 0.1.0
- */
-
-export type DeleteBoardApiV1BoardsBoardIdDelete200 = { [key: string]: boolean };
--- a/frontend/src/api/generated/model/deleteTaskApiV1BoardsBoardIdTasksTaskIdDelete200.ts
+++ b/frontend/src/api/generated/model/deleteTaskApiV1BoardsBoardIdTasksTaskIdDelete200.ts
@@ -1,10 +0,0 @@
-/**
- * Generated by orval v8.2.0 🍺
- * Do not edit manually.
- * Mission Control API
- * OpenAPI spec version: 0.1.0
- */
-
-export type DeleteTaskApiV1BoardsBoardIdTasksTaskIdDelete200 = {
-  [key: string]: boolean;
-};
--- a/frontend/src/api/generated/model/gatewayCommandsApiV1GatewayCommandsGet200.ts
+++ b/frontend/src/api/generated/model/gatewayCommandsApiV1GatewayCommandsGet200.ts
@@ -1,10 +0,0 @@
-/**
- * Generated by orval v8.2.0 🍺
- * Do not edit manually.
- * Mission Control API
- * OpenAPI spec version: 0.1.0
- */
-
-export type GatewayCommandsApiV1GatewayCommandsGet200 = {
-  [key: string]: unknown;
-};
--- a/frontend/src/api/generated/model/gatewayCommandsResponse.ts
+++ b/frontend/src/api/generated/model/gatewayCommandsResponse.ts
@@ -9,7 +9,7 @@
 * Gateway command catalog and protocol metadata.
 */
 export interface GatewayCommandsResponse {
-  events: string[];
-  methods: string[];
  protocol_version: number;
+  methods: string[];
+  events: string[];
 }
--- a/frontend/src/api/generated/model/gatewayCreate.ts
+++ b/frontend/src/api/generated/model/gatewayCreate.ts
@@ -10,7 +10,7 @@
 */
 export interface GatewayCreate {
  name: string;
-  token?: string | null;
  url: string;
  workspace_root: string;
+  token?: string | null;
 }
--- a/frontend/src/api/generated/model/gatewayLeadBroadcastBoardResult.ts
+++ b/frontend/src/api/generated/model/gatewayLeadBroadcastBoardResult.ts
@@ -10,8 +10,8 @@
 */
 export interface GatewayLeadBroadcastBoardResult {
  board_id: string;
-  error?: string | null;
  lead_agent_id?: string | null;
  lead_agent_name?: string | null;
  ok?: boolean;
+  error?: string | null;
 }
--- a/frontend/src/api/generated/model/gatewayLeadBroadcastRequest.ts
+++ b/frontend/src/api/generated/model/gatewayLeadBroadcastRequest.ts
@@ -10,11 +10,11 @@ import type { GatewayLeadBroadcastRequestKind } from "./gatewayLeadBroadcastRequ
 * Request payload for broadcasting a message to multiple board leads.
 */
 export interface GatewayLeadBroadcastRequest {
-  board_ids?: string[] | null;
+  kind?: GatewayLeadBroadcastRequestKind;
+  correlation_id?: string | null;
  /** @minLength 1 */
  content: string;
-  correlation_id?: string | null;
-  kind?: GatewayLeadBroadcastRequestKind;
-  reply_source?: string | null;
+  board_ids?: string[] | null;
  reply_tags?: string[];
+  reply_source?: string | null;
 }
--- a/frontend/src/api/generated/model/gatewayLeadBroadcastResponse.ts
+++ b/frontend/src/api/generated/model/gatewayLeadBroadcastResponse.ts
@@ -10,8 +10,8 @@ import type { GatewayLeadBroadcastBoardResult } from "./gatewayLeadBroadcastBoar
 * Aggregate response for a lead broadcast operation.
 */
 export interface GatewayLeadBroadcastResponse {
-  failed?: number;
  ok?: boolean;
-  results?: GatewayLeadBroadcastBoardResult[];
  sent?: number;
+  failed?: number;
+  results?: GatewayLeadBroadcastBoardResult[];
 }
--- a/frontend/src/api/generated/model/gatewayLeadMessageRequest.ts
+++ b/frontend/src/api/generated/model/gatewayLeadMessageRequest.ts
@@ -10,10 +10,10 @@ import type { GatewayLeadMessageRequestKind } from "./gatewayLeadMessageRequestK
 * Request payload for sending a message to a board lead agent.
 */
 export interface GatewayLeadMessageRequest {
+  kind?: GatewayLeadMessageRequestKind;
+  correlation_id?: string | null;
  /** @minLength 1 */
  content: string;
-  correlation_id?: string | null;
-  kind?: GatewayLeadMessageRequestKind;
-  reply_source?: string | null;
  reply_tags?: string[];
+  reply_source?: string | null;
 }
--- a/frontend/src/api/generated/model/gatewayLeadMessageResponse.ts
+++ b/frontend/src/api/generated/model/gatewayLeadMessageResponse.ts
@@ -9,9 +9,9 @@
 * Response payload for a lead-message dispatch attempt.
 */
 export interface GatewayLeadMessageResponse {
+  ok?: boolean;
  board_id: string;
  lead_agent_id?: string | null;
  lead_agent_name?: string | null;
  lead_created?: boolean;
-  ok?: boolean;
 }
--- a/frontend/src/api/generated/model/gatewayMainAskUserRequest.ts
+++ b/frontend/src/api/generated/model/gatewayMainAskUserRequest.ts
@@ -9,10 +9,10 @@
 * Request payload for asking the end user via a main gateway agent.
 */
 export interface GatewayMainAskUserRequest {
+  correlation_id?: string | null;
  /** @minLength 1 */
  content: string;
-  correlation_id?: string | null;
  preferred_channel?: string | null;
-  reply_source?: string | null;
  reply_tags?: string[];
+  reply_source?: string | null;
 }
--- a/frontend/src/api/generated/model/gatewayMainAskUserResponse.ts
+++ b/frontend/src/api/generated/model/gatewayMainAskUserResponse.ts
@@ -9,8 +9,8 @@
 * Response payload for user-question dispatch via gateway main agent.
 */
 export interface GatewayMainAskUserResponse {
+  ok?: boolean;
  board_id: string;
  main_agent_id?: string | null;
  main_agent_name?: string | null;
-  ok?: boolean;
 }
--- a/frontend/src/api/generated/model/gatewayRead.ts
+++ b/frontend/src/api/generated/model/gatewayRead.ts
@@ -9,12 +9,12 @@
 * Gateway payload returned from read endpoints.
 */
 export interface GatewayRead {
-  created_at: string;
-  id: string;
  name: string;
-  organization_id: string;
-  token?: string | null;
-  updated_at: string;
  url: string;
  workspace_root: string;
+  id: string;
+  organization_id: string;
+  token?: string | null;
+  created_at: string;
+  updated_at: string;
 }
--- a/frontend/src/api/generated/model/gatewayResolveQuery.ts
+++ b/frontend/src/api/generated/model/gatewayResolveQuery.ts
@@ -1,15 +0,0 @@
-/**
- * Generated by orval v8.2.0 🍺
- * Do not edit manually.
- * Mission Control API
- * OpenAPI spec version: 0.1.0
- */
-
-/**
- * Query parameters used to resolve which gateway to target.
- */
-export interface GatewayResolveQuery {
-  board_id?: string | null;
-  gateway_url?: string | null;
-  gateway_token?: string | null;
-}
--- a/frontend/src/api/generated/model/gatewaySessionsResponse.ts
+++ b/frontend/src/api/generated/model/gatewaySessionsResponse.ts
@@ -9,6 +9,6 @@
 * Gateway sessions list response payload.
 */
 export interface GatewaySessionsResponse {
-  main_session?: unknown | null;
  sessions: unknown[];
+  main_session?: unknown | null;
 }
--- a/frontend/src/api/generated/model/gatewayStatusApiV1GatewayStatusGet200.ts
+++ b/frontend/src/api/generated/model/gatewayStatusApiV1GatewayStatusGet200.ts
@@ -1,8 +0,0 @@
-/**
- * Generated by orval v8.2.0 🍺
- * Do not edit manually.
- * Mission Control API
- * OpenAPI spec version: 0.1.0
- */
-
-export type GatewayStatusApiV1GatewayStatusGet200 = { [key: string]: unknown };
--- a/frontend/src/api/generated/model/gatewayStatusApiV1GatewayStatusGetParams.ts
+++ b/frontend/src/api/generated/model/gatewayStatusApiV1GatewayStatusGetParams.ts
@@ -1,10 +0,0 @@
-/**
- * Generated by orval v8.2.0 🍺
- * Do not edit manually.
- * Mission Control API
- * OpenAPI spec version: 0.1.0
- */
-
-export type GatewayStatusApiV1GatewayStatusGetParams = {
-  board_id?: string | null;
-};
--- a/frontend/src/api/generated/model/gatewayTemplatesSyncResult.ts
+++ b/frontend/src/api/generated/model/gatewayTemplatesSyncResult.ts
@@ -10,11 +10,11 @@ import type { GatewayTemplatesSyncError } from "./gatewayTemplatesSyncError";
 * Summary payload returned by gateway template sync endpoints.
 */
 export interface GatewayTemplatesSyncResult {
-  agents_skipped: number;
-  agents_updated: number;
-  errors?: GatewayTemplatesSyncError[];
  gateway_id: string;
  include_main: boolean;
-  main_updated: boolean;
  reset_sessions: boolean;
+  agents_updated: number;
+  agents_skipped: number;
+  main_updated: boolean;
+  errors?: GatewayTemplatesSyncError[];
 }
--- a/frontend/src/api/generated/model/gatewayUpdate.ts
+++ b/frontend/src/api/generated/model/gatewayUpdate.ts
@@ -10,7 +10,7 @@
 */
 export interface GatewayUpdate {
  name?: string | null;
-  token?: string | null;
  url?: string | null;
+  token?: string | null;
  workspace_root?: string | null;
 }
--- a/frontend/src/api/generated/model/gatewaysStatusResponse.ts
+++ b/frontend/src/api/generated/model/gatewaysStatusResponse.ts
@@ -10,10 +10,10 @@
 */
 export interface GatewaysStatusResponse {
  connected: boolean;
-  error?: string | null;
  gateway_url: string;
+  sessions_count?: number | null;
+  sessions?: unknown[] | null;
  main_session?: unknown | null;
  main_session_error?: string | null;
-  sessions?: unknown[] | null;
-  sessions_count?: number | null;
+  error?: string | null;
 }
--- a/frontend/src/api/generated/model/getGatewaySessionApiV1GatewaySessionsSessionIdGet200.ts
+++ b/frontend/src/api/generated/model/getGatewaySessionApiV1GatewaySessionsSessionIdGet200.ts
@@ -1,10 +0,0 @@
-/**
- * Generated by orval v8.2.0 🍺
- * Do not edit manually.
- * Mission Control API
- * OpenAPI spec version: 0.1.0
- */
-
-export type GetGatewaySessionApiV1GatewaySessionsSessionIdGet200 = {
-  [key: string]: unknown;
-};
--- a/frontend/src/api/generated/model/getGatewaySessionApiV1GatewaySessionsSessionIdGetParams.ts
+++ b/frontend/src/api/generated/model/getGatewaySessionApiV1GatewaySessionsSessionIdGetParams.ts
@@ -1,10 +0,0 @@
-/**
- * Generated by orval v8.2.0 🍺
- * Do not edit manually.
- * Mission Control API
- * OpenAPI spec version: 0.1.0
- */
-
-export type GetGatewaySessionApiV1GatewaySessionsSessionIdGetParams = {
-  board_id?: string | null;
-};
--- a/frontend/src/api/generated/model/getSessionHistoryApiV1GatewaySessionsSessionIdHistoryGet200.ts
+++ b/frontend/src/api/generated/model/getSessionHistoryApiV1GatewaySessionsSessionIdHistoryGet200.ts
@@ -1,10 +0,0 @@
-/**
- * Generated by orval v8.2.0 🍺
- * Do not edit manually.
- * Mission Control API
- * OpenAPI spec version: 0.1.0
- */
-
-export type GetSessionHistoryApiV1GatewaySessionsSessionIdHistoryGet200 = {
-  [key: string]: unknown;
-};
--- a/frontend/src/api/generated/model/getSessionHistoryApiV1GatewaySessionsSessionIdHistoryGetParams.ts
+++ b/frontend/src/api/generated/model/getSessionHistoryApiV1GatewaySessionsSessionIdHistoryGetParams.ts
@@ -1,10 +0,0 @@
-/**
- * Generated by orval v8.2.0 🍺
- * Do not edit manually.
- * Mission Control API
- * OpenAPI spec version: 0.1.0
- */
-
-export type GetSessionHistoryApiV1GatewaySessionsSessionIdHistoryGetParams = {
-  board_id?: string | null;
-};
--- a/frontend/src/api/generated/model/index.ts
+++ b/frontend/src/api/generated/model/index.ts
@@ -10,11 +10,9 @@ export * from "./activityTaskCommentFeedItemRead";
 export * from "./agentCreate";
 export * from "./agentCreateHeartbeatConfig";
 export * from "./agentCreateIdentityProfile";
-export * from "./agentDeleteConfirm";
 export * from "./agentHeartbeat";
 export * from "./agentHeartbeatCreate";
 export * from "./agentNudge";
-export * from "./agentProvisionConfirm";
 export * from "./agentRead";
 export * from "./agentReadHeartbeatConfig";
 export * from "./agentReadIdentityProfile";
@@ -49,7 +47,6 @@ export * from "./boardGroupUpdate";
 export * from "./boardMemoryCreate";
 export * from "./boardMemoryRead";
 export * from "./boardOnboardingAgentComplete";
-export * from "./boardOnboardingAgentCompleteStatus";
 export * from "./boardOnboardingAgentCompleteSuccessMetrics";
 export * from "./boardOnboardingAgentQuestion";
 export * from "./boardOnboardingAnswer";
@@ -59,7 +56,6 @@ export * from "./boardOnboardingLeadAgentDraft";
 export * from "./boardOnboardingLeadAgentDraftIdentityProfile";
 export * from "./boardOnboardingQuestionOption";
 export * from "./boardOnboardingRead";
-export * from "./boardOnboardingReadDraftGoal";
 export * from "./boardOnboardingReadMessages";
 export * from "./boardOnboardingStart";
 export * from "./boardOnboardingUserProfile";
@@ -68,12 +64,9 @@ export * from "./boardReadSuccessMetrics";
 export * from "./boardSnapshot";
 export * from "./boardUpdate";
 export * from "./boardUpdateSuccessMetrics";
-export * from "./confirmDeleteAgentApiV1AgentsAgentIdDeleteConfirmPost200";
-export * from "./confirmProvisionAgentApiV1AgentsAgentIdProvisionConfirmPost200";
 export * from "./dashboardKpis";
 export * from "./dashboardMetrics";
 export * from "./dashboardMetricsApiV1MetricsDashboardGetParams";
-export * from "./dashboardMetricsApiV1MetricsDashboardGetRange";
 export * from "./dashboardMetricsApiV1MetricsDashboardGetRangeKey";
 export * from "./dashboardMetricsRange";
 export * from "./dashboardRangeSeries";
@@ -86,10 +79,6 @@ export * from "./dashboardWipRangeSeries";
 export * from "./dashboardWipRangeSeriesBucket";
 export * from "./dashboardWipRangeSeriesRange";
 export * from "./dashboardWipSeriesSet";
-export * from "./deleteAgentApiV1AgentsAgentIdDelete200";
-export * from "./deleteBoardApiV1BoardsBoardIdDelete200";
-export * from "./deleteTaskApiV1BoardsBoardIdTasksTaskIdDelete200";
-export * from "./gatewayCommandsApiV1GatewayCommandsGet200";
 export * from "./gatewayCommandsResponse";
 export * from "./gatewayCreate";
 export * from "./gatewayLeadBroadcastBoardResult";
@@ -102,25 +91,18 @@ export * from "./gatewayLeadMessageResponse";
 export * from "./gatewayMainAskUserRequest";
 export * from "./gatewayMainAskUserResponse";
 export * from "./gatewayRead";
-export * from "./gatewayResolveQuery";
 export * from "./gatewaySessionHistoryResponse";
 export * from "./gatewaySessionMessageRequest";
 export * from "./gatewaySessionResponse";
 export * from "./gatewaySessionsResponse";
 export * from "./gatewaysStatusApiV1GatewaysStatusGetParams";
 export * from "./gatewaysStatusResponse";
-export * from "./gatewayStatusApiV1GatewayStatusGet200";
-export * from "./gatewayStatusApiV1GatewayStatusGetParams";
 export * from "./gatewayTemplatesSyncError";
 export * from "./gatewayTemplatesSyncResult";
 export * from "./gatewayUpdate";
 export * from "./getBoardGroupSnapshotApiV1BoardGroupsGroupIdSnapshotGetParams";
 export * from "./getBoardGroupSnapshotApiV1BoardsBoardIdGroupSnapshotGetParams";
-export * from "./getGatewaySessionApiV1GatewaySessionsSessionIdGet200";
-export * from "./getGatewaySessionApiV1GatewaySessionsSessionIdGetParams";
 export * from "./getGatewaySessionApiV1GatewaysSessionsSessionIdGetParams";
-export * from "./getSessionHistoryApiV1GatewaySessionsSessionIdHistoryGet200";
-export * from "./getSessionHistoryApiV1GatewaySessionsSessionIdHistoryGetParams";
 export * from "./getSessionHistoryApiV1GatewaysSessionsSessionIdHistoryGetParams";
 export * from "./healthHealthGet200";
 export * from "./healthzHealthzGet200";
@@ -136,9 +118,9 @@ export * from "./limitOffsetPageTypeVarCustomizedBoardRead";
 export * from "./limitOffsetPageTypeVarCustomizedGatewayRead";
 export * from "./limitOffsetPageTypeVarCustomizedOrganizationInviteRead";
 export * from "./limitOffsetPageTypeVarCustomizedOrganizationMemberRead";
+export * from "./limitOffsetPageTypeVarCustomizedTagRead";
 export * from "./limitOffsetPageTypeVarCustomizedTaskCommentRead";
 export * from "./limitOffsetPageTypeVarCustomizedTaskRead";
-export * from "./limitOffsetPageTypeVarCustomizedTaskTagRead";
 export * from "./listActivityApiV1ActivityGetParams";
 export * from "./listAgentsApiV1AgentAgentsGetParams";
 export * from "./listAgentsApiV1AgentsGetParams";
@@ -155,14 +137,12 @@ export * from "./listGatewaysApiV1GatewaysGetParams";
 export * from "./listGatewaySessionsApiV1GatewaysSessionsGetParams";
 export * from "./listOrgInvitesApiV1OrganizationsMeInvitesGetParams";
 export * from "./listOrgMembersApiV1OrganizationsMeMembersGetParams";
-export * from "./listSessionsApiV1GatewaySessionsGet200";
-export * from "./listSessionsApiV1GatewaySessionsGetParams";
+export * from "./listTagsApiV1TagsGetParams";
 export * from "./listTaskCommentFeedApiV1ActivityTaskCommentsGetParams";
 export * from "./listTaskCommentsApiV1AgentBoardsBoardIdTasksTaskIdCommentsGetParams";
 export * from "./listTaskCommentsApiV1BoardsBoardIdTasksTaskIdCommentsGetParams";
 export * from "./listTasksApiV1AgentBoardsBoardIdTasksGetParams";
 export * from "./listTasksApiV1BoardsBoardIdTasksGetParams";
-export * from "./listTaskTagsApiV1TagsGetParams";
 export * from "./okResponse";
 export * from "./organizationActiveUpdate";
 export * from "./organizationBoardAccessRead";
@@ -180,9 +160,6 @@ export * from "./organizationUserRead";
 export * from "./readyzReadyzGet200";
 export * from "./searchApiV1SoulsDirectorySearchGetParams";
 export * from "./sendGatewaySessionMessageApiV1GatewaysSessionsSessionIdMessagePostParams";
-export * from "./sendSessionMessageApiV1GatewaySessionsSessionIdMessagePost200";
-export * from "./sendSessionMessageApiV1GatewaySessionsSessionIdMessagePostBody";
-export * from "./sendSessionMessageApiV1GatewaySessionsSessionIdMessagePostParams";
 export * from "./soulsDirectoryMarkdownResponse";
 export * from "./soulsDirectorySearchResponse";
 export * from "./soulsDirectorySoulRef";
@@ -195,6 +172,10 @@ export * from "./streamBoardMemoryApiV1BoardsBoardIdMemoryStreamGetParams";
 export * from "./streamTaskCommentFeedApiV1ActivityTaskCommentsStreamGetParams";
 export * from "./streamTasksApiV1BoardsBoardIdTasksStreamGetParams";
 export * from "./syncGatewayTemplatesApiV1GatewaysGatewayIdTemplatesSyncPostParams";
+export * from "./tagCreate";
+export * from "./tagRead";
+export * from "./tagRef";
+export * from "./tagUpdate";
 export * from "./taskCardRead";
 export * from "./taskCardReadStatus";
 export * from "./taskCommentCreate";
@@ -203,10 +184,6 @@ export * from "./taskCreate";
 export * from "./taskCreateStatus";
 export * from "./taskRead";
 export * from "./taskReadStatus";
-export * from "./taskTagCreate";
-export * from "./taskTagRead";
-export * from "./taskTagRef";
-export * from "./taskTagUpdate";
 export * from "./taskUpdate";
 export * from "./updateAgentApiV1AgentsAgentIdPatchParams";
 export * from "./userRead";
--- a/frontend/src/api/generated/model/limitOffsetPageTypeVarCustomizedActivityEventRead.ts
+++ b/frontend/src/api/generated/model/limitOffsetPageTypeVarCustomizedActivityEventRead.ts
@@ -8,10 +8,10 @@ import type { ActivityEventRead } from "./activityEventRead";

 export interface LimitOffsetPageTypeVarCustomizedActivityEventRead {
  items: ActivityEventRead[];
+  /** @minimum 0 */
+  total: number;
  /** @minimum 1 */
  limit: number;
  /** @minimum 0 */
  offset: number;
-  /** @minimum 0 */
-  total: number;
 }
--- a/frontend/src/api/generated/model/limitOffsetPageTypeVarCustomizedActivityTaskCommentFeedItemRead.ts
+++ b/frontend/src/api/generated/model/limitOffsetPageTypeVarCustomizedActivityTaskCommentFeedItemRead.ts
@@ -8,10 +8,10 @@ import type { ActivityTaskCommentFeedItemRead } from "./activityTaskCommentFeedI

 export interface LimitOffsetPageTypeVarCustomizedActivityTaskCommentFeedItemRead {
  items: ActivityTaskCommentFeedItemRead[];
+  /** @minimum 0 */
+  total: number;
  /** @minimum 1 */
  limit: number;
  /** @minimum 0 */
  offset: number;
-  /** @minimum 0 */
-  total: number;
 }
--- a/frontend/src/api/generated/model/limitOffsetPageTypeVarCustomizedAgentRead.ts
+++ b/frontend/src/api/generated/model/limitOffsetPageTypeVarCustomizedAgentRead.ts
@@ -8,10 +8,10 @@ import type { AgentRead } from "./agentRead";

 export interface LimitOffsetPageTypeVarCustomizedAgentRead {
  items: AgentRead[];
+  /** @minimum 0 */
+  total: number;
  /** @minimum 1 */
  limit: number;
  /** @minimum 0 */
  offset: number;
-  /** @minimum 0 */
-  total: number;
 }
--- a/frontend/src/api/generated/model/limitOffsetPageTypeVarCustomizedApprovalRead.ts
+++ b/frontend/src/api/generated/model/limitOffsetPageTypeVarCustomizedApprovalRead.ts
@@ -8,10 +8,10 @@ import type { ApprovalRead } from "./approvalRead";

 export interface LimitOffsetPageTypeVarCustomizedApprovalRead {
  items: ApprovalRead[];
+  /** @minimum 0 */
+  total: number;
  /** @minimum 1 */
  limit: number;
  /** @minimum 0 */
  offset: number;
-  /** @minimum 0 */
-  total: number;
 }
--- a/frontend/src/api/generated/model/limitOffsetPageTypeVarCustomizedBoardGroupMemoryRead.ts
+++ b/frontend/src/api/generated/model/limitOffsetPageTypeVarCustomizedBoardGroupMemoryRead.ts
@@ -8,10 +8,10 @@ import type { BoardGroupMemoryRead } from "./boardGroupMemoryRead";

 export interface LimitOffsetPageTypeVarCustomizedBoardGroupMemoryRead {
  items: BoardGroupMemoryRead[];
+  /** @minimum 0 */
+  total: number;
  /** @minimum 1 */
  limit: number;
  /** @minimum 0 */
  offset: number;
-  /** @minimum 0 */
-  total: number;
 }
--- a/frontend/src/api/generated/model/limitOffsetPageTypeVarCustomizedBoardGroupRead.ts
+++ b/frontend/src/api/generated/model/limitOffsetPageTypeVarCustomizedBoardGroupRead.ts
@@ -8,10 +8,10 @@ import type { BoardGroupRead } from "./boardGroupRead";

 export interface LimitOffsetPageTypeVarCustomizedBoardGroupRead {
  items: BoardGroupRead[];
+  /** @minimum 0 */
+  total: number;
  /** @minimum 1 */
  limit: number;
  /** @minimum 0 */
  offset: number;
-  /** @minimum 0 */
-  total: number;
 }
--- a/Show More
+++ b/Show More