@khorsheed/dsh-room 0.2.4 → 0.2.5

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.4",
+  "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.1",
-    "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
     }
   },

package/lib/journal-B4FOGO6S.js

@@ -1,482 +0,0 @@
-//#region lib/types/deliveries.js
-/** Accepted delivery intents and their latest durable outcomes. */
-function replayDeliveries(events) {
-	const rows = /* @__PURE__ */ new Map();
-	for (const event of events) if (event.type === "room/dispatch" && event.data.targetIds !== void 0) for (const memberId of event.data.targetIds) {
-		const id = `${event.seq}:${memberId}`;
-		if (!rows.has(id)) rows.set(id, {
-			id,
-			dispatchSeq: event.seq,
-			memberId,
-			status: "queued",
-			text: event.data.text,
-			origin: event.data.origin ?? "human",
-			...event.data.replyTo === void 0 ? {} : { replyTo: event.data.replyTo },
-			...event.data.from === void 0 ? {} : { from: event.data.from },
-			...event.data.kind === void 0 ? {} : { kind: event.data.kind },
-			...event.data.plan === void 0 ? {} : { plan: event.data.plan }
-		});
-	}
-	else if (event.type === "room/delivery-state") {
-		const row = rows.get(event.data.id);
-		if (row === void 0 || row.memberId !== event.data.memberId || row.dispatchSeq !== event.data.dispatchSeq) continue;
-		rows.set(row.id, {
-			...row,
-			status: event.data.state,
-			...event.data.error === void 0 ? {} : { error: event.data.error }
-		});
-	}
-	return [...rows.values()];
-}
-//#endregion
-//#region lib/types/journal.js
-/**
-* Room journal replay: folds the room session's `room/*` custom events into
-* the derived {@link RoomState} — roster, notification relays, the task
-* board, and run states. Pure: the Remote surface reads through it, the
-* dispatch engine reads instruction cursors through it, and the unit tests
-* exercise it without a cordis composition. Reload-replay recovers the exact
-* same state, which is what makes the journal the room's single source of
-* truth. There is NO blackboard fold: member prompts never consume the
-* room's running log (see the design note) — speech/dispatch events are
-* journaled for UI projection and replay only.
-* @module @khorsheed/dsh-room/journal
-*/
-/**
-* The native DSH member's addressing name in new rooms. It starts as the
-* coordinator; bare messages follow the selected coordinator thereafter.
-* Existing journals retain their recorded names, including legacy main.
-*/
-const MAIN_AGENT_MEMBER = "dsh";
-/**
-* Every `room/*` session-event type this package introduces. Room registers
-* them into the harness's KNOWN_SESSION_EVENT_TYPES persistence catalog at
-* apply time (see the RoomService constructor): the catalog's read-path
-* refusal exists so a build that does NOT understand an event type never
-* silently mangles the log — a build with room mounted understands these, so
-* registration is the semantically correct declaration, and a build without
-* room keeps refusing them. The catalog's own header defers a registration
-* surface for out-of-repo plugins "until such a consumer exists"; this
-* in-place add is that surface's temporary form — migrate to the official
-* one when it lands upstream.
-*/
-const ROOM_EVENT_TYPES = [
-	"room/created",
-	"room/plan-state",
-	"room/coordinator",
-	"room/delivery-state",
-	"room/member-added",
-	"room/member-updated",
-	"room/member-removed",
-	"room/dispatch",
-	"room/speech",
-	"room/run-state",
-	"room/execution-metadata",
-	"room/relay",
-	"room/relay-resolved",
-	"room/task-added",
-	"room/task-updated",
-	"room/task-edited",
-	"room/goal",
-	"room/settings"
-];
-/** Collaboration settings of a room that never changed them. */
-const DEFAULT_ROOM_SETTINGS = {
-	memberMessages: "free",
-	hopLimit: 10,
-	paused: false
-};
-/** Whether an event log carries the room identity marker. */
-function isRoomLog(events) {
-	return events.some((event) => event.type === "room/created");
-}
-/**
-* Parse the leading `@name` tokens of a raw composer message.
-* @param raw - the raw text.
-* @returns the addressed names (deduped, order-preserving) and the body with
-* the mention prefix stripped. Only LEADING tokens address: an `@name`
-* inside prose is plain text (a bare message goes to the selected coordinator).
-*/
-function parseMentions(raw) {
-	const targets = [];
-	let rest = raw.trim();
-	for (;;) {
-		const match = /^@(\S+)(?:\s+|$)/.exec(rest);
-		if (match === null) break;
-		const name = match[1];
-		if (!targets.includes(name)) targets.push(name);
-		rest = rest.slice(match[0].length).trim();
-	}
-	return {
-		targets,
-		text: rest
-	};
-}
-/**
-* Fold a session's event log into the room state.
-*
-* Write-side invariants (invite/update/remove validate before appending) are
-* NOT re-enforced here: a replayed log may be hand-edited or forked, so the
-* fold is defensive — a duplicate member-added keeps the first record (first
-* wins, a replay cannot re-seat a member), and updates/removals naming an
-* unknown member are dropped. Unknown event types (e.g. a `room/note` from
-* the dropped blackboard design) fall through the switch and are skipped.
-* Removal also drops the member's run state: the roster reads clean after a
-* remove. Relays and tasks fold by id, latest resolution winning.
-* @param events - the session's event log.
-* @returns the folded room state (empty for a non-room log).
-*/
-function replay(events) {
-	const members = [];
-	const byName = /* @__PURE__ */ new Map();
-	const relays = [];
-	const relayById = /* @__PURE__ */ new Map();
-	const tasks = [];
-	const taskById = /* @__PURE__ */ new Map();
-	const runs = /* @__PURE__ */ new Map();
-	const executions = /* @__PURE__ */ new Map();
-	let goal;
-	let settings = DEFAULT_ROOM_SETTINGS;
-	let coordinator;
-	for (const event of events) switch (event.type) {
-		case "room/coordinator":
-			if (event.data.revision > (coordinator?.revision ?? 0)) coordinator = event.data;
-			break;
-		case "room/member-added": {
-			if (byName.has(event.data.name)) break;
-			const added = {
-				id: event.data.id ?? `legacy:${event.seq}`,
-				name: event.data.name,
-				kind: event.data.kind,
-				invitedBy: event.data.invitedBy,
-				...event.data.provider === void 0 ? {} : { provider: event.data.provider },
-				...event.data.instructions === void 0 ? {} : { instructions: event.data.instructions },
-				...event.data.role === void 0 ? {} : { role: event.data.role },
-				...event.data.preset === void 0 ? {} : { preset: event.data.preset },
-				...event.data.cwd === void 0 ? {} : { cwd: event.data.cwd },
-				...event.data.model === void 0 ? {} : { model: event.data.model },
-				...event.data.childSessionId === void 0 ? {} : { childSessionId: event.data.childSessionId }
-			};
-			byName.set(added.name, added);
-			members.push(added);
-			break;
-		}
-		case "room/member-updated": {
-			const member = byName.get(event.data.name);
-			if (member === void 0) break;
-			const withoutInstructions = event.data.instructions === null ? (({ instructions: _cleared, ...rest }) => rest)(member) : {
-				...member,
-				...event.data.instructions === void 0 ? {} : { instructions: event.data.instructions }
-			};
-			const withoutRole = event.data.role === null ? (({ role: _cleared, ...rest }) => rest)(withoutInstructions) : {
-				...withoutInstructions,
-				...event.data.role === void 0 ? {} : { role: event.data.role }
-			};
-			const withoutCwd = event.data.cwd === null ? (({ cwd: _cleared, ...rest }) => rest)(withoutRole) : {
-				...withoutRole,
-				...event.data.cwd === void 0 ? {} : { cwd: event.data.cwd }
-			};
-			const patched = {
-				...event.data.model === null ? (({ model: _cleared, ...rest }) => rest)(withoutCwd) : {
-					...withoutCwd,
-					...event.data.model === void 0 ? {} : { model: event.data.model }
-				},
-				...event.data.childSessionId === void 0 ? {} : { childSessionId: event.data.childSessionId }
-			};
-			for (const [id, execution] of executions) if (execution.memberId === member.id && execution.childSessionId === void 0 && patched.childSessionId !== void 0) executions.set(id, {
-				...execution,
-				childSessionId: patched.childSessionId
-			});
-			const rename = event.data.rename;
-			if (rename === void 0 || rename === member.name || byName.has(rename)) {
-				byName.set(member.name, patched);
-				members[members.indexOf(member)] = patched;
-				break;
-			}
-			const renamed = {
-				...patched,
-				name: rename
-			};
-			byName.delete(member.name);
-			byName.set(rename, renamed);
-			members[members.indexOf(member)] = renamed;
-			for (let index = 0; index < tasks.length; index++) {
-				const task = tasks[index];
-				if (task.member !== member.name && task.blockedBy !== member.name) continue;
-				const migrated = {
-					...task,
-					...task.member === member.name ? { member: rename } : {},
-					...task.blockedBy === member.name ? { blockedBy: rename } : {}
-				};
-				taskById.set(migrated.id, migrated);
-				tasks[index] = migrated;
-			}
-			for (let index = 0; index < relays.length; index++) {
-				const relay = relays[index];
-				if (relay.from !== member.name && relay.to !== member.name) continue;
-				const migrated = {
-					...relay,
-					from: relay.from === member.name ? rename : relay.from,
-					to: relay.to === member.name ? rename : relay.to
-				};
-				relayById.set(migrated.id, migrated);
-				relays[index] = migrated;
-			}
-			const run = runs.get(member.name);
-			if (run !== void 0) {
-				runs.delete(member.name);
-				runs.set(rename, {
-					...run,
-					member: rename
-				});
-			}
-			break;
-		}
-		case "room/member-removed": {
-			const member = byName.get(event.data.name);
-			if (member === void 0) break;
-			byName.delete(event.data.name);
-			members.splice(members.indexOf(member), 1);
-			runs.delete(event.data.name);
-			break;
-		}
-		case "room/relay": {
-			if (relayById.has(event.data.id)) break;
-			const relay = {
-				id: event.data.id,
-				from: event.data.from,
-				to: event.data.to,
-				content: event.data.content,
-				state: "pending",
-				...event.data.provenance === void 0 ? {} : { provenance: event.data.provenance },
-				...event.data.reason === void 0 ? {} : { reason: event.data.reason },
-				...event.data.intent === void 0 ? {} : { intent: event.data.intent }
-			};
-			relayById.set(relay.id, relay);
-			relays.push(relay);
-			break;
-		}
-		case "room/relay-resolved": {
-			const relay = relayById.get(event.data.id);
-			if (relay === void 0) break;
-			const resolved = {
-				...relay,
-				state: event.data.state
-			};
-			relayById.set(resolved.id, resolved);
-			relays[relays.indexOf(relay)] = resolved;
-			break;
-		}
-		case "room/task-added": {
-			if (taskById.has(event.data.id)) break;
-			const task = {
-				id: event.data.id,
-				member: event.data.member,
-				title: event.data.title,
-				...event.data.deliveryId === void 0 ? {} : { deliveryId: event.data.deliveryId },
-				status: event.data.status,
-				...event.data.blockedBy === void 0 ? {} : { blockedBy: event.data.blockedBy },
-				updatedAt: event.time
-			};
-			taskById.set(task.id, task);
-			tasks.push(task);
-			break;
-		}
-		case "room/task-updated": {
-			const task = taskById.get(event.data.id);
-			if (task === void 0) break;
-			const updated = {
-				...task,
-				status: event.data.status,
-				updatedAt: event.time
-			};
-			taskById.set(updated.id, updated);
-			tasks[tasks.indexOf(task)] = updated;
-			break;
-		}
-		case "room/task-edited": {
-			const task = taskById.get(event.data.id);
-			if (task === void 0) break;
-			const edited = {
-				...event.data.blockedBy === null ? (({ blockedBy: _cleared, ...rest }) => rest)(task) : {
-					...task,
-					...event.data.blockedBy === void 0 ? {} : { blockedBy: event.data.blockedBy }
-				},
-				...event.data.title === void 0 ? {} : { title: event.data.title },
-				...event.data.member === void 0 ? {} : { member: event.data.member },
-				updatedAt: event.time
-			};
-			taskById.set(edited.id, edited);
-			tasks[tasks.indexOf(task)] = edited;
-			break;
-		}
-		case "room/settings":
-			settings = {
-				memberMessages: event.data.memberMessages ?? settings.memberMessages,
-				hopLimit: event.data.hopLimit ?? settings.hopLimit,
-				paused: event.data.paused ?? settings.paused
-			};
-			break;
-		case "room/goal": {
-			const text = event.data.text.trim();
-			goal = text === "" ? void 0 : text;
-			break;
-		}
-		case "room/execution-metadata": {
-			const previous = executions.get(event.data.runId);
-			if (previous) executions.set(previous.id, {
-				...previous,
-				...event.data
-			});
-			break;
-		}
-		case "room/run-state": {
-			const member = byName.get(event.data.member);
-			const id = event.data.runId ?? `legacy:${member?.id ?? event.data.member}:${event.data.startedAt}`;
-			const previous = executions.get(id);
-			executions.set(id, {
-				id,
-				...member?.id === void 0 ? {} : { memberId: member.id },
-				...member?.childSessionId === void 0 ? {} : { childSessionId: member.childSessionId },
-				...member?.provider === void 0 ? {} : { provider: member.provider },
-				...previous,
-				...event.data,
-				...event.data.state === "running" || event.data.elapsedMs !== void 0 ? {} : { elapsedMs: Math.max(0, event.time - event.data.startedAt) }
-			});
-			const current = runs.get(event.data.member);
-			if (event.data.state !== "running" && event.data.runId !== void 0 && current?.runId !== void 0 && current.runId !== event.data.runId) break;
-			runs.set(event.data.member, {
-				member: event.data.member,
-				state: event.data.state,
-				startedAt: event.data.startedAt,
-				...event.data.runId === void 0 ? {} : { runId: event.data.runId },
-				...event.data.elapsedMs === void 0 ? {} : { elapsedMs: event.data.elapsedMs },
-				...event.data.error === void 0 ? {} : { error: event.data.error }
-			});
-			break;
-		}
-	}
-	const planEvent = events.filter((event) => event.type === "room/plan-state").at(-1);
-	const plan = planEvent?.type === "room/plan-state" ? (({ requests: _requests, ...view }) => view)(planEvent.data) : void 0;
-	const deliveries = replayDeliveries(events);
-	return {
-		members,
-		relays,
-		tasks,
-		...executions.size === 0 ? {} : { executions: [...executions.values()] },
-		...plan === void 0 ? {} : { plan },
-		...deliveries.length === 0 ? {} : { deliveries },
-		runs: [...runs.values()],
-		...coordinator === void 0 ? {} : { coordinator },
-		...goal === void 0 ? {} : { goal },
-		settings
-	};
-}
-/**
-* The member's dispatch cursor as of JUST BEFORE a given dispatch event: the
-* latest earlier dispatch naming them. The engine reads the role-instruction
-* carry against this cursor (pass {@link Number.MAX_SAFE_INTEGER} for a
-* dispatch that is not itself journaled, e.g. a relay delivery).
-* @param events - the session's event log.
-* @param member - the dispatch target.
-* @param beforeSeq - the current dispatch event's seq.
-* @returns the previous dispatch seq, or undefined on the member's first dispatch.
-*/
-function previousCursor(events, member, beforeSeq) {
-	let cursor;
-	for (const event of events) {
-		if (event.type !== "room/dispatch" || event.seq >= beforeSeq) continue;
-		if (event.data.targets.includes(member)) cursor = event.seq;
-	}
-	return cursor;
-}
-/**
-* What changed in the room since a member's last dispatch, as one-line
-* notes for the next prompt: other members joining or leaving, renames, role
-* changes, the member's own role change, and a goal change. The full roster
-* rides only the first dispatch's briefing; later dispatches carry these
-* deltas instead (the member's own session holds the rest), and a member who
-* wants the whole picture calls `room_read`. Model, cwd and delegation-handle
-* updates never reach a prompt. A member with no cursor gets no deltas — the
-* briefing already covers everything.
-* @param events - the session's event log.
-* @param cursor - the member's pre-dispatch cursor ({@link previousCursor}).
-* @param self - the member's CURRENT name (its own rename is not news to it).
-* @returns the change notes (empty when nothing changed).
-*/
-function roomChangesSince(events, cursor, self) {
-	if (cursor === void 0) return [];
-	const notes = [];
-	let goal;
-	for (const event of events) {
-		if (event.seq <= cursor) continue;
-		if (event.type === "room/member-added" && event.data.name !== self && event.data.kind !== "main-agent") {
-			const detail = [event.data.role, event.data.provider].filter(Boolean).join(" · ");
-			notes.push(`${event.data.name} 加入${detail === "" ? "" : `（${detail}）`}`);
-		} else if (event.type === "room/member-removed" && event.data.name !== self) notes.push(`${event.data.name} 离开`);
-		else if (event.type === "room/member-updated") {
-			if (event.data.rename !== void 0 && event.data.rename !== self) notes.push(`${event.data.name} 改名为 ${event.data.rename}`);
-			if (event.data.role !== void 0) {
-				const who = event.data.rename ?? event.data.name;
-				const subject = who === self ? "你的职责" : `${who} 的职责`;
-				notes.push(event.data.role === null ? `${subject}已清除` : `${subject}改为：${event.data.role}`);
-			}
-		} else if (event.type === "room/goal") goal = { text: event.data.text.trim() };
-	}
-	if (goal !== void 0) notes.push(goal.text === "" ? "房间目标已清除" : `房间目标更新为：${goal.text}`);
-	return notes;
-}
-/**
-* The role-instructions carry for the next dispatch to a member: 'initial'
-* when the member has never been dispatched (their instructions open the
-* first prompt), 'update' when the latest member-added/member-updated event
-* naming them postdates their dispatch cursor (an edit rides the next
-* dispatch as a context update). Instructions events older than the cursor
-* were already carried.
-* @param events - the session's event log.
-* @param member - the dispatch target.
-* @param cursor - the member's pre-dispatch cursor ({@link previousCursor}).
-* @returns the carry, or undefined when nothing needs carrying.
-*/
-function pendingInstructions(events, member, cursor) {
-	let lastSeq;
-	let lastInstructions;
-	for (const event of events) if (event.type === "room/member-added" && event.data.name === member && event.data.instructions !== void 0) {
-		lastSeq = event.seq;
-		lastInstructions = event.data.instructions;
-	} else if (event.type === "room/member-updated" && event.data.name === member) {
-		if (event.data.instructions === null) {
-			lastSeq = void 0;
-			lastInstructions = void 0;
-		} else if (event.data.instructions !== void 0) {
-			lastSeq = event.seq;
-			lastInstructions = event.data.instructions;
-		}
-	}
-	if (lastSeq === void 0 || lastInstructions === void 0) return void 0;
-	if (cursor === void 0) return {
-		kind: "initial",
-		instructions: lastInstructions
-	};
-	if (lastSeq > cursor) return {
-		kind: "update",
-		instructions: lastInstructions
-	};
-}
-/** Resolve legacy join identity through renames; never key a new dispatch by display name. */
-function memberId(events, member) {
-	if (member.id !== void 0) return member.id;
-	let name = member.name;
-	for (let index = events.length - 1; index >= 0; index--) {
-		const event = events[index];
-		if (event.type === "room/member-updated" && event.data.rename === name) name = event.data.name;
-		if (event.type === "room/member-added" && event.data.name === name) return event.data.id ?? `legacy:${event.seq}`;
-	}
-	throw new Error("Room member has no join identity");
-}
-function coordinatorMember(state, events) {
-	if (state.coordinator === void 0) return state.members.find((member) => member.kind === "main-agent");
-	return state.members.find((member) => (member.id ?? (events === void 0 ? void 0 : memberId(events, member))) === state.coordinator.memberId);
-}
-//#endregion
-export { isRoomLog as a, pendingInstructions as c, roomChangesSince as d, replayDeliveries as f, coordinatorMember as i, previousCursor as l, MAIN_AGENT_MEMBER as n, memberId as o, ROOM_EVENT_TYPES as r, parseMentions as s, DEFAULT_ROOM_SETTINGS as t, replay as u };