matelab-python-sdk 0.1.0a1__py3-none-any.whl

matelab/_generated/models.py

@@ -0,0 +1,3553 @@
+# @generated by datamodel-codegen:
+#   filename:  openapi.yaml
+#   version:   0.71.0
+
+from enum import Enum, IntEnum, StrEnum
+from typing import Annotated, Any, Literal
+
+from pydantic import BaseModel, ConfigDict, Field, RootModel, SecretStr
+
+OPENAPI_INFO_VERSION = "0.1.0"
+
+
+class ResponseEnvelope(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    code: int
+    msg: str
+    errcode: int
+    """
+    Legacy alias of `code`; always present in these operations.
+    """
+    errmsg: str
+    """
+    Legacy alias of `msg`; always present in these operations.
+    """
+
+
+class BasicSuccessResponse(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    code: Literal[0]
+    msg: str
+    errcode: Literal[0]
+    errmsg: str
+    """
+    Legacy alias of `msg`; always present in these operations.
+    """
+
+
+class Code(Enum):
+    int_0 = 0
+    int_10 = 10
+
+
+class Errcode(Enum):
+    int_0 = 0
+    int_10 = 10
+
+
+class ForwardableSuccessResponse(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    code: Code
+    msg: str
+    errcode: Errcode
+    errmsg: str
+    """
+    Legacy alias of `msg`; always present in these operations.
+    """
+
+
+class ErrorDetail(RootModel[Any]):
+    root: Any
+    """
+    A stable per-field or per-location error value returned when code is 4.
+    """
+
+
+class ErrorResponse(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    code: int
+    msg: str
+    errcode: int
+    errmsg: str
+    errs: list[ErrorDetail] | None = None
+    """
+    Present for multi-error code 4; absent from ordinary errors.
+    """
+
+
+class Sha256(RootModel[str]):
+    root: Annotated[str, Field(pattern="^[0-9a-f]{64}$")]
+
+
+class CloudDriveIdentityResponse(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    code: Literal[0]
+    msg: str
+    errcode: Literal[0]
+    errmsg: str
+    """
+    Legacy alias of `msg`; always present in these operations.
+    """
+    id: Annotated[int, Field(ge=1)]
+
+
+class CloudDriveFile(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    id: Annotated[int, Field(ge=1)]
+    filename: Annotated[str, Field(max_length=255, min_length=1)]
+    hash: Sha256
+    size: Annotated[str, Field(pattern="^[0-9]+$")]
+    """
+    Unsigned BIGINT serialized as a decimal string by this query.
+    """
+    userid: Annotated[int, Field(ge=1)]
+    date_time: Annotated[str | None, Field(pattern="^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}$")]
+    comm: str
+    """
+    PHP normalizes a database null to the empty string.
+    """
+    username: Annotated[str | None, Field(...)]
+    """
+    Nullable because the owner is LEFT JOINed.
+    """
+    date: Annotated[str, Field(pattern="^\\d{4}-\\d{2}-\\d{2}$")]
+    time: Annotated[str, Field(pattern="^\\d{2}:\\d{2}$")]
+    owner: Literal[True]
+
+
+class CloudDriveRootPermissions(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    id: Literal[0]
+    power: Literal[1823]
+    showtext: str
+    comm: str
+    admin: Literal[False]
+    dir_create: Literal[True]
+    dir_delete: Literal[True]
+    dir_edit: Literal[True]
+    file_create: Literal[True]
+    file_delete: Literal[True]
+    file_view: Literal[True]
+    file_edit: Literal[True]
+
+
+class CloudDriveFolder(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    id: Annotated[int, Field(ge=1)]
+    showtext: Annotated[str, Field(min_length=1)]
+    parent: Annotated[int, Field(ge=0)]
+    num: Annotated[int, Field(ge=0)]
+    """
+    Direct file count; child-folder contents are not included.
+    """
+    comm: Annotated[str | None, Field(...)]
+
+
+class SaveCloudDriveFolderRequest(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    id: Annotated[int, Field(ge=0)] = 0
+    parent: Annotated[int, Field(ge=0)] = 0
+    root_id: Literal[0] = 0
+    showtext: Annotated[str, Field(max_length=100, min_length=1)]
+    """
+    Must also satisfy the Provider's legal-filename check.
+    """
+    comm: Annotated[str, Field(max_length=1000)] = ""
+
+
+class CloudDriveFolderIdRequest(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    id: Annotated[int, Field(ge=1)]
+
+
+class MoveCloudDriveFolderRequest(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    id: Annotated[int, Field(ge=1)]
+    target: Annotated[int, Field(ge=0)] = 0
+    """
+    Target parent folder; zero is the root.
+    """
+
+
+class BindCloudDriveFileRequest(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    file_id: Annotated[int, Field(ge=1)]
+    """
+    Completed upload_temp id returned by stageTemporaryFile.
+    """
+    type_id: Annotated[int, Field(ge=0)] = 0
+    root_id: Literal[0] = 0
+
+
+class EditCloudDriveFileRequest(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    id: Annotated[int, Field(ge=1)]
+    filename: Annotated[str, Field(max_length=255, min_length=1)]
+    """
+    Must preserve the existing extension and pass the legal-filename check.
+    """
+    comm: Annotated[str, Field(max_length=1000)] = ""
+
+
+class CloudDriveFileIdListItem(RootModel[int]):
+    root: Annotated[int, Field(ge=1)]
+
+
+class CloudDriveFileIdList(RootModel[list[CloudDriveFileIdListItem]]):
+    root: Annotated[list[CloudDriveFileIdListItem], Field(min_length=1)]
+
+
+class DeleteCloudDriveFilesRequest(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    ids: Annotated[
+        str,
+        Field(
+            json_schema_extra={
+                "contentMediaType": "application/json",
+                "contentSchema": {"$ref": "#/components/schemas/CloudDriveFileIdList"},
+            },
+            min_length=1,
+        ),
+    ]
+
+
+class TransferCloudDriveFilesRequest(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    files: Annotated[
+        str,
+        Field(
+            json_schema_extra={
+                "contentMediaType": "application/json",
+                "contentSchema": {"$ref": "#/components/schemas/CloudDriveFileIdList"},
+            },
+            min_length=1,
+        ),
+    ]
+    target: Annotated[int, Field(ge=0)] = 0
+    root_id: Literal[0] = 0
+
+
+class UploadAttachmentRequest(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    eln: Annotated[str, Field(min_length=1)]
+    """
+    Notebook title used to select its data server.
+    """
+    user: Annotated[int | None, Field(ge=1)] = None
+    """
+    Optional notebook owner identifier for a non-owned notebook.
+    """
+    uid: Annotated[str, Field(max_length=45, min_length=1)]
+    """
+    Record wire UID and upload-event identifier.
+    """
+    name: Annotated[str, Field(max_length=45)] = ""
+    """
+    Missing or empty falls back to uid as the unique temporary upload name.
+    """
+    hash: Sha256
+    last: Literal[1] = 1
+    """
+    Missing defaults to 1; integration-v1 only contracts the completed one-fragment flow.
+    """
+    file: bytes
+
+
+class UploadAttachmentResponse(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    code: Literal[0]
+    msg: str
+    errcode: Literal[0]
+    errmsg: str
+    """
+    Legacy alias of `msg`; always present in these operations.
+    """
+    id: Annotated[int, Field(ge=1)]
+    path: Literal["url_eln/temp"]
+    query: str
+    """
+    Provider-built legacy query string for the temporary file.
+    """
+    name: Annotated[str, Field(min_length=1)]
+    filename: Annotated[str, Field(min_length=1)]
+    size: Annotated[int, Field(ge=0)]
+    hash: Sha256
+
+
+class AppUser(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    username: Annotated[str | None, Field(...)]
+    """
+    Raw nullable `login_user.realname`.
+    """
+    avatar: Annotated[str | None, Field(...)]
+    """
+    Raw id-photo path, normalized to null when empty.
+    """
+    email: Annotated[str | None, Field(...)]
+    userid: Annotated[int, Field(ge=1)]
+
+
+class AppNotification(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    id: Annotated[int, Field(ge=1)]
+    showtext: Annotated[str | None, Field(...)]
+    datetime_add: Annotated[str | None, Field(...)]
+    """
+    Raw database datetime retained by the PHP response.
+    """
+    datetime: str
+    """
+    Provider-formatted `Y-m-d H:i`.
+    """
+
+
+class AppEnvironment(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    ai: bool
+    smtp: bool
+    institute: Annotated[int, Field(ge=0)]
+    annals: Annotated[int, Field(ge=0)]
+    paper: Annotated[int, Field(ge=0)]
+    topics: Annotated[int, Field(ge=0)]
+    device: Annotated[int, Field(ge=0)]
+    eln: Annotated[int, Field(ge=0)]
+    files: Annotated[int, Field(ge=0)]
+    recommend: Annotated[int, Field(ge=0)]
+    assets: Annotated[int, Field(ge=0)]
+    feedback: Annotated[int, Field(ge=0)]
+    doc: Annotated[int, Field(ge=0)]
+
+
+class AppMenuItem(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    showtext: str
+    icon: str
+    url: str
+    order: int
+
+
+class TokenRefreshRequest(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    refresh_token: Annotated[str, Field(min_length=1)]
+
+
+class TokenLoginRequest(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    username: Annotated[str, Field(max_length=128, min_length=2)]
+    """
+    Login username or email address.
+    """
+    password: Annotated[SecretStr, Field(max_length=32, min_length=8)]
+    code: str = ""
+    """
+    Conditional WeChat mini-program binding code. Absent in the current MCP
+    credential-login flow.
+
+    """
+    iopcard: Annotated[str, Field(max_length=45)] = ""
+    """
+    Conditional employee-card identifier to bind after successful login.
+    Absent in the current MCP credential-login flow.
+
+    """
+
+
+class ChatSsoCodeExchangeRequest(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    code: Annotated[str, Field(max_length=21, min_length=21, pattern="^chat-[^-]{16}$")]
+    """
+    One-time `chat-` plus 16-character code created by `/actions/ai_iframe`.
+    """
+    key: Annotated[SecretStr, Field(min_length=1)]
+    """
+    Shared key configured for the `chat` third-party type.
+    """
+
+
+class AuthToken(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    token: Annotated[str, Field(min_length=1)]
+    expiredAt: Annotated[int, Field(ge=1)]
+    """
+    Unix expiration timestamp in milliseconds.
+    """
+
+
+class TemplateIdRequest(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    id: Annotated[int, Field(ge=1)]
+
+
+class ShareMultipleTemplatesRequest(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    templates: Annotated[
+        str,
+        Field(
+            json_schema_extra={
+                "contentMediaType": "application/json",
+                "contentSchema": {
+                    "type": "array",
+                    "minItems": 1,
+                    "maxItems": 10,
+                    "uniqueItems": True,
+                    "items": {"type": "integer", "minimum": 1},
+                },
+            },
+            min_length=1,
+        ),
+    ]
+    """
+    JSON-encoded owned template-id list.
+    """
+    users: Annotated[
+        str,
+        Field(
+            json_schema_extra={
+                "contentMediaType": "application/json",
+                "contentSchema": {
+                    "type": "array",
+                    "minItems": 1,
+                    "maxItems": 10,
+                    "uniqueItems": True,
+                    "items": {"type": "integer", "minimum": 1},
+                },
+            },
+            min_length=1,
+        ),
+    ]
+    """
+    JSON-encoded recipient user-id list.
+    """
+
+
+class RemoveUserTemplateRelationRequest(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    id: Annotated[int, Field(ge=1)]
+    """
+    Relation id from `listTemplates.share[].id` or `listTemplates.stores[].id`.
+    """
+
+
+class AddGroupTemplateRequest(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    template_id: Annotated[int, Field(ge=1)]
+    """
+    Owned template identifier.
+    """
+    group_id: Annotated[int, Field(ge=1)]
+    """
+    ELN group identifier in which the caller has a valid membership.
+    """
+
+
+class DeleteGroupTemplateRequest(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    id: Annotated[int, Field(ge=1)]
+    """
+    Group-template relation id from `listTemplates.group[].id`.
+    """
+
+
+class SaveTemplateMetadataRequest(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    id: Annotated[int | None, Field(ge=0)] = 0
+    """
+    Missing or null becomes 0 and selects the create branch.
+    """
+    showtext: Annotated[str, Field(max_length=45, min_length=1)]
+    comm: Annotated[str | None, Field(max_length=255)] = ""
+    """
+    Missing or null becomes the empty string through requestStr.
+    """
+    keyword: Annotated[
+        str | None,
+        Field(
+            json_schema_extra={
+                "contentMediaType": "application/json",
+                "contentSchema": {"type": "array", "items": {"type": "string"}},
+            }
+        ),
+    ] = ""
+    """
+    JSON-encoded keyword string array, not a direct JSON array. Missing,
+    null, malformed JSON, and JSON null are normalized by PHP to `[]`.
+    The stable contract deliberately narrows non-null values to the
+    matelab-mcp use case instead of promising every JSON value PHP could
+    incidentally decode and store.
+
+    """
+
+
+class SaveTemplateContentRequest(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    id: Annotated[int, Field(ge=1)]
+    data: Annotated[
+        str,
+        Field(
+            json_schema_extra={
+                "contentMediaType": "application/json",
+                "contentSchema": {
+                    "type": "array",
+                    "items": {"$ref": "#/components/schemas/TemplateModule"},
+                },
+            }
+        ),
+    ]
+    """
+    JSON-encoded canonical module array. PHP additionally rejects
+    duplicate module names, duplicate table-column names, duplicate
+    form-item names, and purely numeric names; those cross-item rules
+    cannot be expressed completely by JSON Schema and are documented as
+    business validation.
+
+    """
+
+
+class CopyTemplateRequest(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    id: Annotated[int, Field(ge=1)]
+    template_name: Annotated[str, Field(max_length=45, min_length=1)]
+
+
+class UpdateTemplateIntroRequest(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    id: Annotated[int, Field(ge=1)]
+    intro: Annotated[str | None, Field(max_length=13000)] = ""
+    """
+    Missing or null becomes the empty string through requestStr.
+    """
+    uid: Annotated[str, Field(min_length=1)]
+
+
+class TemplateModule(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    name: Annotated[str, Field(min_length=1, pattern=".*[^0-9.\\-+eE ].*")]
+    """
+    PHP trims the name, rejects an empty or purely numeric value, and
+    rejects duplicate names across the module array.
+
+    """
+    type: Annotated[str, Field(min_length=1)]
+    data: dict[str, Any] | list[Any] | str | float | bool | None = None
+    """
+    Runtime requirements depend on the target module type.
+    """
+    language: str | None = None
+    style: Any | None = None
+
+
+class TemplateTableColumn(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    name: Annotated[str, Field(min_length=1, pattern=".*[^0-9.\\-+eE ].*")]
+    """
+    PHP also rejects duplicate names within the table.
+    """
+    type: str
+    data: list[Any]
+
+
+class TemplateFormItem(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    name: Annotated[str, Field(min_length=1, pattern=".*[^0-9.\\-+eE ].*")]
+    """
+    PHP also rejects duplicate names within the form.
+    """
+
+
+class TemplateContentResponse(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    code: Literal[0]
+    msg: str
+    errcode: Literal[0]
+    errmsg: str
+    """
+    Legacy alias of `msg`; always present in these operations.
+    """
+    content: list[TemplateModule]
+
+
+class Action(StrEnum):
+    add = "add"
+    edit = "edit"
+
+
+class SaveTemplateMetadataResponse(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    code: Literal[0]
+    msg: str
+    errcode: Literal[0]
+    errmsg: str
+    """
+    Legacy alias of `msg`; always present in these operations.
+    """
+    id: Annotated[int, Field(ge=1)]
+    action: Action
+
+
+class UpdateTemplateIntroResponse(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    code: Literal[0]
+    msg: str
+    errcode: Literal[0]
+    errmsg: str
+    """
+    Legacy alias of `msg`; always present in these operations.
+    """
+    intro: str
+
+
+class TemplateListItem(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    id: Annotated[int | None, Field(ge=1)] = None
+    template_id: Annotated[int, Field(ge=1)]
+    template_name: Annotated[str | None, Field(...)]
+    comm: Annotated[str | None, Field(...)]
+
+
+class PendingTemplateListItem(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    id: Annotated[int, Field(ge=1)]
+    template_id: Annotated[int, Field(ge=1)]
+    template_name: str
+    comm: Annotated[str | None, Field(...)]
+    userid: Literal[0]
+    username: Annotated[str | None, Field(...)]
+
+
+class StoreTemplateListItem(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    id: Annotated[int, Field(ge=1)]
+    template_id: Annotated[int, Field(ge=1)]
+    template_name: str
+    comm: Annotated[str | None, Field(...)]
+    pub: Literal[2]
+    username: Annotated[str | None, Field(...)]
+
+
+class SharedTemplateListItem(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    id: Annotated[int, Field(ge=1)]
+    template_id: Annotated[int, Field(ge=1)]
+    template_name: Annotated[str | None, Field(...)]
+    comm: Annotated[str | None, Field(...)]
+    userid_from: Annotated[int | None, Field(ge=1)]
+    username: Annotated[str | None, Field(...)]
+    avatar: Annotated[str | None, Field(...)]
+
+
+class GroupTemplateListItem(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    id: Annotated[int, Field(ge=1)]
+    template_id: Annotated[int, Field(ge=1)]
+    template_name: Annotated[str | None, Field(...)]
+    comm: Annotated[str | None, Field(...)]
+    group_id: Annotated[int, Field(ge=1)]
+    datetime: str
+    userid: Annotated[int | None, Field(ge=1)]
+    email: Annotated[str | None, Field(...)]
+    username: Annotated[str | None, Field(...)]
+    group_name: Annotated[str | None, Field(...)]
+    admin: bool
+
+
+class DefaultTemplateListItem(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    template_id: Annotated[int, Field(ge=1)]
+    template_name: str
+    comm: Annotated[str | None, Field(...)]
+
+
+class OwnedTemplateListItem(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    id: Annotated[int, Field(ge=1)]
+    template_id: Annotated[int, Field(ge=1)]
+    template_name: str
+    comm: Annotated[str | None, Field(...)]
+    intro: Annotated[str | None, Field(...)]
+    version: Annotated[int, Field(ge=0)]
+    datetime: Annotated[str | None, Field(...)]
+    keyword: list[Any]
+    userid_from: Annotated[int, Field(ge=0)]
+    username: Annotated[str | None, Field(...)]
+    idphoto: Annotated[str | None, Field(...)]
+    pub: Annotated[int, Field(ge=0)]
+    Ifnull_pub_reason_____: Annotated[str, Field(alias="Ifnull(pub_reason, '')")]
+    template_show: Annotated[str | None, Field(...)]
+    store_version: Annotated[int, Field(ge=0)]
+
+
+class My(IntEnum):
+    integer_0 = 0
+    integer_1 = 1
+
+
+class TemplateStoreItem(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    id: Annotated[int, Field(ge=1)]
+    showtext: str
+    comm: Annotated[str | None, Field(...)]
+    intro: Annotated[str | None, Field(...)]
+    datetime_modify: Annotated[str | None, Field(...)]
+    dtime_pub: Annotated[str | None, Field(...)]
+    pub: Literal[2]
+    username: Annotated[str | None, Field(...)]
+    buy_count: Annotated[int | None, Field(ge=0)]
+    my: My
+    """
+    Raw MySQL EXISTS result; PHP does not cast it to boolean.
+    """
+
+
+class ElnGroup(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    id: Annotated[int, Field(ge=1)]
+    showtext: Annotated[str | None, Field(...)]
+    server: Annotated[str | None, Field(...)]
+
+
+class ElnGroupUser(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    id: Annotated[int | None, Field(ge=1)]
+    """
+    Null only when the membership references a missing user selected by LEFT JOIN.
+    """
+    username: Annotated[str | None, Field(...)]
+    email: Annotated[str | None, Field(...)]
+    iop_id: Annotated[int | None, Field(ge=0)]
+    """
+    Null only for a missing joined user; otherwise NOT NULL and 0 means unlinked.
+    """
+
+
+class DirectoryUser(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    id: Annotated[int, Field(ge=1)]
+    username: Annotated[str | None, Field(...)]
+    """
+    Raw nullable login_user.realname.
+    """
+    email: Annotated[str | None, Field(...)]
+    """
+    Raw nullable login_user.email; no format guarantee.
+    """
+    institute: Annotated[str | None, Field(...)]
+    """
+    Nullable only when the LEFT JOIN cannot resolve the institute row.
+    """
+    iop_id: Annotated[int, Field(ge=0)]
+    """
+    Zero means no linked IOP identity.
+    """
+
+
+class DisplayEnum(Enum):
+    int_0 = 0
+    int_1 = 1
+
+
+class Display(RootModel[DisplayEnum | None]):
+    root: DisplayEnum | None = 0
+    """
+    PHP normalizes an explicit null to 0.
+    """
+
+
+class SaveNotebookRequest(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+        regex_engine="python-re",
+    )
+    id: Annotated[int | None, Field(ge=0)] = 0
+    """
+    Null or 0 creates a notebook; a positive value attempts an owned-notebook update.
+    """
+    display: Annotated[Display | None, Field(validate_default=True)] = 0
+    """
+    PHP normalizes an explicit null to 0.
+    """
+    types: Annotated[
+        str | None,
+        Field(
+            json_schema_extra={
+                "contentMediaType": "application/json",
+                "contentSchema": {"type": "array"},
+            }
+        ),
+    ] = "[]"
+    """
+    JSON-encoded notebook type array. A JSON null field is normalized to
+    the string default `[]`; malformed encoded JSON and the encoded string
+    `null` produce a business error.
+
+    """
+    showtext: Annotated[str, Field(max_length=100, min_length=1, pattern="^(?!-?(?:0|[1-9][0-9]*)$)")]
+    """
+    PHP rejects a canonical decimal integer string as a notebook name.
+    """
+    comm: Annotated[str | None, Field(max_length=255)] = ""
+    """
+    PHP normalizes an explicit null to the empty string.
+    """
+    requests: Annotated[
+        str | None,
+        Field(
+            json_schema_extra={
+                "contentMediaType": "application/json",
+                "contentSchema": {
+                    "type": "array",
+                    "items": {
+                        "type": "object",
+                        "required": ["uid", "path"],
+                        "properties": {
+                            "uid": {},
+                            "path": {"type": "array", "minItems": 1, "maxItems": 4},
+                        },
+                        "additionalProperties": True,
+                    },
+                },
+            }
+        ),
+    ] = None
+    """
+    Optional JSON-encoded list-display configuration. Missing, explicit
+    null, or empty string is normalized to null. A non-empty value is
+    validated only when display is 1.
+
+    """
+    group_id: Annotated[int | None, Field(ge=0)] = 0
+    """
+    Null is normalized to 0. Creation-only; PHP ignores it during updates.
+    """
+
+
+class AddNotebookShareRequest(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    id: Annotated[int, Field(ge=1)]
+    """
+    Notebook database identifier.
+    """
+    users: Annotated[
+        str,
+        Field(
+            json_schema_extra={
+                "contentMediaType": "application/json",
+                "contentSchema": {
+                    "type": "array",
+                    "minItems": 1,
+                    "uniqueItems": True,
+                    "items": {"type": "integer", "minimum": 1},
+                },
+            },
+            min_length=1,
+        ),
+    ]
+    """
+    JSON-encoded user-id list. The stable contract requires at least one
+    positive unique user even though PHP silently filters zero and duplicate
+    values before applying its own self/already-shared filter.
+
+    """
+
+
+class Write(IntEnum):
+    integer_0 = 0
+    integer_1 = 1
+
+
+class Create(IntEnum):
+    integer_0 = 0
+    integer_1 = 1
+
+
+class Delete(IntEnum):
+    integer_0 = 0
+    integer_1 = 1
+
+
+class Sign(IntEnum):
+    integer_0 = 0
+    integer_1 = 1
+
+
+class Subtype(IntEnum):
+    integer_0 = 0
+    integer_1 = 1
+
+
+class Log(IntEnum):
+    integer_0 = 0
+    integer_1 = 1
+
+
+class User(IntEnum):
+    integer_0 = 0
+    integer_1 = 1
+
+
+class UpdateNotebookSharePermissionsRequest(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    id: Annotated[int, Field(ge=1)]
+    """
+    Direct-share row identifier returned by listNotebookShares.
+    """
+    write: Write = 0
+    create: Create = 0
+    delete: Delete = 0
+    sign: Sign = 0
+    subtype: Subtype = 0
+    log: Log = 0
+    user: User = 0
+
+
+class DeleteNotebookShareRequest(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    id: Annotated[int, Field(ge=1)]
+    """
+    Direct-share row identifier, not a notebook identifier.
+    """
+
+
+class PublicRecordListRequest(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    eln: Annotated[str, Field(min_length=1)]
+
+
+class CreateRecordRequest(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    eln: Annotated[str, Field(min_length=1)]
+    title: Annotated[str, Field(max_length=100, min_length=1)]
+    describe: Annotated[str | None, Field(max_length=256)] = ""
+    """
+    Missing or null becomes an empty summary.
+    """
+    uid: Annotated[str | None, Field(max_length=45)] = ""
+    """
+    Missing, null, or empty asks the data server to generate a UID.
+    """
+    user: Annotated[int | None, Field(ge=1)] = None
+    """
+    Missing or null selects the authenticated user's notebook.
+    """
+    path: list[str] | None = None
+    """
+    Missing or null selects the root subtype.
+    """
+
+
+class ImportRecordItem(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    uid: Annotated[str, Field(max_length=45, min_length=1)]
+    title: Annotated[str, Field(max_length=100, min_length=1)]
+    data: dict[str, Any]
+    """
+    Template-shaped values keyed by canonical module name.
+    """
+    keyword: str | None = ""
+    """
+    Missing or null becomes an empty keyword string.
+    """
+    path: list[str] | None = None
+
+
+class IdItem(RootModel[int]):
+    root: Annotated[int, Field(ge=1)]
+
+
+class ImportRecordsResponse(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    code: Literal[0]
+    msg: str
+    errcode: Literal[0]
+    errmsg: str
+    """
+    Legacy alias of `msg`; always present in these operations.
+    """
+    id: list[IdItem]
+    eln_id: Annotated[int, Field(ge=1)]
+
+
+class NotebookSelector1(RootModel[str]):
+    root: Annotated[str, Field(min_length=1)]
+
+
+class User1(RootModel[int]):
+    root: Annotated[int, Field(ge=1)]
+
+
+class User2(RootModel[str]):
+    root: Annotated[str, Field(min_length=1)]
+
+
+class SharedNotebookSelector(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    title: Annotated[str, Field(min_length=1)]
+    user: User1 | User2
+
+
+class ExportRecordItem(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    eln_name: Annotated[str | None, Field(...)]
+    id: Annotated[int, Field(ge=1)]
+    title: str
+    comm: Annotated[str | None, Field(...)]
+    uid: str
+    data: list[Any]
+
+
+class Path(RootModel[int]):
+    root: Annotated[int, Field(ge=0)]
+
+
+class SearchExtractionRequest(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    uid: Annotated[str, Field(min_length=1)]
+    path: Annotated[list[str | Path], Field(max_length=4, min_length=1)]
+
+
+class SearchRecordItem(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    id: Annotated[int, Field(ge=1)]
+    eln_id: Annotated[int, Field(ge=1)]
+    uid: str
+    title: str
+    eln_name: str
+
+
+class QuoteRequest(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    uid: Annotated[str, Field(min_length=1)]
+    name: Annotated[str, Field(min_length=1)]
+    path: Annotated[list[str | int], Field(max_length=4, min_length=1)]
+
+
+class User3(RootModel[int]):
+    root: Annotated[int, Field(ge=1)] = None
+
+
+class User4(RootModel[str]):
+    root: Annotated[str, Field(min_length=1)] = None
+
+
+class ModifyItem(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    path: Annotated[list[str | int], Field(min_length=1)]
+    data: Any
+
+
+class PathOperation(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    path: Annotated[list[str | int], Field(min_length=1)]
+
+
+class DeleteModuleOperation(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    name: Annotated[str, Field(min_length=1)]
+
+
+class Type(StrEnum):
+    form = "form"
+    table = "table"
+    files = "files"
+    richtext = "richtext"
+    code = "code"
+
+
+class LanguageEnum(Enum):
+    json = "json"
+    python = "python"
+    javascript = "javascript"
+    html = "html"
+    css = "css"
+    xml = "xml"
+    php = "php"
+    java = "java"
+    cpp = "cpp"
+    sql = "sql"
+    latex = "latex"
+    other = "other"
+
+
+class Language(RootModel[LanguageEnum | None]):
+    root: LanguageEnum | None = None
+
+
+class StyleEnum(Enum):
+    ternary = "ternary"
+    echarts = "echarts"
+
+
+class Style(RootModel[StyleEnum | None]):
+    root: StyleEnum | None = None
+
+
+class AddModuleOperation(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    name: Annotated[str, Field(min_length=1)]
+    type: Type
+    data: str | None = None
+    """
+    Accepted only as initial content for richtext and code modules.
+    """
+    language: Language | None = None
+    style: Style | None = None
+
+
+class Module(RootModel[str]):
+    root: Annotated[str, Field(min_length=1)]
+
+
+class Type1Enum(Enum):
+    text = "text"
+    richtext = "richtext"
+    multiline = "multiline"
+    number = "number"
+    date = "date"
+    time = "time"
+    file = "file"
+    bool = "bool"
+
+
+class Type1(RootModel[Type1Enum | None]):
+    root: Type1Enum | None = None
+
+
+class RowEnum(Enum):
+    int_0 = 0
+    int__1 = -1
+
+
+class Row(RootModel[RowEnum | None]):
+    root: RowEnum | None = None
+
+
+class AddValueOperation(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    module: Module | int
+    name: Annotated[str | None, Field(min_length=1)] = None
+    type: Type1 | None = None
+    row: Row | None = None
+    data: dict[str, Any] | list[Any] | str | float | bool | None = None
+    """
+    Runtime requirements depend on the target module type.
+    """
+    path: list[str] | None = None
+
+
+class Uid1(RootModel[str]):
+    root: Annotated[str, Field(min_length=1)]
+
+
+class DeleteRecordsRequest(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    eln: Annotated[str, Field(min_length=1)]
+    uids: Annotated[list[Uid1], Field(min_length=1)]
+    user: Annotated[int | None, Field(ge=1)] = None
+
+
+class PublicRecordItem(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    id: Annotated[int, Field(ge=1)]
+    item_id: Annotated[int, Field(ge=1)]
+    eln_id: Annotated[int, Field(ge=1)]
+    uid: Annotated[str | None, Field(...)]
+    title: Annotated[str | None, Field(...)]
+    comm: Annotated[str | None, Field(...)]
+    locked: bool
+    eln_name: Annotated[str | None, Field(...)]
+    userid: Annotated[int | None, Field(...)]
+    username: Annotated[str | None, Field(...)]
+    email: Annotated[str | None, Field(...)]
+    owner: bool
+
+
+class Id(RootModel[int]):
+    root: Annotated[int, Field(ge=1)]
+
+
+class Display1(IntEnum):
+    integer_0 = 0
+    integer_1 = 1
+
+
+class OrderDesc(IntEnum):
+    integer_0 = 0
+    integer_1 = 1
+
+
+class RecordPageNotebook(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    id: Annotated[int, Field(ge=1)]
+    group_id: Annotated[int, Field(ge=0)]
+    username: Annotated[str | None, Field(...)]
+    template_id: Annotated[int | None, Field(...)]
+    eln_text: Annotated[str | None, Field(...)]
+    editable: bool
+    create: bool
+    delete: bool
+    owner: bool
+    subtype: bool
+    readlog: bool
+    user: bool
+    server: str
+    sign: bool
+    power: Annotated[int, Field(ge=0)]
+    display: Display1
+    page_size: Annotated[int, Field(ge=1, le=255)]
+    order_by: Annotated[int, Field(ge=0)]
+    order_desc: OrderDesc
+    requests: list[Any]
+
+
+class Editable(IntEnum):
+    integer_0 = 0
+    integer_1 = 1
+
+
+class PublicAssociation(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    id: Annotated[int, Field(ge=1)]
+    title: Annotated[str | None, Field(...)]
+    item_id: Annotated[int, Field(ge=1)]
+    editable: Editable
+
+
+class ResourceAssociation(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    title: Annotated[str | None, Field(...)]
+    item_id: Annotated[int, Field(ge=1)]
+
+
+class RecordShareLink(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    id: Annotated[int, Field(ge=1)]
+    item_id: Annotated[int, Field(ge=1)]
+    token: Annotated[str | None, Field(...)]
+    expired: Annotated[int, Field(ge=0)]
+
+
+class DeletedRecordItem(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    id: Annotated[int, Field(ge=1)]
+    datetime_create: str
+    datetime_modify: str
+    deleted_dtime: Annotated[str | None, Field(...)]
+    title: str
+    comm: Annotated[str | None, Field(...)]
+    sn: str
+
+
+class DeletedRecordNotebook(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    id: Annotated[int, Field(ge=1)]
+    group_id: Annotated[int, Field(ge=0)]
+    username: Annotated[str | None, Field(...)]
+    eln_text: Annotated[str | None, Field(...)]
+    server: str
+
+
+class RestoreRecordsRequest(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    eln: Annotated[int, Field(ge=1)]
+    ids: Annotated[
+        str,
+        Field(
+            json_schema_extra={
+                "contentMediaType": "application/json",
+                "contentSchema": {
+                    "type": "array",
+                    "minItems": 1,
+                    "items": {"type": "integer", "minimum": 1},
+                },
+            }
+        ),
+    ]
+    """
+    JSON-encoded list of deleted record ids.
+    """
+
+
+class CopyRecordRequest(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    eln: Annotated[int, Field(ge=1)]
+    eln_to: Annotated[int | None, Field(ge=0)] = 0
+    """
+    Missing, null, or zero copies into the source notebook.
+    """
+    id: Annotated[int, Field(ge=1)]
+    uid: Annotated[str | None, Field(max_length=45)] = ""
+    """
+    Missing, null, or empty asks PHP to generate a unique UID.
+    """
+    title: Annotated[str, Field(max_length=100, min_length=1)]
+
+
+class CopyRecordResponse(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    code: Code
+    msg: str
+    errcode: Errcode
+    errmsg: str
+    """
+    Legacy alias of `msg`; always present in these operations.
+    """
+    id: Annotated[int, Field(ge=1)]
+
+
+class AddRelationRequest(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    eln_id: Annotated[int, Field(ge=1)]
+    item_id: Annotated[int, Field(ge=1)]
+    related_eln: Annotated[int, Field(ge=1)]
+    related_id: Annotated[int, Field(ge=1)]
+
+
+class DeleteRelationRequest(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    eln: Annotated[int, Field(ge=1)]
+    item_id: Annotated[int, Field(ge=1)]
+    related_id: Annotated[int, Field(ge=1)]
+
+
+class SaveRecordCommentRequest(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    id: Annotated[int, Field(ge=0)] = 0
+    """
+    Missing or zero creates; a positive comment id attempts an owner-only edit.
+    """
+    eln: Annotated[int, Field(ge=1)]
+    """
+    Notebook database identifier.
+    """
+    item_id: Annotated[int, Field(ge=1)]
+    """
+    Record database identifier.
+    """
+    more: Annotated[
+        str,
+        Field(
+            json_schema_extra={"contentMediaType": "text/html"},
+            max_length=16373,
+            min_length=1,
+            pattern="\\S",
+        ),
+    ]
+    """
+    Non-blank rich-text comment content. PHP trims surrounding
+    whitespace and rewrites embedded Matelab attachment URLs before
+    persistence.
+
+    """
+    uid: Annotated[str, Field(max_length=45)] = ""
+    """
+    Optional temporary-upload correlation key. Missing or explicit
+    empty form content has the same no-new-attachment meaning.
+
+    """
+
+
+class UploadRecordCommentAttachmentRequest(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    uid: Annotated[str, Field(max_length=45, min_length=1)]
+    """
+    Caller-generated correlation key. Reuse this exact value when saving
+    the comment; use an unguessable value unique to this binding attempt.
+
+    """
+    eln: Annotated[int, Field(ge=1)]
+    """
+    Notebook database identifier.
+    """
+    i: Annotated[int, Field(ge=1)]
+    """
+    Record database identifier; this is not a comment id.
+    """
+    upload: bytes
+    """
+    Complete attachment bytes in the Provider's literal multipart field name.
+    """
+
+
+class UploadRecordCommentAttachmentResponse(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    code: Literal[0]
+    msg: str
+    errcode: Literal[0]
+    errmsg: str
+    """
+    Legacy alias of `msg`; always present in these operations.
+    """
+    filename: Annotated[str, Field(max_length=1000, min_length=1)]
+    """
+    Original multipart filename.
+    """
+    path: Literal["eln_url/eln_temp"]
+    query: Annotated[str, Field(min_length=1)]
+    """
+    URL-encoded temporary reference containing `eln`, temporary row
+    `id`, SHA-256 `h`, byte size `s`, and original filename `f`.
+
+    """
+
+
+class DeleteRecordCommentRequest(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    eln: Annotated[int, Field(ge=1)]
+    """
+    Notebook database identifier.
+    """
+    item_id: Annotated[int, Field(ge=1)]
+    """
+    Record database identifier.
+    """
+    id: Annotated[int, Field(ge=1)]
+    """
+    Comment identifier returned by listRecordComments.
+    """
+
+
+class RelatedRecordItem(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    id: Annotated[int, Field(ge=1)]
+    related_eln: Annotated[int | None, Field(...)]
+    related_id: Annotated[int, Field(ge=1)]
+    eln_id: Annotated[int | None, Field(...)]
+    title: Annotated[str | None, Field(...)]
+    comm: Annotated[str | None, Field(...)]
+    uid: Annotated[str | None, Field(...)]
+    eln: str | None = None
+    """
+    Conditional; appended only for a current-user notebook on the same server.
+    """
+
+
+class RecordComment(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    id: Annotated[int, Field(ge=1)]
+    """
+    Comment database identifier.
+    """
+    datetime: str
+    """
+    Provider-local creation time, or last edit time after an owner edit.
+    """
+    data: str
+    """
+    Stored rich-text content; embedded attachment links may use the internal elnurl scheme.
+    """
+    username: Annotated[str | None, Field(...)]
+    """
+    Required nullable user display name resolved by the front Provider.
+    """
+    owner: bool
+    """
+    Whether the authenticated caller created this comment.
+    """
+
+
+class NotebookShare(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    id: Annotated[int, Field(ge=1)]
+    """
+    Direct-share row identifier.
+    """
+    power: Annotated[int, Field(ge=0, le=510)]
+    """
+    Stored mask. A newly added row is 0 despite implicit read access;
+    after permission editing PHP includes READ (4) plus selected flags.
+
+    """
+    username: Annotated[str | None, Field(...)]
+    """
+    Required nullable because login_user is LEFT JOINed.
+    """
+    email: Annotated[str | None, Field(...)]
+    """
+    Required nullable because login_user is LEFT JOINed and the profile column may be null.
+    """
+    userid: Annotated[int, Field(ge=1)]
+    self: bool
+    """
+    Whether this share row belongs to the authenticated caller.
+    """
+
+
+class DeferredUserField(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    userid: Annotated[int, Field(ge=1)]
+    field: Literal["idphoto"]
+
+
+class PublicNotebook(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    id: Annotated[int, Field(ge=1)]
+    showtext: str
+    comm: str
+    """
+    PHP normalizes a database null to an empty string.
+    """
+    num: Annotated[int, Field(ge=0)]
+    datetime_create: str
+    userid: Annotated[int, Field(ge=0)]
+    owner: bool
+
+
+class ListRecordsRequest(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    eln: Annotated[str, Field(min_length=1)]
+    """
+    Exact `showtext` from an owned or shared notebook.
+    """
+    user: Annotated[int | None, Field(ge=1)] = None
+    """
+    Owner userid for a shared notebook; omitted for an owned notebook.
+    """
+    date_start: str | None = ""
+    """
+    Raw lower datetime bound compared by the Provider.
+    """
+    date_end: str | None = ""
+    """
+    Raw upper datetime bound; the current consumer appends 23:59:59 for a date.
+    """
+    keywords: list[str] | None = []
+    content: str | None = ""
+    """
+    Free-text search value used by JSON_SEARCH.
+    """
+
+
+class Encrypt(IntEnum):
+    integer_0 = 0
+    integer_1 = 1
+
+
+class RecordListItem(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    id: Annotated[int, Field(ge=1)]
+    datetime_create: str
+    """
+    Provider-formatted `Y-m-d H:i`.
+    """
+    datetime_modify: str
+    """
+    Provider-formatted `Y-m-d H:i`.
+    """
+    title: str
+    comm: Annotated[str | None, Field(...)]
+    sn: str
+    keywords: list[str]
+    template_id: Annotated[int | None, Field(...)]
+    subtype: Annotated[int | None, Field(...)]
+    encrypt: Encrypt
+    log: Annotated[int | None, Field(ge=1)]
+    """
+    Caller-specific audit row count, or null when no matching row exists.
+    """
+    config: list[Any]
+    """
+    Currently normalized to an empty array by the Provider list constructor.
+    """
+
+
+class RecordSubtype(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    id: Annotated[int, Field(ge=1)]
+    showtext: str
+    parent: Annotated[int, Field(ge=0)]
+    items_num: Annotated[int | None, Field(ge=0)]
+    subtype_num: Annotated[int | None, Field(ge=0)]
+
+
+class Locked(IntEnum):
+    integer_0 = 0
+    integer_1 = 1
+
+
+class RecordVersion(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    id: Annotated[int, Field(ge=1)]
+    """
+    `eln_items_version.id`, suitable for the `item_view` version query parameter.
+    """
+    datetime_locked: Annotated[int, Field(ge=0)]
+    datetime_modify: Annotated[int, Field(ge=0)]
+    locked: Locked
+    """
+    Raw tinyint; PHP does not cast this nested field to boolean.
+    """
+    userid: Annotated[int, Field(ge=1)]
+    username: Annotated[str | None, Field(...)]
+
+
+class RecordSignature(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    userid: Annotated[int, Field(ge=1)]
+    username: Annotated[str | None, Field(...)]
+    photo_sign: Annotated[str | None, Field(...)]
+    datetime_sign: Annotated[str | None, Field(...)]
+    timestamp_result: str
+    user_result: str
+
+
+class LiteratureLibrary(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    id: Annotated[int | None, Field(ge=0)]
+    """
+    Null only for a dangling membership whose LEFT JOIN target no longer exists.
+    """
+    showtext: Annotated[str | None, Field(...)]
+    """
+    Null only for a dangling membership whose LEFT JOIN target no longer exists.
+    """
+    power: Annotated[int, Field(ge=0)]
+    """
+    Provider permission bitmask; the synthetic private library uses 91.
+    """
+    num: Annotated[int, Field(ge=0)]
+    keywords: list[str]
+    """
+    Invalid or null stored JSON is normalized to an empty array.
+    """
+    intro: Annotated[str | None, Field(...)]
+
+
+class IncomingLiteratureShare(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    id: Annotated[int, Field(ge=1)]
+    title: Annotated[str | None, Field(...)]
+    """
+    JSON extraction returns null when content or title is absent.
+    """
+    username: str
+    """
+    Snapshot of the sender name stored in `recommend_fav.user_from`.
+    """
+    intro: Annotated[str | None, Field(...)]
+    keywords: list[str]
+    """
+    Invalid or null stored JSON is normalized to an empty array.
+    """
+
+
+class LiteratureShareComment(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    id: Annotated[int, Field(ge=1)]
+    fav_id: Annotated[int, Field(ge=1)]
+    content: str
+
+
+class Source(IntEnum):
+    integer_1 = 1
+    integer_2 = 2
+    integer_3 = 3
+
+
+class LiteratureListItem(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    id: Annotated[int, Field(ge=1)]
+    star: Annotated[int, Field(ge=0, le=5)]
+    source: Source
+    """
+    One for subscribed, two for user-created, and three for shared.
+    """
+    hash: str
+    """
+    Empty when no PDF is attached.
+    """
+    filename: str
+    """
+    Empty when no PDF is attached.
+    """
+    title: str
+    """
+    Missing or null content title is normalized to an empty string.
+    """
+    author: str
+    """
+    Explicit author text, or semicolon-joined `content.authors`.
+    """
+    info: str
+    """
+    Provider-generated HTML citation summary.
+    """
+    abstract: str
+    """
+    Missing or null abstract is normalized to an empty string.
+    """
+    journal: str
+    """
+    Missing or null journal is normalized to an empty string.
+    """
+    keywords: list[str]
+    """
+    Invalid or null stored JSON is normalized to an empty array.
+    """
+    dtime: Annotated[str, Field(pattern="^\\d{4}-\\d{2}-\\d{2}$")]
+    authors_bold: list[str]
+    """
+    Author fragments matching an active author search; otherwise empty.
+    """
+
+
+class Hash(RootModel[str]):
+    root: Annotated[str, Field(max_length=0)] = ""
+    """
+    Optional complete-file SHA-256 checked only on the final fragment.
+    """
+
+
+class Last(IntEnum):
+    integer_0 = 0
+    integer_1 = 1
+
+
+class Abort(IntEnum):
+    integer_0 = 0
+    integer_1 = 1
+
+
+class StageTemporaryFileRequest(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    uid: Annotated[str, Field(max_length=45, min_length=1)]
+    """
+    Caller-generated, unguessable per-file binding key. Literature
+    binding later reuses this value; cloud drive binds by the returned
+    temporary row id. Never stage more than one file under one uid.
+
+    """
+    tempid: Annotated[str, Field(max_length=45)] = ""
+    """
+    Resumable upload-session key repeated for every fragment. Missing or
+    empty makes PHP generate one and return it on a non-final response;
+    integrations should generate it up front so abort is always possible.
+
+    """
+    hash: Annotated[Sha256 | Hash, Field(validate_default=True)] = ""
+    """
+    Optional complete-file SHA-256 checked only on the final fragment.
+    """
+    last: Last = 0
+    """
+    One marks the final fragment; missing/null/non-integer input is coerced to zero by PHP.
+    """
+    abort: Abort = 0
+    """
+    One cancels and cleans the matching caller-owned upload session.
+    """
+    file: bytes | None = None
+    """
+    Required for upload branches and omitted for abort.
+    """
+
+
+class StagedTemporaryFileFragmentResponse(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    code: Literal[0]
+    msg: str
+    errcode: Literal[0]
+    errmsg: str
+    """
+    Legacy alias of `msg`; always present in these operations.
+    """
+    hash: Sha256
+    tempid: Annotated[str, Field(max_length=45, min_length=1)]
+
+
+class StagedTemporaryFileResponse(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    code: Literal[0]
+    msg: str
+    errcode: Literal[0]
+    errmsg: str
+    """
+    Legacy alias of `msg`; always present in these operations.
+    """
+    id: Annotated[int, Field(ge=1)]
+    """
+    Temporary upload row id. Literature metadata extraction verifies
+    caller ownership; cloud-drive binding is affected by PVD-031.
+
+    """
+    path: Literal["url_eln/temp"]
+    query: Annotated[str, Field(min_length=1)]
+    """
+    Provider-built legacy query string for the temporary file.
+    """
+    name: Annotated[str, Field(max_length=45, min_length=1)]
+    """
+    The upload-session tempid.
+    """
+    filename: Annotated[str, Field(min_length=1)]
+    """
+    Original client filename.
+    """
+    size: Annotated[int, Field(ge=0)]
+    hash: Sha256
+
+
+class ExtractLiteratureMetadataRequest1(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    id: Annotated[int, Field(ge=1)]
+    """
+    Caller-owned upload_temp id; zero selects DOI mode.
+    """
+    doi: Literal[""] = ""
+    """
+    DOI source; empty selects staged-PDF mode.
+    """
+
+
+class ExtractLiteratureMetadataRequest2(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    id: Annotated[Literal[0], Field(ge=0)] = 0
+    """
+    Caller-owned upload_temp id; zero selects DOI mode.
+    """
+    doi: Annotated[str, Field(min_length=1)]
+    """
+    DOI source; empty selects staged-PDF mode.
+    """
+
+
+class ExtractLiteratureMetadataRequest(
+    RootModel[ExtractLiteratureMetadataRequest1 | ExtractLiteratureMetadataRequest2]
+):
+    root: ExtractLiteratureMetadataRequest1 | ExtractLiteratureMetadataRequest2
+
+
+class ExtractedLiteratureAuthor(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    name: str
+    affiliation: list[str] | None = None
+    email: str | None = None
+    is_corresponding: bool | None = None
+    orcid: str | None = None
+
+
+class SaveLiteratureItemRequest1(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    id: Annotated[Literal[0], Field(ge=0)] = 0
+    """
+    Missing or zero creates; a positive id selects metadata replacement.
+    """
+    store_id: Annotated[Literal[0], Field(ge=0)] = 0
+    """
+    Must be zero for create; ignored and derived from the row for update.
+    """
+    uid: Annotated[str, Field(max_length=45)] = ""
+    """
+    In create mode, empty creates metadata only and a non-empty value
+    consumes the one completed file staged under that unguessable uid.
+    Update mode ignores this field. Non-empty create uid binding is
+    affected by PVD-026.
+
+    """
+    info: Annotated[
+        str,
+        Field(
+            json_schema_extra={
+                "contentMediaType": "application/json",
+                "contentSchema": {"$ref": "#/components/schemas/SaveLiteratureContent"},
+            },
+            min_length=1,
+        ),
+    ]
+
+
+class SaveLiteratureItemRequest2(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    id: Annotated[int, Field(ge=1)]
+    """
+    Missing or zero creates; a positive id selects metadata replacement.
+    """
+    store_id: Annotated[int, Field(ge=0)] = 0
+    """
+    Must be zero for create; ignored and derived from the row for update.
+    """
+    uid: Annotated[str, Field(max_length=45)] = ""
+    """
+    In create mode, empty creates metadata only and a non-empty value
+    consumes the one completed file staged under that unguessable uid.
+    Update mode ignores this field. Non-empty create uid binding is
+    affected by PVD-026.
+
+    """
+    info: Annotated[
+        str,
+        Field(
+            json_schema_extra={
+                "contentMediaType": "application/json",
+                "contentSchema": {"$ref": "#/components/schemas/SaveLiteratureContent"},
+            },
+            min_length=1,
+        ),
+    ]
+
+
+class SaveLiteratureItemRequest(RootModel[SaveLiteratureItemRequest1 | SaveLiteratureItemRequest2]):
+    root: SaveLiteratureItemRequest1 | SaveLiteratureItemRequest2
+
+
+class Comm(IntEnum):
+    integer_0 = 0
+    integer_1 = 1
+
+
+class ShareLiteratureItemsRequest(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    ids: Annotated[
+        str,
+        Field(
+            json_schema_extra={
+                "contentMediaType": "application/json",
+                "contentSchema": {
+                    "type": "array",
+                    "minItems": 1,
+                    "uniqueItems": True,
+                    "items": {"type": "integer", "minimum": 1},
+                },
+            },
+            min_length=1,
+        ),
+    ]
+    """
+    JSON-encoded ids from the caller's readable literature list.
+    """
+    users: Annotated[
+        str,
+        Field(
+            json_schema_extra={
+                "contentMediaType": "application/json",
+                "contentSchema": {
+                    "type": "array",
+                    "minItems": 1,
+                    "uniqueItems": True,
+                    "items": {"type": "integer", "minimum": 1},
+                },
+            },
+            min_length=1,
+        ),
+    ]
+    """
+    JSON-encoded, existing, non-self recipient user ids returned by searchUsers.
+    """
+    comm: Comm = 0
+    """
+    One copies the sender's own comment and its attachment quotes.
+    """
+    intro: Annotated[str, Field(max_length=255)] = ""
+    """
+    Optional note shown with every pending recipient copy.
+    """
+
+
+class DeletePersonalLiteratureItemRequest(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    id: Annotated[int, Field(ge=1)]
+    """
+    Literature item id returned by listLiteratureItems for the caller's
+    synthetic personal library (`store_id=0`).
+
+    """
+
+
+class ReplaceLiteraturePdfRequest(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    id: Annotated[int, Field(ge=1)]
+    """
+    Existing literature item for which the caller has FAV_WRITE.
+    """
+    uid: Annotated[str, Field(max_length=45, min_length=1)]
+    """
+    Unguessable uid containing exactly one completed staged PDF.
+    """
+
+
+class DeleteLiteraturePdfRequest(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    id: Annotated[int, Field(ge=1)]
+    """
+    Existing literature item for which the caller has FAV_WRITE.
+    """
+
+
+class Keyword(RootModel[str]):
+    root: Annotated[str, Field(min_length=1)]
+
+
+class ReferenceItem(RootModel[str]):
+    root: Annotated[str, Field(min_length=1)]
+
+
+class LiteratureCitationInfoInput(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    year: float | None = None
+    volume: str | None = None
+    issue: str | None = None
+    page: str | None = None
+
+
+class LiteratureContent1(RootModel[list[Any]]):
+    root: Annotated[list[Any], Field(max_length=0)]
+    """
+    PHP fallback when the stored JSON is null or invalid.
+    """
+
+
+class LiteratureCitationInfo(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    year: float | None = None
+    volume: str | None = None
+    issue: str | None = None
+    page: str | None = None
+
+
+class Name(RootModel[list[str]]):
+    root: Annotated[list[str], Field(max_length=2, min_length=2)]
+
+
+class Type2(StrEnum):
+    richtext = "richtext"
+    text = "text"
+    object = "object"
+    number = "number"
+    textgroup = "textgroup"
+
+
+class Comm1(RootModel[list[str]]):
+    root: Annotated[list[str], Field(max_length=2, min_length=2)]
+
+
+class LiteratureNestedFieldDefinition(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    name: str | Name
+    id: Annotated[str, Field(min_length=1)]
+    type: Type2
+    width: Annotated[int | None, Field(ge=1)] = None
+
+
+class Condition(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    id: str
+    value: Any
+
+
+class Logical(StrEnum):
+    and_ = "and"
+    or_ = "or"
+
+
+class LiteratureFieldCondition(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    conditions: Annotated[list[Condition], Field(min_length=1)]
+    logical: Logical | None = None
+
+
+class LiteratureComment(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    id: Annotated[int, Field(ge=1)]
+    content: str
+    userid: Annotated[int, Field(ge=1)]
+    user: Annotated[str | None, Field(...)]
+    dtime: Annotated[str, Field(pattern="^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}$")]
+    owner: bool
+
+
+class SaveLiteratureCommentRequest1(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    id: Annotated[Literal[0], Field(ge=0)] = 0
+    """
+    Missing or zero creates; a positive id selects an owner-only edit.
+    """
+    fav_id: Annotated[int, Field(ge=1)]
+    """
+    Required and positive for create; ignored for an owner-only edit.
+    """
+    comment: Annotated[
+        str,
+        Field(json_schema_extra={"contentMediaType": "text/html"}, max_length=13000),
+    ] = ""
+    """
+    Rich-text content before Provider URL normalization. Missing and an
+    explicitly empty multipart field both persist an empty string.
+
+    """
+    uid: Annotated[str, Field(max_length=100, min_length=1)]
+    """
+    Required temporary-upload correlation key. It may name no staged
+    files, but Consumers must still generate a fresh, unguessable value.
+
+    """
+
+
+class SaveLiteratureCommentRequest2(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    id: Annotated[int, Field(ge=1)]
+    """
+    Missing or zero creates; a positive id selects an owner-only edit.
+    """
+    fav_id: Annotated[int, Field(ge=0)] = 0
+    """
+    Required and positive for create; ignored for an owner-only edit.
+    """
+    comment: Annotated[
+        str,
+        Field(json_schema_extra={"contentMediaType": "text/html"}, max_length=13000),
+    ] = ""
+    """
+    Rich-text content before Provider URL normalization. Missing and an
+    explicitly empty multipart field both persist an empty string.
+
+    """
+    uid: Annotated[str, Field(max_length=100, min_length=1)]
+    """
+    Required temporary-upload correlation key. It may name no staged
+    files, but Consumers must still generate a fresh, unguessable value.
+
+    """
+
+
+class SaveLiteratureCommentRequest(RootModel[SaveLiteratureCommentRequest1 | SaveLiteratureCommentRequest2]):
+    root: SaveLiteratureCommentRequest1 | SaveLiteratureCommentRequest2
+
+
+class DeleteLiteratureCommentRequest(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    id: Annotated[int, Field(ge=1)]
+    """
+    Comment identifier returned by readLiteratureDetail.
+    """
+
+
+class ShareMultipleTemplatesWithUsersResponse(RootModel[BasicSuccessResponse | ErrorResponse]):
+    root: BasicSuccessResponse | ErrorResponse
+
+
+class RemoveTemplateFromUserLibraryResponse(RootModel[BasicSuccessResponse | ErrorResponse]):
+    root: BasicSuccessResponse | ErrorResponse
+
+
+class AddTemplateToGroupResponse(RootModel[BasicSuccessResponse | ErrorResponse]):
+    root: BasicSuccessResponse | ErrorResponse
+
+
+class RemoveTemplateFromGroupResponse(RootModel[BasicSuccessResponse | ErrorResponse]):
+    root: BasicSuccessResponse | ErrorResponse
+
+
+class ListTemplateStoreParametersQuery(BaseModel):
+    search: str = ""
+    page: Annotated[int, Field(ge=1)] = 1
+    page_size: Annotated[int, Field(ge=0, le=256)] = 0
+
+
+class BuyTemplateStoreEntryResponse(RootModel[BasicSuccessResponse | ErrorResponse]):
+    root: BasicSuccessResponse | ErrorResponse
+
+
+class ReadTemplateContentParametersQuery(BaseModel):
+    id: Annotated[int, Field(ge=1)]
+
+
+class ReadTemplateContentResponse(RootModel[TemplateContentResponse | ErrorResponse]):
+    root: TemplateContentResponse | ErrorResponse
+
+
+class SaveTemplateMetadataResponse1(RootModel[SaveTemplateMetadataResponse | ErrorResponse]):
+    root: SaveTemplateMetadataResponse | ErrorResponse
+
+
+class SaveTemplateContentResponse(RootModel[BasicSuccessResponse | ErrorResponse]):
+    root: BasicSuccessResponse | ErrorResponse
+
+
+class CopyTemplateResponse(RootModel[BasicSuccessResponse | ErrorResponse]):
+    root: BasicSuccessResponse | ErrorResponse
+
+
+class UpdateTemplateIntroResponse1(RootModel[UpdateTemplateIntroResponse | ErrorResponse]):
+    root: UpdateTemplateIntroResponse | ErrorResponse
+
+
+class SubmitTemplateToStoreResponse(RootModel[BasicSuccessResponse | ErrorResponse]):
+    root: BasicSuccessResponse | ErrorResponse
+
+
+class All(IntEnum):
+    integer_0 = 0
+    integer_1 = 1
+
+
+class SearchUsersParametersQuery(BaseModel):
+    keyword: Annotated[str, Field(max_length=100, min_length=2, pattern=".*\\S.*")]
+    all: All = 0
+
+
+class SaveNotebookMetadataResponse(RootModel[BasicSuccessResponse | ErrorResponse]):
+    root: BasicSuccessResponse | ErrorResponse
+
+
+class ListNotebookSharesParametersQuery(BaseModel):
+    id: Annotated[int, Field(ge=1)]
+
+
+class AddNotebookShareResponse(RootModel[BasicSuccessResponse | ErrorResponse]):
+    root: BasicSuccessResponse | ErrorResponse
+
+
+class UpdateNotebookSharePermissionsResponse(RootModel[BasicSuccessResponse | ErrorResponse]):
+    root: BasicSuccessResponse | ErrorResponse
+
+
+class DeleteNotebookShareResponse(RootModel[BasicSuccessResponse | ErrorResponse]):
+    root: BasicSuccessResponse | ErrorResponse
+
+
+class CreateBlankRecordResponse(RootModel[BasicSuccessResponse | ErrorResponse]):
+    root: BasicSuccessResponse | ErrorResponse
+
+
+class ImportRecordDatasetResponse(RootModel[ImportRecordsResponse | ErrorResponse]):
+    root: ImportRecordsResponse | ErrorResponse
+
+
+class UpdateRecordDataResponse(RootModel[BasicSuccessResponse | ErrorResponse]):
+    root: BasicSuccessResponse | ErrorResponse
+
+
+class DeleteRecordsByUidResponse(RootModel[BasicSuccessResponse | ErrorResponse]):
+    root: BasicSuccessResponse | ErrorResponse
+
+
+class UploadRecordAttachmentResponse(RootModel[UploadAttachmentResponse | ErrorResponse]):
+    root: UploadAttachmentResponse | ErrorResponse
+
+
+class Default(IntEnum):
+    integer_0 = 0
+    integer_1 = 1
+
+
+class ListNotebookRecordPageParametersQuery(BaseModel):
+    eln: Annotated[int, Field(ge=1)]
+    page: Annotated[int, Field(ge=1)] = 1
+    page_size: Annotated[int, Field(ge=0, le=255)] = 0
+    subtype: Annotated[int, Field(ge=-1)] = 0
+    default: Default = 0
+    order_by: Annotated[int, Field(ge=0)] = 0
+    order_desc: OrderDesc = 1
+    ds: str = ""
+    de: str = ""
+    content: str = ""
+    keywords: Annotated[
+        str,
+        Field(
+            json_schema_extra={
+                "contentMediaType": "application/json",
+                "contentSchema": {"type": "array", "items": {"type": "string"}},
+            }
+        ),
+    ] = ""
+
+
+class ListDeletedRecordPageParametersQuery(BaseModel):
+    eln: Annotated[int, Field(ge=1)]
+    page: Annotated[int, Field(ge=1)] = 1
+    page_size: Annotated[int, Field(ge=1)] = 24
+
+
+class RestoreDeletedRecordsResponse(RootModel[BasicSuccessResponse | ErrorResponse]):
+    root: BasicSuccessResponse | ErrorResponse
+
+
+class CopyRecordResponse1(RootModel[CopyRecordResponse | ErrorResponse]):
+    root: CopyRecordResponse | ErrorResponse
+
+
+class ListRecordRelationsParametersQuery(BaseModel):
+    eln: Annotated[int, Field(ge=1)]
+    item_id: Annotated[int, Field(ge=1)]
+
+
+class AddRecordRelationResponse(RootModel[ForwardableSuccessResponse | ErrorResponse]):
+    root: ForwardableSuccessResponse | ErrorResponse
+
+
+class DeleteRecordRelationResponse(RootModel[ForwardableSuccessResponse | ErrorResponse]):
+    root: ForwardableSuccessResponse | ErrorResponse
+
+
+class ListRecordCommentsParametersQuery(BaseModel):
+    eln: Annotated[int, Field(ge=1)]
+    item_id: Annotated[int, Field(ge=1)]
+
+
+class SaveRecordCommentResponse(RootModel[ForwardableSuccessResponse | ErrorResponse]):
+    root: ForwardableSuccessResponse | ErrorResponse
+
+
+class UploadRecordCommentAttachmentResponse1(RootModel[UploadRecordCommentAttachmentResponse | ErrorResponse]):
+    root: UploadRecordCommentAttachmentResponse | ErrorResponse
+
+
+class DeleteRecordCommentResponse(RootModel[ForwardableSuccessResponse | ErrorResponse]):
+    root: ForwardableSuccessResponse | ErrorResponse
+
+
+class DownloadRecordCommentAttachmentParametersQuery(BaseModel):
+    eln: Annotated[int, Field(ge=1)]
+    i: Annotated[int, Field(ge=1)]
+    h: Sha256
+    s: Annotated[int, Field(ge=1)]
+    f: Annotated[str, Field(max_length=1000, min_length=1)]
+
+
+class ReadRecordParametersQuery(BaseModel):
+    eln: Annotated[int, Field(ge=1)]
+    id: Annotated[int, Field(ge=1)]
+    version: Annotated[int, Field(ge=0)] = 0
+
+
+class DownloadRecordAttachmentParametersQuery(BaseModel):
+    eln: Annotated[int, Field(ge=1)]
+    i: Annotated[int, Field(ge=1)]
+    u: Annotated[str, Field(min_length=1)]
+    h: Sha256
+    f: Annotated[str, Field(min_length=1)]
+    s: Annotated[int, Field(ge=0)]
+    c: Literal[0]
+    thumb: Literal[0] = 0
+
+
+class SearchType(IntEnum):
+    integer_0 = 0
+    integer_1 = 1
+
+
+class ListLiteratureItemsParametersQuery(BaseModel):
+    page: Annotated[int, Field(ge=0)] = 0
+    page_size: Annotated[int, Field(ge=0, le=256)] = 0
+    store_id: Annotated[int, Field(ge=0)] = 0
+    types: Annotated[
+        str,
+        Field(
+            json_schema_extra={
+                "contentMediaType": "application/json",
+                "contentSchema": {
+                    "type": "array",
+                    "uniqueItems": True,
+                    "items": {"type": "integer", "enum": [1, 2, 3]},
+                },
+            }
+        ),
+    ] = ""
+    stars: Annotated[
+        str,
+        Field(
+            json_schema_extra={
+                "contentMediaType": "application/json",
+                "contentSchema": {
+                    "type": "array",
+                    "uniqueItems": True,
+                    "items": {"type": "integer", "minimum": 1, "maximum": 5},
+                },
+            }
+        ),
+    ] = ""
+    keywords: Annotated[
+        str,
+        Field(
+            json_schema_extra={
+                "contentMediaType": "application/json",
+                "contentSchema": {
+                    "type": "array",
+                    "uniqueItems": True,
+                    "items": {"type": "string"},
+                },
+            }
+        ),
+    ] = ""
+    search: str = ""
+    search_type: SearchType = 0
+
+
+class ReadLiteratureDetailParametersQuery(BaseModel):
+    id: Annotated[int, Field(ge=1)]
+
+
+class SaveLiteratureCommentResponse(RootModel[BasicSuccessResponse | ErrorResponse]):
+    root: BasicSuccessResponse | ErrorResponse
+
+
+class DeleteLiteratureCommentResponse(RootModel[BasicSuccessResponse | ErrorResponse]):
+    root: BasicSuccessResponse | ErrorResponse
+
+
+class ShareLiteratureItemsResponse(RootModel[BasicSuccessResponse | ErrorResponse]):
+    root: BasicSuccessResponse | ErrorResponse
+
+
+class DeletePersonalLiteratureItemResponse(RootModel[BasicSuccessResponse | ErrorResponse]):
+    root: BasicSuccessResponse | ErrorResponse
+
+
+class StageTemporaryFileResponse(
+    RootModel[StagedTemporaryFileFragmentResponse | StagedTemporaryFileResponse | ErrorResponse]
+):
+    root: StagedTemporaryFileFragmentResponse | StagedTemporaryFileResponse | ErrorResponse
+
+
+class SaveLiteratureItemResponse(RootModel[BasicSuccessResponse | ErrorResponse]):
+    root: BasicSuccessResponse | ErrorResponse
+
+
+class ReplaceLiteraturePdfResponse(RootModel[BasicSuccessResponse | ErrorResponse]):
+    root: BasicSuccessResponse | ErrorResponse
+
+
+class DeleteLiteraturePdfResponse(RootModel[BasicSuccessResponse | ErrorResponse]):
+    root: BasicSuccessResponse | ErrorResponse
+
+
+class C(IntEnum):
+    integer_0 = 0
+    integer_1 = 1
+
+
+class DownloadLiteraturePdfParametersQuery(BaseModel):
+    t: Literal["recommend_fav_pdf"]
+    id: Annotated[int, Field(ge=1)]
+    h: Sha256
+    f: str = ""
+    c: C = 1
+    thumb: Literal[0] = 0
+
+
+class OrderBy(IntEnum):
+    integer_0 = 0
+    integer_1 = 1
+
+
+class ListCloudDriveFilesParametersQuery(BaseModel):
+    type_id: Annotated[int, Field(ge=0)] = 0
+    root_id: Literal[0] = 0
+    page: Annotated[int, Field(ge=0)] = 0
+    page_size: Annotated[int, Field(ge=0, le=256)] = 20
+    order_by: OrderBy = 0
+    order_desc: OrderDesc = 1
+    search: str = ""
+
+
+class SaveCloudDriveFolderResponse(RootModel[CloudDriveIdentityResponse | ErrorResponse]):
+    root: CloudDriveIdentityResponse | ErrorResponse
+
+
+class DeleteEmptyCloudDriveFolderResponse(RootModel[BasicSuccessResponse | ErrorResponse]):
+    root: BasicSuccessResponse | ErrorResponse
+
+
+class MoveCloudDriveFolderResponse(RootModel[BasicSuccessResponse | ErrorResponse]):
+    root: BasicSuccessResponse | ErrorResponse
+
+
+class BindStagedCloudDriveFileResponse(RootModel[BasicSuccessResponse | ErrorResponse]):
+    root: BasicSuccessResponse | ErrorResponse
+
+
+class EditCloudDriveFileResponse(RootModel[BasicSuccessResponse | ErrorResponse]):
+    root: BasicSuccessResponse | ErrorResponse
+
+
+class DeleteCloudDriveFilesResponse(RootModel[BasicSuccessResponse | ErrorResponse]):
+    root: BasicSuccessResponse | ErrorResponse
+
+
+class MoveCloudDriveFilesResponse(RootModel[BasicSuccessResponse | ErrorResponse]):
+    root: BasicSuccessResponse | ErrorResponse
+
+
+class Thumb(IntEnum):
+    integer_0 = 0
+    integer_1 = 1
+
+
+class DownloadCloudDriveFileParametersQuery(BaseModel):
+    id: Annotated[int, Field(ge=1)]
+    thumb: Thumb = 0
+    c: C = 1
+
+
+class CloudDriveFileListResponse(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    code: Literal[0]
+    msg: str
+    errcode: Literal[0]
+    errmsg: str
+    """
+    Legacy alias of `msg`; always present in these operations.
+    """
+    files: list[CloudDriveFile]
+    count: Annotated[int, Field(ge=0)]
+    quota: Annotated[int, Field(ge=0)]
+    """
+    Effective cloud-drive quota in GiB; zero means unlimited.
+    """
+    used: Annotated[int, Field(ge=0)]
+    root_type: CloudDriveRootPermissions
+    types: list[CloudDriveFolder]
+    users: Annotated[list[Any], Field(max_length=0)]
+    """
+    Always empty because integration-v1 fixes root_id to the personal root.
+    """
+
+
+class AppMenu(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    uid: str
+    order: int | None = None
+    """
+    May be absent on menu entries merged from the optional IOP server.
+    """
+    showtext: str
+    icon: str
+    sub: list[AppMenuItem]
+
+
+class TokenLoginResponse(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    code: Literal[0]
+    msg: str
+    errcode: Literal[0]
+    errmsg: str
+    """
+    Legacy alias of `msg`; always present in these operations.
+    """
+    userid: Annotated[int, Field(ge=1)]
+    protect: bool
+    username: Annotated[str | None, Field(...)]
+    avatar: Annotated[str | None, Field(...)]
+    email: Annotated[str | None, Field(...)]
+    timestamp: Annotated[int, Field(ge=1)]
+    """
+    Provider Unix timestamp in milliseconds.
+    """
+    access: AuthToken
+    refresh: AuthToken
+
+
+class Token(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    access: AuthToken
+    refresh: AuthToken
+
+
+class ChatSsoCodeExchangeResponse(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    code: Literal[0]
+    msg: str
+    errcode: Literal[0]
+    errmsg: str
+    """
+    Legacy alias of `msg`; always present in these operations.
+    """
+    userid: Annotated[int, Field(ge=1)]
+    username: Annotated[str | None, Field(...)]
+    email: Annotated[str | None, Field(...)]
+    token: Token
+
+
+class TokenRefreshResponse(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    code: Literal[0]
+    msg: str
+    errcode: Literal[0]
+    errmsg: str
+    """
+    Legacy alias of `msg`; always present in these operations.
+    """
+    timestamp: Annotated[int, Field(ge=1)]
+    """
+    Provider Unix timestamp in milliseconds.
+    """
+    access: AuthToken
+    refresh: AuthToken
+
+
+class TemplateListResponse(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    code: Literal[0]
+    msg: str
+    errcode: Literal[0]
+    errmsg: str
+    """
+    Legacy alias of `msg`; always present in these operations.
+    """
+    pending: list[PendingTemplateListItem]
+    stores: list[StoreTemplateListItem]
+    share: list[SharedTemplateListItem]
+    my: list[OwnedTemplateListItem]
+    group: list[GroupTemplateListItem]
+    default: list[DefaultTemplateListItem]
+
+
+class TemplateStoreListResponse(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    code: Literal[0]
+    msg: str
+    errcode: Literal[0]
+    errmsg: str
+    """
+    Legacy alias of `msg`; always present in these operations.
+    """
+    items: list[TemplateStoreItem]
+    count: Annotated[int, Field(ge=0)]
+
+
+class ElnGroupsResponse(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    code: Literal[0]
+    msg: str
+    errcode: Literal[0]
+    errmsg: str
+    """
+    Legacy alias of `msg`; always present in these operations.
+    """
+    users: list[ElnGroupUser]
+    """
+    Members of the group identified by `group_id` only. PHP does not
+    filter `eln_usergroup_list.valid` in this second query.
+
+    """
+    groups: list[ElnGroup]
+    """
+    Groups with a valid membership for the current user. Result order
+    is unspecified because the Provider query has no ORDER BY clause.
+
+    """
+    group_id: Annotated[int, Field(ge=0)]
+    """
+    `groups[0].id`, or 0 when `groups` is empty.
+    """
+
+
+class UserDirectorySearchResponse(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    code: Literal[0]
+    msg: str
+    errcode: Literal[0]
+    errmsg: str
+    """
+    Legacy alias of `msg`; always present in these operations.
+    """
+    users: list[DirectoryUser]
+    """
+    Unpaged and unordered matches from the caller's institute.
+    """
+
+
+class ImportRecordsRequest(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    eln: Annotated[str, Field(min_length=1)]
+    template: Annotated[str, Field(min_length=1)]
+    dataset: Annotated[list[ImportRecordItem], Field(max_length=100, min_length=1)]
+    user: Annotated[int | None, Field(ge=1)] = None
+    """
+    Missing or null selects the authenticated user.
+    """
+    template_user: Annotated[int | None, Field(ge=1)] = None
+    """
+    Missing or null selects the authenticated user.
+    """
+
+
+class NotebookSelector(RootModel[NotebookSelector1 | SharedNotebookSelector]):
+    root: NotebookSelector1 | SharedNotebookSelector
+
+
+class Uid(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    uid: Annotated[str, Field(min_length=1)]
+    eln: NotebookSelector
+
+
+class ExportRecordsRequest(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    uids: Annotated[list[Uid], Field(min_length=1)]
+
+
+class ExportRecordsResponse(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    code: Code
+    msg: str
+    errcode: Errcode
+    errmsg: str
+    """
+    Legacy alias of `msg`; always present in these operations.
+    """
+    dataset: list[ExportRecordItem]
+
+
+class SearchRecordsRequest(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    eln: Annotated[list[NotebookSelector] | None, Field(validate_default=True)] = []
+    """
+    Missing, null, or an empty array searches all notebooks owned by the caller.
+    """
+    requests: Annotated[list[SearchExtractionRequest], Field(max_length=24, min_length=1)]
+    date_start: str | None = ""
+    date_end: str | None = ""
+    keywords: list[str] | None = []
+
+
+class SearchRecordsResponse(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    code: Code
+    msg: str
+    errcode: Errcode
+    errmsg: str
+    """
+    Legacy alias of `msg`; always present in these operations.
+    """
+    data: list[SearchRecordItem]
+
+
+class UpdateRecordRequest(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    eln: Annotated[str, Field(min_length=1)]
+    uid: Annotated[str, Field(min_length=1)]
+    user: User3 | User4 | None = None
+    password: str | None = ""
+    quote: list[QuoteRequest] | None = None
+    del_: Annotated[list[PathOperation] | None, Field(alias="del")] = None
+    delModule: list[DeleteModuleOperation] | None = None
+    addModule: list[AddModuleOperation] | None = None
+    add: list[AddValueOperation] | None = None
+    modify: list[ModifyItem] | None = None
+
+
+class PublicRecordListResponse(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    code: Literal[0]
+    msg: str
+    errcode: Literal[0]
+    errmsg: str
+    """
+    Legacy alias of `msg`; always present in these operations.
+    """
+    items: list[PublicRecordItem]
+
+
+class RecordPageResponse(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    code: Literal[0]
+    msg: str
+    errcode: Literal[0]
+    errmsg: str
+    """
+    Legacy alias of `msg`; always present in these operations.
+    """
+    items: list[RecordListItem]
+    subtypes: list[RecordSubtype]
+    trash_num: Annotated[int, Field(ge=0)]
+    ids: list[Id]
+    page: Annotated[int, Field(ge=1)]
+    eln: RecordPageNotebook
+    keywords: list[Any]
+    public_assoc: list[PublicAssociation]
+    resource_assoc: list[ResourceAssociation]
+    link_power: bool
+    links: list[RecordShareLink]
+    agreement: str
+    agreement_title: str
+
+
+class DeletedRecordPageResponse(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    code: Code
+    msg: str
+    errcode: Errcode
+    errmsg: str
+    """
+    Legacy alias of `msg`; always present in these operations.
+    """
+    items: list[DeletedRecordItem]
+    eln: DeletedRecordNotebook
+    count: Annotated[int, Field(ge=0)]
+    page: Annotated[int, Field(ge=1)]
+
+
+class RelationListResponse(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    code: Literal[0]
+    msg: str
+    errcode: Literal[0]
+    errmsg: str
+    """
+    Legacy alias of `msg`; always present in these operations.
+    """
+    items: list[RelatedRecordItem]
+    more: list[RecordComment]
+    editable: bool
+
+
+class CommentListResponse(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    code: Literal[0]
+    msg: str
+    errcode: Literal[0]
+    errmsg: str
+    """
+    Legacy alias of `msg`; always present in these operations.
+    """
+    mores: list[RecordComment]
+
+
+class NotebookShareListResponse(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    code: Literal[0]
+    msg: str
+    errcode: Literal[0]
+    errmsg: str
+    """
+    Legacy alias of `msg`; always present in these operations.
+    """
+    list_: Annotated[list[NotebookShare], Field(alias="list")]
+    owner: bool
+    """
+    True only when the authenticated caller owns the notebook.
+    """
+    power: Annotated[int, Field(ge=0, le=65535)]
+    """
+    Caller's effective notebook permission mask.
+    """
+
+
+class ElnNotebook(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    id: Annotated[int, Field(ge=1)]
+    showtext: Annotated[str | None, Field(...)]
+    sn: Annotated[str | None, Field(...)]
+    num_total: Annotated[int, Field(ge=0)]
+    modify: str
+    """
+    Localized relative-time text computed when the response is built.
+    """
+    datetime_create: Annotated[str | None, Field(...)]
+    comm: Annotated[str | None, Field(...)]
+    group_name: Annotated[str | None, Field(...)]
+    username: str
+    email: str
+    server: str
+    userid_to: Annotated[int | None, Field(...)]
+    share_num: Annotated[int, Field(ge=0)]
+    share_id: Annotated[int, Field(ge=0)]
+    trans_username: str
+    owner: bool
+    userid: Annotated[int, Field(ge=1)]
+    types: list[Any]
+    keywords: list[Any]
+    power: Annotated[int, Field(ge=0)]
+    display: Display1
+    requests: Annotated[str | None, Field(...)]
+    """
+    Raw JSON database column; this controller does not decode it.
+    """
+    avatar: str | DeferredUserField | None = None
+    """
+    Conditional; returned for a notebook not owned by the caller. Normally
+    resolved to the owner's avatar filename or null. The raw Provider
+    lookup descriptor remains when no matching user can be resolved.
+
+    """
+
+
+class RecordListResponse(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    code: Code
+    msg: str
+    errcode: Errcode
+    errmsg: str
+    """
+    Legacy alias of `msg`; always present in these operations.
+    """
+    items: list[RecordListItem]
+    subtypes: list[RecordSubtype]
+    trash_num: Annotated[int, Field(ge=0)]
+
+
+class ItemViewResponse(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    code: Literal[0]
+    msg: str
+    errcode: Literal[0]
+    errmsg: str
+    """
+    Legacy alias of `msg`; always present in these operations.
+    """
+    title: Annotated[str | None, Field(...)]
+    keywords: Annotated[list[str] | None, Field(...)]
+    modules: list[TemplateModule]
+    """
+    Canonical record modules; module objects remain an open JSON structure.
+    """
+    template_id: Annotated[int | None, Field(...)]
+    datetime_modify: Annotated[int, Field(ge=0)]
+    """
+    Unix timestamp in milliseconds.
+    """
+    username: Annotated[str | None, Field(...)]
+    modify_log: list[RecordVersion]
+    uid: Annotated[str | None, Field(...)]
+    """
+    Historical version `sn` is nullable.
+    """
+    current_version: Annotated[int, Field(ge=0)]
+    item_id: Annotated[int, Field(ge=1)]
+    datetime_locked: Annotated[int, Field(ge=0)]
+    """
+    Unix timestamp in milliseconds, or zero.
+    """
+    locked: bool
+    signs: list[RecordSignature]
+    signed: bool
+    owner: bool
+    eln_text: Annotated[str | None, Field(...)]
+    eln_server: str
+    eln_id: Annotated[int, Field(ge=1)]
+    editable: bool
+    keyword_eln: list[Any]
+    pdf_enable: bool
+    template_show: str
+    """
+    Template render metadata; PHP normalizes missing or null to an empty string.
+    """
+    template_text: str
+    """
+    Template title; PHP normalizes missing or null to an empty string.
+    """
+    template_intro: str
+    """
+    Template usage HTML; PHP normalizes missing or null to an empty string.
+    """
+
+
+class LiteratureLibrariesResponse(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    code: Literal[0]
+    msg: str
+    errcode: Literal[0]
+    errmsg: str
+    """
+    Legacy alias of `msg`; always present in these operations.
+    """
+    stores: list[LiteratureLibrary]
+    share: list[IncomingLiteratureShare]
+    share_comments: list[LiteratureShareComment]
+
+
+class LiteratureListResponse(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    code: Literal[0]
+    msg: str
+    errcode: Literal[0]
+    errmsg: str
+    """
+    Legacy alias of `msg`; always present in these operations.
+    """
+    items: list[LiteratureListItem]
+    keywords: list[str]
+    """
+    Library-level keywords; invalid or null JSON is normalized to an empty array.
+    """
+    count: Annotated[int, Field(ge=0)]
+    """
+    Total number of valid items matching the filters before pagination.
+    """
+    store_name: str
+    power: Annotated[int, Field(ge=0)]
+    """
+    Caller permission bitmask for the selected library.
+    """
+
+
+class ExtractedLiteratureMetadata(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    DOI: str | None = None
+    url: str | None = None
+    date: str | None = None
+    """
+    External publication-date string; Consumers must not assume full-date precision.
+    """
+    publisher: str | None = None
+    publication: str | None = None
+    issue: str | None = None
+    volume: str | None = None
+    page: str | None = None
+    title: str | None = None
+    abstract: str | None = None
+    authors: list[ExtractedLiteratureAuthor] | None = None
+    keywords: list[str] | None = None
+    refs: list[str] | None = None
+    fundings: list[Any] | None = None
+    language: str | None = None
+    citation_count: Annotated[int | None, Field(ge=0)] = None
+
+
+class SaveLiteratureContent(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    title: Annotated[str, Field(min_length=1)]
+    journal: str | None = None
+    info: LiteratureCitationInfoInput | None = None
+    author: str | None = None
+    keywords: Annotated[list[Keyword] | None, Field(validate_default=True)] = []
+    abstract: str | None = ""
+    doi: str | None = None
+    url: str | None = None
+    reference: Annotated[list[ReferenceItem] | None, Field(validate_default=True)] = []
+
+
+class LiteratureContentObject(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    title: str | None = None
+    journal: str | None = None
+    info: LiteratureCitationInfo | None = None
+    author: str | None = None
+    authors: list[str] | None = None
+    keywords: list[str] | None = None
+    abstract: str | None = None
+    reference_information: str | None = None
+    doi: str | None = None
+    url: str | None = None
+    reference: list[str] | None = None
+
+
+class LiteratureFieldDefinition(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    group: str | None = None
+    name: str | Name
+    id: Annotated[str, Field(min_length=1)]
+    type: Type2
+    required: bool | None = None
+    comm: str | Comm1 | None = None
+    print: str | None = None
+    template: list[LiteratureNestedFieldDefinition] | None = None
+    show: bool | None = None
+    width: Annotated[int | None, Field(ge=1)] = None
+    condition: LiteratureFieldCondition | None = None
+
+
+class LoginTokenSetResponse(RootModel[TokenLoginResponse | ErrorResponse]):
+    root: TokenLoginResponse | ErrorResponse
+
+
+class RefreshTokenSetResponse(RootModel[TokenRefreshResponse | ErrorResponse]):
+    root: TokenRefreshResponse | ErrorResponse
+
+
+class ExchangeChatSsoCodeResponse(RootModel[ChatSsoCodeExchangeResponse | ErrorResponse]):
+    root: ChatSsoCodeExchangeResponse | ErrorResponse
+
+
+class ListTemplatesResponse(RootModel[TemplateListResponse | ErrorResponse]):
+    root: TemplateListResponse | ErrorResponse
+
+
+class ListTemplateStoreResponse(RootModel[TemplateStoreListResponse | ErrorResponse]):
+    root: TemplateStoreListResponse | ErrorResponse
+
+
+class ListCurrentUserElnGroupsResponse(RootModel[ElnGroupsResponse | ErrorResponse]):
+    root: ElnGroupsResponse | ErrorResponse
+
+
+class SearchUsersResponse(RootModel[UserDirectorySearchResponse | ErrorResponse]):
+    root: UserDirectorySearchResponse | ErrorResponse
+
+
+class ListNotebookSharesResponse(RootModel[NotebookShareListResponse | ErrorResponse]):
+    root: NotebookShareListResponse | ErrorResponse
+
+
+class ListNotebookRecordsResponse(RootModel[RecordListResponse | ErrorResponse]):
+    root: RecordListResponse | ErrorResponse
+
+
+class ExportRecordsResponse1(RootModel[ExportRecordsResponse | ErrorResponse]):
+    root: ExportRecordsResponse | ErrorResponse
+
+
+class SearchRecordDataResponse(RootModel[SearchRecordsResponse | ErrorResponse]):
+    root: SearchRecordsResponse | ErrorResponse
+
+
+class ListPublicNotebookRecordsResponse(RootModel[PublicRecordListResponse | ErrorResponse]):
+    root: PublicRecordListResponse | ErrorResponse
+
+
+class ListNotebookRecordPageResponse(RootModel[RecordPageResponse | ErrorResponse]):
+    root: RecordPageResponse | ErrorResponse
+
+
+class ListDeletedRecordPageResponse(RootModel[DeletedRecordPageResponse | ErrorResponse]):
+    root: DeletedRecordPageResponse | ErrorResponse
+
+
+class ListRecordRelationsResponse(RootModel[RelationListResponse | ErrorResponse]):
+    root: RelationListResponse | ErrorResponse
+
+
+class ListRecordCommentsResponse(RootModel[CommentListResponse | ErrorResponse]):
+    root: CommentListResponse | ErrorResponse
+
+
+class ReadRecordResponse(RootModel[ItemViewResponse | ErrorResponse]):
+    root: ItemViewResponse | ErrorResponse
+
+
+class ListLiteratureLibrariesResponse(RootModel[LiteratureLibrariesResponse | ErrorResponse]):
+    root: LiteratureLibrariesResponse | ErrorResponse
+
+
+class ListLiteratureItemsResponse(RootModel[LiteratureListResponse | ErrorResponse]):
+    root: LiteratureListResponse | ErrorResponse
+
+
+class ListCloudDriveFilesResponse(RootModel[CloudDriveFileListResponse | ErrorResponse]):
+    root: CloudDriveFileListResponse | ErrorResponse
+
+
+class AppIdentityResponse(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    code: Literal[0]
+    msg: str
+    errcode: Literal[0]
+    errmsg: str
+    """
+    Legacy alias of `msg`; always present in these operations.
+    """
+    user: AppUser
+    notifications: Annotated[list[AppNotification], Field(max_length=5)]
+    env: AppEnvironment
+    ai_enable: bool
+    ai_text: Annotated[list[str], Field(min_length=1)]
+    institute: str
+    institute_eng: str
+    product_name: str
+    product_name_eng: str
+    menu: list[AppMenu]
+
+
+class NotebookListResponse(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    code: Literal[0]
+    msg: str
+    errcode: Literal[0]
+    errmsg: str
+    """
+    Legacy alias of `msg`; always present in these operations.
+    """
+    my: list[ElnNotebook]
+    share: list[ElnNotebook]
+    public: list[PublicNotebook]
+
+
+class LiteratureTemplateResponse(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    code: Literal[0]
+    msg: str
+    errcode: Literal[0]
+    errmsg: str
+    """
+    Legacy alias of `msg`; always present in these operations.
+    """
+    template: Annotated[list[LiteratureFieldDefinition], Field(max_length=10, min_length=10)]
+    doipdf: bool
+    """
+    Whether this deployment configured the optional DOI/PDF extraction backend.
+    """
+
+
+class LiteratureMetadataExtractionResponse(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    code: Literal[0]
+    msg: str
+    errcode: Literal[0]
+    errmsg: str
+    """
+    Legacy alias of `msg`; always present in these operations.
+    """
+    doi: ExtractedLiteratureMetadata
+
+
+class LiteratureContent(RootModel[LiteratureContentObject | LiteratureContent1]):
+    root: LiteratureContentObject | LiteratureContent1
+
+
+class ResolveCurrentIdentityResponse(RootModel[AppIdentityResponse | ErrorResponse]):
+    root: AppIdentityResponse | ErrorResponse
+
+
+class ListNotebooksResponse(RootModel[NotebookListResponse | ErrorResponse]):
+    root: NotebookListResponse | ErrorResponse
+
+
+class ReadLiteratureCreateTemplateResponse(RootModel[LiteratureTemplateResponse | ErrorResponse]):
+    root: LiteratureTemplateResponse | ErrorResponse
+
+
+class ExtractLiteratureMetadataResponse(RootModel[LiteratureMetadataExtractionResponse | ErrorResponse]):
+    root: LiteratureMetadataExtractionResponse | ErrorResponse
+
+
+class LiteratureDetailResponse(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    code: Literal[0]
+    msg: str
+    errcode: Literal[0]
+    errmsg: str
+    """
+    Legacy alias of `msg`; always present in these operations.
+    """
+    template: Annotated[list[LiteratureFieldDefinition], Field(max_length=10, min_length=10)]
+    """
+    Static Provider field definitions from `RecommendTrait::fav_template`.
+    """
+    content: LiteratureContent
+    keywords: list[str]
+    """
+    Library-level keywords.
+    """
+    keywords_item: list[str]
+    """
+    Keywords attached to this literature item.
+    """
+    star: Annotated[int, Field(ge=0, le=5)]
+    comments: list[LiteratureComment]
+    """
+    Ordered by descending comment id.
+    """
+    filename: Annotated[str | None, Field(...)]
+    hash: Annotated[str | None, Field(...)]
+    size: Annotated[int | None, Field(ge=0)]
+    source: Source
+    power: Annotated[int, Field(ge=0)]
+    store_name: str
+
+
+class ReadLiteratureDetailResponse(RootModel[LiteratureDetailResponse | ErrorResponse]):
+    root: LiteratureDetailResponse | ErrorResponse