vibe-sketcherDocumentation

Source code for vibesketcher.server.drafts

"""Review and transaction endpoints for provider-neutral drawing proposals."""

from typing import Any, Literal

from fastapi import APIRouter, HTTPException
from pydantic import BaseModel, ConfigDict, Field

from vibesketcher.document.draft_session import DraftSession
from vibesketcher.document.drafts import DraftConflict, DraftRefused, Proposal, digest
from vibesketcher.server.store import NotFound


[docs] class ReviewRequest(BaseModel): model_config = ConfigDict(extra="forbid", strict=True) revision: int = Field(ge=0) source_digest: str = Field(pattern=r"^[0-9a-f]{64}$") proposal: Proposal
[docs] class TransactionRequest(BaseModel): model_config = ConfigDict(extra="forbid", strict=True) revision: int = Field(ge=0) source_digest: str = Field(pattern=r"^[0-9a-f]{64}$") key: str = Field(min_length=1, max_length=128) action: Literal["apply", "undo", "redo"] client: Literal["browser", "cli", "rest", "mcp", "sdk"] = "rest" actor: Literal["human", "agent"] = "agent"
[docs] def router(session: DraftSession) -> APIRouter: routes = APIRouter(prefix="/api/documents/{identifier}/drafts", tags=["drafts"]) def fail(error: Exception) -> None: status = ( 404 if isinstance(error, NotFound) else 409 if isinstance(error, DraftConflict) else 422 ) raise HTTPException(status, {"errors": [str(error)]}) from None @routes.post("") def review(identifier: str, request: ReviewRequest) -> dict[str, Any]: try: return session.review( identifier, request.proposal.model_dump(mode="json"), revision=request.revision, source_digest=request.source_digest, ) except (DraftRefused, NotFound, ValueError) as error: fail(error) raise AssertionError("unreachable") @routes.get("/source") def source(identifier: str) -> dict[str, Any]: try: document = session.store.get(identifier).document return {"revision": document.revision, "source_digest": digest(document)} except NotFound as error: fail(error) raise AssertionError("unreachable") @routes.get("/{token}") def inspect(identifier: str, token: str) -> dict[str, Any]: try: return session.inspect(identifier, token) except (DraftRefused, NotFound) as error: fail(error) raise AssertionError("unreachable") @routes.delete("/{token}") def discard(identifier: str, token: str) -> dict[str, bool]: try: session.discard(identifier, token) return {"discarded": True} except (DraftRefused, NotFound) as error: fail(error) raise AssertionError("unreachable") @routes.post("/{token}/transactions") def transact(identifier: str, token: str, request: TransactionRequest) -> dict[str, Any]: try: return session.transact(identifier, token, **request.model_dump()) except (DraftRefused, NotFound, ValueError) as error: fail(error) raise AssertionError("unreachable") return routes