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

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

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: soothe-client-python
-Version: 1.0.15
+Version: 1.0.18
 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
@@ -21,7 +21,7 @@ Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: <3.15,>=3.11
 Requires-Dist: pillow<12.0.0,>=10.0.0
 Requires-Dist: pydantic<3.0.0,>=2.0.0
-Requires-Dist: soothe-sdk<2.0.0,>=1.0.2
+Requires-Dist: soothe-sdk<2.0.0,>=1.0.9
 Requires-Dist: websockets>=12.0
 Provides-Extra: dev
 Requires-Dist: mypy>=1.0.0; extra == 'dev'

{soothe_client_python-1.0.15 → soothe_client_python-1.0.18}/pyproject.toml

@@ -23,7 +23,7 @@ classifiers = [
     "Topic :: Software Development :: Libraries :: Python Modules",
 ]
 dependencies = [
-    "soothe-sdk>=1.0.2,<2.0.0",
+    "soothe-sdk>=1.0.9,<2.0.0",
     "pydantic>=2.0.0,<3.0.0",
     "websockets>=12.0",
     "pillow>=10.0.0,<12.0.0",

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

@@ -285,6 +285,7 @@ class DaemonSession:
         router_profile: str | None = None,
         attachments: list[dict[str, str]] | None = None,
         clarification_mode: str | None = None,
+        interaction_mode: str | None = None,
         clarification_answer: bool = False,
         clarification_answers: list[str] | None = None,
         intent_hint: str | None = None,
@@ -305,6 +306,7 @@ class DaemonSession:
             router_profile=router_profile,
             attachments=attachments,
             clarification_mode=clarification_mode,
+            interaction_mode=interaction_mode,
             clarification_answer=clarification_answer,
             clarification_answers=clarification_answers,
             intent_hint=intent_hint,
@@ -750,6 +752,7 @@ class DaemonSession:
         args: str = "",
         *,
         clarification_mode: str | None = None,
+        interaction_mode: str | None = None,
     ) -> dict[str, Any]:
         """Invoke a skill on the **stream** socket (required for turn enqueue)."""
         async with self._read_lock:
@@ -758,6 +761,7 @@ class DaemonSession:
                 args,
                 timeout=120.0,
                 clarification_mode=clarification_mode,
+                interaction_mode=interaction_mode,
             )
 
     async def _ensure_rpc_connected(self) -> None:

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

@@ -205,6 +205,7 @@ class LoopInputParams(ParamsBase):
         response_schema_name: Schema name for logging.
         response_schema_strict: Enable strict schema validation.
         clarification_mode: clarification relay mode.
+        interaction_mode: CoreAgent interaction mode (``agent``|``ask``).
         clarification_answer: Mark as answer to pending clarification.
         clarification_answers: Per-question answers for multi-question clarification.
     """
@@ -222,6 +223,7 @@ class LoopInputParams(ParamsBase):
     response_schema_name: str | None = None
     response_schema_strict: bool | None = None
     clarification_mode: str | None = Field(default=None, pattern=r"^(auto|manual)$")
+    interaction_mode: str | None = Field(default=None, pattern=r"^(agent|ask)$")
     clarification_answer: bool = False
     clarification_answers: list[str] | None = None
 
@@ -591,11 +593,13 @@ class InvokeSkillParams(ParamsBase):
         skill: Skill name (required).
         args: Skill arguments.
         clarification_mode: clarification relay mode.
+        interaction_mode: CoreAgent interaction mode (``agent``|``ask``).
     """
 
     skill: str = Field(..., min_length=1)
     args: str = ""
     clarification_mode: str | None = Field(default=None, pattern=r"^(auto|manual)$")
+    interaction_mode: str | None = Field(default=None, pattern=r"^(agent|ask)$")
 
 
 class McpStatusParams(EmptyParams):

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

@@ -949,6 +949,7 @@ class WebSocketClient:
         response_schema_name: str | None = None,
         response_schema_strict: bool | None = None,
         clarification_mode: str | None = None,
+        interaction_mode: str | None = None,
         clarification_answer: bool = False,
         clarification_answers: list[str] | None = None,
     ) -> None:
@@ -976,6 +977,9 @@ class WebSocketClient:
             clarification_mode: clarification relay mode for this turn
                 (``"auto"`` / ``"manual"``). ``None`` lets the daemon fall back
                 to its configured default.
+            interaction_mode: CoreAgent interaction mode for this turn
+                (``"agent"`` / ``"ask"``). ``None`` lets the daemon fall back
+                to its configured default.
             clarification_answer: When True, the daemon treats this input as the
                 answer to the loop's currently pending clarification interrupt and resumes the graph via ``Command(resume=...)``
                 instead of starting a new turn. Hint only — daemon verifies via
@@ -1014,6 +1018,8 @@ class WebSocketClient:
             params["response_schema_strict"] = response_schema_strict
         if clarification_mode is not None:
             params["clarification_mode"] = clarification_mode
+        if interaction_mode is not None:
+            params["interaction_mode"] = interaction_mode
         if clarification_answer:
             params["clarification_answer"] = True
         if clarification_answers is not None:
@@ -1117,6 +1123,96 @@ 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(
+            "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()
@@ -1256,6 +1352,7 @@ class WebSocketClient:
         *,
         timeout: float = 120.0,
         clarification_mode: str | None = None,
+        interaction_mode: str | None = None,
     ) -> dict[str, Any]:
         """Resolve a skill on the daemon host and receive echo before streaming.
 
@@ -1269,10 +1366,15 @@ class WebSocketClient:
                 configured default. Without this, slash-skill turns ignore
                 the client's Manual badge and always defer to the config
                 default — typically ``"auto"`` (veritas).
+            interaction_mode: CoreAgent interaction mode for the synthetic turn
+                (``"agent"`` / ``"ask"``). ``None`` lets the daemon fall back
+                to its configured default.
         """
         params: dict[str, Any] = {"skill": skill, "args": args}
         if clarification_mode is not None:
             params["clarification_mode"] = clarification_mode
+        if interaction_mode is not None:
+            params["interaction_mode"] = interaction_mode
         return await self.request("invoke_skill", params, timeout=timeout)
 
     async def fetch_daemon_status(