@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.
Files changed (66) hide show
  1. package/.claude-plugin/marketplace.json +2 -2
  2. package/.claude-plugin/plugin.json +2 -2
  3. package/.mcp.json +1 -1
  4. package/README.de.md +32 -32
  5. package/README.es.md +32 -32
  6. package/README.fr.md +32 -32
  7. package/README.hi.md +32 -32
  8. package/README.id.md +32 -32
  9. package/README.ja.md +32 -32
  10. package/README.ko.md +32 -32
  11. package/README.md +33 -33
  12. package/README.pt.md +32 -32
  13. package/README.ru.md +32 -32
  14. package/README.th.md +32 -32
  15. package/README.tr.md +32 -32
  16. package/README.vi.md +32 -32
  17. package/README.zh-TW.md +32 -32
  18. package/README.zh.md +33 -33
  19. package/agy/agents/ds-flash.md +1 -1
  20. package/agy/agents/ds-pro.md +1 -1
  21. package/agy/skills/dsh-playbook/SKILL.md +1 -1
  22. package/codex/agents/ds-flash.toml +2 -2
  23. package/codex/agents/ds-pro.toml +2 -2
  24. package/codex/prompts/dsh-playbook.md +1 -1
  25. package/commands/off.md +1 -1
  26. package/commands/playbook.md +1 -1
  27. package/cordis.patch.yml +2 -2
  28. package/grok/agents/ds-flash.md +1 -1
  29. package/grok/agents/ds-pro.md +1 -1
  30. package/grok/commands/dsh-config.md +1 -1
  31. package/grok/commands/dsh-playbook.md +2 -2
  32. package/grok/commands/dsh-status.md +1 -1
  33. package/lib/client.js +37 -27
  34. package/lib/server.mjs +22 -22
  35. package/package.json +6 -5
  36. package/scripts/bump-version.mjs +79 -0
  37. package/scripts/fake-agy.sh +3 -3
  38. package/scripts/release-local.mjs +2 -2
  39. package/scripts/smoke-bundle.mjs +2 -2
  40. package/scripts/smoke-pack.mjs +4 -4
  41. package/scripts/smoke.mjs +3 -3
  42. package/scripts/verify-wpc10-client.mjs +2 -2
  43. package/scripts/verify-wpc14-proc-endpoints.mjs +6 -6
  44. package/scripts/verify-wpc9-guardrails.mjs +10 -10
  45. package/src/cli-workers.mjs +1 -1
  46. package/src/client/index.tsx +34 -32
  47. package/src/cwd-lock.mjs +1 -1
  48. package/src/hub/index.mjs +10 -10
  49. package/src/hub-client.mjs +4 -4
  50. package/src/install/install.mjs +35 -32
  51. package/src/jobs.mjs +2 -2
  52. package/src/multimodal.mjs +18 -18
  53. package/src/origin-guard.mjs +8 -8
  54. package/src/plugin-env.mjs +2 -2
  55. package/src/proc-kill.mjs +5 -5
  56. package/src/provider-probe.mjs +3 -3
  57. package/src/server.mjs +4 -4
  58. package/src/status-shard.mjs +2 -2
  59. package/src/vision-route.mjs +3 -3
  60. package/statusline/statusline.sh +1 -1
  61. package/statusline/worker-segment.sh +3 -3
  62. package/worker.cordis.yml +1 -1
  63. /package/docs/images/{dsh-crew-host.png → dsh-adapter-host.png} +0 -0
  64. /package/docs/images/{dsh-crew-jobs.png → dsh-adapter-jobs.png} +0 -0
  65. /package/docs/images/{dsh-crew-logo.png → dsh-adapter-logo.png} +0 -0
  66. /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-crew-logo.png" alt="DSH Crew" width="120" />
2
+ <img src="./docs/images/dsh-adapter-logo.png" alt="DSH Adapter" width="120" />
3
3
  </p>
4
4
 
5
- <h1 align="center">DSH Crew</h1>
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-crew</a> (MIT) &mdash; see <a href="./NOTICE">NOTICE</a>.</sub>
8
+ <sub>Independent fork of <a href="https://github.com/ZSeven-W/dsh-crew">dsh-adapter</a> (MIT) &mdash; 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-crew-overview.png" alt="DSH Crew — settings page" width="100%" />
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 Crew settings page — host integrations, dispatch policy, execution and the multimodal bridge</sub></p>
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 Crew
35
+ ## Why DSH Adapter
36
36
 
37
- DSH Crew 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.
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 Crew 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.
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-crew-host.png" alt="Claude Code" width="100%" />
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-crew workers as native subagents, with a statusline segment tracking running tiers, elapsed time and tokens.</sub></p>
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-crew-jobs.png" alt="DSH Crew" width="100%" />
130
+ <img src="./docs/images/dsh-adapter-jobs.png" alt="DSH Adapter" width="100%" />
131
131
  </p>
132
- <p align="center"><sub>The DSH Crew 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>
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-crew
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-crew/.env`:
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 Crew and install the host integrations — Claude Code, Codex, Antigravity, Grok — with one click, or drive the same installer from the command line:
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 Crew → "Install to Claude Code"
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-crew` to temporarily load
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-crew: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` |
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-crew:on` · `/dsh-crew:off` | Turn dispatch for this session on or off (off is a hard switch: the tool refuses) |
223
- | `/dsh-crew:status` | Live status of worker jobs: tier, progress, tokens, current tool |
224
- | `/dsh-crew:playbook` | Dispatch best practices: choosing flash vs pro, self-contained briefs, parallelism, verifying results, guardrails |
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-crew 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.
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-crew]` 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).
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-crew/status.d/` (one shard file per writer, can be read by statusline / external monitoring).
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-crew:playbook` (Claude Code skill), `/dsh-playbook` (Codex prompt, Antigravity skill, Grok command).
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-crew/.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.
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 Crew → Multimodal** (or directly edit `~/.config/dsh-crew/config.json`):
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-crew`:
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-crew/jobs`: spawn tasks, list, long-poll results, cancel
418
- - `GET /_dsh/dsh-crew/ping`: health check (MCP shim uses this to detect if hub is running)
419
- - `POST /_dsh/dsh-crew/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_CREW_HUB` env var, default `http://127.0.0.1:3080`)
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-crew` installed into DSH Web profile, jobs run as first-class sessions in host, appear in Web UI session list
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-crew-logo.png" alt="DSH Crew" width="120" />
2
+ <img src="./docs/images/dsh-adapter-logo.png" alt="DSH Adapter" width="120" />
3
3
  </p>
4
4
 
5
- <h1 align="center">DSH Crew</h1>
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-crew-overview.png" alt="DSH Crew — página de configurações" width="100%" />
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 Crew — integrações do host, política de despacho, execução e a ponte multimodal</sub></p>
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 Crew
31
+ ## Por que DSH Adapter
32
32
 
33
- O DSH Crew é 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.
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 Crew 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.
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-crew-host.png" alt="Claude Code" width="100%" />
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-crew são subagents nativos; o segmento da statusline acompanha os tiers em execução, o tempo decorrido e os tokens.</sub></p>
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-crew-jobs.png" alt="DSH Crew" width="100%" />
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 Crew 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>
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-crew
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-crew/.env`:
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 Crew e instale as integrações do host — Claude Code, Codex, Antigravity, Grok — com um clique, ou acione o mesmo instalador pela linha de comando:
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 Crew → "Install to Claude Code"
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-crew` para carregar temporariamente
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-crew: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` |
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-crew:on` · `/dsh-crew:off` | Ligar ou desligar o despacho nesta sessão (desligado é chave rígida: a ferramenta recusa) |
219
- | `/dsh-crew:status` | Status ao vivo dos jobs de worker: tier, progresso, tokens, ferramenta atual |
220
- | `/dsh-crew:playbook` | Boas práticas de despacho: escolher flash vs pro, briefs autocontidos, paralelismo, verificação de resultados, proteções |
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-crew 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.
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-crew]` 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).
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-crew/status.d/` (um arquivo shard por escritor, que pode ser lido por statusline / monitoramento externo).
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-crew:playbook` (skill do Claude Code), `/dsh-playbook` (prompt do Codex, skill do Antigravity, comando do Grok).
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-crew/.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.
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 Crew → Multimodal** (ou edite diretamente `~/.config/dsh-crew/config.json`):
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-crew`:
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-crew/jobs`: cria tarefas, lista, faz long-poll de resultados e cancela
414
- - `GET /_dsh/dsh-crew/ping`: verificação de saúde (o shim MCP usa isso para detectar se o hub está em execução)
415
- - `POST /_dsh/dsh-crew/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_CREW_HUB` env var, padrão `http://127.0.0.1:3080`)
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-crew` 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
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