@amaster.ai/dsh-a2a 0.1.0 → 0.1.2

package/README.md

@@ -57,7 +57,7 @@ Disabled by default. Configure via the profile's `cordis.patch.yml`:
 - **Agents are full preset citizens.** Each task's agent is created with the deployment's default model selection (`agentDefaultModel`) and mounts its agent preset (the web profile keeps all tools inside presets — without one the agent would see an empty tool catalog). `agent.preset` pins a specific preset.
 - **Streaming aggregation.** Text deltas of a turn share one `messageId`, so clients accumulate them into a single message; reasoning deltas ride a separate `messageId` and are marked `metadata.dshAgent.kind: 'thought'`. The turn-final event's message carries the full assembled text, so blocking `SendMessage` clients read the answer from `result.task.status.message`. Tool calls/results are data parts marked `tool-call` / `tool-result`; token usage lands in `metadata.usage` of the final event. A2A 1.0 has no `final` flag — terminal and interrupted states close the stream.
 - **Text-only boundary** for now: `SendMessage` rejects messages with non-text parts (file/url/data) with a failed task.
-- **No approval bridge**: dsh rc.7 has no mid-turn approval seam, so tools that would ask are governed by the profile's own approval setup; the A2A side never enters a mid-turn `input-required`.
+- **No approval bridge**: dsh ships the mid-turn approval seam only as the optional `dsh-user-approval` package, which headless profiles do not compose, so tools that would ask are governed by the profile's own approval setup; the A2A side never enters a mid-turn `input-required`.
 - **One in-flight message per task** is the supported flow (send the next message after the turn-final event). dsh serializes queued follow-ups into successive turns, but concurrent requests share one event bus — a second in-flight request may resolve with the first turn's final event.
 - **Restart**: persisted task shells survive in Redis/GCS, but live agents do not — continuing after a restart starts a fresh session (a client-supplied `contextId` names it).
 
@@ -75,7 +75,7 @@ dsh ships **no authentication or authorization**. The server binds `127.0.0.1` b
 
 ## Compatibility
 
-Pinned dsh/cordis versions live in the [root compat matrix](../../README.md#compatibility). Event payloads ride pre-release dsh APIs (`@deepseek-ai/dsh-{agent,session,llm}@0.1.0-rc.7`) — check the `TODO(verify)` markers in `src/` before upgrading dsh.
+Pinned dsh/cordis versions live in the [root compat matrix](../../README.md#compatibility). Event payloads ride pre-release dsh APIs (`@deepseek-ai/dsh-{agent,session,llm}@0.1.5-rc.1`) — check the `TODO(verify)` markers in `src/` before upgrading dsh.
 
 ## License
 

package/lib/bridge.js

@@ -4,8 +4,10 @@
  * One A2A task maps to one dsh session/agent; the A2A `contextId` IS the dsh
  * sessionId. The bridge owns every agent it creates (the consumer-handle
  * pattern dsh's own ACP bridge uses) and routes the durable `session/event`
- * stream through a per-task {@link SessionTranslator} onto the executing
- * request's {@link ExecutionEventBus}.
+ * stream plus the live `agent/assistant-stream` frames (the V3 session log no
+ * longer carries incremental chunks) through a per-task
+ * {@link SessionTranslator} onto the executing request's
+ * {@link ExecutionEventBus}.
  *
  * Turn settlement: `agent.followup()` is fire-and-forget, so callers await a
  * FIFO waiter resolved by the session's next `turn/end` event (dsh's inbox
@@ -32,6 +34,7 @@ export class A2aBridge {
         this.options = options;
         ctx.on('session/event', (session, event) => this.onSessionEvent(session, event));
         ctx.on('session/disposed', (session) => this.onSessionDisposed(session));
+        ctx.on('agent/assistant-stream', ({ agent, frame }) => this.onAssistantStream(agent, frame));
     }
     /**
      * Resolve the live task entry, creating the session/agent when needed.
@@ -77,7 +80,7 @@ export class A2aBridge {
             // the agent's installed model selection (dsh-agent-loop's variables read
             // agent.options; the scoped waterfalls wire provider/model into prompt
             // assembly and the request config). Verified against
-            // @deepseek-ai/dsh-headless@0.1.0-rc.7's run() — entry points are
+            // @deepseek-ai/dsh-headless@0.1.5-rc.1's run() — entry points are
             // expected to resolve the deployment default themselves.
             setup: selection || agentPreset
                 ? async (agentCtx) => {
@@ -193,6 +196,22 @@ export class A2aBridge {
             entry.settled.shift()?.();
         }
     }
+    /**
+     * Live assistant deltas (V3: the durable log only commits settled
+     * `assistant/message` events). Same no-throw seam as the session feed.
+     */
+    onAssistantStream(agent, frame) {
+        const entry = this.bySession.get(agent.session.id);
+        if (!entry)
+            return;
+        try {
+            for (const out of entry.translator.handleStreamFrame(frame))
+                entry.bus?.publish(out);
+        }
+        catch (error) {
+            console.error('[dsh-a2a] failed to translate assistant stream frame:', error);
+        }
+    }
     onSessionDisposed(session) {
         const entry = this.bySession.get(session.id);
         if (!entry)

package/lib/executor.js

@@ -82,7 +82,9 @@ function taskEvent(taskId, contextId, state, extra = {}) {
 }
 // TODO(verify): non-text parts (file/raw/url/data) — dsh supports image
 // content blocks; map them when a client needs it. The confirmation data-part
-// protocol ({callId, outcome}) has no dsh rc.7 counterpart to bridge to.
+// protocol ({callId, outcome}) maps onto the optional dsh-user-approval
+// service (0.1.2+, asks carry the exact tool call) — bridge it once a
+// deployment composes that service.
 function extractText(message) {
     const nonText = message.parts.filter((part) => part.content?.$case !== 'text');
     if (nonText.length > 0) {

package/lib/translator.js

@@ -5,14 +5,17 @@
  * deliberately free of cordis/HTTP concerns so the mapping is unit-testable
  * without a harness. The mapping ports the source project's
  * `packages/a2a-server/src/agent/task.ts` event switch onto dsh's
- * `SessionEventMap` (verified against @deepseek-ai/dsh-session@0.1.0-rc.7),
- * emitting the A2A 1.0 data model (@a2a-js/sdk 1.1.0):
+ * `SessionEventMap` (verified against @deepseek-ai/dsh-session@0.1.5-rc.1),
+ * emitting the A2A 1.0 data model (@a2a-js/sdk 1.1.0). As of the V3 session
+ * format the durable log carries no incremental chunks — live text/reasoning
+ * deltas arrive as `agent/assistant-stream` chunk frames
+ * (@deepseek-ai/dsh-agent@0.1.5-rc.1) through {@link handleStreamFrame}:
  *
  *   turn/start                         → statusUpdate(WORKING), ids rotate
- *   assistant/chunk (text-delta)       → statusUpdate(WORKING, text part),
+ *   stream chunk (text-delta)          → statusUpdate(WORKING, text part),
  *                                        reusing the turn's messageId so
  *                                        clients aggregate deltas into one message
- *   assistant/chunk (reasoning-delta)  → statusUpdate(WORKING, thought metadata)
+ *   stream chunk (reasoning-delta)     → statusUpdate(WORKING, thought metadata)
  *   assistant/message                  → no event; text + usage captured for the
  *                                        turn-final message (blocking `SendMessage`
  *                                        clients read the answer from the final
@@ -30,10 +33,12 @@
  * A2A 1.0 removed the `final` flag: the SDK's event queue stops on terminal
  * and interrupted (input-required) states, which is exactly the set above.
  *
- * dsh rc.7 has no approval/`input-required` mid-turn seam (the unpublished
- * dsh-user-approval package is not installed anywhere; `tools/pre-execute`'s
- * `ask` degrades to deny without an approval service), so no approval bridge
- * exists here. TODO(verify) when dsh ships one.
+ * dsh ships the approval seam as the optional
+ * @deepseek-ai/dsh-user-approval package (the `ctx.approval` service), but
+ * headless profiles do not compose it and `tools/pre-execute`'s `ask` fails
+ * closed without one, so no approval bridge exists here. TODO(verify):
+ * bridge approval asks to A2A input-required once a deployment composes the
+ * service.
  */
 import { randomUUID } from 'node:crypto';
 import { Role, TaskState } from '@a2a-js/sdk';
@@ -114,21 +119,6 @@ export class SessionTranslator {
                 this.usage = undefined;
                 return [this.status(TaskState.TASK_STATE_WORKING, { kind: 'state-change' })];
             }
-            case 'assistant/chunk': {
-                const chunk = event.data.chunk;
-                if (chunk.type === 'text-delta') {
-                    this.deltaText += chunk.text;
-                    return [
-                        this.status(TaskState.TASK_STATE_WORKING, { kind: 'text-content' }, agentTextMessage(this.taskId, this.contextId, chunk.text, this.textMessageId)),
-                    ];
-                }
-                if (chunk.type === 'reasoning-delta') {
-                    return [
-                        this.status(TaskState.TASK_STATE_WORKING, { kind: 'thought' }, agentTextMessage(this.taskId, this.contextId, chunk.text, this.thoughtMessageId)),
-                    ];
-                }
-                return [];
-            }
             case 'assistant/message': {
                 this.sawAssistantMessage = true;
                 for (const block of event.data.message.content) {
@@ -173,6 +163,25 @@ export class SessionTranslator {
                 return [];
         }
     }
+    /**
+     * Translate one live `agent/assistant-stream` frame into zero or more A2A
+     * events. Chunk frames carry the transient deltas; start/end frames bracket
+     * an attempt and produce nothing (the settled `assistant/message` session
+     * event captures text + usage).
+     */
+    handleStreamFrame(frame) {
+        if (frame.type !== 'chunk')
+            return [];
+        const { chunk } = frame;
+        if (chunk.type !== 'text-delta' && chunk.type !== 'reasoning-delta')
+            return [];
+        const text = chunk.type === 'text-delta';
+        if (text)
+            this.deltaText += chunk.text;
+        return [
+            this.status(TaskState.TASK_STATE_WORKING, { kind: text ? 'text-content' : 'thought' }, agentTextMessage(this.taskId, this.contextId, chunk.text, text ? this.textMessageId : this.thoughtMessageId)),
+        ];
+    }
     turnEnd(reason) {
         const text = this.sawAssistantMessage ? this.turnText : this.deltaText;
         const finalMessage = text

package/lib/types/bridge.d.ts

@@ -4,8 +4,10 @@
  * One A2A task maps to one dsh session/agent; the A2A `contextId` IS the dsh
  * sessionId. The bridge owns every agent it creates (the consumer-handle
  * pattern dsh's own ACP bridge uses) and routes the durable `session/event`
- * stream through a per-task {@link SessionTranslator} onto the executing
- * request's {@link ExecutionEventBus}.
+ * stream plus the live `agent/assistant-stream` frames (the V3 session log no
+ * longer carries incremental chunks) through a per-task
+ * {@link SessionTranslator} onto the executing request's
+ * {@link ExecutionEventBus}.
  *
  * Turn settlement: `agent.followup()` is fire-and-forget, so callers await a
  * FIFO waiter resolved by the session's next `turn/end` event (dsh's inbox
@@ -65,6 +67,11 @@ export declare class A2aBridge {
     /** Dispose every owned agent (plugin unload / server shutdown). */
     dispose(): Promise<void>;
     private onSessionEvent;
+    /**
+     * Live assistant deltas (V3: the durable log only commits settled
+     * `assistant/message` events). Same no-throw seam as the session feed.
+     */
+    private onAssistantStream;
     private onSessionDisposed;
     /** Close an in-flight stream honestly and release every turn waiter. */
     private settleEntry;

package/lib/types/translator.d.ts

@@ -5,14 +5,17 @@
  * deliberately free of cordis/HTTP concerns so the mapping is unit-testable
  * without a harness. The mapping ports the source project's
  * `packages/a2a-server/src/agent/task.ts` event switch onto dsh's
- * `SessionEventMap` (verified against @deepseek-ai/dsh-session@0.1.0-rc.7),
- * emitting the A2A 1.0 data model (@a2a-js/sdk 1.1.0):
+ * `SessionEventMap` (verified against @deepseek-ai/dsh-session@0.1.5-rc.1),
+ * emitting the A2A 1.0 data model (@a2a-js/sdk 1.1.0). As of the V3 session
+ * format the durable log carries no incremental chunks — live text/reasoning
+ * deltas arrive as `agent/assistant-stream` chunk frames
+ * (@deepseek-ai/dsh-agent@0.1.5-rc.1) through {@link handleStreamFrame}:
  *
  *   turn/start                         → statusUpdate(WORKING), ids rotate
- *   assistant/chunk (text-delta)       → statusUpdate(WORKING, text part),
+ *   stream chunk (text-delta)          → statusUpdate(WORKING, text part),
  *                                        reusing the turn's messageId so
  *                                        clients aggregate deltas into one message
- *   assistant/chunk (reasoning-delta)  → statusUpdate(WORKING, thought metadata)
+ *   stream chunk (reasoning-delta)     → statusUpdate(WORKING, thought metadata)
  *   assistant/message                  → no event; text + usage captured for the
  *                                        turn-final message (blocking `SendMessage`
  *                                        clients read the answer from the final
@@ -30,13 +33,16 @@
  * A2A 1.0 removed the `final` flag: the SDK's event queue stops on terminal
  * and interrupted (input-required) states, which is exactly the set above.
  *
- * dsh rc.7 has no approval/`input-required` mid-turn seam (the unpublished
- * dsh-user-approval package is not installed anywhere; `tools/pre-execute`'s
- * `ask` degrades to deny without an approval service), so no approval bridge
- * exists here. TODO(verify) when dsh ships one.
+ * dsh ships the approval seam as the optional
+ * @deepseek-ai/dsh-user-approval package (the `ctx.approval` service), but
+ * headless profiles do not compose it and `tools/pre-execute`'s `ask` fails
+ * closed without one, so no approval bridge exists here. TODO(verify):
+ * bridge approval asks to A2A input-required once a deployment composes the
+ * service.
  */
 import { type Message } from '@a2a-js/sdk';
 import { type AgentExecutionEvent } from '@a2a-js/sdk/server';
+import type { AssistantStreamFrame } from '@deepseek-ai/dsh-agent';
 import type { SessionEvent } from '@deepseek-ai/dsh-session';
 /** One agent-role text message — the single construction site for the plugin's message payloads. */
 export declare function agentTextMessage(taskId: string, contextId: string, text: string, messageId?: string): Message;
@@ -60,6 +66,13 @@ export declare class SessionTranslator {
     constructor(taskId: string, contextId: string, model?: string | undefined);
     /** Translate one session event into zero or more A2A events. Never throws on unknown types. */
     handle(event: SessionEvent): AgentExecutionEvent[];
+    /**
+     * Translate one live `agent/assistant-stream` frame into zero or more A2A
+     * events. Chunk frames carry the transient deltas; start/end frames bracket
+     * an attempt and produce nothing (the settled `assistant/message` session
+     * event captures text + usage).
+     */
+    handleStreamFrame(frame: AssistantStreamFrame): AgentExecutionEvent[];
     private turnEnd;
     private status;
     private dataMessage;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amaster.ai/dsh-a2a",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "A2A protocol (JSON-RPC + SSE) server plugin for DeepSeek Harness: expose dsh agents as A2A agents.",
   "type": "module",
   "main": "lib/index.js",
@@ -38,9 +38,9 @@
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-agent": "0.1.0-rc.7",
-    "@deepseek-ai/dsh-llm": "0.1.0-rc.7",
-    "@deepseek-ai/dsh-session": "0.1.0-rc.7",
+    "@deepseek-ai/dsh-agent": "0.1.5-rc.1",
+    "@deepseek-ai/dsh-llm": "0.1.5-rc.1",
+    "@deepseek-ai/dsh-session": "0.1.5-rc.1",
     "@google-cloud/storage": "^7.0.0",
     "ioredis": "^5.0.0"
   },
@@ -54,9 +54,9 @@
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-agent": "0.1.0-rc.7",
-    "@deepseek-ai/dsh-llm": "0.1.0-rc.7",
-    "@deepseek-ai/dsh-session": "0.1.0-rc.7",
+    "@deepseek-ai/dsh-agent": "0.1.5-rc.1",
+    "@deepseek-ai/dsh-llm": "0.1.5-rc.1",
+    "@deepseek-ai/dsh-session": "0.1.5-rc.1",
     "@google-cloud/storage": "^7.0.0",
     "@types/express": "^4.17.21",
     "@types/node": "^22.0.0",