soothe-client-python 1.0.18__tar.gz → 1.0.20__tar.gz

{soothe_client_python-1.0.18 → soothe_client_python-1.0.20}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: soothe-client-python
-Version: 1.0.18
+Version: 1.0.20
 Summary: WebSocket client + appkit for soothe-daemon (Python)
 Project-URL: Homepage, https://github.com/mirasoth/soothe-client-python
 Project-URL: Documentation, https://soothe.readthedocs.io

{soothe_client_python-1.0.18 → soothe_client_python-1.0.20}/src/soothe_client/appkit/daemon_session.py

@@ -764,6 +764,24 @@ class DaemonSession:
                 interaction_mode=interaction_mode,
             )
 
+    async def set_clarification_mode(self, mode: str) -> bool:
+        """Hot-swap the clarification mode on the running goal (RFC-622).
+
+        Sends ``loop_set_clarification_mode`` on the RPC socket. Returns
+        ``True`` when the swap landed on a live goal; ``False`` when no goal
+        is currently running (retry on the next turn).
+        """
+        if not self._loop_id:
+            return False
+        async with self._rpc_lock:
+            await self._ensure_rpc_connected()
+            result = await self._rpc_client.request(
+                "loop_set_clarification_mode",
+                {"loop_id": self._loop_id, "mode": mode},
+                timeout=5.0,
+            )
+        return bool(result.get("applied", False))
+
     async def _ensure_rpc_connected(self) -> None:
         if self._rpc_connected:
             return

{soothe_client_python-1.0.18 → soothe_client_python-1.0.20}/src/soothe_client/protocol_params.py

@@ -13,8 +13,6 @@ __all__ = [
     # Loop RPC params
     "LoopGetParams",
     "LoopListParams",
-    "LoopTreeParams",
-    "LoopPruneParams",
     "LoopDeleteParams",
     "LoopNewParams",
     "LoopReattachParams",
@@ -120,28 +118,6 @@ class LoopListParams(ParamsBase):
     limit: int | None = Field(default=None, ge=1, description="Maximum results")
 
 
-class LoopTreeParams(ParamsBase):
-    """Params for ``method=loop_tree``.
-
-    Attributes:
-        loop_id: Loop identifier (required).
-    """
-
-    loop_id: str = Field(..., min_length=1, description="Loop identifier")
-
-
-class LoopPruneParams(ParamsBase):
-    """Params for ``method=loop_prune``.
-
-    Attributes:
-        loop_id: Loop identifier (required).
-        keep_latest: Number of recent branches to keep (default 1).
-    """
-
-    loop_id: str = Field(..., min_length=1)
-    keep_latest: int = Field(default=1, ge=1)
-
-
 class LoopDeleteParams(ParamsBase):
     """Params for ``method=loop_delete``.
 

{soothe_client_python-1.0.18 → soothe_client_python-1.0.20}/src/soothe_client/websocket.py

@@ -1123,33 +1123,6 @@ class WebSocketClient:
             params["as_node"] = as_node
         return await self.request("loop_state_update", params, timeout=timeout)
 
-    async def loop_tree(
-        self,
-        loop_id: str,
-        *,
-        timeout: float = 15.0,
-    ) -> dict[str, Any]:
-        """Fetch the loop checkpoint tree (``loop_tree``)."""
-        return await self.request(
-            "loop_tree",
-            {"loop_id": loop_id},
-            timeout=timeout,
-        )
-
-    async def loop_prune(
-        self,
-        loop_id: str,
-        *,
-        keep_latest: int = 1,
-        timeout: float = 15.0,
-    ) -> dict[str, Any]:
-        """Prune old checkpoints from a loop (``loop_prune``)."""
-        return await self.request(
-            "loop_prune",
-            {"loop_id": loop_id, "keep_latest": keep_latest},
-            timeout=timeout,
-        )
-
     async def loop_delete(self, loop_id: str, *, timeout: float = 15.0) -> dict[str, Any]:
         """Delete a loop and its checkpoints (``loop_delete``)."""
         return await self.request(