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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: soothe-client-python
-Version: 1.0.17
+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.17 → 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.17 → 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.17 → soothe_client_python-1.0.20}/src/soothe_client/websocket.py

@@ -1123,6 +1123,69 @@ class WebSocketClient:
             params["as_node"] = as_node
         return await self.request("loop_state_update", params, 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(
+            "loop_delete",
+            {"loop_id": loop_id},
+            timeout=timeout,
+        )
+
+    async def loop_reattach(self, loop_id: str, *, timeout: float = 15.0) -> dict[str, Any]:
+        """Reattach to an existing loop (``loop_reattach``)."""
+        return await self.request(
+            "loop_reattach",
+            {"loop_id": loop_id},
+            timeout=timeout,
+        )
+
+    async def config_get(
+        self,
+        section: str | None = None,
+        *,
+        timeout: float = 10.0,
+    ) -> dict[str, Any]:
+        """Fetch a daemon config section (``config_get``)."""
+        params: dict[str, Any] = {}
+        if section:
+            params["section"] = section
+        return await self.request("config_get", params, timeout=timeout)
+
+    async def config_reload(self, *, timeout: float = 15.0) -> dict[str, Any]:
+        """Reload daemon config from disk (``config_reload``)."""
+        return await self.request("config_reload", {}, timeout=timeout)
+
+    async def daemon_shutdown(self, *, timeout: float = 10.0) -> dict[str, Any]:
+        """Request a graceful daemon shutdown (``daemon_shutdown``)."""
+        return await self.request("daemon_shutdown", {}, timeout=timeout)
+
+    async def authenticate(
+        self,
+        access_key: str,
+        secret_key: str,
+        *,
+        timeout: float = 15.0,
+    ) -> dict[str, Any]:
+        """Submit credentials for daemon-side auth (``auth``)."""
+        return await self.request(
+            "auth",
+            {"access_key": access_key, "secret_key": secret_key},
+            timeout=timeout,
+        )
+
+    async def refresh_auth_token(
+        self,
+        refresh_token: str,
+        *,
+        timeout: float = 15.0,
+    ) -> dict[str, Any]:
+        """Refresh the daemon-side auth token (``auth_refresh``)."""
+        return await self.request(
+            "auth_refresh",
+            {"refresh_token": refresh_token},
+            timeout=timeout,
+        )
+
     def _reset_disconnect_signal(self) -> None:
         """Clear the mid-session drop signal (called from ``connect``)."""
         self._disconn_event = asyncio.Event()