dfzjb/deskpet-bridge
DeskPet Bridge - a local JS agent preset for DSH (DeepSeek Harness)
安装Install
dsh plugin --profile web add github:dfzjb/deskpet-bridge把 dfzjb/deskpet-bridge 加入你的 DSH 配置（web profile）即可启用。
READMEREADME
DeskPet Bridge
English | 中文
A local JavaScript agent preset for DSH (DeepSeek Harness) that exposes the agent's runtime status over HTTP + SSE and adds a programmable approval channel.
Overview
deskpet-bridge is a standalone agent preset (three files) that you drop into DSH's .agent-presets/ directory. It requires no modification to the DSH codebase.
What it does for DSH
1. Extends DSH's web server
Registers three new routes on DSH's built-in webServer, giving DSH a few externally-callable endpoints:
| Endpoint | Purpose |
|---|---|
GET /api/deskpet/v2/get-status |
Query the current agent status snapshot |
GET /api/deskpet/v2/events |
Server-Sent Events realtime stream |
POST /api/deskpet/v2/approve |
Submit an approval decision |
2. Status observability
Listens to DSH's internal agent/status event, maintains a status cache (idle / running …), and counts state changes (changes) plus agent count (agentCount) — making DSH's runtime state queryable and subscribable by external programs.
3. Programmable approval channel (core)
Acts as an answerer in DSH's approval mechanism:
- Registers on
approval/requestwith{ prepend: true }, claiming the approval ahead of DSH's default approval panel (api-proxy). - Holds the approval (returns a pending Promise) and pushes the request to external clients over SSE.
- Resolves the approval when an external client submits a decision via
/approve— allowed-once or rejected. - Times out after 120 s (or on abort signal) as cancelled, so approvals never hang forever.
4. Realtime event stream
Broadcasts DSH internal events over SSE: hello / agent-status / approval-request / approval-decided / approval-expired, with a 5-second heartbeat.
5. Graceful fallback
When no external client is connected, the approval answerer calls next(), falling back to DSH's default approval panel — so DSH's original approval flow stays intact.
Files
| File | Purpose |
|---|---|
agent.cordis.yml |
Composition entry: id: deskpet-bridge + name: ./bridge.js |
bridge.js |
Core plugin (ESM: export name / inject / apply) |
preset.yml |
Preset metadata (name + description) |
Installation
Copy the three files into %DSH_HOME%/.agent-presets/deskpet-bridge/, then select (or set as default) the deskpet-bridge preset for your agent session.
API Contract
Base: http://127.0.0.1:3080 · Prefix: /api/deskpet/v2/
GET /get-status
{"ok":true,"status":"idle","agentCount":4,"changes":0,"connectedClients":0,"pendingApprovals":0}
GET /events (SSE, text/event-stream)
Events: hello / agent-status / approval-request / approval-decided / approval-expired
POST /approve
{"approvalId":"appr_N","decision":"approve-once"} → 200 {"ok":true,"outcome":"allowed-once"}
{"approvalId":"appr_N","decision":"reject"} → 200 {"ok":true,"outcome":"rejected"}
Unknown approvalId → 404 {"ok":false,"error":"unknown approvalId"}
How approval works
approval/request (waterfall)
└─ prepend answerer claims it
├─ external client connected → hold + push SSE approval-request
│ └─ POST /approve → resolve allowed-once / rejected
└─ no client → next() → DSH default approval panel
120s timeout / abort → cancelled
License
MIT — aligned with DSH's license.
相关推荐Related
- deepseek-ai/deepseek-harness DeepSeek Harness: Everything is a Plugin.
- deepseek-ai/deepseek-harness DeepSeek Harness (dsh) — 由 DeepSeek AI 开发的开源 agent harness（智能体框架）。一切皆插件：核心 + 插件 + 技能 = 可热插拔的 AI 编程工作台。DeepSeek Harness: …
-
ruvnet/ruflo
🌊 The original agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build c…
-
amruthpillai/reactive-resume
A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source a…
-
volcengine/OpenViking
Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.
-
Molunerfinn/PicGo
:rocket: The Ultimate Image Uploader for Efficient Creators. Supports Obsidian, Typora, VS Code etc. and 60+ image hosti…
-
titanwings/colleague-skill
将冰冷的离别化为温暖的 Skill，欢迎加入数字生命1.0！Transforming cold farewells into warm skills? It's giving rebirth era. Welcome to Digital …
-
nocobase/nocobase
NocoBase is an open-source AI + no-code platform for building business systems fast. Instead of generating everything fr…