terrarium-python 0.1.2__tar.gz → 0.2.0__tar.gz

{terrarium_python-0.1.2 → terrarium_python-0.2.0}/.gitignore

@@ -32,3 +32,8 @@ docs/vendor/
 # Tooling caches
 .ruff_cache/
 .serena/
+
+# shunt deploy secrets — resolved locally and streamed to the host over ssh, never committed.
+secrets/
+
+shunt.toml

{terrarium_python-0.1.2 → terrarium_python-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: terrarium-python
-Version: 0.1.2
+Version: 0.2.0
 Summary: Async Python client for the Terrarium orchestrator API — manage sandboxed Claude agents and sessions (Claude-Agent-SDK-aligned).
 Project-URL: Homepage, https://oaisp.github.io/terrarium/
 Project-URL: Documentation, https://oaisp.github.io/terrarium/sdk/

{terrarium_python-0.1.2 → terrarium_python-0.2.0}/pyproject.toml

@@ -3,7 +3,7 @@
 # [tool.hatch.build.targets.wheel] below — so code reads `from terrarium import ...`
 # regardless. The bare `terrarium` name was not available on PyPI.
 name = "terrarium-python"
-version = "0.1.2"
+version = "0.2.0"
 description = "Async Python client for the Terrarium orchestrator API — manage sandboxed Claude agents and sessions (Claude-Agent-SDK-aligned)."
 readme = "README.md"
 requires-python = ">=3.10"

{terrarium_python-0.1.2 → terrarium_python-0.2.0}/terrarium/client.py

@@ -224,6 +224,19 @@ class SessionsResource:
         body = {"content": content} if isinstance(content, list) else {"text": content}
         await self._h.json("POST", f"/v1/sessions/{session_id}/messages", json=body)
 
+    async def recover(self, session_id: str) -> dict[str, Any]:
+        """Reattach to a session marked terminated whose sandbox is still running.
+
+        The orchestrator's event stream is a client of the sandbox, not the sandbox itself, so
+        it can drop (a Docker daemon restart, a host suspend) while the agent is perfectly
+        alive. The orchestrator reattaches automatically now; this is the manual counterpart
+        for sessions stranded before that, or past the automatic retry budget.
+
+        Raises ConflictError (409) when the sandbox really is gone — the transcript remains
+        readable, but the conversation cannot be resumed.
+        """
+        return await self._h.json("POST", f"/v1/sessions/{session_id}/recover")
+
     async def interrupt(self, session_id: str) -> None:
         await self._h.json("POST", f"/v1/sessions/{session_id}/interrupt")