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

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

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

@@ -27,6 +27,12 @@ logger = logging.getLogger(__name__)
 _TRANSITIONAL_DAEMON_READY_STATES = frozenset({"starting", "warming"})
 _DAEMON_READY_POLL_INTERVAL_S = 0.05
 
+# Align with soothe_daemon.config.models.WebSocketConfig.max_frame_size (default 10 MiB)
+# and WebSocketClient._DEFAULT_MAX_FRAME_SIZE. The websockets library defaults
+# max_size to 1 MiB, which closes the connection (1009) when the daemon replies
+# with larger JSON payloads (e.g. autopilot goal forests) to command RPCs.
+_DEFAULT_MAX_FRAME_SIZE = 10 * 1024 * 1024
+
 try:
     from soothe_sdk import __version__ as _client_version
 except Exception:  # pragma: no cover
@@ -151,11 +157,21 @@ class AsyncCommandClient:
     Args:
         ws_url: Daemon WebSocket URL (e.g. ``ws://127.0.0.1:8765``).
         timeout: Per-command timeout in seconds.
+        max_frame_size: Maximum incoming WebSocket message size in bytes. Should be
+            at least the daemon's ``transport.websocket.max_frame_size`` when that
+            is customized; defaults to 10 MiB to match the daemon default.
     """
 
-    def __init__(self, ws_url: str, *, timeout: float = 30.0) -> None:
+    def __init__(
+        self,
+        ws_url: str,
+        *,
+        timeout: float = 30.0,
+        max_frame_size: int = _DEFAULT_MAX_FRAME_SIZE,
+    ) -> None:
         self._ws_url = ws_url.rstrip("/")
         self._timeout = timeout
+        self._max_frame_size = max_frame_size
 
     async def _send_command(
         self,
@@ -197,7 +213,11 @@ class AsyncCommandClient:
         )
 
         try:
-            async with websockets.connect(self._ws_url, open_timeout=cmd_timeout) as ws:
+            async with websockets.connect(
+                self._ws_url,
+                open_timeout=cmd_timeout,
+                max_size=self._max_frame_size,
+            ) as ws:
                 await _perform_handshake(ws, timeout=cmd_timeout)
 
                 # Send the protocol-1 request envelope.
@@ -411,10 +431,23 @@ class CommandClient:
     Args:
         ws_url: Daemon WebSocket URL.
         timeout: Per-command timeout in seconds.
+        max_frame_size: Maximum incoming WebSocket message size in bytes. Should be
+            at least the daemon's ``transport.websocket.max_frame_size`` when that
+            is customized; defaults to 10 MiB to match the daemon default.
     """
 
-    def __init__(self, ws_url: str, *, timeout: float = 30.0) -> None:
-        self._client = AsyncCommandClient(ws_url, timeout=timeout)
+    def __init__(
+        self,
+        ws_url: str,
+        *,
+        timeout: float = 30.0,
+        max_frame_size: int = _DEFAULT_MAX_FRAME_SIZE,
+    ) -> None:
+        self._client = AsyncCommandClient(
+            ws_url,
+            timeout=timeout,
+            max_frame_size=max_frame_size,
+        )
 
     def _run_async(self, coro: Any) -> Any:
         """Run an async coroutine from sync code."""

{soothe_client_python-1.0.14 → soothe_client_python-1.0.17}/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.14 → soothe_client_python-1.0.17}/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:
@@ -1256,6 +1262,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 +1276,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(