chore: add boxlite

examples/boxlite-python/main.py

@@ -0,0 +1,110 @@
+"""
+Sandbox Agent – Python + BoxLite example.
+
+Builds a Docker image, exports it to OCI layout, runs it inside a BoxLite
+sandbox, connects to the sandbox-agent server, creates a session, and sends a prompt.
+
+Usage:
+    pip install -r requirements.txt
+    python main.py
+"""
+
+import asyncio
+import json
+import signal
+import time
+
+import boxlite
+import httpx
+
+from client import SandboxConnection
+from credentials import build_box_env, detect_agent
+from setup_image import OCI_DIR, setup_image
+
+PORT = 3000
+
+
+def wait_for_health(base_url: str, timeout_s: float = 120) -> None:
+    deadline = time.monotonic() + timeout_s
+    last_err: str | None = None
+    while time.monotonic() < deadline:
+        try:
+            r = httpx.get(f"{base_url}/v1/health", timeout=5)
+            if r.status_code == 200 and r.json().get("status") == "ok":
+                return
+            last_err = f"health returned {r.status_code}"
+        except Exception as exc:
+            last_err = str(exc)
+        time.sleep(0.5)
+    raise RuntimeError(f"Timed out waiting for /v1/health: {last_err}")
+
+
+async def main() -> None:
+    agent = detect_agent()
+    print(f"Agent: {agent}")
+
+    setup_image()
+
+    env = build_box_env()
+
+    print("Creating BoxLite sandbox...")
+    box = boxlite.SimpleBox(
+        rootfs_path=OCI_DIR,
+        env=env,
+        ports=[(PORT, PORT, "tcp")],
+    )
+
+    async with box:
+        print("Starting server...")
+        result = await box.exec(
+            "sh", "-c",
+            f"nohup sandbox-agent server --no-token --host 0.0.0.0 --port {PORT} "
+            ">/tmp/sandbox-agent.log 2>&1 &",
+        )
+        if result.exit_code != 0:
+            raise RuntimeError(f"Failed to start server: {result.stderr}")
+
+        base_url = f"http://localhost:{PORT}"
+        print("Waiting for server...")
+        wait_for_health(base_url)
+        print("Server ready.")
+        print(f"Inspector: {base_url}/ui/")
+
+        # -- Session flow ----------------------------------------------------
+        conn = SandboxConnection(base_url, agent)
+
+        print("Connecting...")
+        init_result = conn.initialize()
+        agent_info = init_result.get("result", {}).get("agentInfo", {})
+        print(f"Connected to: {agent_info.get('title', agent)} {agent_info.get('version', '')}")
+
+        session_id = conn.new_session()
+        print(f"Session: {session_id}")
+
+        prompt_text = "Say hello and tell me what you are. Be brief (one sentence)."
+        print(f"\n> {prompt_text}")
+        response = conn.prompt(session_id, prompt_text)
+
+        if "error" in response:
+            err = response["error"]
+            print(f"Error: {err.get('message', err)}")
+        else:
+            print(f"Stop reason: {response.get('result', {}).get('stopReason', 'unknown')}")
+
+        # Give SSE events a moment to arrive.
+        time.sleep(1)
+
+        if conn.events:
+            for ev in conn.events:
+                if ev.get("method") == "session/update":
+                    content = ev.get("params", {}).get("update", {}).get("content", {})
+                    if content.get("text"):
+                        print(content["text"], end="")
+            print()
+
+        conn.close()
+        print("\nDone.")
+
+
+if __name__ == "__main__":
+    asyncio.run(main())