@openma/deepseek-harness-acp 0.4.14 → 0.4.15

package/README.md

@@ -104,6 +104,28 @@ owns the composition.
 
 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,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.4.14",
+  "version": "0.4.15",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/openma-ai/deepseek-harness-acp.git"
@@ -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",