litestartup-com/dsh-api-gateway

REST + SSE gateway exposing running Harness sessions to third-party clients: API-key auth, token streaming, workspace grouping, and adopting GUI sessions to keep chatting.

It runs inside the DSH process and exposes the session surface over an authenticated HTTP facade under a frozen legacy apiproxy contract, aimed at remote clients such as dsh-agent-manager. POST {prefix}/proxy/<method> takes client-request envelopes and serves session.list, session.create, session.prompt, session.cancel, session.history, session.rename, session.fork, session.updateQueue, session.attachment, session.models, session.selectModel, respond and host.describe; anything whitelisted but unmigrated answers 501 rather than silently forwarding. Auth is API-key based with constant-time comparison, a one-time POST {prefix}/key bootstrap, optional X-Admin-Key endpoints for enable and rotate-key, and a downlink WebSocket mux at {prefix}/events.mux. A deny-by-default whitelist keeps the privileged plane (credentials., settings., host.openPath) unreachable. It also ships a Docker compose stack with nginx as a fail-closed front door proxying only /api-gw/, .env knobs for an OpenAI-compatible route, a pinned DSH_VERSION, and two web demos (KB Studio and a support widget).

Development & Runtime ★ 11 updated 2026-09-21
View on GitHub ↗

Install

dsh plugin --profile web add github:litestartup-com/dsh-api-gateway

Copied verbatim from the README's Install section (a powershell fenced block), which is followed by an instruction to add one row to the host composition and restart DSH. The the npm registry check (2026-10-17) found no package for this repo — no npm package published — so the GitHub form is shipped; the README also warns that DSH's built-in @deepseek-ai/dsh-api-gateway is an unrelated package.

Compatibility

The facade runs inside a DSH host, so its compatibility surface is the host version: package.json declares the peer range ^0.1.2-rc.1 || ^0.2.0-0, and the host enforces peers at install and at startup. End-to-end verified pairings listed are DSH 0.2.0-rc.2, 0.1.5-rc.2 and 0.1.2-rc.1, with 0.1.1-rc.2 marked legacy. The 0.1.5 and 0.2.0 lines need npm install --legacy-peer-deps because strict peer resolution rejects the default install, and installation also means adding a row to the host composition (examples/cordis.yml) and restarting DSH.

Details

Alternatives

TecFancy/dsh-auth-gate · ai-eks/dsh-auth-tunnel · Airmetro/dsh-update-checker

More plugins in Development & Runtime

Browse more in Development & Runtime

Guides for Development & Runtime plugins