soothe-client-python 0.9.10__py3-none-any.whl → 0.10.0__py3-none-any.whl

soothe_client/__init__.py

@@ -1,23 +1,27 @@
 """Soothe WebSocket client for talking to a running soothe-daemon.
 
-Public surface (community apps)::
+Public surface::
 
     from soothe_client import WebSocketClient, is_daemon_live
+    from soothe_client import AsyncCommandClient, CommandClient
     from soothe_client.appkit import DaemonSession
-    from soothe_client import AsyncCommandClient, CommandClient  # preferred aliases
 
-Advanced wire validation lives in ``soothe_client.protocol_params``.
-Higher-level session / multi-user helpers live in ``soothe_client.appkit``.
+Wire request param models: ``soothe_client.protocol_params``.
+Session / multi-user helpers: ``soothe_client.appkit``.
 """
 
 from __future__ import annotations
 
 import importlib.metadata
-import warnings
-from typing import Any
 
 from soothe_sdk.wire.codec import ProtocolError
 
+from soothe_client.command_client import (
+    AsyncCommandClient,
+    CommandClient,
+    async_command_client_from_config,
+    command_client_from_config,
+)
 from soothe_client.errors import (
     DaemonError,
     DisconnectCause,
@@ -52,78 +56,12 @@ from soothe_client.session import (
     connect_websocket_with_retries,
 )
 from soothe_client.websocket import WebSocketClient
-from soothe_client.ws_command_client import (
-    AsyncCommandClient,
-    CommandClient,
-    SyncWsCommandClient,
-    WsCommandClient,
-    async_command_client_from_config,
-    async_ws_command_client_from_config,
-    command_client_from_config,
-    ws_command_client_from_config,
-)
 
 try:
     __version__ = importlib.metadata.version("soothe-client-python")
 except importlib.metadata.PackageNotFoundError:
     __version__ = "0.0.0"
 
-# Legacy ``*Params`` names formerly re-exported at package root.
-_LEGACY_PARAM_NAMES = frozenset(
-    {
-        "AuthParams",
-        "AuthRefreshParams",
-        "AutopilotCancelAllParams",
-        "AutopilotCancelGoalParams",
-        "AutopilotDreamParams",
-        "AutopilotGetGoalParams",
-        "AutopilotGetJobParams",
-        "AutopilotListGoalsParams",
-        "AutopilotListJobsParams",
-        "AutopilotResumeParams",
-        "AutopilotStatusParams",
-        "AutopilotSubmitParams",
-        "AutopilotSubscribeParams",
-        "AutopilotWakeParams",
-        "ConfigGetParams",
-        "ConfigReloadParams",
-        "CronAddParams",
-        "CronCancelParams",
-        "CronListParams",
-        "CronShowParams",
-        "DaemonShutdownParams",
-        "DaemonStatusParams",
-        "DisconnectParams",
-        "InvokeSkillParams",
-        "JobCancelParams",
-        "JobCreateParams",
-        "JobDagParams",
-        "JobGuidanceParams",
-        "JobPauseParams",
-        "JobResumeParams",
-        "JobStatusParams",
-        "LoopCardsFetchParams",
-        "LoopDeleteParams",
-        "LoopDetachParams",
-        "LoopGetParams",
-        "LoopInputParams",
-        "LoopListParams",
-        "LoopMessagesParams",
-        "LoopNewParams",
-        "LoopPruneParams",
-        "LoopReattachParams",
-        "LoopStateGetParams",
-        "LoopStateUpdateParams",
-        "LoopTreeParams",
-        "McpStatusParams",
-        "ModelsListParams",
-        "RpcCommandParams",
-        "SkillsListParams",
-        "SlashCommandParams",
-        "SubscribeParams",
-    }
-)
-
 __all__ = [
     "__version__",
     # Transport
@@ -135,13 +73,9 @@ __all__ = [
     "ReconnectError",
     "StaleLoopError",
     "disconnect_cause_name",
-    # Command clients (canonical + preferred aliases)
-    "WsCommandClient",
-    "SyncWsCommandClient",
+    # Command clients
     "AsyncCommandClient",
     "CommandClient",
-    "ws_command_client_from_config",
-    "async_ws_command_client_from_config",
     "command_client_from_config",
     "async_command_client_from_config",
     # Session bootstrap
@@ -168,22 +102,3 @@ __all__ = [
     "DEFAULT_DELIVERABLE_PHASES",
     "validate_loop_input_intent_hint",
 ]
-
-
-def __getattr__(name: str) -> Any:
-    """Lazy-load legacy ``*Params`` with a deprecation warning.
-
-    Prefer ``from soothe_client.protocol_params import LoopInputParams``.
-    """
-    if name in _LEGACY_PARAM_NAMES:
-        warnings.warn(
-            f"Importing {name!r} from soothe_client is deprecated; "
-            f"use soothe_client.protocol_params.{name} instead.",
-            DeprecationWarning,
-            stacklevel=2,
-        )
-        from soothe_client import protocol_params as _params
-
-        return getattr(_params, name)
-    msg = f"module {__name__!r} has no attribute {name!r}"
-    raise AttributeError(msg)

soothe_client/{ws_command_client.py → command_client.py}

@@ -1,8 +1,6 @@
-"""WebSocket command client for daemon command endpoints.
+"""Async and sync daemon command clients (jobs, autopilot, cron).
 
-Provides synchronous and async clients for sending commands over WebSocket
-and receiving responses. Replaces HTTP REST clients for autopilot, cron,
-and memory profiling operations.
+``AsyncCommandClient`` for asyncio; ``CommandClient`` for scripts/CLI.
 """
 
 from __future__ import annotations
@@ -162,14 +160,11 @@ _MEMORY_COMMANDS = {
 }
 
 
-class WsCommandClient:
+class AsyncCommandClient:
     """Async client for one-shot daemon RPCs (jobs, autopilot, cron).
 
     Prefer this for asyncio apps. For scripts/CLI without an event loop, use
-    ``SyncWsCommandClient`` (alias ``CommandClient``). For streaming agent
-    turns, use ``DaemonSession`` instead.
-
-    Preferred community alias: ``AsyncCommandClient``.
+    ``CommandClient``. For streaming agent turns, use ``DaemonSession`` instead.
 
     Job lifecycle uses ``job_*`` methods. Autopilot goal helpers use
     ``autopilot_*``. ``job_cancel`` cancels a root job and its descendants;
@@ -177,7 +172,7 @@ class WsCommandClient:
 
     Example::
 
-        client = WsCommandClient("ws://127.0.0.1:8765")
+        client = AsyncCommandClient("ws://127.0.0.1:8765")
         created = await client.job_create("Summarize the README")
         await client.job_cancel(created["job_id"])
 
@@ -416,11 +411,10 @@ class WsCommandClient:
         return await self._send_command("memory_stats", {"mode": mode})
 
 
-class SyncWsCommandClient:
-    """Synchronous wrapper around ``WsCommandClient`` for scripts and CLI.
+class CommandClient:
+    """Synchronous wrapper around ``AsyncCommandClient`` for scripts and CLI.
 
-    Preferred community alias: ``CommandClient``. Each method opens a short
-    WebSocket RPC (same behavior as the async client).
+    Each method opens a short-lived WebSocket RPC (same behavior as async).
 
     Args:
         ws_url: Daemon WebSocket URL.
@@ -428,7 +422,7 @@ class SyncWsCommandClient:
     """
 
     def __init__(self, ws_url: str, *, timeout: float = 30.0) -> None:
-        self._client = WsCommandClient(ws_url, timeout=timeout)
+        self._client = AsyncCommandClient(ws_url, timeout=timeout)
 
     def _run_async(self, coro: Any) -> Any:
         """Run an async coroutine from sync code."""
@@ -581,38 +575,21 @@ class SyncWsCommandClient:
         return cast(dict[str, Any], self._run_async(self._client.memory_stats(mode)))
 
 
-def ws_command_client_from_config(cfg: Any) -> SyncWsCommandClient:
-    """Build a sync command client from soothe/CLI config (host/port).
-
-    Preferred alias: ``command_client_from_config``.
-    """
+def command_client_from_config(cfg: Any) -> CommandClient:
+    """Build a sync command client from soothe/CLI config (host/port)."""
     ws_url = websocket_url_from_config(cfg)
-    return SyncWsCommandClient(ws_url)
-
+    return CommandClient(ws_url)
 
-def async_ws_command_client_from_config(cfg: Any) -> WsCommandClient:
-    """Build an async command client from soothe/CLI config (host/port).
 
-    Preferred alias: ``async_command_client_from_config``.
-    """
+def async_command_client_from_config(cfg: Any) -> AsyncCommandClient:
+    """Build an async command client from soothe/CLI config (host/port)."""
     ws_url = websocket_url_from_config(cfg)
-    return WsCommandClient(ws_url)
+    return AsyncCommandClient(ws_url)
 
 
 __all__ = [
-    "WsCommandClient",
-    "SyncWsCommandClient",
     "AsyncCommandClient",
     "CommandClient",
-    "ws_command_client_from_config",
-    "async_ws_command_client_from_config",
     "command_client_from_config",
     "async_command_client_from_config",
 ]
-
-
-# Preferred community names (aliases; wire method names unchanged).
-AsyncCommandClient = WsCommandClient
-CommandClient = SyncWsCommandClient
-command_client_from_config = ws_command_client_from_config
-async_command_client_from_config = async_ws_command_client_from_config

soothe_client/helpers.py

@@ -1,7 +1,7 @@
 """Small WebSocket helpers for CLI and scripts (status, fetch, one-shot RPC).
 
 For interactive turns use ``DaemonSession``. For jobs/cron use
-``WsCommandClient`` / ``CommandClient``.
+``AsyncCommandClient`` / ``CommandClient``.
 """
 
 from __future__ import annotations

{soothe_client_python-0.9.10.dist-info → soothe_client_python-0.10.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: soothe-client-python
-Version: 0.9.10
+Version: 0.10.0
 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
@@ -70,12 +70,12 @@ More patterns: [`examples/`](examples/) (hello → streaming → multi-turn →
 | Need | Use |
 |------|-----|
 | One conversation, stream replies | `DaemonSession` (`soothe_client.appkit`) |
-| Jobs / cron (async) | `AsyncCommandClient` (alias of `WsCommandClient`) |
-| Jobs / cron (scripts / sync) | `CommandClient` (alias of `SyncWsCommandClient`) |
+| Jobs / cron (async) | `AsyncCommandClient` |
+| Jobs / cron (scripts / sync) | `CommandClient` |
 | Raw WebSocket / custom RPCs | `WebSocketClient` |
 | Many users / HTTP backend | `ConnectionPool` + `TurnRunner` |
 
-Wire request param models live in `soothe_client.protocol_params` (not at package root).
+Wire request param models: `soothe_client.protocol_params`.
 
 ## Develop
 

{soothe_client_python-0.9.10.dist-info → soothe_client_python-0.10.0.dist-info}/RECORD

@@ -1,6 +1,7 @@
-soothe_client/__init__.py,sha256=U3UtyHs1UFrrT5RChrnzzOBQJsdqc9BVZ3oyeLKX0Vk,5181
+soothe_client/__init__.py,sha256=zgcU3yRwDClFIQv-OYw9r4m99eUSx55cVpPva4wnd5s,2579
+soothe_client/command_client.py,sha256=mqJx9iQgr9Rr_XD50dtW-FXcVkUya12nnIXCzFiXkpc,23341
 soothe_client/errors.py,sha256=gOWYqrZbWxBMhYgtICxl2Di3ndME13qKcXxz1bwPdoQ,1800
-soothe_client/helpers.py,sha256=jcGW1L2cfbTeaUOKK3RGmOrkhariL3jI6b9e-3wfxXo,16356
+soothe_client/helpers.py,sha256=TBLENrHO_Z6Ck7tlk8FBjd_W6x-ub3OG_dP6h3mO7aU,16359
 soothe_client/intent_hints.py,sha256=KbOjV-8JKwpAcmdUesaow2fHnCujvhXEdPW0ff7CSUQ,1287
 soothe_client/protocol_params.py,sha256=gJo_t3-k_qpSuqe4ki7XJmUiRm8XbhaMzasU8FX62nM,18111
 soothe_client/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -9,7 +10,6 @@ soothe_client/session.py,sha256=kTcy4-PMPSrwcTgFTom1zub0fXVgZeTm7128rf4Zt08,7904
 soothe_client/stream_terminal.py,sha256=-g8TvVIbitdsvG2F6OIqH8sSHM19jBP72AijVGS0Rjs,3503
 soothe_client/turn_boundary.py,sha256=AqpiP-Jt2Zts44Iyyf8SgPbd94P60OYtMkeTW2s3-Nw,1960
 soothe_client/websocket.py,sha256=UmHRYNmx8brDYr983fO1tKQIFWHKfF7Wc6DbQRlYBTA,64716
-soothe_client/ws_command_client.py,sha256=QxX1QFkcbyX3Kh0t_HETUq5bGycIc2FsSmYNls7xXa0,24123
 soothe_client/appkit/__init__.py,sha256=z3F93ZAgzlJAWspTFRMz7sI_gW4bMbXwqMmLZmvII1I,2651
 soothe_client/appkit/attachments.py,sha256=hD2FsXeR8TqO3hzIYT49DUedsv9r2yFEuIYDBNhUy9M,3574
 soothe_client/appkit/broadcaster.py,sha256=wcWQUOy7HjFgNaXDk1Ec71CGi7mZmb-zXZZbuOon9OY,3529
@@ -25,7 +25,7 @@ soothe_client/appkit/session_store.py,sha256=uJNMZ33bq3F_qggdSD2ku4CN4aMxbMWywb5
 soothe_client/appkit/thinking_step.py,sha256=dB1L1ERPkisLh2y3KIgd4f6EmN8GmF5B0h6lae9tt18,4558
 soothe_client/appkit/turn.py,sha256=gtQyz3gGw8nkg8tfzpGZzNgRmJ48vJnj2Ll95W_BX4w,12479
 soothe_client/appkit/turn_runner.py,sha256=Svy-LAgy6p506zEHHnKKPay2rzxgLORoAawf6S66dKQ,20753
-soothe_client_python-0.9.10.dist-info/METADATA,sha256=hkjWnpySdLT8vKl_skjU3zAaXZytgIbLZ4A-3Ky9GHU,3085
-soothe_client_python-0.9.10.dist-info/WHEEL,sha256=lCkmxWfQsSc9CfIClYeavTdQeEX2toPqufh9gI35EQA,87
-soothe_client_python-0.9.10.dist-info/licenses/LICENSE,sha256=WbXjnHkSCPG_f4TfOdS_mGrbkQAYykAdfIqVDj9O-IY,1068
-soothe_client_python-0.9.10.dist-info/RECORD,,
+soothe_client_python-0.10.0.dist-info/METADATA,sha256=7T1VonUmH4krrQKKExorvzbjqxuu6rai72P3Y0t_sHQ,2994
+soothe_client_python-0.10.0.dist-info/WHEEL,sha256=lCkmxWfQsSc9CfIClYeavTdQeEX2toPqufh9gI35EQA,87
+soothe_client_python-0.10.0.dist-info/licenses/LICENSE,sha256=WbXjnHkSCPG_f4TfOdS_mGrbkQAYykAdfIqVDj9O-IY,1068
+soothe_client_python-0.10.0.dist-info/RECORD,,