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