prime-agent-dsh 0.2.0 → 0.2.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/CHANGELOG.md +7 -0
- package/README.md +5 -9
- package/docs/getting-started.md +17 -3
- package/extensions/index.ts +1 -1
- package/package.json +1 -1
- package/scripts/package-smoke.mjs +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -10,6 +10,13 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
|
|
|
10
10
|
|
|
11
11
|
- Added production-oriented installation, support, contribution, conduct, roadmap, and release documentation.
|
|
12
12
|
|
|
13
|
+
## 0.2.1 - 2026-09-22
|
|
14
|
+
|
|
15
|
+
### Changed
|
|
16
|
+
|
|
17
|
+
- Made npm installation the primary getting-started path after the verified v0.2.0 publication.
|
|
18
|
+
- Updated GitHub Actions to Node 24-based action runtimes.
|
|
19
|
+
|
|
13
20
|
## 0.2.0 - 2026-09-21
|
|
14
21
|
|
|
15
22
|
### Added
|
package/README.md
CHANGED
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
|
|
7
7
|
A context sidecar for Prime Agent. It turns the active Prime branch into a searchable, rebuildable DeepSeek Harness (DSH) projection, exposes bounded context tools in Python, and reports provider cache use. Prime remains the only agent loop and the only session authority.
|
|
8
8
|
|
|
9
|
-
>
|
|
9
|
+
> The pinned DeepSeek Harness `0.1.6-alpha.2` dependencies are developer previews. Review the security and compatibility notes before deployment.
|
|
10
10
|
|
|
11
11
|
## Why use it?
|
|
12
12
|
|
|
@@ -21,14 +21,10 @@ A context sidecar for Prime Agent. It turns the active Prime branch into a searc
|
|
|
21
21
|
Requirements, source installation, verification, upgrades, removal, and troubleshooting are in **[Getting started](docs/getting-started.md)**.
|
|
22
22
|
|
|
23
23
|
```bash
|
|
24
|
-
|
|
25
|
-
cd prime-agent-dsh
|
|
26
|
-
npm install
|
|
27
|
-
npm run release:check
|
|
28
|
-
prime-agent package install "$PWD"
|
|
24
|
+
prime-agent package install npm:prime-agent-dsh
|
|
29
25
|
```
|
|
30
26
|
|
|
31
|
-
Restart Prime Agent after installation. Then run `/dsh` and try `dsh_context.current()` in IPython.
|
|
27
|
+
Restart Prime Agent after installation. Then run `/dsh` and try `dsh_context.current()` in IPython. Source and project-local installation instructions are in the getting-started guide.
|
|
32
28
|
|
|
33
29
|
## Architecture invariants
|
|
34
30
|
|
|
@@ -56,7 +52,7 @@ The package does not ship a DSH `AgentLoop`, provider wrapper, ACP delegation pa
|
|
|
56
52
|
| Shadow telemetry | Optional | Diagnostic only; never changes provider context. |
|
|
57
53
|
| DSH-driven compaction | Not included | Prime alone decides and performs compaction. |
|
|
58
54
|
| DSH agent loop or tools | Not included | Would create a second execution authority. |
|
|
59
|
-
| npm installation |
|
|
55
|
+
| npm installation | Available | `prime-agent package install npm:prime-agent-dsh` |
|
|
60
56
|
|
|
61
57
|
## Python API at a glance
|
|
62
58
|
|
|
@@ -99,7 +95,7 @@ For grants and API rules, see [Getting started](docs/getting-started.md#use-the-
|
|
|
99
95
|
|
|
100
96
|
## Project status
|
|
101
97
|
|
|
102
|
-
`0.2.
|
|
98
|
+
`0.2.1` is a developer preview. The Prime integration, storage formats, and Python API may change before a stable release. The test suite covers the documented core paths, but this package is not a security boundary against another process running as the same OS user.
|
|
103
99
|
|
|
104
100
|
The current runtime target is Prime Agent `0.9.5` or newer (`@earendil-works/pi-coding-agent >=0.86.1`). See the [roadmap](ROADMAP.md) for direction rather than release promises.
|
|
105
101
|
|
package/docs/getting-started.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Getting started
|
|
2
2
|
|
|
3
|
-
This guide
|
|
3
|
+
This guide covers npm, GitHub, local, and project-scoped installation for `prime-agent-dsh` 0.2.1.
|
|
4
4
|
|
|
5
5
|
## Requirements
|
|
6
6
|
|
|
@@ -21,6 +21,20 @@ git --version
|
|
|
21
21
|
|
|
22
22
|
The package declares `@earendil-works/pi-coding-agent >=0.86.1` and related Prime packages as peer dependencies. `npm install` installs the pinned DSH runtime dependencies and development tools.
|
|
23
23
|
|
|
24
|
+
## Install from npm
|
|
25
|
+
|
|
26
|
+
```bash
|
|
27
|
+
prime-agent package install npm:prime-agent-dsh
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
Restart Prime Agent after installation, then continue with [Restart and verify](#restart-and-verify).
|
|
31
|
+
|
|
32
|
+
Update an npm installation with:
|
|
33
|
+
|
|
34
|
+
```bash
|
|
35
|
+
prime-agent package update npm:prime-agent-dsh
|
|
36
|
+
```
|
|
37
|
+
|
|
24
38
|
## Install from GitHub
|
|
25
39
|
|
|
26
40
|
Clone the repository, validate the exact checkout, and register that checkout with Prime:
|
|
@@ -33,7 +47,7 @@ npm run release:check
|
|
|
33
47
|
prime-agent package install "$PWD"
|
|
34
48
|
```
|
|
35
49
|
|
|
36
|
-
Use a tagged release or reviewed commit when one is available. The default branch can contain unreleased work.
|
|
50
|
+
Use a tagged release or reviewed commit when one is available. The default branch can contain unreleased work. Use Prime's package command rather than installing the package globally with npm.
|
|
37
51
|
|
|
38
52
|
## Install for one project
|
|
39
53
|
|
|
@@ -171,7 +185,7 @@ prime-agent package install "$PWD"
|
|
|
171
185
|
|
|
172
186
|
If the package was registered locally, run the last command from the target project with `--local` and the absolute checkout path. Restart Prime afterward. `prime-agent package update [source]` exists for package sources that Prime can update, but a manual checkout update makes the reviewed revision explicit.
|
|
173
187
|
|
|
174
|
-
No manual data migration is required for 0.2.
|
|
188
|
+
No manual data migration is required for 0.2.x. On first publication, it removes legacy rebuildable snapshot layouts and prunes old derived generations under the writer lock. It does not change Prime JSONL, user artifacts, grants, or inheritance data.
|
|
175
189
|
|
|
176
190
|
## Uninstall
|
|
177
191
|
|
package/extensions/index.ts
CHANGED
|
@@ -38,7 +38,7 @@ function recentSiblingSession(ctx: ExtensionContext): { id: string; ageMinutes:
|
|
|
38
38
|
}
|
|
39
39
|
}
|
|
40
40
|
|
|
41
|
-
export const DSH_VERSION = "0.2.
|
|
41
|
+
export const DSH_VERSION = "0.2.1";
|
|
42
42
|
const CACHE_STATUS_KEY = "prime-agent-dsh-cache";
|
|
43
43
|
const CACHE_WIDGET_KEY = "prime-agent-dsh-cache-widget";
|
|
44
44
|
const INSTALLS_KEY = Symbol.for("prime-agent-dsh.installs.v1");
|
package/package.json
CHANGED
|
@@ -84,7 +84,7 @@ try {
|
|
|
84
84
|
|
|
85
85
|
const installed = join(project, "node_modules", "prime-agent-dsh");
|
|
86
86
|
const manifest = JSON.parse(await readFile(join(installed, "package.json"), "utf8"));
|
|
87
|
-
assert.equal(manifest.version, "0.2.
|
|
87
|
+
assert.equal(manifest.version, "0.2.1", "packed plugin version is stale");
|
|
88
88
|
assert.deepEqual(manifest.repository, { type: "git", url: `git+${repositoryUrl}.git` });
|
|
89
89
|
assert.equal(manifest.homepage, `${repositoryUrl}#readme`);
|
|
90
90
|
assert.deepEqual(manifest.bugs, { url: `${repositoryUrl}/issues` });
|