Chris CoutinhoandClaude Opus 4.6
44a27bd9e9
Bug fixes: - Catch OCSError/HTTPStatusError in all server tools, convert to McpError - Guard update_collective against empty body (raise ValueError) - Use restore_page response data in status message ADR-017 annotation fix: - Distinguish "remove" (reversible association) from "delete" (permanent): remove_tag and deck_remove_label_from_card no longer set destructiveHint - Update annotation test to exclude "remove" from destructive keywords Data model improvements: - Add trashTimestamp field to PageInfo - Create ListTrashedPagesResponse with is_trash context flag - Add collective_id to ListTagsResponse Test robustness: - Read NC credentials from environment variables (not hardcoded) - Filter landing page by parentId == 0 instead of assuming pages[0] Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
148 lines
5.0 KiB
Python
148 lines
5.0 KiB
Python
"""Pydantic models for Nextcloud Collectives app."""
|
|
|
|
from pydantic import BaseModel, Field
|
|
|
|
from .base import BaseResponse, StatusResponse
|
|
|
|
# Domain Models
|
|
|
|
|
|
class Collective(BaseModel):
|
|
"""A Nextcloud Collective (wiki/knowledge base)."""
|
|
|
|
id: int = Field(description="Collective ID")
|
|
circleId: str = Field(description="Linked Circle/Team ID")
|
|
emoji: str | None = Field(default=None, description="Collective emoji")
|
|
name: str = Field(description="Collective name")
|
|
level: int = Field(description="User's membership level")
|
|
canEdit: bool = Field(description="Whether the user can edit")
|
|
canShare: bool = Field(description="Whether the user can share")
|
|
pageMode: int = Field(description="Default page mode: 0=view, 1=edit")
|
|
|
|
|
|
class PageInfo(BaseModel):
|
|
"""A page within a Collective."""
|
|
|
|
id: int = Field(description="Page ID")
|
|
title: str = Field(description="Page title")
|
|
emoji: str | None = Field(default=None, description="Page emoji")
|
|
fileName: str = Field(description="Markdown file name")
|
|
filePath: str = Field(description="File path within the collective")
|
|
collectivePath: str | None = Field(
|
|
default=None, description="Collective folder path in user's files"
|
|
)
|
|
parentId: int = Field(description="Parent page ID (0 for root)")
|
|
timestamp: int = Field(description="Last modification Unix timestamp")
|
|
size: int = Field(description="Content size in bytes")
|
|
lastUserId: str | None = Field(default=None, description="Last editor user ID")
|
|
lastUserDisplayName: str | None = Field(
|
|
default=None, description="Last editor display name"
|
|
)
|
|
subpageOrder: list[int] = Field(
|
|
default_factory=list, description="Ordered subpage IDs"
|
|
)
|
|
isFullWidth: bool | None = Field(default=None, description="Full-width page layout")
|
|
trashTimestamp: int | None = Field(
|
|
default=None, description="Timestamp when the page was trashed"
|
|
)
|
|
|
|
|
|
class CollectiveTag(BaseModel):
|
|
"""A tag within a Collective."""
|
|
|
|
id: int = Field(description="Tag ID")
|
|
collectiveId: int = Field(description="Parent collective ID")
|
|
name: str = Field(description="Tag name")
|
|
color: str = Field(description="Hex color code")
|
|
|
|
|
|
# Response Models
|
|
|
|
|
|
class ListCollectivesResponse(BaseResponse):
|
|
"""Response for listing collectives."""
|
|
|
|
collectives: list[Collective] = Field(description="List of collectives")
|
|
total: int = Field(description="Total number of collectives")
|
|
|
|
|
|
class CreateCollectiveResponse(BaseResponse):
|
|
"""Response for creating a collective."""
|
|
|
|
id: int = Field(description="Created collective ID")
|
|
name: str = Field(description="Created collective name")
|
|
emoji: str | None = Field(default=None, description="Collective emoji")
|
|
|
|
|
|
class CollectiveOperationResponse(StatusResponse):
|
|
"""Response for collective update operations."""
|
|
|
|
collective_id: int = Field(description="ID of the affected collective")
|
|
|
|
|
|
class ListPagesResponse(BaseResponse):
|
|
"""Response for listing pages in a collective."""
|
|
|
|
pages: list[PageInfo] = Field(description="List of pages")
|
|
total: int = Field(description="Total number of pages")
|
|
collective_id: int = Field(description="Collective ID")
|
|
|
|
|
|
class GetPageResponse(BaseResponse):
|
|
"""Response for getting a single page with content."""
|
|
|
|
page: PageInfo = Field(description="Page metadata")
|
|
content: str | None = Field(
|
|
default=None,
|
|
description="Page markdown content (fetched via WebDAV)",
|
|
)
|
|
|
|
|
|
class CreatePageResponse(BaseResponse):
|
|
"""Response for creating a page."""
|
|
|
|
id: int = Field(description="Created page ID")
|
|
title: str = Field(description="Created page title")
|
|
collective_id: int = Field(description="Collective ID")
|
|
parent_id: int = Field(description="Parent page ID")
|
|
|
|
|
|
class PageOperationResponse(StatusResponse):
|
|
"""Response for page operations (update, trash, emoji, tag)."""
|
|
|
|
page_id: int = Field(description="ID of the affected page")
|
|
collective_id: int = Field(description="Collective ID")
|
|
|
|
|
|
class SearchPagesResponse(BaseResponse):
|
|
"""Response for full-text search within a collective."""
|
|
|
|
results: list[PageInfo] = Field(description="Matching pages")
|
|
total: int = Field(description="Total number of results")
|
|
query: str = Field(description="Search query")
|
|
collective_id: int = Field(description="Collective ID")
|
|
|
|
|
|
class ListTrashedPagesResponse(ListPagesResponse):
|
|
"""Response for listing trashed pages in a collective."""
|
|
|
|
is_trash: bool = Field(
|
|
default=True, description="Indicates these are trashed pages"
|
|
)
|
|
|
|
|
|
class ListTagsResponse(BaseResponse):
|
|
"""Response for listing tags in a collective."""
|
|
|
|
tags: list[CollectiveTag] = Field(description="List of tags")
|
|
total: int = Field(description="Total number of tags")
|
|
collective_id: int = Field(description="Collective ID")
|
|
|
|
|
|
class CreateTagResponse(BaseResponse):
|
|
"""Response for creating a tag."""
|
|
|
|
id: int = Field(description="Created tag ID")
|
|
name: str = Field(description="Tag name")
|
|
color: str = Field(description="Tag color")
|