Introduction

When developing agents in the DSH ecosystem, handling long-running server processes is a common need. dsh-dev-server is designed to address the complexity of lifecycle management. It provides primitives rather than starting processes itself.

Plugin Positioning

This plugin is maintained by developer MkaliezZ and belongs to the workflow category. It provides lifecycle primitives for long-running development servers while simplifying environment management by blocking compound shell syntax.

Core Features

  1. Lifecycle Primitives: Provides the primitives needed to manage long-running development servers, helping developers precisely control server startup, execution, and shutdown.
  2. Shell Syntax Control: The plugin blocks compound shell syntax, which helps simplify environment configuration and maintain determinism in the execution environment.
  3. Process Supervision Separation: In version v0.1, the plugin separated the registry and state from the process supervisor provided by the host.
  4. Execution Permission Retention: The plugin does not generate processes itself and leaves execution permissions to the host (such as DSH, KerniQ, or AgentFuse).

Dependencies and Version

This plugin is built based on Node.js. Version information is as follows:

{
  "name": "@mkaliezz/dsh-dev-server",
  "version": "0.2.2",
  "type": "module",
  "engines": {
    "node": ">=20"
  }
}

Notes

  • Node Version: Before use, ensure the environment Node.js version is >= 20.
  • Execution Permissions: The plugin does not generate processes by itself; ensure the host environment (DSH/KerniQ/AgentFuse) has execution permissions.
  • License: This plugin uses the MIT License.

Summary

dsh-dev-server is suitable for developers who need to finely manage server lifecycles and control shell syntax structure in the DSH environment. By separating concerns (registry/state versus supervisor) and delegating process generation, it maintains system flexibility.