soothe-client-python 0.9.10__tar.gz → 0.10.0__tar.gz

{soothe_client_python-0.9.10 → soothe_client_python-0.10.0}/PKG-INFO

@@ -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 → soothe_client_python-0.10.0}/README.md

@@ -37,12 +37,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.10.0/src/soothe_client/__init__.py

@@ -0,0 +1,104 @@
+"""Soothe WebSocket client for talking to a running soothe-daemon.
+
+Public surface::
+
+    from soothe_client import WebSocketClient, is_daemon_live
+    from soothe_client import AsyncCommandClient, CommandClient
+    from soothe_client.appkit import DaemonSession
+
+Wire request param models: ``soothe_client.protocol_params``.
+Session / multi-user helpers: ``soothe_client.appkit``.
+"""
+
+from __future__ import annotations
+
+import importlib.metadata
+
+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,
+    ReconnectError,
+    StaleLoopError,
+    disconnect_cause_name,
+)
+from soothe_client.helpers import (
+    check_daemon_status,
+    connected_websocket,
+    fetch_config_section,
+    fetch_loop_cards,
+    fetch_loop_history,
+    fetch_loop_messages,
+    fetch_skills_catalog,
+    is_daemon_live,
+    protocol1_rpc,
+    request_daemon_config_reload,
+    request_daemon_shutdown,
+    websocket_url_from_config,
+)
+from soothe_client.intent_hints import (
+    DEFAULT_DELIVERABLE_PHASES,
+    EMBED,
+    IMAGE_TO_TEXT,
+    OCR,
+    TEXT_COMPLETION,
+    validate_loop_input_intent_hint,
+)
+from soothe_client.session import (
+    bootstrap_loop_session,
+    connect_websocket_with_retries,
+)
+from soothe_client.websocket import WebSocketClient
+
+try:
+    __version__ = importlib.metadata.version("soothe-client-python")
+except importlib.metadata.PackageNotFoundError:
+    __version__ = "0.0.0"
+
+__all__ = [
+    "__version__",
+    # Transport
+    "WebSocketClient",
+    "ProtocolError",
+    # Errors
+    "DaemonError",
+    "DisconnectCause",
+    "ReconnectError",
+    "StaleLoopError",
+    "disconnect_cause_name",
+    # Command clients
+    "AsyncCommandClient",
+    "CommandClient",
+    "command_client_from_config",
+    "async_command_client_from_config",
+    # Session bootstrap
+    "bootstrap_loop_session",
+    "connect_websocket_with_retries",
+    # Helpers
+    "websocket_url_from_config",
+    "connected_websocket",
+    "protocol1_rpc",
+    "check_daemon_status",
+    "is_daemon_live",
+    "request_daemon_config_reload",
+    "request_daemon_shutdown",
+    "fetch_skills_catalog",
+    "fetch_config_section",
+    "fetch_loop_history",
+    "fetch_loop_cards",
+    "fetch_loop_messages",
+    # Intent hints
+    "TEXT_COMPLETION",
+    "IMAGE_TO_TEXT",
+    "OCR",
+    "EMBED",
+    "DEFAULT_DELIVERABLE_PHASES",
+    "validate_loop_input_intent_hint",
+]

soothe_client_python-0.9.10/src/soothe_client/ws_command_client.py → soothe_client_python-0.10.0/src/soothe_client/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_python-0.9.10 → soothe_client_python-0.10.0}/src/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/src/soothe_client/__init__.py

@@ -1,189 +0,0 @@
-"""Soothe WebSocket client for talking to a running soothe-daemon.
-
-Public surface (community apps)::
-
-    from soothe_client import WebSocketClient, is_daemon_live
-    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``.
-"""
-
-from __future__ import annotations
-
-import importlib.metadata
-import warnings
-from typing import Any
-
-from soothe_sdk.wire.codec import ProtocolError
-
-from soothe_client.errors import (
-    DaemonError,
-    DisconnectCause,
-    ReconnectError,
-    StaleLoopError,
-    disconnect_cause_name,
-)
-from soothe_client.helpers import (
-    check_daemon_status,
-    connected_websocket,
-    fetch_config_section,
-    fetch_loop_cards,
-    fetch_loop_history,
-    fetch_loop_messages,
-    fetch_skills_catalog,
-    is_daemon_live,
-    protocol1_rpc,
-    request_daemon_config_reload,
-    request_daemon_shutdown,
-    websocket_url_from_config,
-)
-from soothe_client.intent_hints import (
-    DEFAULT_DELIVERABLE_PHASES,
-    EMBED,
-    IMAGE_TO_TEXT,
-    OCR,
-    TEXT_COMPLETION,
-    validate_loop_input_intent_hint,
-)
-from soothe_client.session import (
-    bootstrap_loop_session,
-    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
-    "WebSocketClient",
-    "ProtocolError",
-    # Errors
-    "DaemonError",
-    "DisconnectCause",
-    "ReconnectError",
-    "StaleLoopError",
-    "disconnect_cause_name",
-    # Command clients (canonical + preferred aliases)
-    "WsCommandClient",
-    "SyncWsCommandClient",
-    "AsyncCommandClient",
-    "CommandClient",
-    "ws_command_client_from_config",
-    "async_ws_command_client_from_config",
-    "command_client_from_config",
-    "async_command_client_from_config",
-    # Session bootstrap
-    "bootstrap_loop_session",
-    "connect_websocket_with_retries",
-    # Helpers
-    "websocket_url_from_config",
-    "connected_websocket",
-    "protocol1_rpc",
-    "check_daemon_status",
-    "is_daemon_live",
-    "request_daemon_config_reload",
-    "request_daemon_shutdown",
-    "fetch_skills_catalog",
-    "fetch_config_section",
-    "fetch_loop_history",
-    "fetch_loop_cards",
-    "fetch_loop_messages",
-    # Intent hints
-    "TEXT_COMPLETION",
-    "IMAGE_TO_TEXT",
-    "OCR",
-    "EMBED",
-    "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)