Update docs: refine type hints and return types

Adjust various generated API docs to better reflect actual signatures: add explicit return annotations (mostly -> None) for many service methods, generalize kwargs/response types to Any, refine collection element types (e.g. group_users, resolve return), update split_updates return type to return batches of typed dicts, and update an auto-generated WikidataThing sync_time timestamp. These changes improve accuracy and readability of the documentation signatures.

Author: doctorink

docs/knowledge/public/wikidata.md

@@ -250,7 +250,7 @@ Classes
     `repository: str`
     :   Repository of the search result.
 
-`WikidataThing(revision: str, qid: str, modified: datetime.datetime, label: Dict[str, knowledge.base.entity.Label] | None = None, aliases: Dict[str, List[knowledge.base.entity.Label]] | None = None, description: Dict[str, knowledge.base.entity.Description] | None = None, sync_time: datetime.datetime = datetime.datetime(2026, 2, 6, 21, 58, 0, 771075))`
+`WikidataThing(revision: str, qid: str, modified: datetime.datetime, label: Dict[str, knowledge.base.entity.Label] | None = None, aliases: Dict[str, List[knowledge.base.entity.Label]] | None = None, description: Dict[str, knowledge.base.entity.Description] | None = None, sync_time: datetime.datetime = datetime.datetime(2026, 2, 6, 23, 6, 10, 449889))`
 :   WikidataEntity
     -----------
     Generic entity within wikidata.

docs/knowledge/services/asyncio/base.md

@@ -4,7 +4,7 @@ Module knowledge.services.asyncio.base
 Functions
 ---------
 
-`cached_getaddrinfo(host: str, *args, **kwargs) ‑> Any`
+`cached_getaddrinfo(host: str, *args: Any, **kwargs: Any) ‑> Any`
 :   Cached address information.
 
     Parameters
@@ -94,7 +94,7 @@ Classes
     `auth_endpoint: str`
     :   Authentication endpoint.
 
-    `base_auth_url`
+    `base_auth_url: str`
     :   Base authentication URL.
 
     `current_session: knowledge.services.session.RefreshableSession | knowledge.services.session.TimedSession | knowledge.services.session.PermanentSession | None`
@@ -110,10 +110,10 @@ Classes
         WacomServiceException
             Exception if no session is available.
 
-    `service_base_url`
+    `service_base_url: str`
     :   Service endpoint.
 
-    `service_endpoint`
+    `service_endpoint: str`
     :   Service endpoint.
 
     `user_agent: str`
@@ -137,7 +137,7 @@ Classes
         If the session is already closed, the method will not perform any additional
         operations.
 
-    `handle_token(self, force_refresh: bool = False, force_refresh_timeout: float = 120) ‑> Tuple[str, str]`
+    `handle_token(self, force_refresh: bool = False, force_refresh_timeout: float = 120) ‑> Tuple[str, str | None]`
     :   Handles the token and refreshes it if needed.
         
         Parameters
@@ -167,7 +167,7 @@ Classes
             Session. The session is stored in the token manager, and the client is using the session id for further
             calls.
 
-    `logout(self)`
+    `logout(self) ‑> None`
     :   Logs out the user from the current session.
         
         This method handles the removal of the current session from the token manager
@@ -239,7 +239,7 @@ Classes
         WacomServiceException
             Exception if the service returns HTTP error code.
 
-    `use_session(self, session_id: str)`
+    `use_session(self, session_id: str) ‑> None`
     :   Use session.
         Parameters
         ----------
@@ -280,7 +280,7 @@ Classes
         Exception
             If an error occurs during the session closure operation.
 
-    `delete(self, url: str, **kwargs) ‑> knowledge.services.asyncio.base.ResponseData`
+    `delete(self, url: str, **kwargs: Any) ‑> knowledge.services.asyncio.base.ResponseData`
     :   Asynchronously performs an HTTP DELETE request.
         
         This method sends a DELETE request to the specified URL with additional
@@ -301,7 +301,7 @@ Classes
             The response object resulting from the DELETE request. This
             provides access to the response data, status, and headers.
 
-    `get(self, url: str, **kwargs) ‑> knowledge.services.asyncio.base.ResponseData`
+    `get(self, url: str, **kwargs: Any) ‑> knowledge.services.asyncio.base.ResponseData`
     :   Asynchronously sends an HTTP GET request to the specified URL.
         
         This method allows sending GET requests with optional additional parameters
@@ -322,7 +322,7 @@ Classes
             The response object resulting from the get-go request, containing status,
             headers, and body data.
 
-    `patch(self, url: str, **kwargs) ‑> knowledge.services.asyncio.base.ResponseData`
+    `patch(self, url: str, **kwargs: Any) ‑> knowledge.services.asyncio.base.ResponseData`
     :   Asynchronously sends a HTTP PATCH request to the specified URL.
         
         This method is a coroutine that simplifies sending PATCH requests
@@ -345,7 +345,7 @@ Classes
             methods for accessing the content, status, and headers of the HTTP
             response.
 
-    `post(self, url: str, **kwargs) ‑> knowledge.services.asyncio.base.ResponseData`
+    `post(self, url: str, **kwargs: Any) ‑> knowledge.services.asyncio.base.ResponseData`
     :   Sends an asynchronous HTTP POST request to the specified URL with the given parameters.
         
         This method uses the underlying `request` method to perform the HTTP POST
@@ -367,7 +367,7 @@ Classes
         ResponseData
             Represents the response object from the POST request.
 
-    `put(self, url: str, **kwargs) ‑> knowledge.services.asyncio.base.ResponseData`
+    `put(self, url: str, **kwargs: Any) ‑> knowledge.services.asyncio.base.ResponseData`
     :   Asynchronously performs an HTTP PUT request.
         
         The method sends an HTTP PUT request to the specified URL with the given
@@ -385,7 +385,7 @@ Classes
         ResponseData
             The response object returned after the PUT request is completed.
 
-    `request(self, method: Literal['GET', 'POST', 'PUT', 'DELETE', 'PATCH'], url: str, headers: Dict[str, str] | None = None, **kwargs) ‑> knowledge.services.asyncio.base.ResponseData`
+    `request(self, method: Literal['GET', 'POST', 'PUT', 'DELETE', 'PATCH'], url: str, headers: Dict[str, str] | None = None, **kwargs: Any) ‑> knowledge.services.asyncio.base.ResponseData`
     :   Executes an HTTP request using the specified method, URL, headers, and additional options.
         
         Parameters
@@ -424,7 +424,7 @@ Classes
     `close(self) ‑> None`
     :   Release resolver
 
-    `resolve(self, host: str, port: int = 0, family: int = 2)`
+    `resolve(self, host: str, port: int = 0, family: int = 2) ‑> List[Dict[str, Any]]`
     :   Resolves a hostname to a list of address information. This is an asynchronous
         method that fetches the address details for the given hostname. The result
         includes protocol, host address, port, and family information. The family

docs/knowledge/services/asyncio/graph.md

@@ -114,7 +114,7 @@ Classes
         WacomServiceException
             If the graph service returns an error code, and activation failed.
 
-    `add_entity_indexes(self, entity_uri: str, targets: List[Literal['NEL', 'ElasticSearch', 'VectorSearchWord', 'VectorSearchDocument']], auth_key: str | None = None, timeout: int = 60) ‑> Dict[Literal['NEL', 'ElasticSearch', 'VectorSearchWord', 'VectorSearchDocument'], Any]`
+    `add_entity_indexes(self, entity_uri: str, targets: List[Literal['NEL', 'ElasticSearch', 'VectorSearchWord', 'VectorSearchDocument']], auth_key: str | None = None, timeout: int = 60) ‑> Dict[str, Any]`
     :   Updates index targets of an entity. The index targets can be set to "NEL", "ElasticSearch", "VectorSearchWord",
         or "VectorSearchDocument".
         If the target is already set for the entity, there will be no changes.
@@ -188,7 +188,7 @@ Classes
         WacomServiceException
             If the graph service returns an error code
 
-    `create_relation(self, source: str, relation: knowledge.base.ontology.OntologyPropertyReference, target: str, auth_key: str | None = None)`
+    `create_relation(self, source: str, relation: knowledge.base.ontology.OntologyPropertyReference, target: str, auth_key: str | None = None) ‑> None`
     :   Creates a relation for an entity to a source entity.
         
         Parameters
@@ -207,7 +207,7 @@ Classes
         WacomServiceException
             If the graph service returns an error code
 
-    `create_relations_bulk(self, source: str, relations: Dict[knowledge.base.ontology.OntologyPropertyReference, List[str]], auth_key: str | None = None, timeout: int = 60)`
+    `create_relations_bulk(self, source: str, relations: Dict[knowledge.base.ontology.OntologyPropertyReference, List[str]], auth_key: str | None = None, timeout: int = 60) ‑> None`
     :   Creates all the relations for an entity to a source entity.
         
         Parameters
@@ -229,7 +229,7 @@ Classes
         WacomServiceException
             If the graph service returns an error code
 
-    `delete_entities(self, uris: List[str], force: bool = False, auth_key: str | None = None)`
+    `delete_entities(self, uris: List[str], force: bool = False, auth_key: str | None = None) ‑> None`
     :   Delete a list of entities.
         
         Parameters
@@ -248,7 +248,7 @@ Classes
         ValueError
             If more than 100 entities are given
 
-    `delete_entity(self, uri: str, force: bool = False, auth_key: str | None = None)`
+    `delete_entity(self, uri: str, force: bool = False, auth_key: str | None = None) ‑> None`
     :   Deletes an entity.
         
         Parameters
@@ -533,7 +533,7 @@ Classes
         WacomServiceException
             If the graph service returns an error code
 
-    `ontology_update(self, fix: bool = False, auth_key: str | None = None)`
+    `ontology_update(self, fix: bool = False, auth_key: str | None = None) ‑> None`
     :   Update the ontology.
         
         **Remark: **
@@ -575,7 +575,7 @@ Classes
         WacomServiceException
             If the graph service returns an error code
 
-    `remove_entity_indexes(self, entity_uri: str, targets: List[Literal['NEL', 'ElasticSearch', 'VectorSearchWord', 'VectorSearchDocument']], auth_key: str | None = None, timeout: int = 60) ‑> Dict[Literal['NEL', 'ElasticSearch', 'VectorSearchWord', 'VectorSearchDocument'], Any]`
+    `remove_entity_indexes(self, entity_uri: str, targets: List[Literal['NEL', 'ElasticSearch', 'VectorSearchWord', 'VectorSearchDocument']], auth_key: str | None = None, timeout: int = 60) ‑> Dict[str, Any]`
     :   Deletes the search index for a given entity.
         
         Parameters
@@ -850,7 +850,7 @@ Classes
         WacomServiceException
             If the graph service returns an error code.
 
-    `update_entity(self, entity: knowledge.base.ontology.ThingObject, auth_key: str | None = None, timeout: int = 60)`
+    `update_entity(self, entity: knowledge.base.ontology.ThingObject, auth_key: str | None = None, timeout: int = 60) ‑> None`
     :   Updates entity in the graph.
         
         Parameters

docs/knowledge/services/asyncio/users.md

@@ -64,7 +64,7 @@ Classes
         WacomServiceException
             If the tenant service returns an error code.
 
-    `delete_user(self, tenant_key: str, external_id: str, internal_id: str, force: bool = False, timeout: int = 60)`
+    `delete_user(self, tenant_key: str, external_id: str, internal_id: str, force: bool = False, timeout: int = 60) ‑> None`
     :   Deletes user from tenant.
         
         Parameters
@@ -104,7 +104,7 @@ Classes
         user: List[User]
             List of users.
 
-    `update_user(self, tenant_key: str, internal_id: str, external_id: str, meta_data: Dict[str, str] | None = None, roles: List[knowledge.services.users.UserRole] = None, timeout: int = 60)`
+    `update_user(self, tenant_key: str, internal_id: str, external_id: str, meta_data: Dict[str, str] | None = None, roles: List[knowledge.services.users.UserRole] | None = None, timeout: int = 60) ‑> None`
     :   Updates user for a tenant.
         
         Parameters

docs/knowledge/services/group.md

@@ -108,7 +108,7 @@ Classes
 
     ### Instance variables
 
-    `group_users: List`
+    `group_users: List[knowledge.services.users.User]`
     :   List of all users that are part of the group.
 
 `GroupManagementService(service_url: str, application_name: str = 'Group Management Service', service_endpoint: str = 'graph/v1')`
@@ -142,7 +142,7 @@ Classes
 
     ### Methods
 
-    `add_entity_to_group(self, group_id: str, entity_uri: str, auth_key: str | None = None, timeout: int = 60)`
+    `add_entity_to_group(self, group_id: str, entity_uri: str, auth_key: str | None = None, timeout: int = 60) ‑> None`
     :   Adding an entity to a group.
         
         Parameters
@@ -160,7 +160,7 @@ Classes
         WacomServiceException
             If the tenant service returns an error code.
 
-    `add_user_to_group(self, group_id: str, user_id: str, auth_key: str | None = None, timeout: int = 60)`
+    `add_user_to_group(self, group_id: str, user_id: str, auth_key: str | None = None, timeout: int = 60) ‑> None`
     :   Adding a user to a group.
         
         Parameters
@@ -201,7 +201,7 @@ Classes
         WacomServiceException
             If the tenant service returns an error code.
 
-    `delete_group(self, group_id: str, force: bool = False, auth_key: str | None = None, timeout: int = 60)`
+    `delete_group(self, group_id: str, force: bool = False, auth_key: str | None = None, timeout: int = 60) ‑> None`
     :   Delete a group.
         
         Parameters
@@ -241,7 +241,7 @@ Classes
         WacomServiceException
             If the tenant service returns an error code.
 
-    `join_group(self, group_id: str, join_key: str, auth_key: str | None = None, timeout: int = 60)`
+    `join_group(self, group_id: str, join_key: str, auth_key: str | None = None, timeout: int = 60) ‑> None`
     :   User joining a group with his auth token.
         
         Parameters
@@ -259,7 +259,7 @@ Classes
         WacomServiceException
             If the tenant service returns an error code.
 
-    `leave_group(self, group_id: str, auth_key: str | None = None, timeout: int = 60)`
+    `leave_group(self, group_id: str, auth_key: str | None = None, timeout: int = 60) ‑> None`
     :   User leaving a group with his auth token.
         
         Parameters
@@ -296,7 +296,7 @@ Classes
         user:  List[Groups]
             List of groups.
 
-    `remove_entity_to_group(self, group_id: str, entity_uri: str, auth_key: str | None = None, timeout: int = 60)`
+    `remove_entity_to_group(self, group_id: str, entity_uri: str, auth_key: str | None = None, timeout: int = 60) ‑> None`
     :   Remove an entity from group.
         
         Parameters
@@ -314,7 +314,7 @@ Classes
         WacomServiceException
             If the tenant service returns an error code.
 
-    `remove_user_from_group(self, group_id: str, user_id: str, force: bool = False, auth_key: str | None = None, timeout: int = 60)`
+    `remove_user_from_group(self, group_id: str, user_id: str, force: bool = False, auth_key: str | None = None, timeout: int = 60) ‑> None`
     :   Remove a user from a group.
         
         Parameters
@@ -335,7 +335,7 @@ Classes
         WacomServiceException
             If the tenant service returns an error code.
 
-    `update_group(self, group_id: str, name: str, rights: knowledge.base.access.GroupAccessRight = knowledge.base.access.GroupAccessRight, auth_key: str | None = None, timeout: int = 60)`
+    `update_group(self, group_id: str, name: str, rights: knowledge.base.access.GroupAccessRight = [Read], auth_key: str | None = None, timeout: int = 60) ‑> None`
     :   Updates a group.
         
         Parameters

docs/knowledge/services/helper.md

@@ -22,7 +22,7 @@ Functions
     Dict[str, Any]
         The payload for the entity.
 
-`split_updates(updates: Dict[knowledge.base.ontology.OntologyPropertyReference, List[str]], max_operations: int = 30) ‑> Iterator[Dict[str, List[str]]]`
+`split_updates(updates: Dict[knowledge.base.ontology.OntologyPropertyReference, List[str]], max_operations: int = 30) ‑> Iterator[List[Dict[str, str | List[str]]]]`
 :   Parameters
     ----------
     updates: Dict[OntologyPropertyReference, List[str]]
@@ -32,5 +32,5 @@ Functions
 
     Yields
     -------
-    batch: List[Dict[str, List[str]]]
+    batch: List[Dict[str, Union[str, List[str]]]]
         The batch of updates to process.

docs/knowledge/services/tenant.md

@@ -88,7 +88,7 @@ Classes
         WacomServiceException
             If the tenant service returns an error code.
 
-    `delete_tenant(self, identifier: str, timeout: int = 60)`
+    `delete_tenant(self, identifier: str, timeout: int = 60) ‑> None`
     :   Delete a tenant.
         Parameters
         ----------
@@ -120,7 +120,7 @@ Classes
         WacomServiceException
             If the tenant service returns an error code.
 
-    `update_tenant_configuration(self, identifier: str, rights: List[str], vector_search_data_properties: List[str], vector_search_object_properties: List[str], content_data_property_name: str, timeout: int = 60)`
+    `update_tenant_configuration(self, identifier: str, rights: List[str], vector_search_data_properties: List[str], vector_search_object_properties: List[str], content_data_property_name: str, timeout: int = 60) ‑> None`
     :   Update the configuration of a tenant.
         
         Parameters