dsh-run

Plugin del DeepSeek Harness que añade, arriba a la derecha de la cabecera de sesión (junto al botón Open in…), un botón compuesto para los scripts de npm del proyecto abierto.

┌──────────────────────┬─┐
│ ▶  npm run dev       │▾│      ← el botón principal ejecuta el script por defecto
└──────────────────────┴─┘      ← la flecha despliega TODOS los scripts del package.json

English: a DeepSeek Harness web plugin. The Session header grows a split button (play + chevron) that runs one script from the workspace's package.json: the main button runs the default (dev, else start, else the first declared), the chevron lists and runs every script and makes it the new default. It renders nothing when the workspace has no package.json scripts, turns into a stop button while a script is alive, and shows the failure output when a launch dies early. See English at the end.

Qué hace

• Lee package.json del directorio de trabajo de la sesión (el cwd).
• Solo aparece si hay package.json con scripts. Sin manifiesto, o sin scripts, el botón no se renderiza: no queda ni un hueco vacío.
• Botón principal: muestra el icono de play y el comando por defecto (npm run dev). Al pulsarlo, lo ejecuta. Mientras corre, el icono cambia a stop y un segundo clic detiene el proceso (grupo de procesos completo: npm → sh → el servidor).
• Desplegable: lista todos los scripts declarados como npm run <script>. Al elegir uno, se ejecuta y pasa a ser el nuevo por defecto del botón de play. La elección se recuerda por proyecto en el navegador (localStorage, clave dsh-run.defaults).
• Por defecto automático: dev; si no existe, start; si tampoco, el primer script del manifiesto.
• Fallo visible: si un script muere con código distinto de cero en los primeros 30 s, el botón se pinta en rojo y el tooltip trae la última línea de su salida. Un script ya en marcha no se relanza por doble clic: la petición reutiliza la ejecución viva.

Rutas host

Ruta	Qué hace
GET /dsh-run/scripts?cwd=<abs>	Scripts del package.json, el defecto automático y la tabla de ejecuciones de ese proyecto.
POST /dsh-run/run	{ cwd, script } → npm run <script> en ese directorio.
POST /dsh-run/stop	{ cwd, script } → termina el grupo de procesos de esa ejecución.
GET /dsh-run/log?cwd=&script=&bytes=	Cola de salida recogida (stdout/stderr) de una ejecución.

Todas pasan primero por el filtro de confianza del harness (connection.requestRejection): mismo cerco Host/Origin y misma cookie de sesión que el resto de la API. Además, cada ruta con cuerpo valida el JSON en el borde y vuelve a resolver el proyecto en el host: el directorio debe ser absoluto y existir, y el script pedido debe estar declarado en su propio package.json.

Los procesos se lanzan por el servicio subprocess del harness, así que terminate() alcanza a todo el grupo de procesos, la salida queda legible después de salir y descargar el plugin detiene lo que él mismo arrancó.

Instalación

# desde GitHub (público)
dsh plugin --profile web add github:albertgranados/dsh-run

# o desde un checkout local (queda enlazado: editar y reiniciar)
dsh plugin --profile web add /ruta/a/dsh-run

# y reinicia el harness

El paquete declara dsh.bundle.patch, así que el propio dsh plugin reconcilia dsh.profile.bundles solo: no hay que editar package.json ni cordis.patch.yml a mano. No hay build: lib/index.js y lib/client.js van compilados a mano en el repo (el cliente se sirve crudo al navegador, no pasa por ningún bundler).

Tras reiniciar, recarga la página del navegador (http://127.0.0.1:3080). El botón solo aparece en sesiones cuyo workspace tenga un package.json.

Desinstalar

dsh plugin --profile web remove dsh-run

Verificación rápida

# ¿está la fila del plugin en el árbol del perfil?
dsh --profile web --dump-config | grep -A2 dsh-run

# con el harness en marcha (necesita la cookie del navegador para las rutas)
curl -s "http://127.0.0.1:3080/dsh-run/scripts?cwd=$PWD" | head

Notas

• El comando es siempre npm run <script>; npm se resuelve por el mismo mundo de ejecución que usa el resto del harness (subprocess.resolveExecutable).
• Variables de entorno: los hijos arrancan con el entorno del harness ya depurado por el propio harness (sin credenciales ni DSH_*), más FORCE_COLOR=0 / NO_COLOR=1 para que el log no lleve secuencias ANSI.
• Límites: como mucho 8 ejecuciones concurrentes, 32 KiB de cola en memoria por flujo y 4 MiB de spill en disco por ejecución (la ruta completa del log sale en la cabecera de /dsh-run/log).

English

A DeepSeek Harness web plugin: a Session-header split button for the workspace's npm scripts.

• Main button (play icon + the default command, e.g. npm run dev) runs the default script — dev, else start, else the first one declared. While a run is alive it turns into a stop button, and a second click terminates the whole npm process group (npm → sh → the dev server).
• Chevron lists every script in package.json as npm run <script>. Picking one runs it and makes it the new default for that workspace, remembered in the browser (localStorage, key dsh-run.defaults).
• Renders nothing when the workspace has no package.json scripts, or before the host answers.
• An early non-zero exit paints the button red and the tooltip carries the last line of that run's output; the dress clears after 8 seconds.

Install:

dsh plugin --profile web add github:albertgranados/dsh-run
# restart the harness, then reload the browser page

Host routes (all behind the harness's Host/Origin fence and login cookie):

Route	Purpose
GET /dsh-run/scripts?cwd=<abs>	Scripts, auto-picked default, live run table.
POST /dsh-run/run	{ cwd, script } → npm run <script>.
POST /dsh-run/stop	{ cwd, script } → terminate that run's process group.
GET /dsh-run/log?cwd=&script=&bytes=	Collected stdout/stderr tail.

MIT licensed.