@khorsheed/dsh-room 0.2.3 → 0.2.5

package/lib/types/journal.js

@@ -44,6 +44,7 @@ export const ROOM_EVENT_TYPES = [
     'room/dispatch',
     'room/speech',
     'room/run-state',
+    'room/run-moved',
     'room/execution-metadata',
     'room/relay',
     'room/relay-resolved',
@@ -117,6 +118,7 @@ export function replay(events) {
     const relays = [];
     const approvals = new Map();
     const questions = new Map();
+    const asks = new Map();
     const relayById = new Map();
     const tasks = [];
     const taskById = new Map();
@@ -269,10 +271,24 @@ export function replay(events) {
                 break;
             case 'room/question':
                 questions.set(event.data.id, { id: event.data.id, member: event.data.member, questions: event.data.questions, time: event.time });
+                asks.set(event.data.id, {
+                    id: event.data.id, member: event.data.member, questions: event.data.questions, state: 'pending', time: event.time,
+                    ...event.data.runId === undefined ? {} : { runId: event.data.runId },
+                    ...event.data.consent === true ? { consent: true } : {},
+                });
                 break;
-            case 'room/question-resolved':
+            case 'room/question-resolved': {
                 questions.delete(event.data.id);
+                const ask = asks.get(event.data.id);
+                if (ask !== undefined) {
+                    asks.set(ask.id, {
+                        ...ask, state: event.data.outcome,
+                        ...event.data.answers === undefined ? {} : { answers: event.data.answers },
+                        ...event.data.late === true ? { late: true } : {},
+                    });
+                }
                 break;
+            }
             case 'room/approval-resolved':
                 approvals.delete(event.data.id);
                 break;
@@ -395,7 +411,7 @@ export function replay(events) {
     return {
         ...helps.length === 0 ? {} : { helps },
         ...links.linked.length === 0 ? {} : { linked: links.linked },
-        ...links.nudgesDismissed.length === 0 ? {} : { helpNudgesDismissed: links.nudgesDismissed }, members, relays, ...approvals.size === 0 ? {} : { approvals: [...approvals.values()] }, ...questions.size === 0 ? {} : { questions: [...questions.values()] }, tasks, ...executions.size === 0 ? {} : { executions: [...executions.values()] }, ...plan === undefined ? {} : { plan }, ...deliveries.length === 0 ? {} : { deliveries }, runs: [...runs.values()], ...coordinator === undefined ? {} : { coordinator }, ...goal === undefined ? {} : { goal }, ...latestReplySeq === undefined ? {} : { latestReplySeq }, ...latestSpeechSeq === undefined ? {} : { latestSpeechSeq }, settings, ...jobs.length === 0 ? {} : { jobs }
+        ...links.nudgesDismissed.length === 0 ? {} : { helpNudgesDismissed: links.nudgesDismissed }, members, relays, ...approvals.size === 0 ? {} : { approvals: [...approvals.values()] }, ...questions.size === 0 ? {} : { questions: [...questions.values()] }, ...asks.size === 0 ? {} : { askLog: [...asks.values()] }, tasks, ...executions.size === 0 ? {} : { executions: [...executions.values()] }, ...plan === undefined ? {} : { plan }, ...deliveries.length === 0 ? {} : { deliveries }, runs: [...runs.values()], ...coordinator === undefined ? {} : { coordinator }, ...goal === undefined ? {} : { goal }, ...latestReplySeq === undefined ? {} : { latestReplySeq }, ...latestSpeechSeq === undefined ? {} : { latestSpeechSeq }, settings, ...jobs.length === 0 ? {} : { jobs }
     };
 }
 /**

package/lib/types/types.d.ts

@@ -133,6 +133,8 @@ export interface RoomMemberRemovedEvent {
  * log.
  */
 export interface RoomDispatchEvent {
+    /** The human message's admitted attachments, re-sent with the text on a retry. */
+    readonly attachments?: readonly RoomDispatchAttachment[];
     /** Goal work/report correlation, absent for ordinary chat. */
     readonly plan?: {
         readonly goalId: string;
@@ -209,6 +211,11 @@ export interface RoomSpeechEvent {
     readonly reportedTo?: string;
     readonly member: string;
     readonly text: string;
+    /** Questions the round asked, at their offsets in `text` (-1 = no split point found: shown first, marked mid-round). */
+    readonly asks?: readonly {
+        readonly id: string;
+        readonly at: number;
+    }[];
     readonly childSessionId?: SessionId;
     /** Native admission→settle milliseconds, excluding queue time. */
     readonly durationMs?: number;
@@ -235,6 +242,11 @@ export interface RoomRunUsage {
     readonly reasoningTokens?: number;
 }
 /** A member run's lifecycle edge. */
+/** A running member's card moves to the bottom of the conversation; its run is untouched. */
+export interface RoomRunMovedEvent {
+    readonly member: string;
+    readonly startedAt: number;
+}
 export interface RoomRunStateEvent {
     readonly childSessionId?: SessionId;
     /** The child session's round this run reached (the last turn/start it wrote); terminal edges only, live sessions only. */
@@ -489,6 +501,12 @@ export interface RoomQuestionEvent {
     readonly member: string;
     readonly memberId: string;
     readonly questions: readonly RoomQuestionItem[];
+    /** The asker's round (its run id): the question renders inside that round's card and reply. */
+    readonly runId?: string;
+    /** The tail of what the round had said when it asked — where the reply splits around the question. */
+    readonly before?: string;
+    /** A consent gate (room_help's 允许/不允许): its answer only matters while the call waits, so it is never answered late. */
+    readonly consent?: true;
 }
 /** How a member's questions ended. */
 export interface RoomQuestionResolvedEvent {
@@ -496,6 +514,20 @@ export interface RoomQuestionResolvedEvent {
     /** `cancelled`: the call ended, timed out, or the host restarted before an answer. */
     readonly outcome: 'answered' | 'cancelled';
     readonly answers?: readonly RoomQuestionAnswer[];
+    /** Answered after the card expired: the answers went to the member as a new message instead of its (gone) waiting call. */
+    readonly late?: true;
+}
+/** Every question card the room has seen, with its outcome — inline question blocks read it. */
+export interface RoomAsk {
+    readonly id: string;
+    readonly member: string;
+    readonly questions: readonly RoomQuestionItem[];
+    readonly state: 'pending' | 'answered' | 'cancelled';
+    readonly answers?: readonly RoomQuestionAnswer[];
+    readonly late?: true;
+    readonly consent?: true;
+    readonly runId?: string;
+    readonly time: number;
 }
 /** A member's questions still waiting for the human. */
 export interface RoomQuestion {
@@ -696,6 +728,8 @@ declare module '@deepseek-ai/dsh-session/types' {
         'room/speech': RoomSpeechEvent;
         /** Member run lifecycle. */
         'room/run-state': RoomRunStateEvent;
+        /** A running member's card re-anchors below a reply or human message that landed after it (presentation only). */
+        'room/run-moved': RoomRunMovedEvent;
         /** Log-only observed metadata for a single execution. */
         'room/execution-metadata': RoomExecutionMetadataEvent;
         /** Notification gate: a member-to-member relay arrived (pending). */
@@ -829,6 +863,8 @@ export interface RoomExecution extends RoomMemberRun {
  * design note).
  */
 export interface RoomState {
+    /** All question cards with their outcomes (inline blocks in run cards and replies). */
+    readonly askLog?: readonly RoomAsk[];
     readonly executions?: readonly RoomExecution[];
     readonly plan?: Omit<RoomPlan, 'requests'>;
     readonly deliveries?: readonly RoomDelivery[];
@@ -904,6 +940,11 @@ export type RoomFailure = {
 } | {
     readonly code: 'empty-text';
 }
+/** An attachment was refused (not uploaded to this room, too large, an unsupported image…). */
+ | {
+    readonly code: 'attachment-invalid';
+    readonly message: string;
+}
 /** The public role is longer than 30 characters. */
  | {
     readonly code: 'role-too-long';
@@ -1002,6 +1043,16 @@ export interface RoomMemberMessage {
  */
 export type RoomMemberMessageReceipt = 'sent' | 'pending-confirm' | 'busy' | `sent ${string}` | `pending-confirm ${string}`;
 /** isRoom probe: does this session carry the room marker? */
+/** pendingCards request: no arguments (every live room the host knows). */
+export interface RoomPendingCardsRequest {
+    readonly sessionId?: SessionId;
+}
+/** One question/approval card waiting for the human in a room (the session list's 「等你处理」). */
+export interface RoomPendingCard {
+    readonly sessionId: string;
+    readonly id: string;
+    readonly kind: 'question' | 'approval';
+}
 export interface RoomIsRoomRequest {
     /** Session to probe. */
     readonly sessionId: SessionId;
@@ -1199,6 +1250,30 @@ export interface RoomPostMessageRequest {
     readonly targets?: readonly string[];
     /** The composer's task tag: `new` or a task root id (see RoomSetTaskHintRequest). */
     readonly task?: string;
+    /**
+     * Draft attachments in the official composer's wire form: an image's
+     * base64 bytes, or a file's upload receipt (uploaded to this room session
+     * on pick). The host admits them into the human message; members get them
+     * by local path.
+     */
+    readonly attachments?: readonly RoomAttachmentInput[];
+}
+/** One composer attachment as it crosses the wire (the official prompt part shape). */
+export type RoomAttachmentInput = {
+    readonly type: 'image';
+    readonly data: string;
+    readonly mediaType: string;
+    readonly name?: string;
+} | {
+    readonly type: 'file';
+    readonly receiptId: string;
+};
+/** An admitted attachment as a dispatch records it: what members are told to read. */
+export interface RoomDispatchAttachment {
+    readonly kind: 'image' | 'file';
+    readonly name?: string;
+    /** Absolute host path; absent when the attachment store is not file-backed. */
+    readonly path?: string;
 }
 /** What the postMessage parser made of the raw text. */
 export interface RoomPostParsed {
@@ -1472,10 +1547,12 @@ export interface RoomJob {
     /** 1-based ordinal in the room, for 「任务 N」 and the coordinator's `task` argument. */
     readonly number: number;
     readonly title: string;
+    /** `from`: the member id a member/coordinator dispatch came from; absent = the human. */
     readonly messages: readonly {
         readonly id: string;
         readonly time: number;
         readonly text: string;
+        readonly from?: string;
         readonly by?: RoomTaskLinkEvent['by'];
         readonly probability?: number;
     }[];

package/package.json

@@ -7,7 +7,7 @@
     "cordis",
     "multi-agent"
   ],
-  "version": "0.2.3",
+  "version": "0.2.5",
   "type": "module",
   "main": "lib/index.js",
   "types": "lib/types/index.d.ts",
@@ -75,6 +75,7 @@
     "@deepseek-ai/dsh-client-locale": "^0.1.0-rc.6 || ^0.2.0-rc.1 || ^0.2.1-rc.1",
     "@deepseek-ai/dsh-client-ui-conversation": "^0.1.0-rc.6 || ^0.2.0-rc.1 || ^0.2.1-rc.1",
     "@deepseek-ai/dsh-client-ui-primitives": "^0.1.0-rc.6 || ^0.2.0-rc.1 || ^0.2.1-rc.1",
+    "@deepseek-ai/dsh-client-ui-sidebar-right": "^0.1.0-rc.6 || ^0.2.0-rc.1 || ^0.2.1-rc.1",
     "@deepseek-ai/dsh-client-ui-slots": "^0.1.0-rc.6 || ^0.2.0-rc.1 || ^0.2.1-rc.1",
     "@deepseek-ai/dsh-llm": "^0.1.0-rc.6 || ^0.2.0-rc.1 || ^0.2.1-rc.1",
     "@deepseek-ai/dsh-session": "^0.1.0-rc.6 || ^0.2.0-rc.1 || ^0.2.1-rc.1",
@@ -85,9 +86,9 @@
     "@deepseek-ai/dsh-tool-todo": "^0.1.0-rc.6 || ^0.2.0-rc.1 || ^0.2.1-rc.1",
     "@deepseek-ai/dsh-tools": "^0.1.0-rc.6 || ^0.2.0-rc.1 || ^0.2.1-rc.1",
     "@deepseek-ai/dsh-typert-protocol": "^0.1.0-rc.6 || ^0.2.0-rc.1 || ^0.2.1-rc.1",
-    "@khorsheed/dsh-local-agent": "^0.2.0",
-    "react": "^18.2.0",
-    "@deepseek-ai/dsh-client-ui-sidebar-right": "^0.1.0-rc.6 || ^0.2.0-rc.1 || ^0.2.1-rc.1"
+    "@deepseek-ai/dsh-util-workspace-path": "^0.1.0-rc.6 || ^0.2.0-rc.1 || ^0.2.1-rc.1",
+    "@khorsheed/dsh-local-agent": "^0.2.2",
+    "react": "^18.2.0"
   },
   "peerDependenciesMeta": {
     "@deepseek-ai/dsh-agent-preset-registry": {
@@ -96,6 +97,9 @@
     "@deepseek-ai/dsh-agent-presets": {
       "optional": true
     },
+    "@deepseek-ai/dsh-client-ui-sidebar-right": {
+      "optional": true
+    },
     "@deepseek-ai/dsh-session-stats": {
       "optional": true
     },
@@ -105,10 +109,10 @@
     "@deepseek-ai/dsh-tool-todo": {
       "optional": true
     },
-    "@khorsheed/dsh-local-agent": {
+    "@deepseek-ai/dsh-util-workspace-path": {
       "optional": true
     },
-    "@deepseek-ai/dsh-client-ui-sidebar-right": {
+    "@khorsheed/dsh-local-agent": {
       "optional": true
     }
   },