feat(box): add box runtime package and lbp box CLI command

pyproject.toml

@@ -9,6 +9,7 @@ authors = [
 requires-python = ">=3.10"
 dependencies = [
     "aiofiles>=24.1.0",
+    "aiohttp>=3.9.0",
     "dotenv>=0.9.9",
     "httpx>=0.28.1",
     "jinja2>=3.1.6",

src/langbot_plugin/box/__init__.py

@@ -0,0 +1 @@
+"""LangBot Box runtime package."""

src/langbot_plugin/box/__main__.py

@@ -0,0 +1,7 @@
+"""Allow running the Box server via ``python -m langbot_plugin.box``."""
+
+from .server import main
+
+if __name__ == "__main__":
+    main()
+

src/langbot_plugin/box/actions.py

@@ -0,0 +1,21 @@
+"""Box-specific action types for the action RPC protocol."""
+
+from __future__ import annotations
+
+from langbot_plugin.entities.io.actions.enums import ActionType
+
+
+class LangBotToBoxAction(ActionType):
+    """Actions sent from LangBot to the Box runtime."""
+
+    HEALTH = 'box_health'
+    STATUS = 'box_status'
+    EXEC = 'box_exec'
+    CREATE_SESSION = 'box_create_session'
+    GET_SESSION = 'box_get_session'
+    GET_SESSIONS = 'box_get_sessions'
+    DELETE_SESSION = 'box_delete_session'
+    START_MANAGED_PROCESS = 'box_start_managed_process'
+    GET_MANAGED_PROCESS = 'box_get_managed_process'
+    GET_BACKEND_INFO = 'box_get_backend_info'
+    SHUTDOWN = 'box_shutdown'