dsh-ringcentral

If your team collaborates daily in RingCentral Team Messaging and runs LLM agents with deepseek-harness, dsh-ringcentral bridges the two: inbound chat posts drive the agent inference loop directly, and assistant replies flow back as Mini-Markdown threaded posts anchored to the original message, creating a natural conversational experience. The plugin requires no external SDK; it speaks the RingCentral v1 REST API and WebSocket subscription stream natively, follows the dsh "plugins, not loop changes" principle as a pure Cordis plugin, reuses host-side agent, session, model-routing, and tool-presentation services, and degrades gracefully whenever optional seams are absent rather than crashing.

On the session side, every RingCentral peer-identity (individual, team channel, or group chat) receives an isolated agent session. The SessionId is deterministically derived via SHA-256 from the server URL, bot token, and peer identity, guaranteeing that the same user or chat always routes to the same context across restarts. Access-control semantics mirror dsh-qqbot: DMs and the three group-chat types (Team, Everyone, Group) each support disabled, allowlist, or open modes, and group chats require an explicit @-mention by default. When the agent needs to ask the user a question, the prompt is rendered as a threaded post in the chat; the user answers by typing an option number or free text, and the response resolves the pending question without polluting session history. Unanswered asks time out after ten minutes.

Configuration-wise, the plugin registers a settings card in the Web GUI where every non-secret field is editable online and takes effect on the very next inbound message with no restart, while the four secret fields are write-only controls that report only whether a value is set and never echo the value back to the browser page, supporting near-instant hot rotation of REST clients and WebSocket reconnection. In a bare YAML deployment without a settings service the card simply does not mount and the plugin behaves identically to before. This plugin is well suited for development teams that already collaborate in RingCentral and want to embed dsh agents into their everyday chat workflow.