blaxel 0.2.2rc79__tar.gz → 0.2.4__tar.gz

{blaxel-0.2.2rc79 → blaxel-0.2.4}/Makefile

@@ -1,10 +1,10 @@
 ARGS:= $(wordlist 2,$(words $(MAKECMDGOALS)),$(MAKECMDGOALS))
 
 install:
-	uv sync --all-packages --all-extras --dev
+	uv sync --all-groups --all-packages --all-extras
 
 sdk-sandbox:
-	cp ../sandbox/sandbox-api/docs/openapi.yml ./definition.yml
+	cp ../../sandbox/sandbox-api/docs/openapi.yml ./definition.yml
 	rm -rf src/blaxel/core/sandbox/client/api src/blaxel/core/sandbox/client/models
 	openapi-python-client generate \
 		--path=definition.yml \
@@ -17,7 +17,7 @@ sdk-sandbox:
 	uv run ruff check --fix
 
 sdk-controlplane:
-	cp ../controlplane/api/api/definitions/controlplane.yml ./definition.yml
+	cp ../../controlplane/api/api/definitions/controlplane.yml ./definition.yml
 	rm -rf src/blaxel/core/client/api src/blaxel/core/client/models
 	openapi-python-client generate \
 		--path=definition.yml \
@@ -33,7 +33,7 @@ sdk: sdk-sandbox sdk-controlplane
 
 doc:
 	rm -rf docs
-	uv run pdoc blaxel-docs src/* -o docs --force --skip-errors
+	uv run pdoc blaxel src/* -o docs --force --skip-errors
 
 lint:
 	uv run ruff check --fix

{blaxel-0.2.2rc79 → blaxel-0.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: blaxel
-Version: 0.2.2rc79
+Version: 0.2.4
 Summary: Blaxel - AI development platform SDK
 Project-URL: Homepage, https://blaxel.ai
 Project-URL: Documentation, https://docs.blaxel.ai
@@ -42,7 +42,7 @@ Requires-Dist: llama-index-llms-google-genai>=0.1.13; extra == 'all'
 Requires-Dist: llama-index-llms-groq>=0.3.1; extra == 'all'
 Requires-Dist: llama-index-llms-mistralai>=0.4.0; extra == 'all'
 Requires-Dist: llama-index-llms-openai>=0.3.42; extra == 'all'
-Requires-Dist: llama-index>=0.12.37; extra == 'all'
+Requires-Dist: llama-index>=0.12.46; extra == 'all'
 Requires-Dist: openai-agents>=0.0.19; extra == 'all'
 Requires-Dist: opentelemetry-exporter-otlp>=1.28.0; extra == 'all'
 Requires-Dist: opentelemetry-instrumentation-anthropic==0.40.6; extra == 'all'
@@ -92,7 +92,7 @@ Requires-Dist: llama-index-llms-google-genai>=0.1.13; extra == 'llamaindex'
 Requires-Dist: llama-index-llms-groq>=0.3.1; extra == 'llamaindex'
 Requires-Dist: llama-index-llms-mistralai>=0.4.0; extra == 'llamaindex'
 Requires-Dist: llama-index-llms-openai>=0.3.42; extra == 'llamaindex'
-Requires-Dist: llama-index>=0.12.37; extra == 'llamaindex'
+Requires-Dist: llama-index>=0.12.46; extra == 'llamaindex'
 Requires-Dist: opentelemetry-instrumentation-llamaindex>=0.40.7; extra == 'llamaindex'
 Provides-Extra: openai
 Requires-Dist: openai-agents>=0.0.19; extra == 'openai'

{blaxel-0.2.2rc79 → blaxel-0.2.4}/docs/blaxel/core/client/client.md

@@ -4,7 +4,7 @@ Module blaxel.core.client.client
 Classes
 -------
 
-`Client(base_url: str = '', auth: httpx.Auth = None, *, raise_on_unexpected_status: bool = True, cookies: dict[str, str] = _Nothing.NOTHING, headers: dict[str, str] = _Nothing.NOTHING, timeout: openai.Timeout | None = None, verify_ssl: str | bool | ssl.SSLContext = True, follow_redirects: bool = False, httpx_args: dict[str, typing.Any] = _Nothing.NOTHING)`
+`Client(base_url: str = '', auth: httpx.Auth = None, *, raise_on_unexpected_status: bool = True, cookies: dict[str, str] = _Nothing.NOTHING, headers: dict[str, str] = _Nothing.NOTHING, timeout: httpx.Timeout | None = None, verify_ssl: str | bool | ssl.SSLContext = True, follow_redirects: bool = False, httpx_args: dict[str, typing.Any] = _Nothing.NOTHING)`
 :   A Client which has been authenticated for use on secured endpoints
     
     The following are accepted as keyword arguments and will be used to construct httpx Clients internally:
@@ -71,5 +71,5 @@ Classes
     `with_headers(self, headers: dict[str, str]) ‑> blaxel.core.client.client.Client`
     :   Get a new client matching this one with additional headers
 
-    `with_timeout(self, timeout: openai.Timeout) ‑> blaxel.core.client.client.Client`
+    `with_timeout(self, timeout: httpx.Timeout) ‑> blaxel.core.client.client.Client`
     :   Get a new client matching this one with a new timeout (in seconds)

{blaxel-0.2.2rc79 → blaxel-0.2.4}/docs/blaxel/core/client/index.md

@@ -13,7 +13,7 @@ Sub-modules
 Classes
 -------
 
-`Client(base_url: str = '', auth: httpx.Auth = None, *, raise_on_unexpected_status: bool = True, cookies: dict[str, str] = _Nothing.NOTHING, headers: dict[str, str] = _Nothing.NOTHING, timeout: openai.Timeout | None = None, verify_ssl: str | bool | ssl.SSLContext = True, follow_redirects: bool = False, httpx_args: dict[str, typing.Any] = _Nothing.NOTHING)`
+`Client(base_url: str = '', auth: httpx.Auth = None, *, raise_on_unexpected_status: bool = True, cookies: dict[str, str] = _Nothing.NOTHING, headers: dict[str, str] = _Nothing.NOTHING, timeout: httpx.Timeout | None = None, verify_ssl: str | bool | ssl.SSLContext = True, follow_redirects: bool = False, httpx_args: dict[str, typing.Any] = _Nothing.NOTHING)`
 :   A Client which has been authenticated for use on secured endpoints
     
     The following are accepted as keyword arguments and will be used to construct httpx Clients internally:
@@ -80,5 +80,5 @@ Classes
     `with_headers(self, headers: dict[str, str]) ‑> blaxel.core.client.client.Client`
     :   Get a new client matching this one with additional headers
 
-    `with_timeout(self, timeout: openai.Timeout) ‑> blaxel.core.client.client.Client`
+    `with_timeout(self, timeout: httpx.Timeout) ‑> blaxel.core.client.client.Client`
     :   Get a new client matching this one with a new timeout (in seconds)

{blaxel-0.2.2rc79 → blaxel-0.2.4}/docs/blaxel/core/common/internal.md

@@ -14,6 +14,16 @@ Functions
     Returns:
         str: An alphanumeric hash of the input string, limited to max_size
 
+`get_forced_url(type_str: str, name: str) ‑> str | None`
+:   Check for forced URLs in environment variables using both plural and singular forms.
+    
+    Args:
+        type_str: The type identifier
+        name: The name identifier
+    
+    Returns:
+        The forced URL if found in environment variables, None otherwise
+
 `get_global_unique_hash(workspace: str, type: str, name: str) ‑> str`
 :   Generate a unique hash for a combination of workspace, type, and name.
     
@@ -23,4 +33,13 @@ Functions
         name: The name identifier
     
     Returns:
-        A unique alphanumeric hash string of maximum length 48
+        A unique alphanumeric hash string of maximum length 48
+
+`pluralize(type_str: str) ‑> str`
+:   Convert a string to its plural form following English pluralization rules.
+    
+    Args:
+        type_str: The input string to pluralize
+    
+    Returns:
+        The pluralized form of the input string

{blaxel-0.2.2rc79 → blaxel-0.2.4}/docs/blaxel/core/common/logger.md

@@ -6,6 +6,9 @@ to set up logging configurations for Blaxel applications.
 Functions
 ---------
 
+`get_current_span()`
+:   Fallback function when opentelemetry is not available.
+
 `init_logger(log_level: str)`
 :   Initializes the logging configuration for Blaxel.
     

{blaxel-0.2.2rc79 → blaxel-0.2.4}/docs/blaxel/core/index.md

@@ -148,13 +148,6 @@ Classes
     `connect(self, name: str)`
     :
 
-    `connect_with_url(self, name: str, url: str) ‑> None`
-    :   Initialize a session and load tools from it.
-        
-        Args:
-            name: Name to identify this server connection
-            url: The URL to connect to
-
     `get_tools(self) ‑> list[blaxel.core.tools.types.Tool]`
     :   Get a list of all tools from all connected servers.
 
@@ -207,11 +200,6 @@ Classes
     Args:
         port: The port to listen on (defaults to 8080 or BL_SERVER_PORT env var)
 
-    ### Class variables
-
-    `spans: Dict[str, opentelemetry.trace.span.Span]`
-    :
-
     ### Methods
 
     `websocket_server(self)`
@@ -258,16 +246,16 @@ Classes
     `to_dict(self) ‑> dict[str, typing.Any]`
     :
 
-`SandboxFileSystem(sandbox)`
+`SandboxFileSystem(sandbox_config: blaxel.core.sandbox.types.SandboxConfiguration)`
 :   
 
     ### Ancestors (in MRO)
 
-    * blaxel.core.sandbox.base.SandboxHandleBase
+    * blaxel.core.sandbox.action.SandboxAction
 
     ### Methods
 
-    `cp(self, source: str, destination: str) ‑> Dict[str, str]`
+    `cp(self, source: str, destination: str) ‑> blaxel.core.sandbox.types.CopyResponse`
     :
 
     `format_path(self, path: str) ‑> str`
@@ -285,20 +273,35 @@ Classes
     `rm(self, path: str, recursive: bool = False) ‑> blaxel.core.sandbox.client.models.success_response.SuccessResponse`
     :
 
+    `watch(self, path: str, callback: Callable[[blaxel.core.sandbox.types.WatchEvent], None], options: Dict[str, Any] | None = None) ‑> Dict[str, Callable]`
+    :   Watch for file system changes.
+
     `write(self, path: str, content: str) ‑> blaxel.core.sandbox.client.models.success_response.SuccessResponse`
     :
 
+    `write_binary(self, path: str, content: bytes | bytearray) ‑> blaxel.core.sandbox.client.models.success_response.SuccessResponse`
+    :   Write binary content to a file.
+
+    `write_tree(self, files: List[blaxel.core.sandbox.types.SandboxFilesystemFile | Dict[str, Any]], destination_path: str | None = None) ‑> blaxel.core.sandbox.client.models.directory.Directory`
+    :   Write multiple files in a tree structure.
+
 `SandboxInstance(sandbox: blaxel.core.client.models.sandbox.Sandbox)`
 :   
 
     ### Static methods
 
-    `create(sandbox: blaxel.core.client.models.sandbox.Sandbox) ‑> blaxel.core.sandbox.sandbox.SandboxInstance`
+    `create(sandbox: blaxel.core.client.models.sandbox.Sandbox | blaxel.core.sandbox.types.SandboxCreateConfiguration | Dict[str, Any] | None = None) ‑> blaxel.core.sandbox.sandbox.SandboxInstance`
     :
 
+    `create_if_not_exists(sandbox: blaxel.core.client.models.sandbox.Sandbox | blaxel.core.sandbox.types.SandboxCreateConfiguration | Dict[str, Any]) ‑> blaxel.core.sandbox.sandbox.SandboxInstance`
+    :   Create a sandbox if it doesn't exist, otherwise return existing.
+
     `delete(sandbox_name: str) ‑> blaxel.core.client.models.sandbox.Sandbox`
     :
 
+    `from_session(session: blaxel.core.sandbox.types.SessionWithToken | Dict[str, Any]) ‑> blaxel.core.sandbox.sandbox.SandboxInstance`
+    :   Create a sandbox instance from a session with token.
+
     `get(sandbox_name: str) ‑> blaxel.core.sandbox.sandbox.SandboxInstance`
     :
 
@@ -334,7 +337,7 @@ Classes
 
     ### Methods
 
-    `create(self, preview: blaxel.core.client.models.preview.Preview) ‑> blaxel.core.sandbox.preview.SandboxPreview`
+    `create(self, preview: blaxel.core.client.models.preview.Preview | Dict[str, Any]) ‑> blaxel.core.sandbox.preview.SandboxPreview`
     :   Create a new preview.
 
     `delete(self, preview_name: str) ‑> dict`
@@ -346,16 +349,16 @@ Classes
     `list(self) ‑> List[blaxel.core.sandbox.preview.SandboxPreview]`
     :   List all previews for the sandbox.
 
-`SandboxProcess(sandbox: blaxel.core.client.models.sandbox.Sandbox)`
+`SandboxProcess(sandbox_config: blaxel.core.sandbox.types.SandboxConfiguration)`
 :   
 
     ### Ancestors (in MRO)
 
-    * blaxel.core.sandbox.base.SandboxHandleBase
+    * blaxel.core.sandbox.action.SandboxAction
 
     ### Methods
 
-    `exec(self, process: blaxel.core.sandbox.client.models.process_request.ProcessRequest) ‑> blaxel.core.sandbox.client.models.process_response.ProcessResponse`
+    `exec(self, process: blaxel.core.sandbox.client.models.process_request.ProcessRequest | Dict[str, Any], on_log: Callable[[str], None] | None = None) ‑> blaxel.core.sandbox.client.models.process_response.ProcessResponse`
     :
 
     `get(self, identifier: str) ‑> blaxel.core.sandbox.client.models.process_response.ProcessResponse`
@@ -367,8 +370,14 @@ Classes
     `list(self) ‑> list[blaxel.core.sandbox.client.models.process_response.ProcessResponse]`
     :
 
-    `logs(self, identifier: str, type_: str = 'stdout') ‑> str`
+    `logs(self, identifier: str, log_type: Literal['stdout', 'stderr', 'all'] = 'all') ‑> str`
     :
 
     `stop(self, identifier: str) ‑> blaxel.core.sandbox.client.models.success_response.SuccessResponse`
-    :
+    :
+
+    `stream_logs(self, identifier: str, options: Dict[str, Callable[[str], None]] | None = None) ‑> Dict[str, Callable[[], None]]`
+    :   Stream logs from a process with callbacks for different output types.
+
+    `wait(self, identifier: str, max_wait: int = 60000, interval: int = 1000) ‑> blaxel.core.sandbox.client.models.process_response.ProcessResponse`
+    :   Wait for a process to complete.

{blaxel-0.2.2rc79 → blaxel-0.2.4}/docs/blaxel/core/mcp/index.md

@@ -25,11 +25,6 @@ Classes
     Args:
         port: The port to listen on (defaults to 8080 or BL_SERVER_PORT env var)
 
-    ### Class variables
-
-    `spans: Dict[str, opentelemetry.trace.span.Span]`
-    :
-
     ### Methods
 
     `websocket_server(self)`

{blaxel-0.2.2rc79 → blaxel-0.2.4}/docs/blaxel/core/mcp/server.md

@@ -12,17 +12,12 @@ Classes
     Args:
         port: The port to listen on (defaults to 8080 or BL_SERVER_PORT env var)
 
-    ### Class variables
-
-    `spans: Dict[str, opentelemetry.trace.span.Span]`
-    :
-
     ### Methods
 
     `websocket_server(self)`
     :   Create and run a WebSocket server for MCP communication.
 
-`FastMCP(name: str | None = None, instructions: str | None = None, auth_server_provider: OAuthAuthorizationServerProvider[Any, Any, Any] | None = None, **settings: Any)`
+`FastMCP(name: str | None = None, instructions: str | None = None, auth_server_provider: OAuthAuthorizationServerProvider[Any, Any, Any] | None = None, event_store: EventStore | None = None, *, tools: list[Tool] | None = None, **settings: Any)`
 :   
 
     ### Ancestors (in MRO)

blaxel-0.2.4/docs/blaxel/core/sandbox/action.md

@@ -0,0 +1,50 @@
+Module blaxel.core.sandbox.action
+=================================
+
+Classes
+-------
+
+`ResponseError(response: httpx.Response, data: Any = None, error: Any = None)`
+:   Common base class for all non-exit exceptions.
+
+    ### Ancestors (in MRO)
+
+    * builtins.Exception
+    * builtins.BaseException
+
+`SandboxAction(sandbox_config: blaxel.core.sandbox.types.SandboxConfiguration)`
+:   
+
+    ### Descendants
+
+    * blaxel.core.sandbox.filesystem.SandboxFileSystem
+    * blaxel.core.sandbox.network.SandboxNetwork
+    * blaxel.core.sandbox.process.SandboxProcess
+
+    ### Instance variables
+
+    `external_url: str`
+    :
+
+    `fallback_url: str | None`
+    :
+
+    `forced_url: str | None`
+    :
+
+    `internal_url: str`
+    :
+
+    `name: str`
+    :
+
+    `url: str`
+    :
+
+    ### Methods
+
+    `get_client(self) ‑> httpx.AsyncClient`
+    :
+
+    `handle_response_error(self, response: httpx.Response, data: Any, error: Any)`
+    :

{blaxel-0.2.2rc79 → blaxel-0.2.4}/docs/blaxel/core/sandbox/client/client.md

@@ -4,7 +4,7 @@ Module blaxel.core.sandbox.client.client
 Classes
 -------
 
-`Client(base_url: str = '', auth: httpx.Auth = None, *, raise_on_unexpected_status: bool = True, cookies: dict[str, str] = _Nothing.NOTHING, headers: dict[str, str] = _Nothing.NOTHING, timeout: openai.Timeout | None = None, verify_ssl: str | bool | ssl.SSLContext = True, follow_redirects: bool = False, httpx_args: dict[str, typing.Any] = _Nothing.NOTHING)`
+`Client(base_url: str = '', auth: httpx.Auth = None, *, raise_on_unexpected_status: bool = True, cookies: dict[str, str] = _Nothing.NOTHING, headers: dict[str, str] = _Nothing.NOTHING, timeout: httpx.Timeout | None = None, verify_ssl: str | bool | ssl.SSLContext = True, follow_redirects: bool = False, httpx_args: dict[str, typing.Any] = _Nothing.NOTHING)`
 :   A Client which has been authenticated for use on secured endpoints
     
     The following are accepted as keyword arguments and will be used to construct httpx Clients internally:
@@ -71,5 +71,5 @@ Classes
     `with_headers(self, headers: dict[str, str]) ‑> blaxel.core.sandbox.client.client.Client`
     :   Get a new client matching this one with additional headers
 
-    `with_timeout(self, timeout: openai.Timeout) ‑> blaxel.core.sandbox.client.client.Client`
+    `with_timeout(self, timeout: httpx.Timeout) ‑> blaxel.core.sandbox.client.client.Client`
     :   Get a new client matching this one with a new timeout (in seconds)

{blaxel-0.2.2rc79 → blaxel-0.2.4}/docs/blaxel/core/sandbox/client/index.md

@@ -13,7 +13,7 @@ Sub-modules
 Classes
 -------
 
-`Client(base_url: str = '', auth: httpx.Auth = None, *, raise_on_unexpected_status: bool = True, cookies: dict[str, str] = _Nothing.NOTHING, headers: dict[str, str] = _Nothing.NOTHING, timeout: openai.Timeout | None = None, verify_ssl: str | bool | ssl.SSLContext = True, follow_redirects: bool = False, httpx_args: dict[str, typing.Any] = _Nothing.NOTHING)`
+`Client(base_url: str = '', auth: httpx.Auth = None, *, raise_on_unexpected_status: bool = True, cookies: dict[str, str] = _Nothing.NOTHING, headers: dict[str, str] = _Nothing.NOTHING, timeout: httpx.Timeout | None = None, verify_ssl: str | bool | ssl.SSLContext = True, follow_redirects: bool = False, httpx_args: dict[str, typing.Any] = _Nothing.NOTHING)`
 :   A Client which has been authenticated for use on secured endpoints
     
     The following are accepted as keyword arguments and will be used to construct httpx Clients internally:
@@ -80,5 +80,5 @@ Classes
     `with_headers(self, headers: dict[str, str]) ‑> blaxel.core.sandbox.client.client.Client`
     :   Get a new client matching this one with additional headers
 
-    `with_timeout(self, timeout: openai.Timeout) ‑> blaxel.core.sandbox.client.client.Client`
+    `with_timeout(self, timeout: httpx.Timeout) ‑> blaxel.core.sandbox.client.client.Client`
     :   Get a new client matching this one with a new timeout (in seconds)

blaxel-0.2.4/docs/blaxel/core/sandbox/client/models/directory.md

@@ -0,0 +1,44 @@
+Module blaxel.core.sandbox.client.models.directory
+==================================================
+
+Classes
+-------
+
+`Directory(files: list['File'], name: str, path: str, subdirectories: list['Subdirectory'])`
+:   Attributes:
+        files (list['File']):
+        name (str):
+        path (str):
+        subdirectories (list['Subdirectory']): @name Subdirectories
+    
+    Method generated by attrs for class Directory.
+
+    ### Static methods
+
+    `from_dict(src_dict: dict[str, typing.Any]) ‑> ~T`
+    :
+
+    ### Instance variables
+
+    `additional_keys: list[str]`
+    :
+
+    `additional_properties`
+    :
+
+    `files`
+    :
+
+    `name`
+    :
+
+    `path`
+    :
+
+    `subdirectories`
+    :
+
+    ### Methods
+
+    `to_dict(self) ‑> dict[str, typing.Any]`
+    :

{blaxel-0.2.2rc79 → blaxel-0.2.4}/docs/blaxel/core/sandbox/client/models/error_response.md

@@ -4,9 +4,9 @@ Module blaxel.core.sandbox.client.models.error_response
 Classes
 -------
 
-`ErrorResponse(error: blaxel.core.sandbox.client.types.Unset | str = <blaxel.core.sandbox.client.types.Unset object>)`
+`ErrorResponse(error: str)`
 :   Attributes:
-        error (Union[Unset, str]):  Example: Error message.
+        error (str):  Example: Error message.
     
     Method generated by attrs for class ErrorResponse.
 
@@ -23,7 +23,7 @@ Classes
     `additional_properties: dict[str, typing.Any]`
     :
 
-    `error: blaxel.core.sandbox.client.types.Unset | str`
+    `error: str`
     :
 
     ### Methods

blaxel-0.2.4/docs/blaxel/core/sandbox/client/models/file.md

@@ -0,0 +1,56 @@
+Module blaxel.core.sandbox.client.models.file
+=============================================
+
+Classes
+-------
+
+`File(group: str, last_modified: str, name: str, owner: str, path: str, permissions: str, size: int)`
+:   Attributes:
+        group (str):
+        last_modified (str):
+        name (str):
+        owner (str):
+        path (str):
+        permissions (str):
+        size (int):
+    
+    Method generated by attrs for class File.
+
+    ### Static methods
+
+    `from_dict(src_dict: dict[str, typing.Any]) ‑> ~T`
+    :
+
+    ### Instance variables
+
+    `additional_keys: list[str]`
+    :
+
+    `additional_properties: dict[str, typing.Any]`
+    :
+
+    `group: str`
+    :
+
+    `last_modified: str`
+    :
+
+    `name: str`
+    :
+
+    `owner: str`
+    :
+
+    `path: str`
+    :
+
+    `permissions: str`
+    :
+
+    `size: int`
+    :
+
+    ### Methods
+
+    `to_dict(self) ‑> dict[str, typing.Any]`
+    :

blaxel-0.2.4/docs/blaxel/core/sandbox/client/models/file_with_content.md

@@ -0,0 +1,60 @@
+Module blaxel.core.sandbox.client.models.file_with_content
+==========================================================
+
+Classes
+-------
+
+`FileWithContent(content: str, group: str, last_modified: str, name: str, owner: str, path: str, permissions: str, size: int)`
+:   Attributes:
+        content (str):
+        group (str):
+        last_modified (str):
+        name (str):
+        owner (str):
+        path (str):
+        permissions (str):
+        size (int):
+    
+    Method generated by attrs for class FileWithContent.
+
+    ### Static methods
+
+    `from_dict(src_dict: dict[str, typing.Any]) ‑> ~T`
+    :
+
+    ### Instance variables
+
+    `additional_keys: list[str]`
+    :
+
+    `additional_properties: dict[str, typing.Any]`
+    :
+
+    `content: str`
+    :
+
+    `group: str`
+    :
+
+    `last_modified: str`
+    :
+
+    `name: str`
+    :
+
+    `owner: str`
+    :
+
+    `path: str`
+    :
+
+    `permissions: str`
+    :
+
+    `size: int`
+    :
+
+    ### Methods
+
+    `to_dict(self) ‑> dict[str, typing.Any]`
+    :