@xiangyixie/dsh-superagent 0.9.2 → 0.9.3

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 (3) hide show
  1. package/CHANGELOG.md +22 -0
  2. package/README.md +17 -6
  3. package/package.json +1 -1
package/CHANGELOG.md CHANGED
@@ -1,5 +1,27 @@
1
1
  # Changelog
2
2
 
3
+ Doc-only releases: npm serves the README from the tarball, so a README edit is
4
+ invisible on the package page until something is published. When the edit
5
+ changes what a reader would do — install commands, limits, troubleshooting
6
+ steps — it gets its own patch version (0.9.2, 0.9.3). Typos and wording ride
7
+ along with the next code release. A doc-only version leaves `lib/` and `bin/`
8
+ byte-identical to the version before it, and the pinned install line in the
9
+ README is updated to the version being released.
10
+
11
+ ## 0.9.3 — 2026-11-14
12
+
13
+ Documentation only; no code change.
14
+
15
+ - Both install commands name the version (`@xiangyixie/dsh-superagent@0.9.3`),
16
+ and the Quickstart explains why: pnpm's minimum release age skips packages
17
+ published in the last few hours, so a bare `add` installs an older version and
18
+ still reports success. A bare install here resolved 0.9.0 while 0.9.2 was
19
+ current.
20
+ - Added the command that reports what actually landed:
21
+ `npm ls --prefix <DSH_HOME>/profiles/web @xiangyixie/dsh-superagent`.
22
+ - The troubleshooting rows for a missing tool and for
23
+ `Cannot find module .../lib/control.js` now carry the pinned reinstall command.
24
+
3
25
  ## 0.9.2 — 2026-11-14
4
26
 
5
27
  Documentation only; no code change. npm renders the README from the tarball, so
package/README.md CHANGED
@@ -24,7 +24,7 @@ with the host's credentials and filesystem; this is not a sandbox.
24
24
  in the environment:
25
25
 
26
26
  ```bash
27
- dsh plugin --profile web add @xiangyixie/dsh-superagent
27
+ dsh plugin --profile web add @xiangyixie/dsh-superagent@0.9.3
28
28
  ```
29
29
 
30
30
  Then ask the session for a run — a real call, not a sketch:
@@ -73,15 +73,25 @@ your `PATH`, use `npx @deepseek-ai/dsh@0.2.2-rc.1` instead.
73
73
 
74
74
  ```bash
75
75
  # 1. install the plugin into a profile (web, headless, ... whatever you run)
76
- dsh plugin --profile web add @xiangyixie/dsh-superagent
76
+ dsh plugin --profile web add @xiangyixie/dsh-superagent@0.9.3
77
77
 
78
78
  # 2. confirm the bundle row exists in the merged config
79
79
  dsh --profile web --dump-config
80
80
  ```
81
81
 
82
- `add @xiangyixie/dsh-superagent` resolves the published package. For an offline
83
- machine or a pinned artifact, install a packed tarball instead — it is
84
- byte-identical to what the registry serves:
82
+ Name the version. Without one, pnpm's minimum release age policy skips releases
83
+ published in the last few hours and installs the newest older one, so a bare
84
+ `add` succeeds while giving you a version that is not current. If you would
85
+ rather track the newest release, add it to `minimumReleaseAgeExclude` in the
86
+ profile's `pnpm-workspace.yaml`; otherwise bump the number above. Check what
87
+ actually landed with:
88
+
89
+ ```bash
90
+ npm ls --prefix <DSH_HOME>/profiles/web @xiangyixie/dsh-superagent
91
+ ```
92
+
93
+ For an offline machine or a pinned artifact, install a packed tarball instead —
94
+ it is byte-identical to what the registry serves:
85
95
 
86
96
  ```bash
87
97
  npm pack # writes xiangyixie-dsh-superagent-<version>.tgz
@@ -507,7 +517,8 @@ appears to "hang" until the ignored-abort child returns.
507
517
 
508
518
  | What you see | What it means | What to do |
509
519
  | --- | --- | --- |
510
- | `superagent_*` tools do not exist | The bundle row is not mounted, or the host refused to load the plugin. | Run `--dump-config` and check for the `@xiangyixie/dsh-superagent` block; reinstall with `dsh plugin --profile <p> add @xiangyixie/dsh-superagent` and read the host log for `[dsh-superagent]` lines. |
520
+ | `superagent_*` tools do not exist | The bundle row is not mounted, or the host refused to load the plugin. | Run `--dump-config` and check for the `@xiangyixie/dsh-superagent` block; reinstall with `dsh plugin --profile <p> add @xiangyixie/dsh-superagent@0.9.3` and read the host log for `[dsh-superagent]` lines. |
521
+ | `Cannot find module .../lib/control.js` (or `watch.js` / `report.js`) and the plugin never activates | The copy in that profile is incomplete — an `add` that was interrupted leaves a partial extraction. The published package is not the cause: every version ships all eight `lib/` files. | Delete the plugin's directory under the profile's `node_modules` (scoped `@xiangyixie/dsh-superagent`, or unscoped `dsh-superagent` from an older tarball install) and run the same `add` command again, with the version number. Do not copy files in by hand. |
511
522
  | `[error] the model provider rejected the API key` | The key env var is missing in the process that started the host. | Export `DEEPSEEK_API_KEY` (the default route) or the variable your route names, then restart `dsh`. |
512
523
  | `MISSING_CREDENTIAL ... no API key for provider route "..."` | The profile's route has no credential in the environment. | Set the env var named for that route and restart. The error line names the route, so use that, not this page. |
513
524
  | `[error] the subagent service is unavailable` | The profile has no `subagents` service, so the plugin has nothing to spawn. | Use a profile built on the base bundle (`web` or `headless` from the stock image), or add the subagent plugin to the profile. |
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@xiangyixie/dsh-superagent",
3
- "version": "0.9.2",
3
+ "version": "0.9.3",
4
4
  "description": "Long-horizon autonomous runs for DeepSeek Harness: one goal, model-planned parallel subtasks, one merged report, durable across restarts.",
5
5
  "author": "Admire (LittleChenLiya)",
6
6
  "type": "module",