@zoraxylia/dsh-codex-adapter 0.1.0 → 0.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude-plugin/marketplace.json +2 -2
- package/.claude-plugin/plugin.json +2 -2
- package/.mcp.json +1 -1
- package/README.de.md +32 -32
- package/README.es.md +32 -32
- package/README.fr.md +32 -32
- package/README.hi.md +32 -32
- package/README.id.md +32 -32
- package/README.ja.md +32 -32
- package/README.ko.md +32 -32
- package/README.md +33 -33
- package/README.pt.md +32 -32
- package/README.ru.md +32 -32
- package/README.th.md +32 -32
- package/README.tr.md +32 -32
- package/README.vi.md +32 -32
- package/README.zh-TW.md +32 -32
- package/README.zh.md +33 -33
- package/agy/agents/ds-flash.md +1 -1
- package/agy/agents/ds-pro.md +1 -1
- package/agy/skills/dsh-playbook/SKILL.md +1 -1
- package/codex/agents/ds-flash.toml +2 -2
- package/codex/agents/ds-pro.toml +2 -2
- package/codex/prompts/dsh-playbook.md +1 -1
- package/commands/off.md +1 -1
- package/commands/playbook.md +1 -1
- package/cordis.patch.yml +2 -2
- package/grok/agents/ds-flash.md +1 -1
- package/grok/agents/ds-pro.md +1 -1
- package/grok/commands/dsh-config.md +1 -1
- package/grok/commands/dsh-playbook.md +2 -2
- package/grok/commands/dsh-status.md +1 -1
- package/lib/client.js +37 -27
- package/lib/server.mjs +22 -22
- package/package.json +6 -5
- package/scripts/bump-version.mjs +79 -0
- package/scripts/fake-agy.sh +3 -3
- package/scripts/release-local.mjs +2 -2
- package/scripts/smoke-bundle.mjs +2 -2
- package/scripts/smoke-pack.mjs +4 -4
- package/scripts/smoke.mjs +3 -3
- package/scripts/verify-wpc10-client.mjs +2 -2
- package/scripts/verify-wpc14-proc-endpoints.mjs +6 -6
- package/scripts/verify-wpc9-guardrails.mjs +10 -10
- package/src/cli-workers.mjs +1 -1
- package/src/client/index.tsx +34 -32
- package/src/cwd-lock.mjs +1 -1
- package/src/hub/index.mjs +10 -10
- package/src/hub-client.mjs +4 -4
- package/src/install/install.mjs +35 -32
- package/src/jobs.mjs +2 -2
- package/src/multimodal.mjs +18 -18
- package/src/origin-guard.mjs +8 -8
- package/src/plugin-env.mjs +2 -2
- package/src/proc-kill.mjs +5 -5
- package/src/provider-probe.mjs +3 -3
- package/src/server.mjs +4 -4
- package/src/status-shard.mjs +2 -2
- package/src/vision-route.mjs +3 -3
- package/statusline/statusline.sh +1 -1
- package/statusline/worker-segment.sh +3 -3
- package/worker.cordis.yml +1 -1
- /package/docs/images/{dsh-crew-host.png → dsh-adapter-host.png} +0 -0
- /package/docs/images/{dsh-crew-jobs.png → dsh-adapter-jobs.png} +0 -0
- /package/docs/images/{dsh-crew-logo.png → dsh-adapter-logo.png} +0 -0
- /package/docs/images/{dsh-crew-overview.png → dsh-adapter-overview.png} +0 -0
package/README.md
CHANGED
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
<p align="center">
|
|
2
|
-
<img src="./docs/images/dsh-
|
|
2
|
+
<img src="./docs/images/dsh-adapter-logo.png" alt="DSH Adapter" width="120" />
|
|
3
3
|
</p>
|
|
4
4
|
|
|
5
|
-
<h1 align="center">DSH
|
|
5
|
+
<h1 align="center">DSH Adapter</h1>
|
|
6
6
|
|
|
7
7
|
<p align="center">
|
|
8
|
-
<sub>Independent fork of <a href="https://github.com/ZSeven-W/dsh-crew">dsh-
|
|
8
|
+
<sub>Independent fork of <a href="https://github.com/ZSeven-W/dsh-crew">dsh-adapter</a> (MIT) — see <a href="./NOTICE">NOTICE</a>.</sub>
|
|
9
9
|
</p>
|
|
10
10
|
|
|
11
11
|
<p align="center">
|
|
@@ -28,13 +28,13 @@
|
|
|
28
28
|
<br />
|
|
29
29
|
|
|
30
30
|
<p align="center">
|
|
31
|
-
<img src="./docs/images/dsh-
|
|
31
|
+
<img src="./docs/images/dsh-adapter-overview.png" alt="DSH Adapter — settings page" width="100%" />
|
|
32
32
|
</p>
|
|
33
|
-
<p align="center"><sub>The DSH
|
|
33
|
+
<p align="center"><sub>The DSH Adapter settings page — host integrations, dispatch policy, execution and the multimodal bridge</sub></p>
|
|
34
34
|
|
|
35
|
-
## Why DSH
|
|
35
|
+
## Why DSH Adapter
|
|
36
36
|
|
|
37
|
-
DSH
|
|
37
|
+
DSH Adapter is a plugin for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (DSH) — an open-source agent harness. It makes DSH agents dispatchable from Claude Code, Codex, Antigravity and Grok: the orchestrator keeps its own model, the work runs on a real DSH agent with that harness's tools, sandbox, presets and session history, and the host still shows it as a native subagent with live progress.
|
|
38
38
|
|
|
39
39
|
What runs the work is a DSH agent, not a bare model call. Tiers (`flash` / `pro`) select how much capability that agent gets from the harness's configured roster — DeepSeek V4 Flash and V4 Pro today — so a change of model in DSH needs no change here.
|
|
40
40
|
|
|
@@ -83,7 +83,7 @@ Every dispatch is checked before anything spawns. Worker→worker nesting is cap
|
|
|
83
83
|
|
|
84
84
|
### 📋 Jobs Board
|
|
85
85
|
|
|
86
|
-
The DSH
|
|
86
|
+
The DSH Adapter panel doubles as a jobs board: every worker job — running or finished — is listed with tier, effort, live progress and tokens, held workspaces show their holders, and a job that vanishes mid-flight (e.g. a hub restart) is surfaced as an orphan ghost instead of disappearing silently.
|
|
87
87
|
|
|
88
88
|
</td>
|
|
89
89
|
</tr>
|
|
@@ -122,14 +122,14 @@ Claude Code / Codex / Antigravity / Grok (orchestrator, keeps its own model)
|
|
|
122
122
|
Dispatch fans out. Below, eighteen workers translate this README in parallel: the host counts them as its own subagents, while the harness runs them as real sessions.
|
|
123
123
|
|
|
124
124
|
<p align="center">
|
|
125
|
-
<img src="./docs/images/dsh-
|
|
125
|
+
<img src="./docs/images/dsh-adapter-host.png" alt="Claude Code" width="100%" />
|
|
126
126
|
</p>
|
|
127
|
-
<p align="center"><sub>Claude Code sees dsh-
|
|
127
|
+
<p align="center"><sub>Claude Code sees dsh-adapter workers as native subagents, with a statusline segment tracking running tiers, elapsed time and tokens.</sub></p>
|
|
128
128
|
|
|
129
129
|
<p align="center">
|
|
130
|
-
<img src="./docs/images/dsh-
|
|
130
|
+
<img src="./docs/images/dsh-adapter-jobs.png" alt="DSH Adapter" width="100%" />
|
|
131
131
|
</p>
|
|
132
|
-
<p align="center"><sub>The DSH
|
|
132
|
+
<p align="center"><sub>The DSH Adapter panel sees the same run from the harness side: which host dispatched each job, its tier and effort, live progress and token usage.</sub></p>
|
|
133
133
|
|
|
134
134
|
<p align="center"><sub>The panel is also the jobs board: running and finished jobs stay listed with tier, progress and tokens, held workspaces name their holders, and a job that vanishes mid-flight (a hub restart) surfaces as an orphan ghost instead of disappearing silently.</sub></p>
|
|
135
135
|
|
|
@@ -145,7 +145,7 @@ dsh web
|
|
|
145
145
|
Or, for local development straight from the source tree:
|
|
146
146
|
|
|
147
147
|
```bash
|
|
148
|
-
dsh plugin --profile web add link:/path/to/dsh-
|
|
148
|
+
dsh plugin --profile web add link:/path/to/dsh-adapter
|
|
149
149
|
dsh web
|
|
150
150
|
```
|
|
151
151
|
|
|
@@ -155,7 +155,7 @@ The `link:` protocol symlinks the profile dependency to this repository, so rebu
|
|
|
155
155
|
|
|
156
156
|
In hub mode — the installation above — workers run inside the DSH instance and use the DeepSeek credentials it is already configured with. Nothing else to set up.
|
|
157
157
|
|
|
158
|
-
Only the standalone fallback needs a key of its own: dispatching from a host with no DSH instance running launches a worker runtime as a separate process. Obtain an API key from [platform.deepseek.com](https://platform.deepseek.com) and write it to `~/.config/dsh-
|
|
158
|
+
Only the standalone fallback needs a key of its own: dispatching from a host with no DSH instance running launches a worker runtime as a separate process. Obtain an API key from [platform.deepseek.com](https://platform.deepseek.com) and write it to `~/.config/dsh-adapter/.env`:
|
|
159
159
|
|
|
160
160
|
```
|
|
161
161
|
DEEPSEEK_API_KEY=sk-...
|
|
@@ -169,7 +169,7 @@ node scripts/smoke.mjs
|
|
|
169
169
|
|
|
170
170
|
The smoke test dispatches one cheap job through whichever path is available — the hub when a DSH instance is running, standalone otherwise — and prints which one it used. Within about ten seconds you should see `smoke test passed — configuration OK`. On failure the reason is printed, scoped to the path that was tested.
|
|
171
171
|
|
|
172
|
-
Then open Settings → DSH
|
|
172
|
+
Then open Settings → DSH Adapter and install the host integrations — Claude Code, Codex, Antigravity, Grok — with one click, or drive the same installer from the command line:
|
|
173
173
|
|
|
174
174
|
```bash
|
|
175
175
|
node src/install/cli.mjs claude # Claude Code plugin: marketplace + permissions + HUD segment
|
|
@@ -196,7 +196,7 @@ node src/install/cli.mjs uninstall-claude
|
|
|
196
196
|
|
|
197
197
|
One-click installation (choose one):
|
|
198
198
|
|
|
199
|
-
- **DSH settings page** (when hub mode is installed): Settings → DSH
|
|
199
|
+
- **DSH settings page** (when hub mode is installed): Settings → DSH Adapter → "Install to Claude Code"
|
|
200
200
|
- **Command line**: `node src/install/cli.mjs all`
|
|
201
201
|
|
|
202
202
|
Both do the same thing: register local marketplace (the repo itself, via `.claude-plugin/marketplace.json`) + `claude plugin install` + MCP tool permission allowlist + claude-hud worker status segment config (auto-backup settings.json before changes, idempotent). **Restart the session after installation for changes to take effect.**
|
|
@@ -208,7 +208,7 @@ Both do the same thing: register local marketplace (the repo itself, via `.claud
|
|
|
208
208
|
- **HUD status line segment**: `⚙dsh 1▶pro 2m14s 21.7k/606 ✓3` (current tier / elapsed time / token usage / completion count)
|
|
209
209
|
- For local development, `statusline/statusline.sh` or `statusline/worker-segment.sh` can be independently integrated
|
|
210
210
|
- **Long-running tasks**: CC has timeout limits on MCP calls (`MCP_TOOL_TIMEOUT` adjustable), long tasks can have orchestrator use `dsh_spawn_worker` + `dsh_worker_result(wait_seconds)` polling
|
|
211
|
-
- **Local development and debugging**: `claude --plugin-dir /path/to/dsh-
|
|
211
|
+
- **Local development and debugging**: `claude --plugin-dir /path/to/dsh-adapter` to temporarily load
|
|
212
212
|
|
|
213
213
|
|
|
214
214
|
### Session commands
|
|
@@ -217,11 +217,11 @@ These override the global defaults for the current session only, and are enforce
|
|
|
217
217
|
|
|
218
218
|
| Command | What it does |
|
|
219
219
|
|---|---|
|
|
220
|
-
| `/dsh-
|
|
220
|
+
| `/dsh-adapter:config` | Show or set this session's defaults: `tier=flash\|pro`, `effort=off\|high\|max`, `mode=auto\|hub\|standalone`, `timeout=<seconds>`, `policy=auto\|flash-only\|pro-only`, `escalate=true\|false`, `origin_depth_limit=<1-32>`, `preset_flash/preset_pro=<preset id|default>`, `reset` |
|
|
221
221
|
|
|
222
|
-
| `/dsh-
|
|
223
|
-
| `/dsh-
|
|
224
|
-
| `/dsh-
|
|
222
|
+
| `/dsh-adapter:on` · `/dsh-adapter:off` | Turn dispatch for this session on or off (off is a hard switch: the tool refuses) |
|
|
223
|
+
| `/dsh-adapter:status` | Live status of worker jobs: tier, progress, tokens, current tool |
|
|
224
|
+
| `/dsh-adapter:playbook` | Dispatch best practices: choosing flash vs pro, self-contained briefs, parallelism, verifying results, guardrails |
|
|
225
225
|
|
|
226
226
|
## Codex
|
|
227
227
|
|
|
@@ -272,7 +272,7 @@ Three prompts are installed for Codex:
|
|
|
272
272
|
node src/install/cli.mjs agy
|
|
273
273
|
```
|
|
274
274
|
|
|
275
|
-
Registers the dsh-
|
|
275
|
+
Registers the dsh-adapter MCP server in `~/.gemini/config/mcp_config.json` and installs the `ds-flash` / `ds-pro` agents plus the `dsh-config`, `dsh-status` and `dsh-playbook` skills into `~/.gemini/config/` (all files backed up first). Restart the session after installation.
|
|
276
276
|
|
|
277
277
|
### Usage
|
|
278
278
|
|
|
@@ -301,7 +301,7 @@ Uninstall: `node src/install/cli.mjs uninstall-agy`
|
|
|
301
301
|
node src/install/cli.mjs grok
|
|
302
302
|
```
|
|
303
303
|
|
|
304
|
-
Writes the `[mcp_servers.dsh-
|
|
304
|
+
Writes the `[mcp_servers.dsh-adapter]` section into `~/.grok/config.toml` and installs the `ds-flash` / `ds-pro` agents plus the `/dsh-config`, `/dsh-status` and `/dsh-playbook` commands into `~/.grok/` (all files backed up first).
|
|
305
305
|
|
|
306
306
|
### Usage
|
|
307
307
|
|
|
@@ -333,7 +333,7 @@ Uninstall: `node src/install/cli.mjs uninstall-grok`
|
|
|
333
333
|
| `dsh_worker_cancel` | Cancel specified job, terminate its runtime process |
|
|
334
334
|
| `dsh_worker_config` | Read/set session defaults (tier, effort, mode, timeout, policy, escalation) and list `worker_profiles` |
|
|
335
335
|
|
|
336
|
-
Progress is simultaneously mirrored to `~/.config/dsh-
|
|
336
|
+
Progress is simultaneously mirrored to `~/.config/dsh-adapter/status.d/` (one shard file per writer, can be read by statusline / external monitoring).
|
|
337
337
|
|
|
338
338
|
## Dispatch guardrails
|
|
339
339
|
|
|
@@ -344,7 +344,7 @@ Every dispatch is checked before anything spawns — refusals are readable error
|
|
|
344
344
|
|
|
345
345
|
## Dispatch playbook
|
|
346
346
|
|
|
347
|
-
How to dispatch *well* — flash vs pro, self-contained briefs, safe parallelism, verifying results, and the guardrails above — is bundled as a per-host playbook: `/dsh-
|
|
347
|
+
How to dispatch *well* — flash vs pro, self-contained briefs, safe parallelism, verifying results, and the guardrails above — is bundled as a per-host playbook: `/dsh-adapter:playbook` (Claude Code skill), `/dsh-playbook` (Codex prompt, Antigravity skill, Grok command).
|
|
348
348
|
|
|
349
349
|
## Explicit CLI backends
|
|
350
350
|
|
|
@@ -354,7 +354,7 @@ How to dispatch *well* — flash vs pro, self-contained briefs, safe parallelism
|
|
|
354
354
|
|
|
355
355
|
**DeepSeek is a text-only model** and does not support image input or generation. This plugin sources these capabilities externally through MCP tools:
|
|
356
356
|
|
|
357
|
-
**Native vision first**: when the vision provider is a built-in CLI (or explicitly `native`), `describe_image` first tries DeepSeek's own VL model `deepseek-v4-flash-vision-exp` (direct API call; key from `DEEPSEEK_API_KEY` or `~/.config/dsh-
|
|
357
|
+
**Native vision first**: when the vision provider is a built-in CLI (or explicitly `native`), `describe_image` first tries DeepSeek's own VL model `deepseek-v4-flash-vision-exp` (direct API call; key from `DEEPSEEK_API_KEY` or `~/.config/dsh-adapter/.env`). Any failure degrades gracefully to the CLI provider chain below, which is kept as the fallback. Image generation is untouched — the native model only ever looks at pictures.
|
|
358
358
|
|
|
359
359
|
| Tool | Description |
|
|
360
360
|
|---|---|
|
|
@@ -365,7 +365,7 @@ How to dispatch *well* — flash vs pro, self-contained briefs, safe parallelism
|
|
|
365
365
|
|
|
366
366
|
### Configuration
|
|
367
367
|
|
|
368
|
-
In **DSH settings page → DSH
|
|
368
|
+
In **DSH settings page → DSH Adapter → Multimodal** (or directly edit `~/.config/dsh-adapter/config.json`):
|
|
369
369
|
|
|
370
370
|
**Vision provider** (image viewing):
|
|
371
371
|
|
|
@@ -409,15 +409,15 @@ Two integration methods:
|
|
|
409
409
|
|
|
410
410
|
## Hub mode
|
|
411
411
|
|
|
412
|
-
This package is also a valid DSH bundle (`dsh.bundle` + `cordis.patch.yml`). After installing into DSH Web profile with `dsh plugin add dsh-
|
|
412
|
+
This package is also a valid DSH bundle (`dsh.bundle` + `cordis.patch.yml`). After installing into DSH Web profile with `dsh plugin add dsh-adapter`:
|
|
413
413
|
|
|
414
414
|
- **Worker sessions become first-class citizens**: run as first-class sessions in DSH host (`agents.create` + per-session model/effort waterfall + default preset), appear in Web UI session list, can be opened anytime to view complete execution
|
|
415
415
|
- **Organize by working directory**: manage worker sessions by cwd in Web UI
|
|
416
416
|
- **Loopback API**:
|
|
417
|
-
- `POST/GET /_dsh/dsh-
|
|
418
|
-
- `GET /_dsh/dsh-
|
|
419
|
-
- `POST /_dsh/dsh-
|
|
420
|
-
- **Auto-detection**: the hosts' MCP shim auto-detects hub (`
|
|
417
|
+
- `POST/GET /_dsh/dsh-adapter/jobs`: spawn tasks, list, long-poll results, cancel
|
|
418
|
+
- `GET /_dsh/dsh-adapter/ping`: health check (MCP shim uses this to detect if hub is running)
|
|
419
|
+
- `POST /_dsh/dsh-adapter/install`: one-click install of the host integrations — Claude Code / Codex / Antigravity / Grok (backend of `src/install/`)
|
|
420
|
+
- **Auto-detection**: the hosts' MCP shim auto-detects hub (`DSHPLUGIN_ADAPTER_HUB` env var, default `http://127.0.0.1:3080`)
|
|
421
421
|
- DSH Web running → jobs enter hub mode (`mode: "hub"`)
|
|
422
422
|
- Not running → fall back to standalone runtime
|
|
423
423
|
|
|
@@ -441,7 +441,7 @@ This package is also a valid DSH bundle (`dsh.bundle` + `cordis.patch.yml`). Aft
|
|
|
441
441
|
|
|
442
442
|
### Running DSH Web → hub mode auto-enabled
|
|
443
443
|
|
|
444
|
-
- **Current state**: If `dsh plugin add dsh-
|
|
444
|
+
- **Current state**: If `dsh plugin add dsh-adapter` installed into DSH Web profile, jobs run as first-class sessions in host, appear in Web UI session list
|
|
445
445
|
- **Recommendation**: During local development iteration, recommend enabling hub mode; worker progress can be fully observed in Web UI; for cross-machine collaboration or environments without Web UI, use the dispatching-host shell approach
|
|
446
446
|
|
|
447
447
|
### Known items
|
package/README.pt.md
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
<p align="center">
|
|
2
|
-
<img src="./docs/images/dsh-
|
|
2
|
+
<img src="./docs/images/dsh-adapter-logo.png" alt="DSH Adapter" width="120" />
|
|
3
3
|
</p>
|
|
4
4
|
|
|
5
|
-
<h1 align="center">DSH
|
|
5
|
+
<h1 align="center">DSH Adapter</h1>
|
|
6
6
|
|
|
7
7
|
<p align="center">
|
|
8
8
|
<strong>Um plugin do <a href="https://github.com/deepseek-ai/deepseek-harness">DeepSeek Harness</a>: envie trabalho para agentes DSH a partir do Claude Code / Codex / Antigravity / Grok, sem abrir mão da UI nativa de subagent do host.</strong><br />
|
|
@@ -24,13 +24,13 @@
|
|
|
24
24
|
<br />
|
|
25
25
|
|
|
26
26
|
<p align="center">
|
|
27
|
-
<img src="./docs/images/dsh-
|
|
27
|
+
<img src="./docs/images/dsh-adapter-overview.png" alt="DSH Adapter — página de configurações" width="100%" />
|
|
28
28
|
</p>
|
|
29
|
-
<p align="center"><sub>A página de configurações do DSH
|
|
29
|
+
<p align="center"><sub>A página de configurações do DSH Adapter — integrações do host, política de despacho, execução e a ponte multimodal</sub></p>
|
|
30
30
|
|
|
31
|
-
## Por que DSH
|
|
31
|
+
## Por que DSH Adapter
|
|
32
32
|
|
|
33
|
-
O DSH
|
|
33
|
+
O DSH Adapter é um plugin para [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (DSH) — um harness de agente open-source. Ele torna os agentes DSH despacháveis a partir do Claude Code, Codex, Antigravity e Grok: o orchestrator mantém seu próprio modelo, o trabalho é executado em um agente DSH real com as ferramentas, o sandbox, os presets e o histórico de sessão desse harness, e o host continua exibindo-o como um subagent nativo com progresso ao vivo.
|
|
34
34
|
|
|
35
35
|
O que executa o trabalho é um agente DSH, não uma chamada de modelo pura. Os tiers (`flash` / `pro`) selecionam quanta capacidade esse agente recebe do roster configurado do harness — DeepSeek V4 Flash e V4 Pro hoje — portanto, uma mudança de modelo no DSH não exige mudança aqui.
|
|
36
36
|
|
|
@@ -79,7 +79,7 @@ Todo despacho é verificado antes de qualquer coisa ser iniciada. O aninhamento
|
|
|
79
79
|
|
|
80
80
|
### 📋 Quadro de Jobs
|
|
81
81
|
|
|
82
|
-
O painel do DSH
|
|
82
|
+
O painel do DSH Adapter também funciona como um quadro de jobs: cada job de worker — em execução ou concluído — é listado com tier, effort, progresso ao vivo e tokens; workspaces ocupados mostram seus detentores; e um job que desaparece no meio da execução (por exemplo, um restart do hub) aparece como um fantasma órfão em vez de desaparecer silenciosamente.
|
|
83
83
|
|
|
84
84
|
</td>
|
|
85
85
|
</tr>
|
|
@@ -118,14 +118,14 @@ Claude Code / Codex / Antigravity / Grok (orchestrator, mantém o próprio model
|
|
|
118
118
|
O despacho se espalha. Abaixo, dezoito workers traduzem este README em paralelo: o host os conta como seus próprios subagents, enquanto o harness os executa como sessões reais.
|
|
119
119
|
|
|
120
120
|
<p align="center">
|
|
121
|
-
<img src="./docs/images/dsh-
|
|
121
|
+
<img src="./docs/images/dsh-adapter-host.png" alt="Claude Code" width="100%" />
|
|
122
122
|
</p>
|
|
123
|
-
<p align="center"><sub>No Claude Code, os workers do dsh-
|
|
123
|
+
<p align="center"><sub>No Claude Code, os workers do dsh-adapter são subagents nativos; o segmento da statusline acompanha os tiers em execução, o tempo decorrido e os tokens.</sub></p>
|
|
124
124
|
|
|
125
125
|
<p align="center">
|
|
126
|
-
<img src="./docs/images/dsh-
|
|
126
|
+
<img src="./docs/images/dsh-adapter-jobs.png" alt="DSH Adapter" width="100%" />
|
|
127
127
|
</p>
|
|
128
|
-
<p align="center"><sub>O painel do DSH
|
|
128
|
+
<p align="center"><sub>O painel do DSH Adapter mostra a mesma execução pelo lado do harness: qual host despachou cada job, seu tier e effort, o progresso ao vivo e o uso de tokens.</sub></p>
|
|
129
129
|
|
|
130
130
|
<p align="center"><sub>O painel também é o quadro de jobs: jobs em execução e concluídos permanecem listados com tier, progresso e tokens, workspaces ocupados nomeiam seus detentores, e um job que desaparece no meio da execução (um restart do hub) aparece como um fantasma órfão em vez de desaparecer silenciosamente.</sub></p>
|
|
131
131
|
|
|
@@ -141,7 +141,7 @@ dsh web
|
|
|
141
141
|
Ou, para desenvolvimento local a partir do código-fonte:
|
|
142
142
|
|
|
143
143
|
```bash
|
|
144
|
-
dsh plugin --profile web add link:/path/to/dsh-
|
|
144
|
+
dsh plugin --profile web add link:/path/to/dsh-adapter
|
|
145
145
|
dsh web
|
|
146
146
|
```
|
|
147
147
|
|
|
@@ -151,7 +151,7 @@ O protocolo `link:` cria um symlink da dependência do perfil para este reposit
|
|
|
151
151
|
|
|
152
152
|
No modo hub — a instalação anterior — os workers são executados dentro da instância DSH e usam as credenciais do DeepSeek já configuradas. Nada mais para configurar.
|
|
153
153
|
|
|
154
|
-
Apenas o fallback standalone precisa de sua própria key: despachar de um host sem uma instância DSH em execução inicia um worker runtime como um processo separado. Obtenha uma API key em [platform.deepseek.com](https://platform.deepseek.com) e escreva em `~/.config/dsh-
|
|
154
|
+
Apenas o fallback standalone precisa de sua própria key: despachar de um host sem uma instância DSH em execução inicia um worker runtime como um processo separado. Obtenha uma API key em [platform.deepseek.com](https://platform.deepseek.com) e escreva em `~/.config/dsh-adapter/.env`:
|
|
155
155
|
|
|
156
156
|
```
|
|
157
157
|
DEEPSEEK_API_KEY=sk-...
|
|
@@ -165,7 +165,7 @@ node scripts/smoke.mjs
|
|
|
165
165
|
|
|
166
166
|
O smoke test despacha uma tarefa econômica por qualquer caminho disponível — o hub se uma instância DSH está em execução, caso contrário standalone — e imprime qual foi utilizado. Em cerca de dez segundos você deve ver `smoke test passed — configuration OK`. Em caso de falha o motivo é impresso, limitado ao caminho que foi testado.
|
|
167
167
|
|
|
168
|
-
Depois abra Configurações → DSH
|
|
168
|
+
Depois abra Configurações → DSH Adapter e instale as integrações do host — Claude Code, Codex, Antigravity, Grok — com um clique, ou acione o mesmo instalador pela linha de comando:
|
|
169
169
|
|
|
170
170
|
```bash
|
|
171
171
|
node src/install/cli.mjs claude # plugin do Claude Code: marketplace + permissões + segmento do HUD
|
|
@@ -192,7 +192,7 @@ node src/install/cli.mjs uninstall-claude
|
|
|
192
192
|
|
|
193
193
|
Instalação em um clique (escolha uma opção):
|
|
194
194
|
|
|
195
|
-
- **Página de configurações do DSH** (quando o modo hub está instalado): Configurações → DSH
|
|
195
|
+
- **Página de configurações do DSH** (quando o modo hub está instalado): Configurações → DSH Adapter → "Install to Claude Code"
|
|
196
196
|
- **Linha de comando**: `node src/install/cli.mjs all`
|
|
197
197
|
|
|
198
198
|
Ambas fazem a mesma coisa: registrar o marketplace local (diretório pai `dsh-plugins/` como raiz do marketplace) + `claude plugin install` + allowlist de permissões das ferramentas MCP + configuração do segmento de status do worker no claude-hud (backup automático do settings.json antes de alterações, idempotente). **Reinicie a sessão após a instalação para que as alterações entrem em vigor.**
|
|
@@ -204,7 +204,7 @@ Ambas fazem a mesma coisa: registrar o marketplace local (diretório pai `dsh-pl
|
|
|
204
204
|
- **Segmento da linha de status do HUD**: `⚙dsh 1▶pro 2m14s 21.7k/606 ✓3` (tier atual / tempo decorrido / uso de tokens / contagem de conclusões)
|
|
205
205
|
- Para desenvolvimento local, `statusline/statusline.sh` ou `statusline/worker-segment.sh` podem ser integrados de forma independente
|
|
206
206
|
- **Tarefas de longa duração**: o CC tem limites de timeout em chamadas MCP (`MCP_TOOL_TIMEOUT` ajustável); tarefas longas podem fazer o orchestrator usar `dsh_spawn_worker` + polling com `dsh_worker_result(wait_seconds)`
|
|
207
|
-
- **Desenvolvimento e depuração locais**: `claude --plugin-dir /path/to/dsh-
|
|
207
|
+
- **Desenvolvimento e depuração locais**: `claude --plugin-dir /path/to/dsh-adapter` para carregar temporariamente
|
|
208
208
|
|
|
209
209
|
|
|
210
210
|
### Comandos de sessão
|
|
@@ -213,11 +213,11 @@ Substituem os padrões globais apenas na sessão atual e são aplicados na camad
|
|
|
213
213
|
|
|
214
214
|
| Comando | O que faz |
|
|
215
215
|
|---|---|
|
|
216
|
-
| `/dsh-
|
|
216
|
+
| `/dsh-adapter:config` | Mostrar ou definir os padrões da sessão: `tier=flash\|pro`, `effort=off\|high\|max`, `mode=auto\|hub\|standalone`, `timeout=<segundos>`, `policy=auto\|flash-only\|pro-only`, `escalate=true\|false`, `origin_depth_limit=<1-32>`, `preset_flash/preset_pro=<preset id|default>`, `reset` |
|
|
217
217
|
|
|
218
|
-
| `/dsh-
|
|
219
|
-
| `/dsh-
|
|
220
|
-
| `/dsh-
|
|
218
|
+
| `/dsh-adapter:on` · `/dsh-adapter:off` | Ligar ou desligar o despacho nesta sessão (desligado é chave rígida: a ferramenta recusa) |
|
|
219
|
+
| `/dsh-adapter:status` | Status ao vivo dos jobs de worker: tier, progresso, tokens, ferramenta atual |
|
|
220
|
+
| `/dsh-adapter:playbook` | Boas práticas de despacho: escolher flash vs pro, briefs autocontidos, paralelismo, verificação de resultados, proteções |
|
|
221
221
|
|
|
222
222
|
## Codex
|
|
223
223
|
|
|
@@ -268,7 +268,7 @@ Três prompts são instalados para o Codex:
|
|
|
268
268
|
node src/install/cli.mjs agy
|
|
269
269
|
```
|
|
270
270
|
|
|
271
|
-
Registra o servidor MCP dsh-
|
|
271
|
+
Registra o servidor MCP dsh-adapter em `~/.gemini/config/mcp_config.json` e instala os agents `ds-flash` / `ds-pro`, além das skills `dsh-config`, `dsh-status` e `dsh-playbook`, em `~/.gemini/config/` (todos os arquivos têm backup antes). Reinicie a sessão após a instalação.
|
|
272
272
|
|
|
273
273
|
### Uso
|
|
274
274
|
|
|
@@ -297,7 +297,7 @@ Desinstalar: `node src/install/cli.mjs uninstall-agy`
|
|
|
297
297
|
node src/install/cli.mjs grok
|
|
298
298
|
```
|
|
299
299
|
|
|
300
|
-
Escreve a seção `[mcp_servers.dsh-
|
|
300
|
+
Escreve a seção `[mcp_servers.dsh-adapter]` em `~/.grok/config.toml` e instala os agents `ds-flash` / `ds-pro`, além dos comandos `/dsh-config`, `/dsh-status` e `/dsh-playbook`, em `~/.grok/` (todos os arquivos têm backup antes).
|
|
301
301
|
|
|
302
302
|
### Uso
|
|
303
303
|
|
|
@@ -329,7 +329,7 @@ Desinstalar: `node src/install/cli.mjs uninstall-grok`
|
|
|
329
329
|
| `dsh_worker_cancel` | Cancela o job especificado e encerra o processo do runtime |
|
|
330
330
|
| `dsh_worker_config` | Ler/definir os padrões da sessão (tier, effort, mode, timeout, policy, escalation) e listar `worker_profiles` |
|
|
331
331
|
|
|
332
|
-
O progresso também é espelhado em `~/.config/dsh-
|
|
332
|
+
O progresso também é espelhado em `~/.config/dsh-adapter/status.d/` (um arquivo shard por escritor, que pode ser lido por statusline / monitoramento externo).
|
|
333
333
|
|
|
334
334
|
## Proteções de despacho
|
|
335
335
|
|
|
@@ -340,7 +340,7 @@ Todo despacho é verificado antes de qualquer coisa ser iniciada — recusas sã
|
|
|
340
340
|
|
|
341
341
|
## Playbook de despacho
|
|
342
342
|
|
|
343
|
-
Como despachar *bem* — flash vs pro, briefs autocontidos, paralelismo seguro, verificação de resultados e as proteções acima — vem empacotado como um playbook por host: `/dsh-
|
|
343
|
+
Como despachar *bem* — flash vs pro, briefs autocontidos, paralelismo seguro, verificação de resultados e as proteções acima — vem empacotado como um playbook por host: `/dsh-adapter:playbook` (skill do Claude Code), `/dsh-playbook` (prompt do Codex, skill do Antigravity, comando do Grok).
|
|
344
344
|
|
|
345
345
|
## Backends de CLI explícitos
|
|
346
346
|
|
|
@@ -350,7 +350,7 @@ Como despachar *bem* — flash vs pro, briefs autocontidos, paralelismo seguro,
|
|
|
350
350
|
|
|
351
351
|
**DeepSeek é um modelo somente texto** e não suporta entrada ou geração de imagens. Este plugin obtém essas capacidades externamente por meio de ferramentas MCP:
|
|
352
352
|
|
|
353
|
-
**Visão nativa primeiro**: quando o provedor de visão é uma CLI embutida (ou explicitamente `native`), o `describe_image` tenta primeiro o modelo VL da própria DeepSeek `deepseek-v4-flash-vision-exp` (chamada de API direta; key de `DEEPSEEK_API_KEY` ou `~/.config/dsh-
|
|
353
|
+
**Visão nativa primeiro**: quando o provedor de visão é uma CLI embutida (ou explicitamente `native`), o `describe_image` tenta primeiro o modelo VL da própria DeepSeek `deepseek-v4-flash-vision-exp` (chamada de API direta; key de `DEEPSEEK_API_KEY` ou `~/.config/dsh-adapter/.env`). Qualquer falha degrada graciosamente para a cadeia de provedores de CLI abaixo, que é mantida como fallback. A geração de imagens não é afetada — o modelo nativo apenas olha para imagens.
|
|
354
354
|
|
|
355
355
|
| Ferramenta | Descrição |
|
|
356
356
|
|---|---|
|
|
@@ -361,7 +361,7 @@ Como despachar *bem* — flash vs pro, briefs autocontidos, paralelismo seguro,
|
|
|
361
361
|
|
|
362
362
|
### Configuração
|
|
363
363
|
|
|
364
|
-
Na **página de configurações do DSH → DSH
|
|
364
|
+
Na **página de configurações do DSH → DSH Adapter → Multimodal** (ou edite diretamente `~/.config/dsh-adapter/config.json`):
|
|
365
365
|
|
|
366
366
|
**Provedor de visão** (visualização de imagens):
|
|
367
367
|
|
|
@@ -405,15 +405,15 @@ Dois métodos de integração:
|
|
|
405
405
|
|
|
406
406
|
## Modo hub
|
|
407
407
|
|
|
408
|
-
Este pacote também é um bundle DSH válido (`dsh.bundle` + `cordis.patch.yml`). Após instalar no perfil do DSH Web com `dsh plugin add dsh-
|
|
408
|
+
Este pacote também é um bundle DSH válido (`dsh.bundle` + `cordis.patch.yml`). Após instalar no perfil do DSH Web com `dsh plugin add dsh-adapter`:
|
|
409
409
|
|
|
410
410
|
- **Sessões de worker se tornam cidadãs de primeira classe**: são executadas como sessões de primeira classe no host DSH (`agents.create` + waterfall de model/effort por sessão + preset padrão), aparecem na lista de sessões da Web UI e podem ser abertas a qualquer momento para ver a execução completa
|
|
411
411
|
- **Organize por diretório de trabalho**: gerencie sessões de worker por cwd na Web UI
|
|
412
412
|
- **Loopback API**:
|
|
413
|
-
- `POST/GET /_dsh/dsh-
|
|
414
|
-
- `GET /_dsh/dsh-
|
|
415
|
-
- `POST /_dsh/dsh-
|
|
416
|
-
- **Detecção automática**: o shim MCP dos hosts detecta automaticamente o hub (`
|
|
413
|
+
- `POST/GET /_dsh/dsh-adapter/jobs`: cria tarefas, lista, faz long-poll de resultados e cancela
|
|
414
|
+
- `GET /_dsh/dsh-adapter/ping`: verificação de saúde (o shim MCP usa isso para detectar se o hub está em execução)
|
|
415
|
+
- `POST /_dsh/dsh-adapter/install`: instalação em um clique das integrações do host — Claude Code / Codex / Antigravity / Grok (backend de `src/install/`)
|
|
416
|
+
- **Detecção automática**: o shim MCP dos hosts detecta automaticamente o hub (`DSHPLUGIN_ADAPTER_HUB` env var, padrão `http://127.0.0.1:3080`)
|
|
417
417
|
- DSH Web em execução → os jobs entram no modo hub (`mode: "hub"`)
|
|
418
418
|
- Sem execução → volta para o runtime standalone
|
|
419
419
|
|
|
@@ -437,7 +437,7 @@ Este pacote também é um bundle DSH válido (`dsh.bundle` + `cordis.patch.yml`)
|
|
|
437
437
|
|
|
438
438
|
### DSH Web em execução → modo hub ativado automaticamente
|
|
439
439
|
|
|
440
|
-
- **Estado atual**: se `dsh plugin add dsh-
|
|
440
|
+
- **Estado atual**: se `dsh plugin add dsh-adapter` foi instalado no perfil do DSH Web, os jobs são executados como sessões de primeira classe no host e aparecem na lista de sessões da Web UI
|
|
441
441
|
- **Recomendação**: durante a iteração de desenvolvimento local, recomenda-se ativar o modo hub; o progresso dos workers pode ser totalmente observado na Web UI; para colaboração entre máquinas ou ambientes sem Web UI, use a abordagem de shell do host de despacho
|
|
442
442
|
|
|
443
443
|
### Itens conhecidos
|