Introduction

The design philosophy of DSH is “everything is a plugin”. During development, bidirectional communication between the host and client often requires handling complex networking layers and protocol adaptation. The following section introduces memorax-ai/the-binding-of-dsh, which integrates native DSH Connection and Typert Gateway to solve the problem of bidirectional service calls between the Host and Client.

Plugin Positioning

This is a DSH plugin for establishing bidirectional RPC between the Host and Client. It is maintained by memorax-ai and primarily addresses the following issues:
* Host-to-Client calls: Supports targeted calls to connected browser or Node objects.
* Bidirectional communication: Supports symmetric bidirectional calls via Typert Gateway.
* Lifecycle management: Handles request association, cancellation, and connection lifecycle.

Core Features

  • Targeted Host-to-Client calls: Supports calling connected browser or Node peers.
  • Symmetric Typert Gateway calls: Supports bidirectional calls via Typert Gateway.
  • Connection and request handling: Provides mechanisms for request association, cancellation, and connection lifecycle handling.
  • Multi-version compatibility strategy:
    • Legacy hosts: Share native events.host WebSocket for RPC and events.
    • Modern hosts: Use Binding sockets for bidirectional RPC and native Gateway streams for events.
  • Separation of concerns: The Connection object is responsible for peer addressing and lifecycle; the Typert Gateway object is responsible for service descriptors, encoders/decoders, calls, and errors.

Installation and Activation

Installing this plugin requires the following environment:
* Node.js 22.22.3 or later.
* Harmony 0.8.6 or later (Harmony automatically resolves browser module dependencies and automatically orders Binding modules).

The installation command is as follows:

npm install the-binding-of-dsh

Typical Usage

The plugin provides a set of APIs for Host and Client usage:

  • Subscribe to events:
    peer.subscribe('api-session/status', (...args) => refreshSessionStatus(args))
  • Handle events:
    peer.handleEvent('approval/request', async ({ agentId, request, signal }) => {
      // 处理逻辑
    })
  • Establish connection:
    await peer.connect()
  • Streaming:
    stream(endpoint, payload, signal)

Notes

  • Connection status: connect() only resolves after the Gateway is ready for the handshake. After disconnection, call connect() again or enable reconnectDelayMs for automatic retries.
  • Event replay: Binding does not replay events. After the connection is restored, manually refresh the application state and reopen business streams.
  • Agent context: Handlers do not rebuild Agent context.
  • Version compatibility: If a legacy client only requests Legacy events, Modern hosts return HTTP 409.
  • Code verification: This plugin follows the MIT license. Inspect the source code and license before installation.

Summary

This plugin provides a structured bidirectional communication layer for DSH development, simplifying the interaction logic between the Host and Client. The complete source code and documentation are available on GitHub.

References

  • GitHub: https://github.com/memorax-ai/the-binding-of-dsh
  • Catalog page: https://www.skillhub.cn/plugins/memorax-ai/the-binding-of-dsh