prime-agent-dsh 0.2.1 → 0.2.3

package/CHANGELOG.md

@@ -10,6 +10,18 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 
 - Added production-oriented installation, support, contribution, conduct, roadmap, and release documentation.
 
+## 0.2.3 - 2026-09-22
+
+### Changed
+
+- Renamed cache display controls from `/dsh on|off` to `/dsh show|hide` for accurate presentation semantics.
+
+## 0.2.2 - 2026-09-22
+
+### Added
+
+- Added `/dsh help` for concise command and behavior guidance.
+
 ## 0.2.1 - 2026-09-22
 
 ### Changed

package/README.md

@@ -48,7 +48,7 @@ The package does not ship a DSH `AgentLoop`, provider wrapper, ACP delegation pa
 | Native RLM inheritance | Available | Bounded untrusted evidence through Prime 0.9.5 lifecycle hooks. |
 | Explicit parent-to-child grants | Available | Bounded, read-only, expiring capabilities. |
 | Provider cache metrics | Available when reported | No cache hit is inferred if the provider omits usage fields. |
-| `/dsh` display toggle | Available | Changes widget visibility only; indexing continues. |
+| `/dsh` display toggle and help | Available | `/dsh`, `/dsh show`, `/dsh hide`, `/dsh help`; indexing continues. |
 | Shadow telemetry | Optional | Diagnostic only; never changes provider context. |
 | DSH-driven compaction | Not included | Prime alone decides and performs compaction. |
 | DSH agent loop or tools | Not included | Would create a second execution authority. |
@@ -95,7 +95,7 @@ For grants and API rules, see [Getting started](docs/getting-started.md#use-the-
 
 ## Project status
 
-`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.
+`0.2.3` 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.
 
 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.
 

package/docs/getting-started.md

@@ -1,6 +1,6 @@
 # Getting started
 
-This guide covers npm, GitHub, local, and project-scoped installation for `prime-agent-dsh` 0.2.1.
+This guide covers npm, GitHub, local, and project-scoped installation for `prime-agent-dsh` 0.2.3.
 
 ## Requirements
 
@@ -104,13 +104,15 @@ Cache rates can remain `—` when the provider does not report enough usage data
 
 ```text
 /dsh
-/dsh on
-/dsh off
+/dsh show
+/dsh hide
+/dsh help
 ```
 
 - `/dsh` toggles the native cache-rate text and reports the resulting state.
-- `/dsh on` shows it.
-- `/dsh off` hides it.
+- `/dsh show` shows it.
+- `/dsh hide` hides it.
+- `/dsh help` lists the available controls and explains that indexing remains active.
 
 The command controls display only. Projection, indexing, and provider cache measurement continue while the display is hidden. A typical provider-reported value is:
 

package/extensions/index.ts

@@ -38,7 +38,7 @@ function recentSiblingSession(ctx: ExtensionContext): { id: string; ageMinutes:
   }
 }
 
-export const DSH_VERSION = "0.2.1";
+export const DSH_VERSION = "0.2.3";
 const CACHE_STATUS_KEY = "prime-agent-dsh-cache";
 const CACHE_WIDGET_KEY = "prime-agent-dsh-cache-widget";
 const INSTALLS_KEY = Symbol.for("prime-agent-dsh.installs.v1");
@@ -137,15 +137,26 @@ export default function deepSeekHarnessExtension(pi: ExtensionAPI): void {
   });
 
   pi.registerCommand("dsh", {
-    description: "Toggle DSH cache-rate text and report the resulting state",
+    description: "Toggle DSH cache-rate text, set visibility, or show help",
     handler: async (args, ctx) => {
       await Promise.resolve();
       const action = args.trim().toLowerCase();
+      if (action === "help") {
+        ctx.ui.notify([
+          "DSH commands:",
+          "/dsh — toggle cache-rate text and report the resulting state",
+          "/dsh show — show cache-rate text",
+          "/dsh hide — hide cache-rate text",
+          "/dsh help — show this help",
+          "Display controls do not disable indexing or provider cache measurement.",
+        ].join("\n"), "info");
+        return;
+      }
       if (action === "") showCacheDisplay = !showCacheDisplay;
-      else if (action === "on") showCacheDisplay = true;
-      else if (action === "off") showCacheDisplay = false;
+      else if (action === "show") showCacheDisplay = true;
+      else if (action === "hide") showCacheDisplay = false;
       else {
-        ctx.ui.notify("Usage: /dsh [on|off]", "warning");
+        ctx.ui.notify("Usage: /dsh [show|hide|help]", "warning");
         return;
       }
       refreshCacheDisplay(ctx);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prime-agent-dsh",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "DeepSeek Harness context sidecar and Python context objects for Prime Agent.",
   "keywords": [
     "prime-agent",

package/scripts/package-smoke.mjs

@@ -84,7 +84,7 @@ try {
 
   const installed = join(project, "node_modules", "prime-agent-dsh");
   const manifest = JSON.parse(await readFile(join(installed, "package.json"), "utf8"));
-  assert.equal(manifest.version, "0.2.1", "packed plugin version is stale");
+  assert.equal(manifest.version, "0.2.3", "packed plugin version is stale");
   assert.deepEqual(manifest.repository, { type: "git", url: `git+${repositoryUrl}.git` });
   assert.equal(manifest.homepage, `${repositoryUrl}#readme`);
   assert.deepEqual(manifest.bugs, { url: `${repositoryUrl}/issues` });