box/packages/protocol-muse/README.md

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

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}")