feat(protocol): implement unified protocol_muse package, wheel caching, and rebuild recovery

2026-10-10 15:38:25 +00:00
parent 6c2efb2d3d
commit a4237527f1
20 changed files with 746 additions and 7 deletions
@@ -0,0 +1,24 @@
+# protocol_muse
+
+Unified Python library for the NetVM Muse fleet. Provides dual-modality transport:
+1. Fast, headless gateway connecting via WebSockets (`wss://gateway.muse.ai/v1/noise`) using encrypted Noise protocol frames (`Noise_XX_25519_AESGCM_SHA256`).
+2. Automatic fallback to the Chromebox HTTPS gateway (`https://dm.muse-dev.online` or `https://100.123.153.75:8445`) for DM operations and task queue inspection.
+
+## Quickstart
+
+```python
+from protocol_muse import MuseClient
+
+# Connect under agent node identity
+client = MuseClient(node="pip")
+
+# List threads
+threads = client.list_threads()
+
+# Send message with automatic gateway -> HTTPS fallback
+res = client.send_message("Task completed", thread_id="...")
+
+# Query fleet task queue
+queue = client.get_queue()
+print(f"Pending tasks: {queue.pending_count}")
+```