dsh-mqtt

The dsh-mqtt plugin addresses the challenge of remotely controlling DeepSeek Harness agent tasks in distributed or network-constrained environments. By turning a DSH process into an MQTT-addressable agent worker, it enables users to submit tasks, monitor execution in real-time, and steer running agents from anywhere, without needing to expose an HTTP server—ideal for secure deployments behind NAT or firewalls. Its core capabilities include support for MQTT 3.1.1 and 5 protocols over various transports (TCP, TLS, WebSocket), broker authentication, persistent sessions, and node-scoped commands. Clients can submit work, inject context, cancel tasks, and receive normalized events and final results, with QoS 1 deduplication and safe event exposure for data privacy. This plugin is suited for users needing asynchronous automation, remote agent control, or distributed worker fleets, such as invoking private servers from CI/CD pipelines, running small clusters of agents with local resources (like repositories, browsers, or GPUs), or implementing simple software-to-agent event integration. However, it is not intended as a replacement for synchronous HTTP APIs or complex workflow systems that involve features like priority queues, dependency graphs, or exactly-once execution.