@khorsheed/dsh-room 0.2.3 → 0.2.5

package/lib/types/index.d.ts

@@ -7,7 +7,7 @@ import { SessionId } from '@deepseek-ai/dsh-session';
 import { TypertRemoteService } from '@deepseek-ai/dsh-typert-protocol';
 import { DispatchEngine } from './dispatch.ts';
 import type { Agent } from '@deepseek-ai/dsh-agent';
-import type { RoomHelpLinkRequest, RoomHelpLinkResult, RoomCancelRequest, RoomCancelResult, RoomPrepareMemberRequest, RoomPrepareMemberResult, RoomFailure, RoomSetCoordinatorRequest, RoomSetCoordinatorResult, RoomReconcileDeliveryRequest, RoomReconcileDeliveryResult, RoomGetStateRequest, RoomGetStateResult, RoomInviteRequest, RoomInviteResult, RoomIsRoomRequest, RoomListProvidersRequest, RoomMemberMessage, RoomMemberMessageReceipt, RoomMessageRequest, RoomReleaseReportsRequest, RoomReleaseReportsResult, RoomSetTaskHintRequest, RoomStopJobRequest, RoomStopJobResult, RoomMessageResult, RoomSetSettingsRequest, RoomSetSettingsResult, RoomPostMessageRequest, RoomPostMessageResult, RoomProviderList, RoomRelayResolveRequest, RoomRelayResolveResult, RoomRemoveMemberRequest, RoomRemoveMemberResult, RoomRestoreMemberRequest, RoomRestoreMemberResult, RoomSetGoalRequest, RoomSetGoalResult, RoomState, RoomUpdateMemberRequest, RoomUpdateMemberResult, RoomAnswerApprovalRequest, RoomAnswerApprovalResult, RoomAnswerQuestionRequest, RoomAnswerQuestionResult, RoomQuestionItem } from './types.ts';
+import type { RoomHelpLinkRequest, RoomHelpLinkResult, RoomCancelRequest, RoomCancelResult, RoomPrepareMemberRequest, RoomPrepareMemberResult, RoomFailure, RoomSetCoordinatorRequest, RoomSetCoordinatorResult, RoomReconcileDeliveryRequest, RoomReconcileDeliveryResult, RoomGetStateRequest, RoomGetStateResult, RoomInviteRequest, RoomInviteResult, RoomIsRoomRequest, RoomListProvidersRequest, RoomMemberMessage, RoomMemberMessageReceipt, RoomMessageRequest, RoomReleaseReportsRequest, RoomReleaseReportsResult, RoomSetTaskHintRequest, RoomStopJobRequest, RoomStopJobResult, RoomMessageResult, RoomSetSettingsRequest, RoomSetSettingsResult, RoomPostMessageRequest, RoomPostMessageResult, RoomDispatchAttachment, RoomPendingCard, RoomPendingCardsRequest, RoomProviderList, RoomRelayResolveRequest, RoomRelayResolveResult, RoomRemoveMemberRequest, RoomRemoveMemberResult, RoomRestoreMemberRequest, RoomRestoreMemberResult, RoomSetGoalRequest, RoomSetGoalResult, RoomState, RoomUpdateMemberRequest, RoomUpdateMemberResult, RoomAnswerApprovalRequest, RoomAnswerApprovalResult, RoomAnswerQuestionRequest, RoomAnswerQuestionResult, RoomQuestionAnswer, RoomQuestionItem } from './types.ts';
 export type * from './types.ts';
 export { MAIN_AGENT_MEMBER, ROOM_EVENT_TYPES } from './journal.ts';
 declare module '@deepseek-ai/cordis' {
@@ -39,6 +39,23 @@ type RoomLoad = {
  * @returns the questions, or the error text the model reads.
  */
 export declare function parseQuestions(raw: unknown): readonly RoomQuestionItem[] | string;
+/**
+ * The message a late answer reaches its member as: each question with the
+ * human's pick, so the member can go on (or correct what it assumed).
+ * @param questions - the card's questions.
+ * @param answers - the human's answers, one per question.
+ * @returns the dispatch text.
+ */
+export declare function lateAnswerText(questions: readonly RoomQuestionItem[], answers: readonly RoomQuestionAnswer[]): string;
+/**
+ * The dispatch text with the message's attachments appended as local paths:
+ * every member — CLI or native — opens them with its own read tool, so one
+ * form reaches all of them.
+ * @param text - the dispatched text.
+ * @param attachments - the admitted attachments.
+ * @returns the text members receive.
+ */
+export declare function withAttachmentPaths(text: string, attachments: readonly RoomDispatchAttachment[] | undefined): string;
 /**
  * What a new coordinator reads once, on its first round: who handed over,
  * the goal and open tasks, and where to look. The conversation itself is
@@ -95,6 +112,36 @@ export declare class RoomService extends TypertRemoteService {
      * @param request - session identity.
      * @returns true when the session carries the marker (false for unknown sessions too).
      */
+    /** Run ids of the members working in each room (the session list's 运行中). */
+    private readonly activeRuns;
+    /** Question/approval cards waiting for the human, per room. */
+    private readonly waitingCards;
+    /**
+     * Follow a room's run and card edges as they are journaled: a room turns
+     * running when its first member starts and settles when its last one ends
+     * (the host's `api-session/status`, so the list shows 运行中 and then
+     * 已完成), and its waiting cards are kept for {@link pendingCards}.
+     * @param session - the session the event landed in.
+     * @param event - the journaled event.
+     */
+    private observeActivity;
+    /**
+     * End the waits behind one member's open cards (its round settled): the
+     * question/approval calls resolve as unanswered, which journals them
+     * expired — still answerable, by a new message (answerExpiredQuestion).
+     * @param roomId - the room session.
+     * @param member - the member whose round ended.
+     */
+    private expireCardsOf;
+    /** Broadcast a room's running flip on the host's session-status channel. */
+    private emitStatus;
+    /**
+     * The question/approval cards waiting for the human across live rooms —
+     * the browser publishes them as the session list's 等你处理 status.
+     * @param request - optionally one room only.
+     * @returns the waiting cards.
+     */
+    pendingCards(request: RoomPendingCardsRequest): Promise<readonly RoomPendingCard[]>;
     isRoom(request: RoomIsRoomRequest): Promise<boolean>;
     /**
      * Resolve a session for a room WRITE, promoting it when it isn't a room
@@ -293,6 +340,16 @@ export declare class RoomService extends TypertRemoteService {
      * @returns the parse receipt, or a rejection.
      */
     postMessage(request: RoomPostMessageRequest): Promise<RoomPostMessageResult>;
+    /**
+     * Admit a human message's composer attachments the way the host's own
+     * prompt path does: file receipts resolve against this room session's
+     * uploads, images are stored, and every attachment becomes a durable
+     * content block for the message — plus the local path members read it by.
+     * @param sessionId - the room session (its agent owns the uploads).
+     * @param inputs - the wire attachments.
+     * @returns the content blocks, the dispatch records, and the receipt binder; or a refusal.
+     */
+    private admitAttachments;
     /**
      * Send one message from a member to another (host-only — the `room_message`
      * tool and the bridge's `member_message`/`room_message` land here; the
@@ -443,6 +500,17 @@ export declare class RoomService extends TypertRemoteService {
      * @returns ok, or `question-not-pending` when it already ended.
      */
     answerQuestion(request: RoomAnswerQuestionRequest): Promise<RoomAnswerQuestionResult>;
+    /**
+     * Answer a card whose waiting call is gone (it timed out, or a restart
+     * ended the member's process): the card records the answers, and they
+     * reach the member as a new message that wakes it with its own context —
+     * the member asked so it could go on, so a late answer is still worth it.
+     * A consent gate is never answered late: its call already decided.
+     * @param session - the live room session.
+     * @param request - card id and the human's answers.
+     * @returns ok, or `question-not-pending` when the card is not an expired, unanswered question.
+     */
+    private answerExpiredQuestion;
     /** Shared backend for external MCP room tools. Not exposed as a browser Remote. */
     receiveMemberCommand(actor: LocalAgentMemberRun, command: MemberRoomCommand): Promise<MemberMessageOutcome>;
     /**