mirror of
https://github.com/AstrBotDevs/AstrBot
synced 2026-07-15 17:30:13 +08:00
eb69bf3687
* fix(shipyard-neo): add readiness gate and graceful sandbox cleanup * fix: Add **kwargs to ComputerBooter.shutdown() * test(shipyard-neo): add tests for readiness gate and shutdown behavior
63 lines
1.6 KiB
Python
63 lines
1.6 KiB
Python
from ..olayer import (
|
|
BrowserComponent,
|
|
FileSystemComponent,
|
|
GUIComponent,
|
|
PythonComponent,
|
|
ShellComponent,
|
|
)
|
|
|
|
|
|
class ComputerBooter:
|
|
@property
|
|
def fs(self) -> FileSystemComponent: ...
|
|
|
|
@property
|
|
def python(self) -> PythonComponent: ...
|
|
|
|
@property
|
|
def shell(self) -> ShellComponent: ...
|
|
|
|
@property
|
|
def capabilities(self) -> tuple[str, ...] | None:
|
|
"""Sandbox capabilities (e.g. ('python', 'shell', 'filesystem', 'browser')).
|
|
|
|
Returns None if the booter doesn't support capability introspection
|
|
(backward-compatible default). Subclasses override after boot.
|
|
"""
|
|
return None
|
|
|
|
@property
|
|
def browser(self) -> BrowserComponent | None:
|
|
return None
|
|
|
|
@property
|
|
def gui(self) -> GUIComponent | None:
|
|
return None
|
|
|
|
async def boot(self, session_id: str) -> None: ...
|
|
|
|
async def shutdown(self, **kwargs) -> None:
|
|
"""Shut down the computer sandbox.
|
|
|
|
Subclasses may accept extra keyword arguments for
|
|
type-specific cleanup (e.g. ``delete_sandbox`` for
|
|
ShipyardNeoBooter). The default implementation ignores
|
|
them.
|
|
"""
|
|
...
|
|
|
|
async def upload_file(self, path: str, file_name: str) -> dict:
|
|
"""Upload file to the computer.
|
|
|
|
Should return a dict with `success` (bool) and `file_path` (str) keys.
|
|
"""
|
|
...
|
|
|
|
async def download_file(self, remote_path: str, local_path: str) -> None:
|
|
"""Download file from the computer."""
|
|
...
|
|
|
|
async def available(self) -> bool:
|
|
"""Check if the computer is available."""
|
|
...
|