matelab-python-sdk 0.2.0a5__py3-none-any.whl → 0.2.0a6__py3-none-any.whl

matelab/_generated/models.py

@@ -4,14 +4,14 @@
 #   filename:  openapi.yaml
 #   version:   0.83.0
 
-from enum import Enum, StrEnum
+from enum import StrEnum
 from typing import Annotated, Any, Literal
 
-from pydantic import ConfigDict, Field, RootModel, SecretStr, StrictBool, StrictFloat, StrictInt
+from pydantic import ConfigDict, Field, RootModel, SecretStr, StrictBool, StrictFloat, StrictInt, confloat, conint
 
 from matelab._wire_validation import WireModel
 
-OPENAPI_INFO_VERSION = "2026.10.2"
+OPENAPI_INFO_VERSION = "2026.10.3"
 
 
 class ResponseEnvelope(WireModel):
@@ -70,6 +70,9 @@ class ErrorDetail(RootModel[Any]):
 
 
 class ErrorResponse(WireModel):
+    model_config = ConfigDict(
+        json_schema_extra={"matelab-runtime-rules": {"properties": {"errs": {"not": {"type": "null"}}}}}
+    )
     code: Annotated[StrictInt, Field(json_schema_extra={"matelab-runtime-rules": {"not": {"enum": [0, 10]}}})]
     msg: str
     """
@@ -236,6 +239,9 @@ class CloudDriveFileIdListItem(RootModel[StrictInt]):
 
 class CloudDriveFileIdList(RootModel[list[CloudDriveFileIdListItem]]):
     root: Annotated[list[CloudDriveFileIdListItem], Field(min_length=1)]
+    """
+    PHP converts entries with intval, removes duplicates and zero, then requires at least one remaining id.
+    """
 
 
 class DeleteCloudDriveFilesRequest(WireModel):
@@ -251,8 +257,8 @@ class DeleteCloudDriveFilesRequest(WireModel):
                         "CloudDriveFileIdList": {
                             "type": "array",
                             "minItems": 1,
-                            "uniqueItems": True,
                             "items": {"type": "integer", "minimum": 1},
+                            "description": "PHP converts entries with intval, removes duplicates and zero, then requires at least one remaining id.",
                         }
                     },
                 },
@@ -275,8 +281,8 @@ class TransferCloudDriveFilesRequest(WireModel):
                         "CloudDriveFileIdList": {
                             "type": "array",
                             "minItems": 1,
-                            "uniqueItems": True,
                             "items": {"type": "integer", "minimum": 1},
+                            "description": "PHP converts entries with intval, removes duplicates and zero, then requires at least one remaining id.",
                         }
                     },
                 },
@@ -289,7 +295,9 @@ class TransferCloudDriveFilesRequest(WireModel):
 
 
 class UploadAttachmentRequest(WireModel):
-    model_config = ConfigDict(extra="forbid")
+    model_config = ConfigDict(
+        extra="forbid", json_schema_extra={"matelab-runtime-rules": {"properties": {"user": {"not": {"type": "null"}}}}}
+    )
     eln: Annotated[str, Field(min_length=1)]
     """
     Notebook title used to check write permission and select its data
@@ -445,38 +453,26 @@ class ShareMultipleTemplatesRequest(WireModel):
         Field(
             json_schema_extra={
                 "contentMediaType": "application/json",
-                "contentSchema": {
-                    "type": "array",
-                    "minItems": 1,
-                    "maxItems": 10,
-                    "uniqueItems": True,
-                    "items": {"type": "integer", "minimum": 1},
-                },
+                "contentSchema": {"type": "array", "minItems": 1, "items": {"type": "integer", "minimum": 1}},
             },
             min_length=1,
         ),
     ]
     """
-    JSON-encoded owned template-id list.
+    JSON-encoded owned template ids. PHP converts entries with intval, removes duplicates and zero, then checks the 1–10 count.
     """
     users: Annotated[
         str,
         Field(
             json_schema_extra={
                 "contentMediaType": "application/json",
-                "contentSchema": {
-                    "type": "array",
-                    "minItems": 1,
-                    "maxItems": 10,
-                    "uniqueItems": True,
-                    "items": {"type": "integer", "minimum": 1},
-                },
+                "contentSchema": {"type": "array", "minItems": 1, "items": {"type": "integer", "minimum": 1}},
             },
             min_length=1,
         ),
     ]
     """
-    JSON-encoded recipient user-id list.
+    JSON-encoded recipient user ids. PHP converts entries with intval, removes duplicates and zero, then checks the 1–10 count.
     """
 
 
@@ -551,8 +547,22 @@ class SaveTemplateContentRequest(WireModel):
                     "items": {"$ref": "#/$defs/TemplateWriteModule"},
                     "$defs": {
                         "TemplateWriteModule": {
+                            "properties": {
+                                "name": {"$ref": "#/$defs/TemplateWriteName"},
+                                "type": {"not": {"const": "0"}},
+                            },
                             "allOf": [
                                 {"$ref": "#/$defs/TemplateModule"},
+                                {
+                                    "if": {"properties": {"type": {"enum": ["form", "table"]}}, "required": ["type"]},
+                                    "then": {
+                                        "properties": {
+                                            "data": {
+                                                "items": {"properties": {"name": {"$ref": "#/$defs/TemplateWriteName"}}}
+                                            }
+                                        }
+                                    },
+                                },
                                 {
                                     "if": {
                                         "properties": {
@@ -576,6 +586,14 @@ class SaveTemplateContentRequest(WireModel):
                             ],
                             "description": "Template-save input. Non-null styled JSON code must carry JSON text;\nthe decoded JSON may have any JSON type. This write-only constraint\ndoes not apply to raw code returned from record or template reads.\n",
                         },
+                        "TemplateWriteName": {
+                            "type": "string",
+                            "pattern": "[^ \\t\\n\\r\\u0000\\u000b]",
+                            "not": {
+                                "pattern": "^[ \\t\\n\\r\\f\\v]*[+-]?(?:[0-9]+(?:\\.[0-9]*)?|\\.[0-9]+)(?:[eE][+-]?[0-9]+)?[ \\t\\n\\r\\f\\v]*$"
+                            },
+                            "description": "Template saving rejects names that are empty after PHP trim, numeric, or duplicates in their containing module, column or field list.",
+                        },
                         "TemplateModule": {
                             "type": "object",
                             "required": ["name", "type"],
@@ -583,16 +601,15 @@ class SaveTemplateContentRequest(WireModel):
                                 "name": {
                                     "type": "string",
                                     "minLength": 1,
-                                    "pattern": ".*[^0-9.\\-+eE ].*",
-                                    "description": "PHP trims the name, rejects an empty or purely numeric value, and\nrejects duplicate names across the module array.\n",
+                                    "description": "Stored module name. Record updates can create numeric names; template-save name checks apply only to TemplateWriteModule.",
                                 },
                                 "type": {"type": "string", "minLength": 1},
                                 "data": {
-                                    "type": ["object", "array", "string", "number", "boolean", "null"],
+                                    "type": ["object", "array", "string", "integer", "number", "boolean", "null"],
                                     "description": "Runtime requirements depend on the target module type.",
                                     "nullable": True,
                                 },
-                                "language": {"type": "string"},
+                                "language": {},
                                 "style": {},
                             },
                             "allOf": [
@@ -616,7 +633,11 @@ class SaveTemplateContentRequest(WireModel):
                                 },
                                 {
                                     "if": {
-                                        "properties": {"type": {"const": "code"}, "language": {"const": "json"}},
+                                        "properties": {
+                                            "type": {"const": "code"},
+                                            "language": {"const": "json"},
+                                            "style": {"not": {"type": "null"}},
+                                        },
                                         "required": ["type", "language", "style"],
                                     },
                                     "then": {
@@ -637,12 +658,7 @@ class SaveTemplateContentRequest(WireModel):
                             "type": "object",
                             "required": ["name", "type", "data"],
                             "properties": {
-                                "name": {
-                                    "type": "string",
-                                    "minLength": 1,
-                                    "pattern": ".*[^0-9.\\-+eE ].*",
-                                    "description": "PHP also rejects duplicate names within the table.",
-                                },
+                                "name": {"type": "string", "minLength": 1},
                                 "type": {"type": "string"},
                                 "data": {"type": "array"},
                             },
@@ -669,7 +685,7 @@ class SaveTemplateContentRequest(WireModel):
                                                 "type": "array",
                                                 "items": {
                                                     "oneOf": [
-                                                        {"type": "number"},
+                                                        {"type": ["integer", "number"]},
                                                         {
                                                             "type": "string",
                                                             "pattern": "^[+-]?(?:[0-9]+(?:\\.[0-9]*)?|\\.[0-9]+)(?:[eE][+-]?[0-9]+)?$",
@@ -739,14 +755,7 @@ class SaveTemplateContentRequest(WireModel):
                         "TemplateFormItem": {
                             "type": "object",
                             "required": ["name"],
-                            "properties": {
-                                "name": {
-                                    "type": "string",
-                                    "minLength": 1,
-                                    "pattern": ".*[^0-9.\\-+eE ].*",
-                                    "description": "PHP also rejects duplicate names within the form.",
-                                }
-                            },
+                            "properties": {"name": {"type": "string", "minLength": 1}},
                             "additionalProperties": True,
                         },
                     },
@@ -782,6 +791,25 @@ class UpdateTemplateIntroRequest(WireModel):
     uid: Annotated[str, Field(min_length=1)]
 
 
+class TemplateWriteName(RootModel[str]):
+    root: Annotated[
+        str,
+        Field(
+            json_schema_extra={
+                "matelab-runtime-rules": {
+                    "not": {
+                        "pattern": "^[ \\t\\n\\r\\f\\v]*[+-]?(?:[0-9]+(?:\\.[0-9]*)?|\\.[0-9]+)(?:[eE][+-]?[0-9]+)?[ \\t\\n\\r\\f\\v]*$"
+                    }
+                }
+            },
+            pattern="[^ \\t\\n\\r\\u0000\\u000b]",
+        ),
+    ]
+    """
+    Template saving rejects names that are empty after PHP trim, numeric, or duplicates in their containing module, column or field list.
+    """
+
+
 class TemplateModule(WireModel):
     model_config = ConfigDict(
         extra="allow",
@@ -804,7 +832,11 @@ class TemplateModule(WireModel):
                     },
                     {
                         "if": {
-                            "properties": {"type": {"const": "code"}, "language": {"const": "json"}},
+                            "properties": {
+                                "type": {"const": "code"},
+                                "language": {"const": "json"},
+                                "style": {"not": {"type": "null"}},
+                            },
                             "required": ["type", "language", "style"],
                         },
                         "then": {
@@ -824,12 +856,7 @@ class TemplateModule(WireModel):
                         "type": "object",
                         "required": ["name", "type", "data"],
                         "properties": {
-                            "name": {
-                                "type": "string",
-                                "minLength": 1,
-                                "pattern": ".*[^0-9.\\-+eE ].*",
-                                "description": "PHP also rejects duplicate names within the table.",
-                            },
+                            "name": {"type": "string", "minLength": 1},
                             "type": {"type": "string"},
                             "data": {"type": "array"},
                         },
@@ -856,7 +883,7 @@ class TemplateModule(WireModel):
                                             "type": "array",
                                             "items": {
                                                 "oneOf": [
-                                                    {"type": "number"},
+                                                    {"type": ["integer", "number"]},
                                                     {
                                                         "type": "string",
                                                         "pattern": "^[+-]?(?:[0-9]+(?:\\.[0-9]*)?|\\.[0-9]+)(?:[eE][+-]?[0-9]+)?$",
@@ -926,32 +953,23 @@ class TemplateModule(WireModel):
                     "TemplateFormItem": {
                         "type": "object",
                         "required": ["name"],
-                        "properties": {
-                            "name": {
-                                "type": "string",
-                                "minLength": 1,
-                                "pattern": ".*[^0-9.\\-+eE ].*",
-                                "description": "PHP also rejects duplicate names within the form.",
-                            }
-                        },
+                        "properties": {"name": {"type": "string", "minLength": 1}},
                         "additionalProperties": True,
                     },
                 },
             }
         },
     )
-    name: Annotated[str, Field(min_length=1, pattern=".*[^0-9.\\-+eE ].*")]
+    name: Annotated[str, Field(min_length=1)]
     """
-    PHP trims the name, rejects an empty or purely numeric value, and
-    rejects duplicate names across the module array.
-
+    Stored module name. Record updates can create numeric names; template-save name checks apply only to TemplateWriteModule.
     """
     type: Annotated[str, Field(min_length=1)]
-    data: dict[str, Any] | list[Any] | str | StrictFloat | StrictBool | None = None
+    data: dict[str, Any] | list[Any] | str | StrictInt | StrictFloat | StrictBool | None = None
     """
     Runtime requirements depend on the target module type.
     """
-    language: str | None = None
+    language: Any | None = None
     style: Any | None = None
 
 
@@ -980,7 +998,7 @@ class TemplateTableColumn(WireModel):
                                     "type": "array",
                                     "items": {
                                         "oneOf": [
-                                            {"type": "number"},
+                                            {"type": ["integer", "number"]},
                                             {
                                                 "type": "string",
                                                 "pattern": "^[+-]?(?:[0-9]+(?:\\.[0-9]*)?|\\.[0-9]+)(?:[eE][+-]?[0-9]+)?$",
@@ -1048,10 +1066,7 @@ class TemplateTableColumn(WireModel):
             }
         },
     )
-    name: Annotated[str, Field(min_length=1, pattern=".*[^0-9.\\-+eE ].*")]
-    """
-    PHP also rejects duplicate names within the table.
-    """
+    name: Annotated[str, Field(min_length=1)]
     type: str
     data: list[Any]
 
@@ -1074,10 +1089,7 @@ class RecordAttachment(WireModel):
 
 class TemplateFormItem(WireModel):
     model_config = ConfigDict(extra="allow")
-    name: Annotated[str, Field(min_length=1, pattern=".*[^0-9.\\-+eE ].*")]
-    """
-    PHP also rejects duplicate names within the form.
-    """
+    name: Annotated[str, Field(min_length=1)]
 
 
 class TemplateContentResponse(WireModel):
@@ -1156,6 +1168,9 @@ class UpdateTemplateIntroResponse(WireModel):
 
 
 class TemplateListItem(WireModel):
+    model_config = ConfigDict(
+        json_schema_extra={"matelab-runtime-rules": {"properties": {"id": {"not": {"type": "null"}}}}}
+    )
     id: Annotated[StrictInt | None, Field(ge=1)] = None
     template_id: Annotated[StrictInt, Field(ge=1)]
     template_name: Annotated[str | None, Field(...)]
@@ -1165,7 +1180,7 @@ class TemplateListItem(WireModel):
 class PendingTemplateListItem(WireModel):
     id: Annotated[StrictInt, Field(ge=1)]
     template_id: Annotated[StrictInt, Field(ge=1)]
-    template_name: Annotated[str | None, Field(...)]
+    template_name: str
     comm: Annotated[str | None, Field(...)]
     userid: Annotated[StrictInt, Field(ge=0, le=0)]
     username: Annotated[str | None, Field(...)]
@@ -1174,7 +1189,7 @@ class PendingTemplateListItem(WireModel):
 class StoreTemplateListItem(WireModel):
     id: Annotated[StrictInt, Field(ge=1)]
     template_id: Annotated[StrictInt, Field(ge=1)]
-    template_name: Annotated[str | None, Field(...)]
+    template_name: str
     comm: Annotated[str | None, Field(...)]
     pub: Annotated[StrictInt, Field(ge=2, le=2)]
     username: Annotated[str | None, Field(...)]
@@ -1213,12 +1228,15 @@ class DefaultTemplateListItem(WireModel):
 class OwnedTemplateListItem(WireModel):
     id: Annotated[StrictInt, Field(ge=1)]
     template_id: Annotated[StrictInt, Field(ge=1)]
-    template_name: Annotated[str | None, Field(...)]
+    template_name: str
     comm: Annotated[str | None, Field(...)]
     intro: Annotated[str | None, Field(...)]
     version: Annotated[StrictInt, Field(ge=0)]
     datetime: Annotated[str | None, Field(...)]
-    keyword: list[Any]
+    keyword: dict[str, Any] | list[Any] | str | StrictInt | StrictFloat | StrictBool
+    """
+    Stored JSON is decoded without type normalization; missing or JSON null becomes an empty array.
+    """
     userid_from: Annotated[StrictInt, Field(ge=0)]
     username: Annotated[str | None, Field(...)]
     idphoto: Annotated[str | None, Field(...)]
@@ -1328,7 +1346,7 @@ class SaveNotebookRequest(WireModel):
                             "required": ["uid", "path"],
                             "properties": {
                                 "uid": {
-                                    "type": ["object", "array", "string", "number", "boolean"],
+                                    "type": ["object", "array", "string", "integer", "number", "boolean"],
                                     "description": "Non-null display alias; PHP compares aliases loosely for uniqueness.",
                                 },
                                 "path": {"$ref": "#/$defs/ExtractionPath"},
@@ -1346,10 +1364,14 @@ class SaveNotebookRequest(WireModel):
                                 {"$ref": "#/$defs/ExtractionPathName"},
                             ],
                             "items": False,
-                            "description": "SQL extraction path used by search, quote and notebook list-display\nrequests. The first three segments select names or non-negative\nindices; a fourth segment selects a non-numeric property name.\nSelectors must address the current module structure; invalid SQL JSON\npaths still produce a business error.\n",
+                            "description": "SQL extraction path used by search, quote and notebook list-display\nrequests. The first three segments select names or numeric indices,\nincluding numeric-string indices; a fourth segment selects a non-numeric property name.\nSelectors must address the current module structure; invalid SQL JSON\npaths still produce a business error.\n",
                         },
                         "ExtractionPathSelector": {
-                            "oneOf": [{"$ref": "#/$defs/ExtractionPathName"}, {"type": "integer", "minimum": 0}]
+                            "oneOf": [
+                                {"type": "string", "pattern": "[^ \\t\\n\\r\\u0000\\u000b]"},
+                                {"type": ["integer", "number"], "exclusiveMinimum": -1},
+                            ],
+                            "description": "PHP treats numeric strings and numbers as indices, truncates them toward\nzero, and rejects a negative resulting index. Non-numeric strings select\nnames and must remain non-empty after PHP trim. Numeric-string range\nvalidation is performed by the Provider.\n",
                         },
                         "ExtractionPathName": {
                             "type": "string",
@@ -1357,7 +1379,7 @@ class SaveNotebookRequest(WireModel):
                             "not": {
                                 "pattern": "^[ \\t\\n\\r\\f\\v]*[+-]?(?:[0-9]+(?:\\.[0-9]*)?|\\.[0-9]+)(?:[eE][+-]?[0-9]+)?[ \\t\\n\\r\\f\\v]*$"
                             },
-                            "description": "A name that remains non-empty after PHP trim and is not a PHP numeric\nstring. Numeric selectors use JSON integers in this callable subset.\n",
+                            "description": "A name that remains non-empty after PHP trim and is not a PHP numeric\nstring. The fourth extraction-path segment uses this name form.\n",
                         },
                     },
                 },
@@ -1368,8 +1390,9 @@ class SaveNotebookRequest(WireModel):
     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. Uids must be non-null and unique
-    under PHP's loose comparison; indices use JSON integers and the
-    fourth path segment is a non-numeric property name.
+    under PHP's loose comparison; the fourth path segment is a
+    non-numeric property name. Numeric selectors
+    in the first three positions are converted to integers by PHP.
 
     """
     group_id: Annotated[StrictInt | None, Field(ge=0)] = 0
@@ -1389,20 +1412,15 @@ class AddNotebookShareRequest(WireModel):
         Field(
             json_schema_extra={
                 "contentMediaType": "application/json",
-                "contentSchema": {
-                    "type": "array",
-                    "minItems": 1,
-                    "uniqueItems": True,
-                    "items": {"type": "integer", "minimum": 1},
-                },
+                "contentSchema": {"type": "array", "minItems": 1, "items": {"type": "integer", "minimum": 1}},
             },
             min_length=1,
         ),
     ]
     """
-    JSON-encoded user-id list. The current 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.
+    JSON-encoded user ids. PHP converts entries with intval, removes zero
+    and duplicates, then applies its self/already-shared filter. An empty
+    recipient list after these filters is rejected.
 
     """
 
@@ -1441,7 +1459,9 @@ class PublicRecordListRequest(WireModel):
 class CreateRecordRequest(WireModel):
     model_config = ConfigDict(extra="forbid")
     eln: Annotated[str, Field(min_length=1)]
-    title: Annotated[str, Field(max_length=100, min_length=1)]
+    title: Annotated[
+        str, Field(json_schema_extra={"matelab-runtime-rules": {"not": {"const": "0"}}}, max_length=100, min_length=1)
+    ]
     describe: Annotated[str | None, Field(max_length=256)] = ""
     """
     Missing or null becomes an empty summary.
@@ -1450,9 +1470,9 @@ class CreateRecordRequest(WireModel):
     """
     Missing, null, or empty asks the data server to generate a UID.
     """
-    user: Annotated[StrictInt | None, Field(ge=1)] = None
+    user: conint(ge=0, strict=True) | str | None = None
     """
-    Missing or null selects the authenticated user's notebook.
+    Owner userid, canonical numeric-id string, or email. Missing, null, zero, or empty selects the authenticated user's notebook.
     """
     path: list[str] | None = None
     """
@@ -1462,9 +1482,13 @@ class CreateRecordRequest(WireModel):
 
 class ImportRecordItem(WireModel):
     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]
+    uid: Annotated[
+        str, Field(json_schema_extra={"matelab-runtime-rules": {"not": {"const": "0"}}}, max_length=45, min_length=1)
+    ]
+    title: Annotated[
+        str, Field(json_schema_extra={"matelab-runtime-rules": {"not": {"const": "0"}}}, max_length=100, min_length=1)
+    ]
+    data: dict[str, Any] | list[Any]
     """
     Template-shaped values keyed by canonical module name. File fields
     and cells supplied by the request contain string references; omit a
@@ -1472,6 +1496,8 @@ class ImportRecordItem(WireModel):
     file entries and inline base64 are not callable on the current
     Provider. The selected template determines which values require
     file-reference validation; arbitrary text fields are unaffected.
+    PHP also accepts a JSON list; entries without a matching module name
+    are ignored and the corresponding template defaults remain unchanged.
 
     """
     keyword: str | None = ""
@@ -1552,17 +1578,42 @@ class ExtractionPathName(RootModel[str]):
     ]
     """
     A name that remains non-empty after PHP trim and is not a PHP numeric
-    string. Numeric selectors use JSON integers in this callable subset.
+    string. The fourth extraction-path segment uses this name form.
 
     """
 
 
-class ExtractionPathSelector1(RootModel[StrictInt]):
-    root: Annotated[StrictInt, Field(ge=0)]
+class ExtractionPathSelector1(RootModel[str]):
+    root: Annotated[str, Field(pattern="[^ \\t\\n\\r\\u0000\\u000b]")]
+    """
+    PHP treats numeric strings and numbers as indices, truncates them toward
+    zero, and rejects a negative resulting index. Non-numeric strings select
+    names and must remain non-empty after PHP trim. Numeric-string range
+    validation is performed by the Provider.
 
+    """
+
+
+class ExtractionPathSelector2(RootModel[conint(gt=-1, strict=True) | confloat(gt=-1.0, strict=True)]):
+    root: conint(gt=-1, strict=True) | confloat(gt=-1.0, strict=True)
+    """
+    PHP treats numeric strings and numbers as indices, truncates them toward
+    zero, and rejects a negative resulting index. Non-numeric strings select
+    names and must remain non-empty after PHP trim. Numeric-string range
+    validation is performed by the Provider.
+
+    """
+
+
+class ExtractionPathSelector(RootModel[ExtractionPathSelector1 | ExtractionPathSelector2]):
+    root: ExtractionPathSelector1 | ExtractionPathSelector2
+    """
+    PHP treats numeric strings and numbers as indices, truncates them toward
+    zero, and rejects a negative resulting index. Non-numeric strings select
+    names and must remain non-empty after PHP trim. Numeric-string range
+    validation is performed by the Provider.
 
-class ExtractionPathSelector(RootModel[ExtractionPathName | ExtractionPathSelector1]):
-    root: ExtractionPathName | ExtractionPathSelector1
+    """
 
 
 class ExtractionPath(RootModel[list[ExtractionPathSelector | ExtractionPathName]]):
@@ -1580,7 +1631,11 @@ class ExtractionPath(RootModel[list[ExtractionPathSelector | ExtractionPathName]
                     "items": False,
                     "$defs": {
                         "ExtractionPathSelector": {
-                            "oneOf": [{"$ref": "#/$defs/ExtractionPathName"}, {"type": "integer", "minimum": 0}]
+                            "oneOf": [
+                                {"type": "string", "pattern": "[^ \\t\\n\\r\\u0000\\u000b]"},
+                                {"type": ["integer", "number"], "exclusiveMinimum": -1},
+                            ],
+                            "description": "PHP treats numeric strings and numbers as indices, truncates them toward\nzero, and rejects a negative resulting index. Non-numeric strings select\nnames and must remain non-empty after PHP trim. Numeric-string range\nvalidation is performed by the Provider.\n",
                         },
                         "ExtractionPathName": {
                             "type": "string",
@@ -1588,7 +1643,7 @@ class ExtractionPath(RootModel[list[ExtractionPathSelector | ExtractionPathName]
                             "not": {
                                 "pattern": "^[ \\t\\n\\r\\f\\v]*[+-]?(?:[0-9]+(?:\\.[0-9]*)?|\\.[0-9]+)(?:[eE][+-]?[0-9]+)?[ \\t\\n\\r\\f\\v]*$"
                             },
-                            "description": "A name that remains non-empty after PHP trim and is not a PHP numeric\nstring. Numeric selectors use JSON integers in this callable subset.\n",
+                            "description": "A name that remains non-empty after PHP trim and is not a PHP numeric\nstring. The fourth extraction-path segment uses this name form.\n",
                         },
                     },
                 }
@@ -1599,8 +1654,8 @@ class ExtractionPath(RootModel[list[ExtractionPathSelector | ExtractionPathName]
     ]
     """
     SQL extraction path used by search, quote and notebook list-display
-    requests. The first three segments select names or non-negative
-    indices; a fourth segment selects a non-numeric property name.
+    requests. The first three segments select names or numeric indices,
+    including numeric-string indices; a fourth segment selects a non-numeric property name.
     Selectors must address the current module structure; invalid SQL JSON
     paths still produce a business error.
 
@@ -1609,7 +1664,7 @@ class ExtractionPath(RootModel[list[ExtractionPathSelector | ExtractionPathName]
 
 class NotebookExtractionRequest(WireModel):
     model_config = ConfigDict(extra="forbid")
-    uid: dict[str, Any] | list[Any] | str | StrictFloat | StrictBool
+    uid: dict[str, Any] | list[Any] | str | StrictInt | StrictFloat | StrictBool
     """
     Non-null display alias; PHP compares aliases loosely for uniqueness.
     """
@@ -1631,10 +1686,14 @@ class NotebookExtractionRequest(WireModel):
                                 {"$ref": "#/$defs/ExtractionPathName"},
                             ],
                             "items": False,
-                            "description": "SQL extraction path used by search, quote and notebook list-display\nrequests. The first three segments select names or non-negative\nindices; a fourth segment selects a non-numeric property name.\nSelectors must address the current module structure; invalid SQL JSON\npaths still produce a business error.\n",
+                            "description": "SQL extraction path used by search, quote and notebook list-display\nrequests. The first three segments select names or numeric indices,\nincluding numeric-string indices; a fourth segment selects a non-numeric property name.\nSelectors must address the current module structure; invalid SQL JSON\npaths still produce a business error.\n",
                         },
                         "ExtractionPathSelector": {
-                            "oneOf": [{"$ref": "#/$defs/ExtractionPathName"}, {"type": "integer", "minimum": 0}]
+                            "oneOf": [
+                                {"type": "string", "pattern": "[^ \\t\\n\\r\\u0000\\u000b]"},
+                                {"type": ["integer", "number"], "exclusiveMinimum": -1},
+                            ],
+                            "description": "PHP treats numeric strings and numbers as indices, truncates them toward\nzero, and rejects a negative resulting index. Non-numeric strings select\nnames and must remain non-empty after PHP trim. Numeric-string range\nvalidation is performed by the Provider.\n",
                         },
                         "ExtractionPathName": {
                             "type": "string",
@@ -1642,7 +1701,7 @@ class NotebookExtractionRequest(WireModel):
                             "not": {
                                 "pattern": "^[ \\t\\n\\r\\f\\v]*[+-]?(?:[0-9]+(?:\\.[0-9]*)?|\\.[0-9]+)(?:[eE][+-]?[0-9]+)?[ \\t\\n\\r\\f\\v]*$"
                             },
-                            "description": "A name that remains non-empty after PHP trim and is not a PHP numeric\nstring. Numeric selectors use JSON integers in this callable subset.\n",
+                            "description": "A name that remains non-empty after PHP trim and is not a PHP numeric\nstring. The fourth extraction-path segment uses this name form.\n",
                         },
                     },
                 }
@@ -1685,10 +1744,14 @@ class SearchExtractionRequest(WireModel):
                                 {"$ref": "#/$defs/ExtractionPathName"},
                             ],
                             "items": False,
-                            "description": "SQL extraction path used by search, quote and notebook list-display\nrequests. The first three segments select names or non-negative\nindices; a fourth segment selects a non-numeric property name.\nSelectors must address the current module structure; invalid SQL JSON\npaths still produce a business error.\n",
+                            "description": "SQL extraction path used by search, quote and notebook list-display\nrequests. The first three segments select names or numeric indices,\nincluding numeric-string indices; a fourth segment selects a non-numeric property name.\nSelectors must address the current module structure; invalid SQL JSON\npaths still produce a business error.\n",
                         },
                         "ExtractionPathSelector": {
-                            "oneOf": [{"$ref": "#/$defs/ExtractionPathName"}, {"type": "integer", "minimum": 0}]
+                            "oneOf": [
+                                {"type": "string", "pattern": "[^ \\t\\n\\r\\u0000\\u000b]"},
+                                {"type": ["integer", "number"], "exclusiveMinimum": -1},
+                            ],
+                            "description": "PHP treats numeric strings and numbers as indices, truncates them toward\nzero, and rejects a negative resulting index. Non-numeric strings select\nnames and must remain non-empty after PHP trim. Numeric-string range\nvalidation is performed by the Provider.\n",
                         },
                         "ExtractionPathName": {
                             "type": "string",
@@ -1696,7 +1759,7 @@ class SearchExtractionRequest(WireModel):
                             "not": {
                                 "pattern": "^[ \\t\\n\\r\\f\\v]*[+-]?(?:[0-9]+(?:\\.[0-9]*)?|\\.[0-9]+)(?:[eE][+-]?[0-9]+)?[ \\t\\n\\r\\f\\v]*$"
                             },
-                            "description": "A name that remains non-empty after PHP trim and is not a PHP numeric\nstring. Numeric selectors use JSON integers in this callable subset.\n",
+                            "description": "A name that remains non-empty after PHP trim and is not a PHP numeric\nstring. The fourth extraction-path segment uses this name form.\n",
                         },
                     },
                 }
@@ -1736,10 +1799,14 @@ class QuoteRequest(WireModel):
                                 {"$ref": "#/$defs/ExtractionPathName"},
                             ],
                             "items": False,
-                            "description": "SQL extraction path used by search, quote and notebook list-display\nrequests. The first three segments select names or non-negative\nindices; a fourth segment selects a non-numeric property name.\nSelectors must address the current module structure; invalid SQL JSON\npaths still produce a business error.\n",
+                            "description": "SQL extraction path used by search, quote and notebook list-display\nrequests. The first three segments select names or numeric indices,\nincluding numeric-string indices; a fourth segment selects a non-numeric property name.\nSelectors must address the current module structure; invalid SQL JSON\npaths still produce a business error.\n",
                         },
                         "ExtractionPathSelector": {
-                            "oneOf": [{"$ref": "#/$defs/ExtractionPathName"}, {"type": "integer", "minimum": 0}]
+                            "oneOf": [
+                                {"type": "string", "pattern": "[^ \\t\\n\\r\\u0000\\u000b]"},
+                                {"type": ["integer", "number"], "exclusiveMinimum": -1},
+                            ],
+                            "description": "PHP treats numeric strings and numbers as indices, truncates them toward\nzero, and rejects a negative resulting index. Non-numeric strings select\nnames and must remain non-empty after PHP trim. Numeric-string range\nvalidation is performed by the Provider.\n",
                         },
                         "ExtractionPathName": {
                             "type": "string",
@@ -1747,7 +1814,7 @@ class QuoteRequest(WireModel):
                             "not": {
                                 "pattern": "^[ \\t\\n\\r\\f\\v]*[+-]?(?:[0-9]+(?:\\.[0-9]*)?|\\.[0-9]+)(?:[eE][+-]?[0-9]+)?[ \\t\\n\\r\\f\\v]*$"
                             },
-                            "description": "A name that remains non-empty after PHP trim and is not a PHP numeric\nstring. Numeric selectors use JSON integers in this callable subset.\n",
+                            "description": "A name that remains non-empty after PHP trim and is not a PHP numeric\nstring. The fourth extraction-path segment uses this name form.\n",
                         },
                     },
                 }
@@ -1819,7 +1886,9 @@ class Data(WireModel):
 
 
 class AppendFilesModuleStagedAttachmentOperation(WireModel):
-    model_config = ConfigDict(extra="forbid")
+    model_config = ConfigDict(
+        extra="forbid", json_schema_extra={"matelab-runtime-rules": {"properties": {"path": {"not": {"type": "null"}}}}}
+    )
     module: Annotated[str, Field(min_length=1)]
     path: Annotated[list[PathItem3] | None, Field(min_length=1)] = None
     """
@@ -1895,14 +1964,6 @@ class DeleteWholeFileTableColumnOperation(WireModel):
     ]
 
 
-class User2(RootModel[StrictInt]):
-    root: Annotated[StrictInt, Field(ge=1)] = None
-
-
-class User3(RootModel[str]):
-    root: Annotated[str, Field(min_length=1)] = None
-
-
 class ModifyItem(WireModel):
     path: Annotated[list[str | StrictInt], Field(min_length=1)]
     data: Annotated[Any, Field(json_schema_extra={"matelab-runtime-rules": {"not": {"type": "null"}}})]
@@ -1925,34 +1986,6 @@ class Type(StrEnum):
     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(WireModel):
     model_config = ConfigDict(
         extra="forbid",
@@ -1961,7 +1994,7 @@ class AddModuleOperation(WireModel):
                 "allOf": [
                     {
                         "if": {"properties": {"type": {"enum": ["richtext", "code"]}}, "required": ["type"]},
-                        "then": {"properties": {"data": {"default": ""}}},
+                        "then": {"properties": {"data": {"type": ["string", "null"], "default": "", "nullable": True}}},
                     },
                     {
                         "if": {"properties": {"type": {"const": "code"}}, "required": ["type"]},
@@ -1988,13 +2021,28 @@ class AddModuleOperation(WireModel):
                             },
                         },
                     },
+                    {
+                        "if": {
+                            "properties": {"type": {"const": "code"}, "language": {"const": "json"}},
+                            "required": ["type", "language"],
+                        },
+                        "then": {
+                            "properties": {
+                                "style": {
+                                    "type": ["string", "null"],
+                                    "enum": ["ternary", "echarts", None],
+                                    "nullable": True,
+                                }
+                            }
+                        },
+                    },
                 ]
             }
         },
     )
     name: Annotated[str, Field(min_length=1)]
     type: Type
-    data: str | None = None
+    data: Any | None = None
     """
     Initial content for richtext and code modules. Omitted or null becomes
     an empty string; every explicit string, including empty and "0", is
@@ -2002,36 +2050,36 @@ class AddModuleOperation(WireModel):
     Other module types initialize an empty array and ignore this field.
 
     """
-    language: Language | None = None
-    style: Style | None = None
+    language: Any = None
+    """
+    Required and validated only for code modules; ignored by other module types.
+    """
+    style: Any = None
+    """
+    Validated only for JSON code modules; ignored by other languages and module types.
+    """
 
 
 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 AddValueOperation(WireModel):
     model_config = ConfigDict(extra="forbid")
     module: Module | StrictInt
-    name: Annotated[str | None, Field(min_length=1)] = None
-    type: Type1 | None = None
-    row: Annotated[StrictInt | None, Field(ge=-1, le=0)] = None
-    data: dict[str, Any] | list[Any] | str | StrictFloat | StrictBool | None = None
+    name: Any = None
+    """
+    Non-empty string required when adding a form field or table column; ignored when adding a table row or files entry.
+    """
+    type: Any = None
+    """
+    Field/column type checked against the target module's supported types. Ignored when adding a table row or files entry.
+    """
+    row: Any = None
+    """
+    For a table, a non-null value must be integer 0 (prepend) or -1 (append); null or omission adds a column. Ignored by other module types.
+    """
+    data: dict[str, Any] | list[Any] | str | StrictInt | StrictFloat | StrictBool | None = None
     """
     Runtime requirements depend on the target module type.
     """
@@ -2045,7 +2093,10 @@ class DeleteRecordsRequest(WireModel):
     model_config = ConfigDict(extra="forbid")
     eln: Annotated[str, Field(min_length=1)]
     uids: Annotated[list[Uid1], Field(min_length=1)]
-    user: Annotated[StrictInt | None, Field(ge=1)] = None
+    user: conint(ge=0, strict=True) | str | None = None
+    """
+    Owner userid, canonical numeric-id string, or email. Missing, null, zero, or empty selects the authenticated user.
+    """
 
 
 class PublicRecordItem(WireModel):
@@ -2392,7 +2443,7 @@ class ElnNotebook(WireModel):
     trans_username: str
     owner: StrictBool
     userid: Annotated[StrictInt, Field(ge=1)]
-    types: list[Any] | dict[str, Any] | str | StrictFloat | StrictBool
+    types: list[Any] | dict[str, Any] | str | StrictInt | StrictFloat | StrictBool
     """
     Decoded stored JSON. Missing, invalid or JSON null falls back to
     an empty array; other JSON values are returned unchanged. The
@@ -2470,9 +2521,9 @@ class ListRecordsRequest(WireModel):
     """
     Exact `showtext` from an owned or shared notebook.
     """
-    user: Annotated[StrictInt | None, Field(ge=1)] = None
+    user: conint(ge=0, strict=True) | str | None = None
     """
-    Owner userid for a shared notebook; omitted for an owned notebook.
+    Owner userid, canonical numeric-id string, or email. Missing, null, zero, or empty selects the authenticated user's notebook.
     """
     date_start: str | None = ""
     """
@@ -2657,16 +2708,17 @@ class StageTemporaryFileRequest(WireModel):
         extra="forbid",
         json_schema_extra={
             "matelab-runtime-rules": {
+                "properties": {"file": {"not": {"type": "null"}}},
                 "allOf": [
                     {
                         "if": {"required": ["abort"], "properties": {"abort": {"const": 1}}},
                         "then": {
                             "required": ["tempid"],
-                            "properties": {"tempid": {"type": "string", "minLength": 1, "maxLength": 100}},
+                            "properties": {"tempid": {"type": "string", "minLength": 1, "maxLength": 45}},
                         },
                         "else": {"required": ["file"]},
                     }
-                ]
+                ],
             }
         },
     )
@@ -2677,7 +2729,7 @@ class StageTemporaryFileRequest(WireModel):
     temporary row id. Never stage more than one file under one uid.
 
     """
-    tempid: Annotated[str, Field(max_length=100)] = ""
+    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;
@@ -2691,10 +2743,19 @@ class StageTemporaryFileRequest(WireModel):
     last: Annotated[StrictInt, Field(ge=0, le=1)] = 0
     """
     One marks the final fragment; missing/null/non-integer input is coerced to zero by PHP.
+    """
+    offset: Annotated[StrictInt, Field(ge=0)] = 0
+    """
+    Start at zero; subsequent fragments use the previous successful
+    response's cumulative byte offset. Missing defaults to zero and
+    replaces incomplete bytes. This is not a fragment sequence number.
+    PHP applies intval to supplied values and defaults missing/null to
+    zero; this contract admits only canonical non-negative integers.
+
     """
     abort: Annotated[StrictInt, Field(ge=0, le=1)] = 0
     """
-    One cancels and cleans the matching caller-owned upload session.
+    One removes incomplete bytes; completed staging rows and bytes remain.
     """
     file: bytes | None = None
     """
@@ -2723,7 +2784,11 @@ class StagedTemporaryFileFragmentResponse(WireModel):
 
     """
     hash: Sha256
-    tempid: Annotated[str, Field(max_length=100, min_length=1)]
+    tempid: Annotated[str, Field(max_length=45, min_length=1)]
+    offset: Annotated[StrictInt, Field(ge=0)]
+    """
+    Total bytes acknowledged for this incomplete upload; use as the next request offset.
+    """
 
 
 class StagedTemporaryFileResponse(WireModel):
@@ -2757,7 +2822,7 @@ class StagedTemporaryFileResponse(WireModel):
     """
     Provider-built legacy query string for the temporary file.
     """
-    name: Annotated[str, Field(max_length=100, min_length=1)]
+    name: Annotated[str, Field(max_length=45, min_length=1)]
     """
     The upload-session tempid.
     """
@@ -2770,10 +2835,12 @@ class StagedTemporaryFileResponse(WireModel):
 
 
 class ExtractLiteratureMetadataRequest1(WireModel):
-    model_config = ConfigDict(extra="forbid")
+    model_config = ConfigDict(
+        extra="forbid", json_schema_extra={"matelab-runtime-rules": {"properties": {"doi": {"not": {"type": "null"}}}}}
+    )
     id: Annotated[StrictInt, Field(ge=1)]
     """
-    Caller-owned upload_temp id; zero selects DOI mode.
+    Caller-owned upload_temp id used only when doi is empty. A non-empty doi takes precedence over any id.
     """
     doi: Literal[""] = ""
     """
@@ -2783,9 +2850,9 @@ class ExtractLiteratureMetadataRequest1(WireModel):
 
 class ExtractLiteratureMetadataRequest2(WireModel):
     model_config = ConfigDict(extra="forbid")
-    id: Annotated[StrictInt, Field(ge=0, le=0)] = 0
+    id: Annotated[StrictInt, Field(ge=0)] = 0
     """
-    Caller-owned upload_temp id; zero selects DOI mode.
+    Caller-owned upload_temp id used only when doi is empty. A non-empty doi takes precedence over any id.
     """
     doi: Annotated[str, Field(min_length=1, pattern="^10\\.[0-9]+/\\S+$")]
     """
@@ -2808,7 +2875,14 @@ class ExtractedLiteratureAuthor(WireModel):
 
 
 class SaveLiteratureItemRequest1(WireModel):
-    model_config = ConfigDict(extra="forbid")
+    model_config = ConfigDict(
+        extra="forbid",
+        json_schema_extra={
+            "matelab-runtime-rules": {
+                "properties": {"id": {"not": {"type": "null"}}, "store_id": {"not": {"type": "null"}}}
+            }
+        },
+    )
     id: Annotated[StrictInt, Field(ge=0, le=0)] = 0
     """
     Missing or zero creates; a positive id selects metadata replacement.
@@ -2867,7 +2941,7 @@ class SaveLiteratureItemRequest1(WireModel):
                             "type": "object",
                             "required": [],
                             "properties": {
-                                "year": {"type": ["number", "null"], "default": None, "nullable": True},
+                                "year": {"type": ["integer", "number", "null"], "default": None, "nullable": True},
                                 "volume": {"type": ["string", "null"], "default": None, "nullable": True},
                                 "issue": {"type": ["string", "null"], "default": None, "nullable": True},
                                 "page": {"type": ["string", "null"], "default": None, "nullable": True},
@@ -2942,7 +3016,7 @@ class SaveLiteratureItemRequest2(WireModel):
                             "type": "object",
                             "required": [],
                             "properties": {
-                                "year": {"type": ["number", "null"], "default": None, "nullable": True},
+                                "year": {"type": ["integer", "number", "null"], "default": None, "nullable": True},
                                 "volume": {"type": ["string", "null"], "default": None, "nullable": True},
                                 "issue": {"type": ["string", "null"], "default": None, "nullable": True},
                                 "page": {"type": ["string", "null"], "default": None, "nullable": True},
@@ -2968,36 +3042,29 @@ class ShareLiteratureItemsRequest(WireModel):
         Field(
             json_schema_extra={
                 "contentMediaType": "application/json",
-                "contentSchema": {
-                    "type": "array",
-                    "minItems": 1,
-                    "uniqueItems": True,
-                    "items": {"type": "integer", "minimum": 1},
-                },
+                "contentSchema": {"type": "array", "minItems": 1, "items": {"type": "integer", "minimum": 1}},
             },
             min_length=1,
         ),
     ]
     """
-    JSON-encoded ids from the caller's readable literature list.
+    JSON-encoded ids from the caller's readable literature list. PHP converts entries with intval, removes duplicates and zero, then requires a non-empty result.
     """
     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,
+                "contentSchema": {"type": "array", "items": {"type": "integer", "minimum": 1}},
+            }
         ),
-    ]
+    ] = ""
     """
-    JSON-encoded, existing, non-self recipient user ids returned by searchUsers.
+    JSON-encoded, existing, non-self recipient user ids returned by
+    searchUsers. PHP converts entries with intval and removes duplicates
+    and zero. Missing, empty or an empty list sends no copies and still
+    returns success.
+
     """
     comm: Annotated[StrictInt, Field(ge=0, le=1)] = 0
     """
@@ -3049,7 +3116,7 @@ class ReferenceItem(RootModel[str]):
 
 class LiteratureCitationInfoInput(WireModel):
     model_config = ConfigDict(extra="forbid")
-    year: StrictFloat | None = None
+    year: StrictInt | StrictFloat | None = None
     volume: str | None = None
     issue: str | None = None
     page: str | None = None
@@ -3064,7 +3131,7 @@ class LiteratureContent1(RootModel[list[Any]]):
 
 class LiteratureCitationInfo(WireModel):
     model_config = ConfigDict(extra="allow")
-    year: StrictFloat | None = None
+    year: StrictInt | StrictFloat | None = None
     volume: str | None = None
     issue: str | None = None
     page: str | None = None
@@ -3074,7 +3141,7 @@ class Name(RootModel[list[str]]):
     root: Annotated[list[str], Field(max_length=2, min_length=2)]
 
 
-class Type2(StrEnum):
+class Type1(StrEnum):
     richtext = "richtext"
     text = "text"
     object = "object"
@@ -3087,9 +3154,12 @@ class Comm(RootModel[list[str]]):
 
 
 class LiteratureNestedFieldDefinition(WireModel):
+    model_config = ConfigDict(
+        json_schema_extra={"matelab-runtime-rules": {"properties": {"width": {"not": {"type": "null"}}}}}
+    )
     name: str | Name
     id: Annotated[str, Field(min_length=1)]
-    type: Type2
+    type: Type1
     width: Annotated[StrictInt | None, Field(ge=1)] = None
 
 
@@ -3104,6 +3174,9 @@ class Logical(StrEnum):
 
 
 class LiteratureFieldCondition(WireModel):
+    model_config = ConfigDict(
+        json_schema_extra={"matelab-runtime-rules": {"properties": {"logical": {"not": {"type": "null"}}}}}
+    )
     conditions: Annotated[list[Condition], Field(min_length=1)]
     logical: Logical | None = None
 
@@ -3118,7 +3191,9 @@ class LiteratureComment(WireModel):
 
 
 class SaveLiteratureCommentRequest1(WireModel):
-    model_config = ConfigDict(extra="forbid")
+    model_config = ConfigDict(
+        extra="forbid", json_schema_extra={"matelab-runtime-rules": {"properties": {"id": {"not": {"type": "null"}}}}}
+    )
     id: Annotated[StrictInt, Field(ge=0, le=0)] = 0
     """
     Missing or zero creates; a positive id selects an owner-only edit.
@@ -3232,7 +3307,7 @@ class SubmitTemplateToStoreResponse(RootModel[BasicSuccessResponse | ErrorRespon
 
 
 class SearchUsersParametersQuery(WireModel):
-    keyword: Annotated[str, Field(max_length=100, min_length=2, pattern=".*\\S.*")]
+    keyword: Annotated[str, Field(pattern="[^\\x00-\\x7f]|[\\s\\S]{2}")]
     all: Annotated[StrictInt, Field(ge=0, le=1)] = 0
 
 
@@ -3301,7 +3376,7 @@ class ListNotebookRecordPageParametersQuery(WireModel):
 class ListDeletedRecordPageParametersQuery(WireModel):
     eln: Annotated[StrictInt, Field(ge=1)]
     page: Annotated[StrictInt, Field(ge=1)] = 1
-    page_size: Annotated[StrictInt, Field(ge=1)] = 24
+    page_size: Annotated[StrictInt, Field(ge=0)] = 24
 
 
 class RestoreDeletedRecordsResponse(RootModel[BasicSuccessResponse | ErrorResponse]):
@@ -3376,11 +3451,7 @@ class ListLiteratureItemsParametersQuery(WireModel):
         Field(
             json_schema_extra={
                 "contentMediaType": "application/json",
-                "contentSchema": {
-                    "type": "array",
-                    "uniqueItems": True,
-                    "items": {"type": "integer", "minimum": 1, "maximum": 3},
-                },
+                "contentSchema": {"type": "array", "items": {"type": "integer", "minimum": 1, "maximum": 3}},
             }
         ),
     ] = ""
@@ -3389,11 +3460,7 @@ class ListLiteratureItemsParametersQuery(WireModel):
         Field(
             json_schema_extra={
                 "contentMediaType": "application/json",
-                "contentSchema": {
-                    "type": "array",
-                    "uniqueItems": True,
-                    "items": {"type": "integer", "minimum": 1, "maximum": 5},
-                },
+                "contentSchema": {"type": "array", "items": {"type": "integer", "minimum": 1, "maximum": 5}},
             }
         ),
     ] = ""
@@ -3402,7 +3469,7 @@ class ListLiteratureItemsParametersQuery(WireModel):
         Field(
             json_schema_extra={
                 "contentMediaType": "application/json",
-                "contentSchema": {"type": "array", "uniqueItems": True, "items": {"type": "string"}},
+                "contentSchema": {"type": "array", "items": {"type": "string"}},
             }
         ),
     ] = ""
@@ -3537,6 +3604,9 @@ class CloudDriveFileListResponse(WireModel):
 
 
 class AppMenu(WireModel):
+    model_config = ConfigDict(
+        json_schema_extra={"matelab-runtime-rules": {"properties": {"order": {"not": {"type": "null"}}}}}
+    )
     uid: str
     order: StrictInt | None = None
     """
@@ -3643,8 +3713,17 @@ class TemplateWriteModule(TemplateModule):
     model_config = ConfigDict(
         json_schema_extra={
             "matelab-runtime-rules": {
+                "properties": {"name": {"not": {"type": "null"}}},
                 "allOf": [
                     {"$ref": "#/$defs/TemplateModule"},
+                    {
+                        "if": {"properties": {"type": {"enum": ["form", "table"]}}, "required": ["type"]},
+                        "then": {
+                            "properties": {
+                                "data": {"items": {"properties": {"name": {"$ref": "#/$defs/TemplateWriteName"}}}}
+                            }
+                        },
+                    },
                     {
                         "if": {
                             "properties": {
@@ -3670,16 +3749,15 @@ class TemplateWriteModule(TemplateModule):
                             "name": {
                                 "type": "string",
                                 "minLength": 1,
-                                "pattern": ".*[^0-9.\\-+eE ].*",
-                                "description": "PHP trims the name, rejects an empty or purely numeric value, and\nrejects duplicate names across the module array.\n",
+                                "description": "Stored module name. Record updates can create numeric names; template-save name checks apply only to TemplateWriteModule.",
                             },
                             "type": {"type": "string", "minLength": 1},
                             "data": {
-                                "type": ["object", "array", "string", "number", "boolean", "null"],
+                                "type": ["object", "array", "string", "integer", "number", "boolean", "null"],
                                 "description": "Runtime requirements depend on the target module type.",
                                 "nullable": True,
                             },
-                            "language": {"type": "string"},
+                            "language": {},
                             "style": {},
                         },
                         "allOf": [
@@ -3703,7 +3781,11 @@ class TemplateWriteModule(TemplateModule):
                             },
                             {
                                 "if": {
-                                    "properties": {"type": {"const": "code"}, "language": {"const": "json"}},
+                                    "properties": {
+                                        "type": {"const": "code"},
+                                        "language": {"const": "json"},
+                                        "style": {"not": {"type": "null"}},
+                                    },
                                     "required": ["type", "language", "style"],
                                 },
                                 "then": {
@@ -3724,12 +3806,7 @@ class TemplateWriteModule(TemplateModule):
                         "type": "object",
                         "required": ["name", "type", "data"],
                         "properties": {
-                            "name": {
-                                "type": "string",
-                                "minLength": 1,
-                                "pattern": ".*[^0-9.\\-+eE ].*",
-                                "description": "PHP also rejects duplicate names within the table.",
-                            },
+                            "name": {"type": "string", "minLength": 1},
                             "type": {"type": "string"},
                             "data": {"type": "array"},
                         },
@@ -3756,7 +3833,7 @@ class TemplateWriteModule(TemplateModule):
                                             "type": "array",
                                             "items": {
                                                 "oneOf": [
-                                                    {"type": "number"},
+                                                    {"type": ["integer", "number"]},
                                                     {
                                                         "type": "string",
                                                         "pattern": "^[+-]?(?:[0-9]+(?:\\.[0-9]*)?|\\.[0-9]+)(?:[eE][+-]?[0-9]+)?$",
@@ -3826,20 +3903,42 @@ class TemplateWriteModule(TemplateModule):
                     "TemplateFormItem": {
                         "type": "object",
                         "required": ["name"],
-                        "properties": {
-                            "name": {
-                                "type": "string",
-                                "minLength": 1,
-                                "pattern": ".*[^0-9.\\-+eE ].*",
-                                "description": "PHP also rejects duplicate names within the form.",
-                            }
-                        },
+                        "properties": {"name": {"type": "string", "minLength": 1}},
                         "additionalProperties": True,
                     },
+                    "TemplateWriteName": {
+                        "type": "string",
+                        "pattern": "[^ \\t\\n\\r\\u0000\\u000b]",
+                        "not": {
+                            "pattern": "^[ \\t\\n\\r\\f\\v]*[+-]?(?:[0-9]+(?:\\.[0-9]*)?|\\.[0-9]+)(?:[eE][+-]?[0-9]+)?[ \\t\\n\\r\\f\\v]*$"
+                        },
+                        "description": "Template saving rejects names that are empty after PHP trim, numeric, or duplicates in their containing module, column or field list.",
+                    },
                 },
             }
         }
     )
+    name: Annotated[
+        TemplateWriteName,
+        Field(
+            json_schema_extra={
+                "matelab-runtime-rules": {
+                    "$ref": "#/$defs/TemplateWriteName",
+                    "$defs": {
+                        "TemplateWriteName": {
+                            "type": "string",
+                            "pattern": "[^ \\t\\n\\r\\u0000\\u000b]",
+                            "not": {
+                                "pattern": "^[ \\t\\n\\r\\f\\v]*[+-]?(?:[0-9]+(?:\\.[0-9]*)?|\\.[0-9]+)(?:[eE][+-]?[0-9]+)?[ \\t\\n\\r\\f\\v]*$"
+                            },
+                            "description": "Template saving rejects names that are empty after PHP trim, numeric, or duplicates in their containing module, column or field list.",
+                        }
+                    },
+                }
+            }
+        ),
+    ]
+    type: Annotated[str, Field(json_schema_extra={"matelab-runtime-rules": {"not": {"const": "0"}}}, min_length=1)]
 
 
 class TemplateListResponse(WireModel):
@@ -3963,13 +4062,13 @@ class ImportRecordsRequest(WireModel):
     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[StrictInt | None, Field(ge=1)] = None
+    user: conint(ge=0, strict=True) | str | None = None
     """
-    Missing or null selects the authenticated user.
+    Owner userid, canonical numeric-id string, or email. Missing, null, zero, or empty selects the authenticated user.
     """
-    template_user: Annotated[StrictInt | None, Field(ge=1)] = None
+    template_user: conint(ge=0, strict=True) | str | None = None
     """
-    Missing or null selects the authenticated user.
+    Template owner userid, canonical numeric-id string, or email. Missing, null, zero, or empty selects the authenticated user.
     """
 
 
@@ -4050,7 +4149,10 @@ class UpdateRecordRequest(WireModel):
     model_config = ConfigDict(extra="forbid")
     eln: Annotated[str, Field(min_length=1)]
     uid: Annotated[str, Field(min_length=1)]
-    user: User2 | User3 | None = None
+    user: conint(ge=0, strict=True) | str | None = None
+    """
+    Owner userid, canonical numeric-id string, or email. Missing, null, zero, or empty selects the authenticated user.
+    """
     password: str | None = ""
     quote: list[QuoteRequest] | None = None
     del_: Annotated[list[PathOperation] | None, Field(alias="del")] = None
@@ -4119,6 +4221,14 @@ class RecordPageResponse(WireModel):
 
 
 class DeletedRecordPageResponse(WireModel):
+    model_config = ConfigDict(
+        json_schema_extra={
+            "matelab-runtime-rules": {
+                "properties": {"count": {"not": {"type": "null"}}, "page": {"not": {"type": "null"}}},
+                "dependentRequired": {"count": ["page"], "page": ["count"]},
+            }
+        }
+    )
     code: Annotated[StrictInt, Field(ge=0, le=0)]
     msg: str
     """
@@ -4140,8 +4250,8 @@ class DeletedRecordPageResponse(WireModel):
     """
     items: list[DeletedRecordItem]
     eln: DeletedRecordNotebook
-    count: Annotated[StrictInt, Field(ge=0)]
-    page: Annotated[StrictInt, Field(ge=1)]
+    count: Annotated[StrictInt | None, Field(ge=0)] = None
+    page: Annotated[StrictInt | None, Field(ge=1)] = None
 
 
 class RecordComment(WireModel):
@@ -4430,10 +4540,26 @@ class LiteratureContentObject(WireModel):
 
 
 class LiteratureFieldDefinition(WireModel):
+    model_config = ConfigDict(
+        json_schema_extra={
+            "matelab-runtime-rules": {
+                "properties": {
+                    "group": {"not": {"type": "null"}},
+                    "required": {"not": {"type": "null"}},
+                    "comm": {"not": {"type": "null"}},
+                    "print": {"not": {"type": "null"}},
+                    "template": {"not": {"type": "null"}},
+                    "show": {"not": {"type": "null"}},
+                    "width": {"not": {"type": "null"}},
+                    "condition": {"not": {"type": "null"}},
+                }
+            }
+        }
+    )
     group: str | None = None
     name: str | Name
     id: Annotated[str, Field(min_length=1)]
-    type: Type2
+    type: Type1
     required: StrictBool | None = None
     comm: str | Comm | None = None
     print: str | None = None