soothe-client-python 0.9.4__py3-none-any.whl

soothe_client_python-0.9.4.dist-info/METADATA

@@ -0,0 +1,131 @@
+Metadata-Version: 2.4
+Name: soothe-client-python
+Version: 0.9.4
+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
+Project-URL: Repository, https://github.com/mirasoth/soothe-client-python
+License: MIT
+License-File: LICENSE
+Keywords: agents,ai,client,soothe,websocket
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: <3.15,>=3.11
+Requires-Dist: pydantic<3.0.0,>=2.0.0
+Requires-Dist: soothe-sdk<1.0.0,>=0.5.25
+Requires-Dist: websockets>=12.0
+Provides-Extra: dev
+Requires-Dist: mypy>=1.0.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=1.3.0; extra == 'dev'
+Requires-Dist: pytest-cov; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.12.0; extra == 'dev'
+Provides-Extra: image
+Requires-Dist: pillow>=10.0.0; extra == 'image'
+Description-Content-Type: text/markdown
+
+# soothe-client-python
+
+WebSocket client in Python for [soothe-daemon](https://github.com/mirasoth/soothe).
+
+Peer of [`soothe-client-go`](https://github.com/mirasoth/soothe-client-go) and
+[`@mirasoth/soothe-client`](https://github.com/mirasoth/soothe-client-typescript).
+
+## Install
+
+```bash
+pip install soothe-client-python
+# optional image compaction:
+pip install 'soothe-client-python[image]'
+# or, in the soothe monorepo workspace:
+uv sync --all-packages
+```
+
+## Quick start
+
+```python
+from soothe_client import WebSocketClient, bootstrap_loop_session, connect_websocket_with_retries
+
+client = WebSocketClient(url="ws://127.0.0.1:8765")
+await connect_websocket_with_retries(client)
+status = await bootstrap_loop_session(client, resume_loop_id=None)
+```
+
+## Layout (RFC-629)
+
+### Layer 0 (transport)
+
+| Module | Role |
+|--------|------|
+| `websocket` | Protocol-1 `WebSocketClient` |
+| `session` | Connect retries + loop bootstrap |
+| `helpers` | Daemon status / config / skills RPCs |
+| `ws_command_client` | Sync/async command helpers |
+| `protocol_params` | Client-side params models |
+| `intent_hints` | Intent-hint validation + `DEFAULT_DELIVERABLE_PHASES` |
+
+### Layer 1 (`soothe_client.appkit`)
+
+| Symbol | Role |
+|--------|------|
+| `DaemonSession` | Dual-socket loop session + `iter_turn_chunks` (CLI-grade) |
+| `QueryGate` | Single-flight cancel-before-context gating |
+| `EventClassifier` / `extract_thinking_step` | Deliverable / thinking-step mapping |
+| `SSEBroadcaster` | Drop-on-full SSE-style fan-out |
+| `ConnectionPool` / `TurnRunner` | Pooled multi-session turn execution |
+| Idle / soft-complete / `compact_*` | Turn lifecycle + optional Pillow compaction |
+| `SessionStore` | Persistence seam (Protocol) |
+
+```python
+from soothe_client.appkit import DaemonSession
+
+session = DaemonSession("ws://127.0.0.1:8765")
+await session.connect()
+await session.send_turn("hello")
+async for namespace, mode, data in session.iter_turn_chunks():
+    ...
+```
+
+Shared wire codec and path constants remain in **soothe-sdk**
+(`soothe_sdk.wire`, `soothe_sdk.paths`).
+
+## Development
+
+From this repository (or the `client/python` submodule):
+
+```bash
+make sync-dev      # uv sync --extra dev --extra image
+make fix           # ruff --fix + format
+make check         # format-check + lint + unit tests
+make test          # unit + examples
+make verify        # format-check + lint + test + build
+make publish-dry   # inspect upload without publishing
+make publish       # PyPI (trusted publisher in CI, or UV_PUBLISH_TOKEN locally)
+```
+
+| Target | Purpose |
+|--------|---------|
+| `format` / `format-check` | Ruff format |
+| `lint` / `lint-fix` / `fix` | Ruff lint (+ auto-fix) |
+| `test` / `test-unit` / `test-examples` | Pytest |
+| `test-coverage` | Coverage HTML under `htmlcov/` |
+| `build` | `uv build` → `dist/` |
+| `verify` | Full pre-publish gate |
+| `version-patch` / `-minor` / `-major` | Bump `VERSION` |
+
+Examples live under `examples/appkit/` (run with `make test-examples`).
+
+## Release
+
+GitHub Actions:
+
+- **CI** (`.github/workflows/ci.yml`) — format, lint, tests on Python 3.11–3.13
+- **Release** (`.github/workflows/release.yml`) — on GitHub Release publish, builds and uploads to PyPI via trusted publishing (skips if the `VERSION` already exists)

soothe_client_python-0.9.4.dist-info/RECORD

@@ -0,0 +1,28 @@
+soothe_client/__init__.py,sha256=ri6TjvFxo0faE8y-9JsCGCuP9ZSnO_z0UyOY8ON7JNM,4172
+soothe_client/errors.py,sha256=gOWYqrZbWxBMhYgtICxl2Di3ndME13qKcXxz1bwPdoQ,1800
+soothe_client/helpers.py,sha256=apmFfVzXrVeqxxHIwhjgSCpkLv42V2On40rsLX9437Q,13774
+soothe_client/intent_hints.py,sha256=KbOjV-8JKwpAcmdUesaow2fHnCujvhXEdPW0ff7CSUQ,1287
+soothe_client/protocol_params.py,sha256=ILY1jnbF_7NqfCjd7QPb4Fv5dY22py5pipkULouv1ng,17460
+soothe_client/schemas.py,sha256=uMacG4BSPOURlgVzfNcs8BkcAmFBGCFYmmDVk8TtkA4,1952
+soothe_client/session.py,sha256=NcXvs4okniCI4WjYe2R_DIL_wVx3bvoTujskXWhIY5w,7972
+soothe_client/websocket.py,sha256=Nitfx3hyIAqkfjXFQ6caln4_q1Ih-RKHye371A49McQ,66471
+soothe_client/ws_command_client.py,sha256=1tmzq5fC-ugVZ6CZt-ruoEv2Ivr30j6gnq2vFbdR4GI,22661
+soothe_client/appkit/__init__.py,sha256=RE7fEgqY49Q6m-PZKEPb2bDYNtxU8mA2uE9KsPAQHqg,3902
+soothe_client/appkit/attachments.py,sha256=NIUGqH_Be1iy50gCI5iDaZSWXbQq6Kchrid2vdq4KsI,3760
+soothe_client/appkit/broadcaster.py,sha256=wLqqAVEE2lIfHRy6woaQ4_B4tRhUcMaW3jclLNPOSNs,3547
+soothe_client/appkit/chunk_filter.py,sha256=UoC4kbS_65UNEJIjbyufqxGBLwvamwvQ26BqZ_gkDTg,3134
+soothe_client/appkit/classifier.py,sha256=og6O4VIyP8lOUIHMn0t4-bCKVgE4DdCJlr_xMAKAtPw,18637
+soothe_client/appkit/daemon_session.py,sha256=HRIunYPK6w89IcSlN4qXi_uNOxeQtfOOmKbf4H6j4Ag,26585
+soothe_client/appkit/events.py,sha256=p7uZmSx_kYdiR7DQY84rvgyHE6RQ6Orbq2KT-WCNsiM,2290
+soothe_client/appkit/managed_client.py,sha256=DLuOwSysSpRB0vj-M4_tAwLQM-qcN7VO9cjVTP9MajA,4952
+soothe_client/appkit/observability.py,sha256=9maW5oyEK0PZBjU7x8tHupoRBvAxApkHFQavRzkr7SM,650
+soothe_client/appkit/pool.py,sha256=auv1MIwRYpjLBnZB86at12xSIJj52J3TdZrfQpQFI_M,8742
+soothe_client/appkit/query_gate.py,sha256=fn6QNUCDtO_95pdVZn_XRM-ylezl-U_2nH7YIEcg6zc,3149
+soothe_client/appkit/session_store.py,sha256=uDWMZWYCIaRGmFNzhR2qCENeBOUE1tRtAiXGbqN830E,2739
+soothe_client/appkit/thinking_step.py,sha256=RoEKDO2na8L-m_DyvyPPblf7G5HPCuqdSTxQDeWEapA,4576
+soothe_client/appkit/turn.py,sha256=gtQyz3gGw8nkg8tfzpGZzNgRmJ48vJnj2Ll95W_BX4w,12479
+soothe_client/appkit/turn_runner.py,sha256=cTLU6W8fvWRtI9s2Xg-JZp2Z2UWrOpi86dZKfF3TFXs,20594
+soothe_client_python-0.9.4.dist-info/METADATA,sha256=cL9V7wqvQBuHu6kmwxSsCYXO9LD_fj32QhCCyX8Y_wU,4719
+soothe_client_python-0.9.4.dist-info/WHEEL,sha256=lCkmxWfQsSc9CfIClYeavTdQeEX2toPqufh9gI35EQA,87
+soothe_client_python-0.9.4.dist-info/licenses/LICENSE,sha256=WbXjnHkSCPG_f4TfOdS_mGrbkQAYykAdfIqVDj9O-IY,1068
+soothe_client_python-0.9.4.dist-info/RECORD,,

soothe_client_python-0.9.4.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.31.0
+Root-Is-Purelib: true
+Tag: py3-none-any

soothe_client_python-0.9.4.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mirasoth-AI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.