@openma/deepseek-harness-acp 0.4.13 → 0.4.15

package/README.md

@@ -31,13 +31,13 @@ touch your editor config — it reuses the key you saved in the dsh Web UI, or
 
 ## Two entry points, one embeddable plugin
 
-| | **A · Standalone server** | **B · dsh profile plugin** |
+| | **A · dsh profile plugin (recommended)** | **B · Standalone server** |
 |---|---|---|
-| Best for | Getting started in one command | Living inside your dsh setup |
-| Install | `npm i -g @openma/deepseek-harness-acp` | `dsh plugin --profile acp add -w @openma/deepseek-harness-acp` |
-| Zed runs | `dsh-acp` | `dsh --profile acp` |
-| Harness | Your installed dsh — or the npm-installed peer when none exists | The dsh that owns the profile |
-| Composition | dsh-base + this bundle (profile machinery booted in-process) | dsh-base + this bundle + your profile's own patches |
+| Best for | Normal installation and upgrades | Connecting an ACP client without managing a dsh profile |
+| Install | `dsh plugin --profile acp add @openma/deepseek-harness-acp@latest` | `npm i -g @openma/deepseek-harness-acp` |
+| Zed runs | `dsh --profile acp` | `dsh-acp` |
+| Harness | The dsh that owns the profile | Your installed dsh — or the npm-installed peer when none exists |
+| Composition | dsh-base + this bundle + your profile's own patches | dsh-base + this bundle (profile machinery booted in-process) |
 
 Both shapes share `$DSH_HOME`: the same credential store, settings, presets,
 and session logs as `dsh web` — conversations started in the Web UI can be
@@ -54,55 +54,78 @@ plugin used by other dsh applications: one Host composition can expose the
 same sessions, tools, presets, skills, and persistence through a transport
 chosen by the surface.
 
-### A · Standalone server
+### A · dsh profile plugin (recommended)
 
 ```bash
-npm install -g @openma/deepseek-harness-acp
-dsh-acp login        # interactive; or save the key in the dsh Web UI
+npm install -g @deepseek-ai/dsh
+dsh web                                                    # save your API key once
+dsh plugin --profile acp add @openma/deepseek-harness-acp@latest
 ```
 
 ```jsonc
 // Zed settings.json
 {
   "agent_servers": {
-    "DeepSeek Harness": { "command": "dsh-acp" }
+    "DeepSeek Harness": { "command": "dsh", "args": ["--profile", "acp"] }
   }
 }
 ```
 
-Self-contained: it finds your DeepSeek Harness via `--dsh-path` / `DSH_PATH`,
-its own tree, `./node_modules`, `dsh` on PATH, or `npm root -g` — and ships a
-npm-installed harness peer as the **last** candidate, so it works out of the box
-and always prefers the dsh you installed. When a real
-`$DSH_HOME/profiles/acp` exists, that profile owns the composition.
+The plugin command creates `$DSH_HOME/profiles/acp`, installs or upgrades the
+adapter, and registers its `dsh.bundle` patch. The bridge mounts over
+`@deepseek-ai/dsh-base` — the same product baseline as `dsh web`, with the
+module-reload watcher off. Extend the profile in
+`$DSH_HOME/profiles/acp/cordis.patch.yml` like any other dsh profile. A global
+`dsh-acp` installation is not required for this path.
 
-### B · dsh profile plugin
+### B · Standalone server
 
 ```bash
-npm install -g @deepseek-ai/dsh
-dsh web                                                  # save your API key once
-dsh plugin --profile acp add -w @openma/deepseek-harness-acp
+npm install -g @openma/deepseek-harness-acp
+dsh-acp login        # interactive; or save the key in the dsh Web UI
 ```
 
 ```jsonc
 // Zed settings.json
 {
   "agent_servers": {
-    "DeepSeek Harness": { "command": "dsh", "args": ["--profile", "acp"] }
+    "DeepSeek Harness": { "command": "dsh-acp" }
   }
 }
 ```
 
-This creates `$DSH_HOME/profiles/acp` and registers the package's
-`dsh.bundle` patch: the bridge mounts over `@deepseek-ai/dsh-base` — the same
-product baseline as `dsh web`, with the module-reload watcher off. Extend the
-profile in `$DSH_HOME/profiles/acp/cordis.patch.yml` like any other dsh
-profile.
+The standalone binary finds DeepSeek Harness via `--dsh-path` / `DSH_PATH`,
+its own tree, `./node_modules`, `dsh` on PATH, or `npm root -g`. It ships an
+npm-installed harness peer as the **last** candidate, so it still prefers the
+dsh you installed. When a real `$DSH_HOME/profiles/acp` exists, that profile
+owns the composition.
 
 ## Plugin and extension model
 
 There are two independent ways to extend an ACP-backed surface.
 
+To use portable Agent Plugins, Codex plugins, Claude Code plugins, or Pi
+packages through an ACP client, add the
+[Agent Plugins Bridge](https://github.com/openma-ai/dsh-agents-plugins-bridge) to the
+same profile:
+
+```sh
+dsh plugin --profile acp add @openma/dsh-agents-plugins-bridge@latest
+```
+
+The Bridge contributes ordinary Host rows. Imported commands, skills, tools,
+hooks, MCP connections, agents, and Pi extensions therefore reach ACP through
+this adapter's existing projections; there is no ACP-specific plugin import
+runtime. The Bridge's Web management panel and MCP Apps HTML renderer remain
+Web surfaces and are not sent over ACP.
+
+For extensions that need a session-owned background lifecycle without an open
+terminal UI, use
+[Martty owner](https://github.com/openma-ai/deepseek-harness-tui/blob/main/README.en.md#martty-owner-long-lived-headless-acp--pi-rpc).
+It is a generic ACP `rpc` client: this package remains the server/transport,
+while Martty owns the long-lived Session and explicit startup/shutdown slash
+commands.
+
 ### Extend the Host composition
 
 The ACP adapter rides the Cordis tree that the profile already owns. Add dsh

package/dist/bridge.js

@@ -961,6 +961,35 @@ function buildReplay(events) {
   return { updates, title, contextWindow: projection.contextWindow };
 }
 
+// src/bridge/latest-publication.ts
+var LatestPublication = class {
+  revisions = /* @__PURE__ */ new Map();
+  async run(key, produce, publish) {
+    const revision = (this.revisions.get(key) ?? 0) + 1;
+    this.revisions.set(key, revision);
+    const value = await produce();
+    if (this.revisions.get(key) !== revision) return;
+    publish(value);
+  }
+  invalidate(key) {
+    this.revisions.set(key, (this.revisions.get(key) ?? 0) + 1);
+  }
+};
+
+// src/bridge/interaction-mode.ts
+function interactionModeFromClientMeta(meta) {
+  if (meta === null || typeof meta !== "object") return void 0;
+  const dsh = meta["dsh"];
+  if (dsh === null || typeof dsh !== "object") return void 0;
+  const interaction = dsh["interaction"];
+  if (interaction === null || typeof interaction !== "object") return void 0;
+  const mode = interaction["mode"];
+  return mode === "interactive" || mode === "rpc" ? mode : void 0;
+}
+function withInteractionMode(options, mode) {
+  return mode === void 0 ? options : { ...options, interactionMode: mode };
+}
+
 // src/bridge/prompt.ts
 function deliverPrompt(target, message, running) {
   if (running) {
@@ -1767,6 +1796,7 @@ async function apply3(ctx, config = {}) {
   const { createUserMessage: createUserMessage2, errorChain: errorChain2, sessionId: SessionId2, foldSessionTitle: foldSessionTitle2, setSandboxMode: setSandboxMode2 } = harness;
   const SANDBOX_MODES2 = harness.sandboxModes;
   const sessions = /* @__PURE__ */ new Map();
+  const commandPublications = new LatestPublication();
   const subagentByChild = /* @__PURE__ */ new Map();
   const subagentByRun = /* @__PURE__ */ new Map();
   const watchedSubagentParents = /* @__PURE__ */ new WeakSet();
@@ -1775,6 +1805,7 @@ async function apply3(ctx, config = {}) {
   let clientTerminalOutput = false;
   let clientSubagentTranscript = false;
   let clientElicitationForm = false;
+  let clientInteractionMode;
   const tuiClient = { advertised: false };
   const rpc = new AcpRpc();
   const findAgent = (agentId) => {
@@ -2003,11 +2034,11 @@ async function apply3(ctx, config = {}) {
       'no credential found for this provider: call authenticate with `_meta["api-key"].apiKey` or `_meta.gateway`, use the browser method, run `dsh-acp login`, or save a key in the dsh Web UI (Settings \u2192 Models)'
     );
   };
-  const agentOptionsFor = (model, provider) => ({
+  const agentOptionsFor = (model, provider) => withInteractionMode({
     ...provider !== void 0 ? { provider } : config.provider !== void 0 ? { provider: config.provider } : {},
     ...model !== void 0 ? { model } : {},
     ...config.maxTokens !== void 0 ? { maxTokens: config.maxTokens } : {}
-  });
+  }, clientInteractionMode);
   const ownedRecord = (agent) => {
     const record = sessions.get(String(agent.session.id));
     return record?.agent === agent ? record : void 0;
@@ -2481,12 +2512,20 @@ async function apply3(ctx, config = {}) {
   const publishCommands = (sessionId, record) => {
     const target = record ?? sessions.get(sessionId);
     if (target === void 0) return;
-    void availableCommandsFor(target).then((availableCommands) => {
+    void commandPublications.run(sessionId, () => availableCommandsFor(target), (availableCommands) => {
+      if (sessions.get(sessionId) !== target) return;
+      logDebug(
+        `available commands ${sessionId}: ${availableCommands.map((command) => command.name).join(", ")}`
+      );
       notify(sessionId, { sessionUpdate: "available_commands_update", availableCommands });
     }).catch((error) => {
       logWarn(`publishing commands failed: ${String(error)}`);
     });
   };
+  ctx.on("commands/change", () => {
+    logDebug(`commands/change: ${sessions.size} live ACP session(s)`);
+    for (const [sessionId, record] of sessions) publishCommands(sessionId, record);
+  });
   const publishConfigOptions = (sessionId, record) => {
     void configOptions(record).then((options) => {
       notify(sessionId, {
@@ -2699,6 +2738,7 @@ async function apply3(ctx, config = {}) {
         const capsMeta = params.clientCapabilities?.["_meta"];
         clientTerminalOutput = capsMeta !== null && typeof capsMeta === "object" ? capsMeta["terminal_output"] === true : false;
         clientSubagentTranscript = capsMeta !== null && typeof capsMeta === "object" ? capsMeta["subagent-transcript"] === true : false;
+        clientInteractionMode = interactionModeFromClientMeta(capsMeta);
         clientElicitationForm = params.clientCapabilities?.elicitation?.form !== void 0 && params.clientCapabilities.elicitation.form !== null;
         tuiClient.advertised = advertisesCordis(capsMeta);
         const providers = await listProviderRoutes();

package/dist/index.js

@@ -44,6 +44,7 @@ ${probed.map((p) => `    ${p}`).join("\n")}` : ""
   }
 };
 var ANCHOR = "@deepseek-ai/dsh-agent";
+var PROFILE_LAUNCHER = "@deepseek-ai/dsh";
 function packageDirFrom(base, name) {
   let dir = resolve(base);
   for (; ; ) {
@@ -66,7 +67,8 @@ function versionOf(packageDir) {
 }
 function hostAt(base, source) {
   const anchor = packageDirFrom(base, ANCHOR);
-  if (anchor === void 0) return void 0;
+  const launcher = packageDirFrom(base, PROFILE_LAUNCHER);
+  if (anchor === void 0 || launcher === void 0) return void 0;
   return { base: resolve(base), version: versionOf(anchor), source };
 }
 function hostFromExplicit(explicit) {

package/dist/plugin.js

@@ -962,6 +962,35 @@ function buildReplay(events) {
   return { updates, title, contextWindow: projection.contextWindow };
 }
 
+// src/bridge/latest-publication.ts
+var LatestPublication = class {
+  revisions = /* @__PURE__ */ new Map();
+  async run(key, produce, publish) {
+    const revision = (this.revisions.get(key) ?? 0) + 1;
+    this.revisions.set(key, revision);
+    const value = await produce();
+    if (this.revisions.get(key) !== revision) return;
+    publish(value);
+  }
+  invalidate(key) {
+    this.revisions.set(key, (this.revisions.get(key) ?? 0) + 1);
+  }
+};
+
+// src/bridge/interaction-mode.ts
+function interactionModeFromClientMeta(meta) {
+  if (meta === null || typeof meta !== "object") return void 0;
+  const dsh = meta["dsh"];
+  if (dsh === null || typeof dsh !== "object") return void 0;
+  const interaction = dsh["interaction"];
+  if (interaction === null || typeof interaction !== "object") return void 0;
+  const mode = interaction["mode"];
+  return mode === "interactive" || mode === "rpc" ? mode : void 0;
+}
+function withInteractionMode(options, mode) {
+  return mode === void 0 ? options : { ...options, interactionMode: mode };
+}
+
 // src/bridge/prompt.ts
 function deliverPrompt(target, message, running) {
   if (running) {
@@ -1768,6 +1797,7 @@ async function apply3(ctx, config = {}) {
   const { createUserMessage: createUserMessage2, errorChain: errorChain2, sessionId: SessionId2, foldSessionTitle: foldSessionTitle2, setSandboxMode: setSandboxMode2 } = harness;
   const SANDBOX_MODES2 = harness.sandboxModes;
   const sessions = /* @__PURE__ */ new Map();
+  const commandPublications = new LatestPublication();
   const subagentByChild = /* @__PURE__ */ new Map();
   const subagentByRun = /* @__PURE__ */ new Map();
   const watchedSubagentParents = /* @__PURE__ */ new WeakSet();
@@ -1776,6 +1806,7 @@ async function apply3(ctx, config = {}) {
   let clientTerminalOutput = false;
   let clientSubagentTranscript = false;
   let clientElicitationForm = false;
+  let clientInteractionMode;
   const tuiClient = { advertised: false };
   const rpc = new AcpRpc();
   const findAgent = (agentId) => {
@@ -2004,11 +2035,11 @@ async function apply3(ctx, config = {}) {
       'no credential found for this provider: call authenticate with `_meta["api-key"].apiKey` or `_meta.gateway`, use the browser method, run `dsh-acp login`, or save a key in the dsh Web UI (Settings \u2192 Models)'
     );
   };
-  const agentOptionsFor = (model, provider) => ({
+  const agentOptionsFor = (model, provider) => withInteractionMode({
     ...provider !== void 0 ? { provider } : config.provider !== void 0 ? { provider: config.provider } : {},
     ...model !== void 0 ? { model } : {},
     ...config.maxTokens !== void 0 ? { maxTokens: config.maxTokens } : {}
-  });
+  }, clientInteractionMode);
   const ownedRecord = (agent) => {
     const record = sessions.get(String(agent.session.id));
     return record?.agent === agent ? record : void 0;
@@ -2482,12 +2513,20 @@ async function apply3(ctx, config = {}) {
   const publishCommands = (sessionId, record) => {
     const target = record ?? sessions.get(sessionId);
     if (target === void 0) return;
-    void availableCommandsFor(target).then((availableCommands) => {
+    void commandPublications.run(sessionId, () => availableCommandsFor(target), (availableCommands) => {
+      if (sessions.get(sessionId) !== target) return;
+      logDebug(
+        `available commands ${sessionId}: ${availableCommands.map((command) => command.name).join(", ")}`
+      );
       notify(sessionId, { sessionUpdate: "available_commands_update", availableCommands });
     }).catch((error) => {
       logWarn(`publishing commands failed: ${String(error)}`);
     });
   };
+  ctx.on("commands/change", () => {
+    logDebug(`commands/change: ${sessions.size} live ACP session(s)`);
+    for (const [sessionId, record] of sessions) publishCommands(sessionId, record);
+  });
   const publishConfigOptions = (sessionId, record) => {
     void configOptions(record).then((options) => {
       notify(sessionId, {
@@ -2700,6 +2739,7 @@ async function apply3(ctx, config = {}) {
         const capsMeta = params.clientCapabilities?.["_meta"];
         clientTerminalOutput = capsMeta !== null && typeof capsMeta === "object" ? capsMeta["terminal_output"] === true : false;
         clientSubagentTranscript = capsMeta !== null && typeof capsMeta === "object" ? capsMeta["subagent-transcript"] === true : false;
+        clientInteractionMode = interactionModeFromClientMeta(capsMeta);
         clientElicitationForm = params.clientCapabilities?.elicitation?.form !== void 0 && params.clientCapabilities.elicitation.form !== null;
         tuiClient.advertised = advertisesCordis(capsMeta);
         const providers = await listProviderRoutes();

package/dist/server.js

@@ -957,6 +957,35 @@ function buildReplay(events) {
   return { updates, title, contextWindow: projection.contextWindow };
 }
 
+// src/bridge/latest-publication.ts
+var LatestPublication = class {
+  revisions = /* @__PURE__ */ new Map();
+  async run(key, produce, publish) {
+    const revision = (this.revisions.get(key) ?? 0) + 1;
+    this.revisions.set(key, revision);
+    const value = await produce();
+    if (this.revisions.get(key) !== revision) return;
+    publish(value);
+  }
+  invalidate(key) {
+    this.revisions.set(key, (this.revisions.get(key) ?? 0) + 1);
+  }
+};
+
+// src/bridge/interaction-mode.ts
+function interactionModeFromClientMeta(meta) {
+  if (meta === null || typeof meta !== "object") return void 0;
+  const dsh = meta["dsh"];
+  if (dsh === null || typeof dsh !== "object") return void 0;
+  const interaction = dsh["interaction"];
+  if (interaction === null || typeof interaction !== "object") return void 0;
+  const mode = interaction["mode"];
+  return mode === "interactive" || mode === "rpc" ? mode : void 0;
+}
+function withInteractionMode(options, mode) {
+  return mode === void 0 ? options : { ...options, interactionMode: mode };
+}
+
 // src/bridge/prompt.ts
 function deliverPrompt(target, message, running) {
   if (running) {
@@ -1763,6 +1792,7 @@ async function apply3(ctx, config = {}) {
   const { createUserMessage: createUserMessage2, errorChain: errorChain2, sessionId: SessionId2, foldSessionTitle: foldSessionTitle2, setSandboxMode: setSandboxMode2 } = harness;
   const SANDBOX_MODES2 = harness.sandboxModes;
   const sessions = /* @__PURE__ */ new Map();
+  const commandPublications = new LatestPublication();
   const subagentByChild = /* @__PURE__ */ new Map();
   const subagentByRun = /* @__PURE__ */ new Map();
   const watchedSubagentParents = /* @__PURE__ */ new WeakSet();
@@ -1771,6 +1801,7 @@ async function apply3(ctx, config = {}) {
   let clientTerminalOutput = false;
   let clientSubagentTranscript = false;
   let clientElicitationForm = false;
+  let clientInteractionMode;
   const tuiClient = { advertised: false };
   const rpc = new AcpRpc();
   const findAgent = (agentId) => {
@@ -1999,11 +2030,11 @@ async function apply3(ctx, config = {}) {
       'no credential found for this provider: call authenticate with `_meta["api-key"].apiKey` or `_meta.gateway`, use the browser method, run `dsh-acp login`, or save a key in the dsh Web UI (Settings \u2192 Models)'
     );
   };
-  const agentOptionsFor = (model, provider) => ({
+  const agentOptionsFor = (model, provider) => withInteractionMode({
     ...provider !== void 0 ? { provider } : config.provider !== void 0 ? { provider: config.provider } : {},
     ...model !== void 0 ? { model } : {},
     ...config.maxTokens !== void 0 ? { maxTokens: config.maxTokens } : {}
-  });
+  }, clientInteractionMode);
   const ownedRecord = (agent) => {
     const record = sessions.get(String(agent.session.id));
     return record?.agent === agent ? record : void 0;
@@ -2477,12 +2508,20 @@ async function apply3(ctx, config = {}) {
   const publishCommands = (sessionId, record) => {
     const target = record ?? sessions.get(sessionId);
     if (target === void 0) return;
-    void availableCommandsFor(target).then((availableCommands) => {
+    void commandPublications.run(sessionId, () => availableCommandsFor(target), (availableCommands) => {
+      if (sessions.get(sessionId) !== target) return;
+      logDebug(
+        `available commands ${sessionId}: ${availableCommands.map((command) => command.name).join(", ")}`
+      );
       notify(sessionId, { sessionUpdate: "available_commands_update", availableCommands });
     }).catch((error) => {
       logWarn(`publishing commands failed: ${String(error)}`);
     });
   };
+  ctx.on("commands/change", () => {
+    logDebug(`commands/change: ${sessions.size} live ACP session(s)`);
+    for (const [sessionId, record] of sessions) publishCommands(sessionId, record);
+  });
   const publishConfigOptions = (sessionId, record) => {
     void configOptions(record).then((options) => {
       notify(sessionId, {
@@ -2695,6 +2734,7 @@ async function apply3(ctx, config = {}) {
         const capsMeta = params.clientCapabilities?.["_meta"];
         clientTerminalOutput = capsMeta !== null && typeof capsMeta === "object" ? capsMeta["terminal_output"] === true : false;
         clientSubagentTranscript = capsMeta !== null && typeof capsMeta === "object" ? capsMeta["subagent-transcript"] === true : false;
+        clientInteractionMode = interactionModeFromClientMeta(capsMeta);
         clientElicitationForm = params.clientCapabilities?.elicitation?.form !== void 0 && params.clientCapabilities.elicitation.form !== null;
         tuiClient.advertised = advertisesCordis(capsMeta);
         const providers = await listProviderRoutes();

package/package.json

@@ -3,12 +3,12 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.4.13",
+  "version": "0.4.15",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/openma-ai/deepseek-harness-acp.git"
   },
-  "homepage": "https://github.com/openma-ai/deepseek-harness-acp#readme",
+  "homepage": "https://dshsuite.dev/#other-products",
   "bugs": {
     "url": "https://github.com/openma-ai/deepseek-harness-acp/issues"
   },
@@ -110,7 +110,8 @@
     "pnpm": "11.22.0",
     "tsx": "^4.23.1",
     "typescript": "^7.0.2",
-    "vitest": "^4.1.10"
+    "vitest": "^4.1.10",
+    "yaml": "^2.9.0"
   },
   "dependencies": {
     "@agentclientprotocol/sdk": "^1.3.0",