@beeos-ai/bma-dsh-acp 0.2.0 → 0.2.1

package/README.md

@@ -7,7 +7,7 @@ It has no DSH dependency of its own (test `pins`), runs the shared conformance s
 ## Install and run (npm)
 
 ```sh
-npx --yes @beeos-ai/bma-dsh-acp@0.2.0      # one-off; or: npm install -g @beeos-ai/bma-dsh-acp
+npx --yes @beeos-ai/bma-dsh-acp@0.2.1      # one-off; or: npm install -g @beeos-ai/bma-dsh-acp
 BMA_DSH_ACP_HOME=$HOME/.bma-dsh-acp bma-dsh-acp   # ACP (JSON-RPC, newline-delimited) on stdin/stdout
 ```
 
@@ -29,10 +29,10 @@ Using it from the BMA executor SDK (`bma-executor-sdk`, Go `ACPAgent`; the SDK n
 
 ```go
 agent, err := bmaexecutor.NewACPAgent(ctx, bmaexecutor.ACPAgentOptions{
-    // installed once with `npm install -g @beeos-ai/bma-dsh-acp@0.2.0` (the `bma-dsh-acp` bin of that prefix):
+    // installed once with `npm install -g @beeos-ai/bma-dsh-acp@0.2.1` (the `bma-dsh-acp` bin of that prefix):
     Command: []string{"/usr/local/bin/bma-dsh-acp"},
     // or fetched on first use (slow first start; the cache keeps it afterwards):
-    // Command: []string{"/usr/local/bin/npx", "--yes", "@beeos-ai/bma-dsh-acp@0.2.0"},
+    // Command: []string{"/usr/local/bin/npx", "--yes", "@beeos-ai/bma-dsh-acp@0.2.1"},
     StateDir: stateDir, // becomes BMA_DSH_ACP_HOME
     Core:     core,
     Upstream: bmaexecutor.ACPModelUpstream{BaseURL: "https://api.example.com/v1", Model: "my-model"},
@@ -52,7 +52,7 @@ Standard ACP v1 (`@agentclientprotocol/sdk`), plus BMA additions under the `bma`
 | tool call | `tool_call` (`kind`, full `rawInput`, `_meta.bma {name, permission}`) → `session/request_permission` (full input; `allow_once` / `reject_once`) when the policy says ask → request `_bma/tools/call {sessionId, toolCallId, name, input}` → `{text, isError, images?: [{mimeType, data}]}` (the client runs it; images are shown to the model after the tool message, as a user message — Chat Completions tool messages carry text only) → `tool_call_update` completed/failed with the result |
 | `session/cancel` | the turn ends with `stopReason: cancelled`; a pending permission or tool call is abandoned (`$/cancel_request` is sent for it) |
 | stops | `output_limit_reached` → `stopReason: max_tokens` + `_meta.bma {stopCode, detail}`; `context_too_large`, `model_stream_idle` → JSON-RPC error `-32603` with `data.bma {stopCode, detail}`; other failures → `-32603` |
-| `session/close` | releases the session (its JSONL stays for a later load) |
+| `session/close` | releases the session's agent scope (its memory; its JSONL stays, so `session/load` brings the whole conversation back); advertised as `agentCapabilities.sessionCapabilities.close`. A client that keeps many sessions (the executor SDK's `ACPAgent` keeps at most `MaxResidentSessions` and closes the least recently used idle one) is what bounds the memory of this process: it holds every session that was opened and not closed. Closing a session that is not open answers `-32002`, which the ACP SDK treats as closed |
 
 Sessions share one DSH kernel in the process; each session is its own agent scope (conversation, tool catalog, model route, permissions): session-level isolation, not one DSH context per session.
 

package/lib/agent.js

@@ -4,6 +4,8 @@
 //   initialize                capabilities + _meta.bma facts (dsh version, tools, streaming, permission relay);
 //                             request _meta.bma.hostTools adds the client machine's own tools to the six
 //   session/new | load        createSession | resumeSession (+ history replay); _meta.bma carries the model route
+//   session/close            releases the session's agent scope (memory); its JSONL stays for session/load. Advertised as
+//                             sessionCapabilities.close, so a client can keep many sessions by closing the least recently used
 //   session/set_mode          per-session tool policy (default | accept_edits)
 //   session/prompt            submitInput: deltas -> agent_*_chunk (messageId), durable -> _bma/message
 //   tool call                 tool_call -> [request_permission] -> _bma/tools/call (client runs it) -> tool_call_update
@@ -86,7 +88,7 @@ export class DshAcpShell {
         this.registerTools();
         return {
             protocolVersion: PROTOCOL_VERSION,
-            agentCapabilities: { loadSession: true, promptCapabilities: { image: this.imageInput, audio: false, embeddedContext: false }, mcpCapabilities: { http: false, sse: false } },
+            agentCapabilities: { loadSession: true, sessionCapabilities: { close: {} }, promptCapabilities: { image: this.imageInput, audio: false, embeddedContext: false }, mcpCapabilities: { http: false, sse: false } },
             agentInfo: { name: "bma-dsh-acp", title: "BMA DSH", version: VERSION },
             authMethods: [],
             _meta: { [META]: { dsh: DSH_VERSION, tools: TOOL_NAMES, hostTools: this.hostTools.map((t) => t.name), streaming: "token", permissionRelay: "full", modes: Object.keys(MODES) } },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@beeos-ai/bma-dsh-acp",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "bma-dsh-acp: the shared DSH adapter served as an Agent Client Protocol (stdio) agent, driven by the BMA executor's ACP client.",
   "keywords": [
     "dsh",
@@ -27,7 +27,7 @@
   "dependencies": {
     "@agentclientprotocol/sdk": "2.2.0",
     "zod": "4.6.7",
-    "@beeos-ai/bma-dsh-adapter": "0.2.0"
+    "@beeos-ai/bma-dsh-adapter": "0.2.1"
   },
   "devDependencies": {
     "esbuild": "0.28.2"