@openmarket/rooms-client 0.3.0 → 0.4.1

package/dist/agent/lane-prompts.js

@@ -96,7 +96,7 @@ export function buildMergeProposalBootstrap(opts) {
 /** The librarian bootstrap for `/brief refresh`: the agent rewrites the
  *  room's brief doc itself, in the canonical structure renderBrief pins. */
 export function buildBriefRefreshBootstrap(opts) {
-    return lines(opts.personaLine, `You are the LIBRARIAN for ${opts.label}. Maintain its brief: a concise, current snapshot.`, "1. Read the recent conversation with room_history for this room.", `2. Read the existing brief if any: doc_read spaceId ${opts.spaceId}, path ${opts.path}.`, `3. List the docs in play with doc_list (spaceId ${opts.spaceId}).`, `4. Write the brief with doc_write (spaceId ${opts.spaceId}, path ${opts.path}, a note describing what changed), following EXACTLY this structure:`, "", `# Brief: ${opts.label}`, "", `> Auto-generated by the room agent, read-only. Updated ${opts.nowLabel}.`, "", "## Summary", "<one or two short paragraphs on what this room is about and where it stands>", "", "## Open threads", "- <unresolved questions, or `None.`>", "", "## Decisions", "- <decisions reached, or `None yet.`>", "", "## Docs in play", "- `path` (rN, when) for each referenced doc, or `None referenced.`", "", "Keep it tight and factual. Do NOT output a DRAFT line. After writing, reply with one line naming the revision you wrote.");
+    return lines(opts.personaLine, `You are the LIBRARIAN for ${opts.label}. Maintain its brief: a concise, current snapshot.`, "1. Read the recent conversation with room_history for this room.", `2. Read the existing brief if any: doc_read spaceId ${opts.spaceId}, path ${opts.path}.`, `3. List the docs in play with doc_list (spaceId ${opts.spaceId}).`, `4. Write the brief with doc_write (spaceId ${opts.spaceId}, path ${opts.path}, a note describing what changed), following EXACTLY this structure:`, "", `# Brief: ${opts.label}`, "", `> Auto-generated by the room agent, read-only. Updated ${opts.nowLabel}.`, "", "## Summary", "<one or two short paragraphs on what this room is about and where it stands>", "", "## Open questions", "- <unresolved questions, or `None.`>", "", "## Decisions", "- <decisions reached, or `None yet.`>", "", "## Docs in play", "- `path` (rN, when) for each referenced doc, or `None referenced.`", "", "Keep it tight and factual. Do NOT output a DRAFT line. After writing, reply with one line naming the revision you wrote.");
 }
 /** The scoped-summarize turn message. It runs on the DEFAULT lane bootstrap
  *  (context spine + citation teaching already present); the message carries

package/dist/agent/room-context.d.ts

@@ -107,7 +107,14 @@ export interface BriefInput {
     openThreads: string[];
     decisions: string[];
     docs: BriefDocRef[];
+    /** Highest message seq this brief has incorporated. Rendered into the
+     *  banner as the librarian's shared cursor; co-librarians read it before
+     *  spending anything. */
+    coveredSeq?: number;
 }
+/** The banner's machine-readable coverage claim. Parsers must only consult
+ *  the banner blockquote line, never body prose. */
+export declare const BRIEF_COVERED_RE: RegExp;
 /** Render the canonical brief markdown. Deterministic shell; the LLM only
  *  supplies the summary/threads/decisions prose. */
 export declare function renderBrief(input: BriefInput): string;

package/dist/agent/room-context.js

@@ -128,19 +128,23 @@ export function briefPath(roomName) {
         .slice(0, 60) || "room";
     return `briefs/${slug}.md`;
 }
+/** The banner's machine-readable coverage claim. Parsers must only consult
+ *  the banner blockquote line, never body prose. */
+export const BRIEF_COVERED_RE = /\bCovers through seq (\d+)\./;
 /** Render the canonical brief markdown. Deterministic shell; the LLM only
  *  supplies the summary/threads/decisions prose. */
 export function renderBrief(input) {
+    const covered = input.coveredSeq !== undefined ? ` Covers through seq ${input.coveredSeq}.` : "";
     const lines = [];
     lines.push(`# Brief: ${input.room}`);
     lines.push("");
-    lines.push(`> Auto-generated by the room agent, read-only. Updated ${input.updatedAtLabel}.`);
+    lines.push(`> Auto-generated by the room agent, read-only. Updated ${input.updatedAtLabel}.${covered}`);
     lines.push("");
     lines.push("## Summary");
     lines.push("");
     lines.push(input.summary.trim() || "_No summary yet._");
     lines.push("");
-    lines.push("## Open threads");
+    lines.push("## Open questions");
     lines.push("");
     if (input.openThreads.length === 0)
         lines.push("_None._");

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-import { type RoomAccessMode, type RoomAttachmentInput, type RoomAuditLogPayload, type RoomAuthSuccessPayload, type RoomBackfillPayload, type RoomDmHistoryResultPayload, type RoomDmMessagePayload, type RoomDmOpenedPayload, type RoomFriendPresence, type RoomInvitedPayload, type RoomLedgerEntry, type RoomMemberRemovedPayload, type RoomMemberRoleChangedPayload, type RoomMeta, type RoomPinsPayload, type RoomPresencePayload, type RoomReactorsPayload, type RoomReadStatePayload, type RoomReportedPayload, type RoomRole, type RoomSearchResultsPayload, type RoomSearchScope, type RoomSpace, type RoomThreadPayload, type RoomTopic, type RoomTopicAttention, type RoomTopicResultPayload, type RoomTopicsResultPayload, type RoomUserStatus, type RoomWhoPayload } from "./types.js";
+import { type RoomAccessMode, type RoomAttachmentInput, type RoomAuditLogPayload, type RoomAuthSuccessPayload, type RoomBackfillPayload, type RoomClientPlatform, type RoomDmHistoryResultPayload, type RoomDmInboxUpdatedPayload, type RoomDmMessagePayload, type RoomDmOpenedPayload, type RoomFriendPresence, type RoomInvitedPayload, type RoomLedgerEntry, type RoomMemberRemovedPayload, type RoomMemberRoleChangedPayload, type RoomMeta, type RoomPinsPayload, type RoomPresencePayload, type RoomReactorsPayload, type RoomReadStatePayload, type RoomReportedPayload, type RoomRole, type RoomSearchResultsPayload, type RoomSearchScope, type RoomSpace, type RoomThreadPayload, type RoomTopic, type RoomTopicAttention, type RoomTopicResultPayload, type RoomTopicsResultPayload, type RoomUserStatus, type RoomWhoPayload } from "./types.js";
 import { type RoomWebSocketCtor, RoomWsClient } from "./ws-client.js";
 export interface RoomClientConfig {
     url: string;
@@ -213,6 +213,10 @@ export interface RoomDmSendRequest {
      *  Additive — omitted for text-only sends. */
     imageUrl?: string;
 }
+export interface RoomDmReadRequest {
+    username?: string;
+    conversationId?: string;
+}
 export interface RoomThreadRequest {
     room: string;
     rootSeq: number;
@@ -254,6 +258,7 @@ export declare function whoamiRoom(config: RoomClientConfig): Promise<RoomAuthSu
 export declare function requestRoomFriends(client: RoomWsClient): Promise<RoomFriendPresence[]>;
 export declare function openRoomDmOnClient(client: RoomWsClient, request: RoomDmOpenRequest, timeoutMs?: number): Promise<RoomDmOpenedPayload>;
 export declare function requestRoomDmHistoryOnClient(client: RoomWsClient, request: RoomDmHistoryRequest, timeoutMs?: number): Promise<RoomDmHistoryResultPayload>;
+export declare function markRoomDmReadOnClient(client: RoomWsClient, request: RoomDmReadRequest, timeoutMs?: number): Promise<RoomDmInboxUpdatedPayload>;
 export declare function sendRoomDmOnClient(client: RoomWsClient, request: RoomDmSendRequest, timeoutMs?: number): Promise<RoomDmMessagePayload>;
 /** Edit one of my DM messages. Fire-and-forget over the WS; the relay fans out
  *  DM_MESSAGE_EDITED to both participants. */
@@ -283,9 +288,18 @@ export declare function joinRoom(config: RoomClientConfig, options: RoomJoinOpti
 /** Re-join a room on an already-connected client (used after a reconnect). */
 export declare function rejoinRoomOnClient(client: RoomWsClient, options: RoomJoinOptions): Promise<RoomBackfillPayload>;
 export declare function attachRejoinOnReconnect(client: RoomWsClient, options: RoomJoinOptions, latestSeq: () => number | undefined, onRejoined?: (backfill: RoomBackfillPayload) => void, onError?: (err: unknown) => void): () => void;
-export declare function postRoomMessage(client: RoomWsClient, room: string, text: string, inReplyTo?: number, attachments?: RoomAttachmentInput[], topicId?: string): string;
+/**
+ * Post into a joined room and return the frame's clientMsgId (what MESSAGE
+ * echoes carry back for optimistic-send reconciliation). `clientMsgId` is
+ * caller-suppliable so an offline send queue can retry one logical message
+ * under one stable id (same contract as sayRoom / sendRoomDmOnClient);
+ * omitted, it mints a UUID exactly as before. The relay validates the id
+ * (1..128 chars after trim); dedupe on (userId, clientMsgId) is server-side
+ * work and NOT implied here.
+ */
+export declare function postRoomMessage(client: RoomWsClient, room: string, text: string, inReplyTo?: number, attachments?: RoomAttachmentInput[], topicId?: string, clientMsgId?: string): string;
 export declare function sendRoomTyping(client: RoomWsClient, room: string, state: "start" | "stop"): void;
-export declare function sendRoomStatus(client: RoomWsClient, status: RoomUserStatus, statusText?: string | null): void;
+export declare function sendRoomStatus(client: RoomWsClient, status: RoomUserStatus, statusText?: string | null, platform?: RoomClientPlatform): void;
 /**
  * Fetch a joined room's meta (title, access, postingRoles, viewerRole) over
  * the live socket via a scoped SEARCH. Returns null on timeout/no match so
@@ -310,7 +324,18 @@ export declare function requestRoomReactors(client: RoomWsClient, request: {
  *  persists it durably; a one-shot socket has no joined rooms, so live
  *  rosters pick the change up from the store (the TUI/GUI send STATUS on
  *  their live connection instead, which also broadcasts PRESENCE_DELTA). */
-export declare function setRoomStatusOnce(config: RoomClientConfig, status: RoomUserStatus, statusText?: string | null): Promise<void>;
+export declare function setRoomStatusOnce(config: RoomClientConfig, status: RoomUserStatus, statusText?: string | null, platform?: RoomClientPlatform): Promise<void>;
+/**
+ * Set the caller's room-level attention (notification posture) on a live
+ * client. The relay validates room participation, persists through the
+ * store, and acks with a READ_STATE frame scoped to this room whose
+ * attention map carries the persisted value (readState stays empty: cursors
+ * are untouched). Private per-user state; nothing broadcasts.
+ */
+export declare function setRoomAttentionOnClient(client: RoomWsClient, request: {
+    room: string;
+    attention: RoomTopicAttention;
+}): Promise<RoomReadStatePayload>;
 /** Add/remove one reaction (one-shot). Returns the updated entry. */
 export declare function reactRoom(config: RoomClientConfig, options: {
     room: string;

package/dist/client.js

@@ -454,6 +454,20 @@ export async function requestRoomDmHistoryOnClient(client, request, timeoutMs) {
     const history = await client.waitFor(RoomServerMessageType.DM_HISTORY, (msg) => msg.payload.requestId === requestId, timeoutMs, requestId);
     return history.payload;
 }
+export async function markRoomDmReadOnClient(client, request, timeoutMs) {
+    const requestId = randomUUID();
+    client.send({
+        type: RoomClientMessageType.DM_READ,
+        payload: {
+            requestId,
+            ...(request.username ? { username: request.username } : {}),
+            ...(request.conversationId ? { conversationId: request.conversationId } : {}),
+        },
+        timestamp: Date.now(),
+    });
+    const updated = await client.waitFor(RoomServerMessageType.DM_INBOX_UPDATED, (msg) => msg.payload.requestId === requestId, timeoutMs, requestId);
+    return updated.payload;
+}
 export async function sendRoomDmOnClient(client, request, timeoutMs) {
     const requestId = randomUUID();
     const clientMsgId = request.clientMsgId ?? randomUUID();
@@ -618,21 +632,30 @@ export function attachRejoinOnReconnect(client, options, latestSeq, onRejoined,
             .catch((err) => onError?.(err));
     });
 }
-export function postRoomMessage(client, room, text, inReplyTo, attachments, topicId) {
-    const clientMsgId = randomUUID();
+/**
+ * Post into a joined room and return the frame's clientMsgId (what MESSAGE
+ * echoes carry back for optimistic-send reconciliation). `clientMsgId` is
+ * caller-suppliable so an offline send queue can retry one logical message
+ * under one stable id (same contract as sayRoom / sendRoomDmOnClient);
+ * omitted, it mints a UUID exactly as before. The relay validates the id
+ * (1..128 chars after trim); dedupe on (userId, clientMsgId) is server-side
+ * work and NOT implied here.
+ */
+export function postRoomMessage(client, room, text, inReplyTo, attachments, topicId, clientMsgId) {
+    const msgId = clientMsgId ?? randomUUID();
     client.send({
         type: RoomClientMessageType.POST,
         payload: {
             room,
             ...(text ? { text } : {}),
             ...(attachments?.length ? { attachments: toRoomAttachmentPayloads(attachments) } : {}),
-            clientMsgId,
+            clientMsgId: msgId,
             ...(inReplyTo !== undefined ? { inReplyTo } : {}),
             ...(topicId ? { topicId } : {}),
         },
         timestamp: Date.now(),
     });
-    return clientMsgId;
+    return msgId;
 }
 export function sendRoomTyping(client, room, state) {
     if (client.isGuest())
@@ -643,10 +666,16 @@ export function sendRoomTyping(client, room, state) {
         timestamp: Date.now(),
     });
 }
-export function sendRoomStatus(client, status, statusText) {
+export function sendRoomStatus(client, status, statusText, platform) {
     client.send({
         type: RoomClientMessageType.STATUS,
-        payload: { status, ...(statusText !== undefined ? { statusText } : {}) },
+        payload: {
+            status,
+            ...(statusText !== undefined ? { statusText } : {}),
+            // Session identity, declared once per connection (or on change): the
+            // relay carries it onto presence member entries.
+            ...(platform ? { platform } : {}),
+        },
         timestamp: Date.now(),
     });
 }
@@ -769,11 +798,11 @@ export async function requestRoomReactors(client, request) {
  *  persists it durably; a one-shot socket has no joined rooms, so live
  *  rosters pick the change up from the store (the TUI/GUI send STATUS on
  *  their live connection instead, which also broadcasts PRESENCE_DELTA). */
-export async function setRoomStatusOnce(config, status, statusText) {
+export async function setRoomStatusOnce(config, status, statusText, platform) {
     const client = new RoomWsClient(config);
     try {
         await client.connect();
-        sendRoomStatus(client, status, statusText);
+        sendRoomStatus(client, status, statusText, platform);
         // STATUS has no ack frame: give the socket a beat to flush before close.
         await new Promise((resolve) => setTimeout(resolve, 200));
     }
@@ -781,6 +810,24 @@ export async function setRoomStatusOnce(config, status, statusText) {
         client.close();
     }
 }
+/**
+ * Set the caller's room-level attention (notification posture) on a live
+ * client. The relay validates room participation, persists through the
+ * store, and acks with a READ_STATE frame scoped to this room whose
+ * attention map carries the persisted value (readState stays empty: cursors
+ * are untouched). Private per-user state; nothing broadcasts.
+ */
+export async function setRoomAttentionOnClient(client, request) {
+    const requestId = randomUUID();
+    const room = normalizeRoomName(request.room);
+    client.send({
+        type: RoomClientMessageType.ROOM_SET_ATTENTION,
+        payload: { requestId, room, attention: request.attention },
+        timestamp: Date.now(),
+    });
+    const result = await client.waitFor(RoomServerMessageType.READ_STATE, (msg) => msg.payload.requestId === requestId, undefined, requestId);
+    return result.payload;
+}
 /** One-shot session helper for the config-based mutation verbs below (the
  *  agent tools' transport: connect, join, act, wait for the echo, close). */
 async function withRoomEcho(config, room, seq, send) {

package/dist/shared/rooms-protocol.d.ts

@@ -48,6 +48,7 @@ export declare const RoomClientMessageType: {
     readonly TOPIC_RESOLVE: "TOPIC_RESOLVE";
     readonly TOPIC_SET_ATTENTION: "TOPIC_SET_ATTENTION";
     readonly TOPIC_LIST: "TOPIC_LIST";
+    readonly ROOM_SET_ATTENTION: "ROOM_SET_ATTENTION";
 };
 export type RoomClientMessageType = (typeof RoomClientMessageType)[keyof typeof RoomClientMessageType];
 export declare const RoomServerMessageType: {
@@ -127,6 +128,9 @@ export type RoomRole = "owner" | "admin" | "mod" | "member";
  *  semantics of an absent value). */
 export type RoomTopicsPolicy = "off" | "allowed" | "required";
 export type RoomTopicAttention = "follow" | "default" | "mute";
+/** Self-declared client class on STATUS frames; presence member entries
+ *  carry it through so rosters can render where someone is connected from. */
+export type RoomClientPlatform = "web" | "desktop" | "mobile" | "tui";
 export interface RoomMember {
     userId: string;
     username: string;
@@ -140,6 +144,8 @@ export interface RoomMember {
     joinedAt: number;
     avatarUrl?: string | null;
     statusText?: string | null;
+    /** Present when the member's session declared one via STATUS. */
+    platform?: RoomClientPlatform | undefined;
 }
 export interface RoomMeta {
     name: string;
@@ -164,6 +170,10 @@ export interface RoomMeta {
      *  2026-07-12 dial-default flip (post-flip relays always advertise the
      *  stored value, "off" included); explicit "off" means topics are inert. */
     topicsPolicy?: RoomTopicsPolicy | undefined;
+    /** The viewer's room attention (notification posture), a per-viewer field
+     *  like viewerRole: surfaced on rooms listings for the caller. Absent
+     *  reads as "default". */
+    attention?: RoomTopicAttention | undefined;
     tags?: string[] | undefined;
     entities?: string[] | undefined;
     sourceRefs?: Array<Record<string, unknown>> | undefined;
@@ -295,7 +305,12 @@ export interface RoomPinsPayload {
     requestId?: string | undefined;
 }
 export interface RoomReadStatePayload {
+    /** Partial map: rooms absent from a reply are unchanged. */
     readState: Record<string, number>;
+    /** Per-room attention for the requesting user, keyed like readState.
+     *  Present when the store surfaces it and on ROOM_SET_ATTENTION acks
+     *  (which reply READ_STATE scoped to the one room, readState empty). */
+    attention?: Record<string, RoomTopicAttention> | undefined;
     requestId?: string | undefined;
 }
 export interface RoomSearchResultsPayload {
@@ -560,6 +575,7 @@ export interface RoomDmMessagePayload {
     clientMsgId?: string;
 }
 export interface RoomDmInboxUpdatedPayload {
+    requestId?: string;
     conversationId: string;
     participant: RoomDmParticipant;
     unreadCount: number;
@@ -743,6 +759,15 @@ export interface RoomTopicSetAttentionPayload {
     topicId: string;
     attention: RoomTopicAttention;
 }
+/** Room-level attention (notification posture). Private per-user state on
+ *  the caller's read row; topic attention wins for topic-scoped messages
+ *  and room attention wins over space attention. The relay acks with a
+ *  READ_STATE frame scoped to the room (see RoomReadStatePayload). */
+export interface RoomSetAttentionPayload {
+    requestId?: string;
+    room: string;
+    attention: RoomTopicAttention;
+}
 export interface RoomTopicListPayload {
     requestId?: string;
     room: string;
@@ -1017,6 +1042,7 @@ export type RoomClientMessage = {
     payload: {
         status: RoomUserStatus;
         statusText?: string | null;
+        platform?: RoomClientPlatform;
     };
     timestamp?: number;
 } | {
@@ -1092,6 +1118,10 @@ export type RoomClientMessage = {
     type: typeof RoomClientMessageType.TOPIC_LIST;
     payload: RoomTopicListPayload;
     timestamp?: number;
+} | {
+    type: typeof RoomClientMessageType.ROOM_SET_ATTENTION;
+    payload: RoomSetAttentionPayload;
+    timestamp?: number;
 };
 export type RoomServerMessage = {
     type: typeof RoomServerMessageType.AUTH_SUCCESS;

package/dist/shared/rooms-protocol.js

@@ -48,6 +48,7 @@ export const RoomClientMessageType = {
     TOPIC_RESOLVE: "TOPIC_RESOLVE",
     TOPIC_SET_ATTENTION: "TOPIC_SET_ATTENTION",
     TOPIC_LIST: "TOPIC_LIST",
+    ROOM_SET_ATTENTION: "ROOM_SET_ATTENTION",
 };
 export const RoomServerMessageType = {
     AUTH_SUCCESS: "AUTH_SUCCESS",

package/dist/social-client.d.ts

@@ -174,7 +174,8 @@ export interface RoomSpaceSummary {
 export declare function listRoomSpacesViaChat(config: RoomSocialConfig): Promise<RoomSpaceSummary[]>;
 export interface RoomSpaceMember {
     userId: string;
-    role: "owner" | "admin" | "member";
+    /** The ladder role. 'librarian' maintains the generated briefs/ docs. */
+    role: "owner" | "admin" | "librarian" | "member";
     /** Named identity roles (RoomSpaceRole.roleId). */
     roleIds?: string[];
     joinedAt?: string;
@@ -329,7 +330,7 @@ export declare function listRoomChannelMembers(config: RoomSocialConfig, roomId:
 export declare function removeSpaceMember(config: RoomSocialConfig, spaceId: string, targetUserId: string): Promise<{
     removed?: boolean;
 }>;
-export declare function changeSpaceMemberRole(config: RoomSocialConfig, spaceId: string, targetUserId: string, role: "admin" | "member"): Promise<RoomSpaceMember>;
+export declare function changeSpaceMemberRole(config: RoomSocialConfig, spaceId: string, targetUserId: string, role: "admin" | "librarian" | "member"): Promise<RoomSpaceMember>;
 /** Set (string) or clear (null) a member's per-space nickname; the store validates and enforces uniqueness. */
 export declare function setSpaceMemberNickname(config: RoomSocialConfig, spaceId: string, targetUserId: string, nickname: string | null): Promise<RoomSpaceMember>;
 export declare function createRoomSpace(config: RoomSocialConfig, input: {

package/dist/social-types.d.ts

@@ -130,6 +130,9 @@ export interface RoomDmMessage {
         emoji: string;
         users: string[];
     }>;
+    /** Client-minted idempotency tag echoed back on DM sends, so a sender's
+     *  durable queue can settle its optimistic row. Additive (0.4.0). */
+    clientMsgId?: string;
 }
 export interface RoomDmHistory {
     conversationId: string;

package/dist/types.d.ts

@@ -1,2 +1,2 @@
-export type { RoomAccessMode, RoomAttachment, RoomAttachmentInput, RoomAuditEntry, RoomAuditLogPayload, RoomAuditLogRequestPayload, RoomAuthSuccessPayload, RoomBackfillPayload, RoomClientMessage, RoomCreatedPayload, RoomCreatePayload, RoomDmHistoryPayload, RoomDmHistoryResultPayload, RoomDmInboxUpdatedPayload, RoomDmMessage, RoomDmMessagePayload, RoomDmOpenedPayload, RoomDmOpenPayload, RoomDmParticipant, RoomDmReadPayload, RoomDmSendPayload, RoomEntryUpdatedPayload, RoomErrorPayload, RoomFriendPresence, RoomInvitedPayload, RoomInvitePayload, RoomLedgerEntry, RoomMember, RoomMemberRemovedPayload, RoomMemberRoleChangedPayload, RoomMemberTier, RoomMessagePayload, RoomMeta, RoomModerateMemberPayload, RoomMutedPayload, RoomPinsPayload, RoomPresenceDeltaPayload, RoomPresencePayload, RoomReactorsPayload, RoomReadStatePayload, RoomRemoveMemberPayload, RoomReportedPayload, RoomReportPayload, RoomResyncPayload, RoomRole, RoomRoleChangePayload, RoomSearchPayload, RoomSearchResultsPayload, RoomSearchScope, RoomServerMessage, RoomServerMessageOf, RoomSetReadOnlyPayload, RoomSpace, RoomSpaceJoinedPayload, RoomSpacesPayload, RoomThreadPayload, RoomTopic, RoomTopicAttention, RoomTopicBucketState, RoomTopicCreatePayload, RoomTopicListPayload, RoomTopicMergePayload, RoomTopicMovePayload, RoomTopicRenamePayload, RoomTopicResolvePayload, RoomTopicResultPayload, RoomTopicSetAttentionPayload, RoomTopicsPolicy, RoomTopicsResultPayload, RoomTopicUpdatedPayload, RoomTypingPayload, RoomUserStatus, RoomWhoPayload, } from "./shared/rooms-protocol.js";
+export type { RoomAccessMode, RoomAttachment, RoomAttachmentInput, RoomAuditEntry, RoomAuditLogPayload, RoomAuditLogRequestPayload, RoomAuthSuccessPayload, RoomBackfillPayload, RoomClientMessage, RoomClientPlatform, RoomCreatedPayload, RoomCreatePayload, RoomDmHistoryPayload, RoomDmHistoryResultPayload, RoomDmInboxUpdatedPayload, RoomDmMessage, RoomDmMessagePayload, RoomDmOpenedPayload, RoomDmOpenPayload, RoomDmParticipant, RoomDmReadPayload, RoomDmSendPayload, RoomEntryUpdatedPayload, RoomErrorPayload, RoomFriendPresence, RoomInvitedPayload, RoomInvitePayload, RoomLedgerEntry, RoomMember, RoomMemberRemovedPayload, RoomMemberRoleChangedPayload, RoomMemberTier, RoomMessagePayload, RoomMeta, RoomModerateMemberPayload, RoomMutedPayload, RoomPinsPayload, RoomPresenceDeltaPayload, RoomPresencePayload, RoomReactorsPayload, RoomReadStatePayload, RoomRemoveMemberPayload, RoomReportedPayload, RoomReportPayload, RoomResyncPayload, RoomRole, RoomRoleChangePayload, RoomSearchPayload, RoomSearchResultsPayload, RoomSearchScope, RoomServerMessage, RoomServerMessageOf, RoomSetAttentionPayload, RoomSetReadOnlyPayload, RoomSpace, RoomSpaceJoinedPayload, RoomSpacesPayload, RoomThreadPayload, RoomTopic, RoomTopicAttention, RoomTopicBucketState, RoomTopicCreatePayload, RoomTopicListPayload, RoomTopicMergePayload, RoomTopicMovePayload, RoomTopicRenamePayload, RoomTopicResolvePayload, RoomTopicResultPayload, RoomTopicSetAttentionPayload, RoomTopicsPolicy, RoomTopicsResultPayload, RoomTopicUpdatedPayload, RoomTypingPayload, RoomUserStatus, RoomWhoPayload, } from "./shared/rooms-protocol.js";
 export { applyRoomPresenceDelta, isSystemRoomLedgerEntryType, ROOM_PRESENCE_SAMPLE_LIMIT, RoomClientMessageType, RoomLedgerEntryType, RoomServerMessageType, SUPPORTED_ROOM_PROTOCOL_VERSION, } from "./shared/rooms-protocol.js";

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.5.1";
-export declare const RUNNER_VERSION = "0.5.1";
+export declare const VERSION = "0.6.0";
+export declare const RUNNER_VERSION = "0.6.0";

package/dist/version.js

@@ -1,2 +1,2 @@
-export const VERSION = "0.5.1";
-export const RUNNER_VERSION = "0.5.1";
+export const VERSION = "0.6.0";
+export const RUNNER_VERSION = "0.6.0";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openmarket/rooms-client",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "description": "OM Rooms protocol client: wire types, WebSocket + REST clients, and chat view-models. Browser-safe (no node:/bun: imports).",
   "type": "module",
   "license": "Apache-2.0",

package/src/agent/lane-prompts.ts

@@ -202,7 +202,7 @@ export function buildBriefRefreshBootstrap(opts: {
     "## Summary",
     "<one or two short paragraphs on what this room is about and where it stands>",
     "",
-    "## Open threads",
+    "## Open questions",
     "- <unresolved questions, or `None.`>",
     "",
     "## Decisions",

package/src/agent/room-context.ts

@@ -202,21 +202,32 @@ export interface BriefInput {
   openThreads: string[];
   decisions: string[];
   docs: BriefDocRef[];
+  /** Highest message seq this brief has incorporated. Rendered into the
+   *  banner as the librarian's shared cursor; co-librarians read it before
+   *  spending anything. */
+  coveredSeq?: number;
 }
 
+/** The banner's machine-readable coverage claim. Parsers must only consult
+ *  the banner blockquote line, never body prose. */
+export const BRIEF_COVERED_RE = /\bCovers through seq (\d+)\./;
+
 /** Render the canonical brief markdown. Deterministic shell; the LLM only
  *  supplies the summary/threads/decisions prose. */
 export function renderBrief(input: BriefInput): string {
+  const covered = input.coveredSeq !== undefined ? ` Covers through seq ${input.coveredSeq}.` : "";
   const lines: string[] = [];
   lines.push(`# Brief: ${input.room}`);
   lines.push("");
-  lines.push(`> Auto-generated by the room agent, read-only. Updated ${input.updatedAtLabel}.`);
+  lines.push(
+    `> Auto-generated by the room agent, read-only. Updated ${input.updatedAtLabel}.${covered}`,
+  );
   lines.push("");
   lines.push("## Summary");
   lines.push("");
   lines.push(input.summary.trim() || "_No summary yet._");
   lines.push("");
-  lines.push("## Open threads");
+  lines.push("## Open questions");
   lines.push("");
   if (input.openThreads.length === 0) lines.push("_None._");
   else for (const t of input.openThreads) lines.push(`- ${t}`);

package/src/client.ts

@@ -13,7 +13,9 @@ import {
   type RoomBackfillPayload,
   type RoomClientMessage,
   RoomClientMessageType,
+  type RoomClientPlatform,
   type RoomDmHistoryResultPayload,
+  type RoomDmInboxUpdatedPayload,
   type RoomDmMessagePayload,
   type RoomDmOpenedPayload,
   type RoomFriendPresence,
@@ -292,6 +294,11 @@ export interface RoomDmSendRequest {
   imageUrl?: string;
 }
 
+export interface RoomDmReadRequest {
+  username?: string;
+  conversationId?: string;
+}
+
 export interface RoomThreadRequest {
   room: string;
   rootSeq: number;
@@ -922,6 +929,30 @@ export async function requestRoomDmHistoryOnClient(
   return history.payload;
 }
 
+export async function markRoomDmReadOnClient(
+  client: RoomWsClient,
+  request: RoomDmReadRequest,
+  timeoutMs?: number,
+): Promise<RoomDmInboxUpdatedPayload> {
+  const requestId = randomUUID();
+  client.send({
+    type: RoomClientMessageType.DM_READ,
+    payload: {
+      requestId,
+      ...(request.username ? { username: request.username } : {}),
+      ...(request.conversationId ? { conversationId: request.conversationId } : {}),
+    },
+    timestamp: Date.now(),
+  });
+  const updated = await client.waitFor(
+    RoomServerMessageType.DM_INBOX_UPDATED,
+    (msg) => msg.payload.requestId === requestId,
+    timeoutMs,
+    requestId,
+  );
+  return updated.payload;
+}
+
 export async function sendRoomDmOnClient(
   client: RoomWsClient,
   request: RoomDmSendRequest,
@@ -1147,6 +1178,15 @@ export function attachRejoinOnReconnect(
   });
 }
 
+/**
+ * Post into a joined room and return the frame's clientMsgId (what MESSAGE
+ * echoes carry back for optimistic-send reconciliation). `clientMsgId` is
+ * caller-suppliable so an offline send queue can retry one logical message
+ * under one stable id (same contract as sayRoom / sendRoomDmOnClient);
+ * omitted, it mints a UUID exactly as before. The relay validates the id
+ * (1..128 chars after trim); dedupe on (userId, clientMsgId) is server-side
+ * work and NOT implied here.
+ */
 export function postRoomMessage(
   client: RoomWsClient,
   room: string,
@@ -1154,21 +1194,22 @@ export function postRoomMessage(
   inReplyTo?: number,
   attachments?: RoomAttachmentInput[],
   topicId?: string,
+  clientMsgId?: string,
 ): string {
-  const clientMsgId = randomUUID();
+  const msgId = clientMsgId ?? randomUUID();
   client.send({
     type: RoomClientMessageType.POST,
     payload: {
       room,
       ...(text ? { text } : {}),
       ...(attachments?.length ? { attachments: toRoomAttachmentPayloads(attachments) } : {}),
-      clientMsgId,
+      clientMsgId: msgId,
       ...(inReplyTo !== undefined ? { inReplyTo } : {}),
       ...(topicId ? { topicId } : {}),
     },
     timestamp: Date.now(),
   });
-  return clientMsgId;
+  return msgId;
 }
 
 export function sendRoomTyping(client: RoomWsClient, room: string, state: "start" | "stop"): void {
@@ -1184,10 +1225,17 @@ export function sendRoomStatus(
   client: RoomWsClient,
   status: RoomUserStatus,
   statusText?: string | null,
+  platform?: RoomClientPlatform,
 ): void {
   client.send({
     type: RoomClientMessageType.STATUS,
-    payload: { status, ...(statusText !== undefined ? { statusText } : {}) },
+    payload: {
+      status,
+      ...(statusText !== undefined ? { statusText } : {}),
+      // Session identity, declared once per connection (or on change): the
+      // relay carries it onto presence member entries.
+      ...(platform ? { platform } : {}),
+    },
     timestamp: Date.now(),
   });
 }
@@ -1393,11 +1441,12 @@ export async function setRoomStatusOnce(
   config: RoomClientConfig,
   status: RoomUserStatus,
   statusText?: string | null,
+  platform?: RoomClientPlatform,
 ): Promise<void> {
   const client = new RoomWsClient(config);
   try {
     await client.connect();
-    sendRoomStatus(client, status, statusText);
+    sendRoomStatus(client, status, statusText, platform);
     // STATUS has no ack frame: give the socket a beat to flush before close.
     await new Promise((resolve) => setTimeout(resolve, 200));
   } finally {
@@ -1405,6 +1454,33 @@ export async function setRoomStatusOnce(
   }
 }
 
+/**
+ * Set the caller's room-level attention (notification posture) on a live
+ * client. The relay validates room participation, persists through the
+ * store, and acks with a READ_STATE frame scoped to this room whose
+ * attention map carries the persisted value (readState stays empty: cursors
+ * are untouched). Private per-user state; nothing broadcasts.
+ */
+export async function setRoomAttentionOnClient(
+  client: RoomWsClient,
+  request: { room: string; attention: RoomTopicAttention },
+): Promise<RoomReadStatePayload> {
+  const requestId = randomUUID();
+  const room = normalizeRoomName(request.room);
+  client.send({
+    type: RoomClientMessageType.ROOM_SET_ATTENTION,
+    payload: { requestId, room, attention: request.attention },
+    timestamp: Date.now(),
+  });
+  const result = await client.waitFor(
+    RoomServerMessageType.READ_STATE,
+    (msg) => msg.payload.requestId === requestId,
+    undefined,
+    requestId,
+  );
+  return result.payload;
+}
+
 /** One-shot session helper for the config-based mutation verbs below (the
  *  agent tools' transport: connect, join, act, wait for the echo, close). */
 async function withRoomEcho(

package/src/shared/rooms-protocol.ts

@@ -48,6 +48,7 @@ export const RoomClientMessageType = {
   TOPIC_RESOLVE: "TOPIC_RESOLVE",
   TOPIC_SET_ATTENTION: "TOPIC_SET_ATTENTION",
   TOPIC_LIST: "TOPIC_LIST",
+  ROOM_SET_ATTENTION: "ROOM_SET_ATTENTION",
 } as const;
 
 export type RoomClientMessageType =
@@ -152,6 +153,9 @@ export type RoomRole = "owner" | "admin" | "mod" | "member";
  *  semantics of an absent value). */
 export type RoomTopicsPolicy = "off" | "allowed" | "required";
 export type RoomTopicAttention = "follow" | "default" | "mute";
+/** Self-declared client class on STATUS frames; presence member entries
+ *  carry it through so rosters can render where someone is connected from. */
+export type RoomClientPlatform = "web" | "desktop" | "mobile" | "tui";
 
 export interface RoomMember {
   userId: string;
@@ -166,6 +170,8 @@ export interface RoomMember {
   joinedAt: number;
   avatarUrl?: string | null;
   statusText?: string | null;
+  /** Present when the member's session declared one via STATUS. */
+  platform?: RoomClientPlatform | undefined;
 }
 
 export interface RoomMeta {
@@ -191,6 +197,10 @@ export interface RoomMeta {
    *  2026-07-12 dial-default flip (post-flip relays always advertise the
    *  stored value, "off" included); explicit "off" means topics are inert. */
   topicsPolicy?: RoomTopicsPolicy | undefined;
+  /** The viewer's room attention (notification posture), a per-viewer field
+   *  like viewerRole: surfaced on rooms listings for the caller. Absent
+   *  reads as "default". */
+  attention?: RoomTopicAttention | undefined;
   tags?: string[] | undefined;
   entities?: string[] | undefined;
   sourceRefs?: Array<Record<string, unknown>> | undefined;
@@ -331,7 +341,12 @@ export interface RoomPinsPayload {
 }
 
 export interface RoomReadStatePayload {
+  /** Partial map: rooms absent from a reply are unchanged. */
   readState: Record<string, number>;
+  /** Per-room attention for the requesting user, keyed like readState.
+   *  Present when the store surfaces it and on ROOM_SET_ATTENTION acks
+   *  (which reply READ_STATE scoped to the one room, readState empty). */
+  attention?: Record<string, RoomTopicAttention> | undefined;
   requestId?: string | undefined;
 }
 
@@ -659,6 +674,7 @@ export interface RoomDmMessagePayload {
 }
 
 export interface RoomDmInboxUpdatedPayload {
+  requestId?: string;
   conversationId: string;
   participant: RoomDmParticipant;
   unreadCount: number;
@@ -862,6 +878,16 @@ export interface RoomTopicSetAttentionPayload {
   attention: RoomTopicAttention;
 }
 
+/** Room-level attention (notification posture). Private per-user state on
+ *  the caller's read row; topic attention wins for topic-scoped messages
+ *  and room attention wins over space attention. The relay acks with a
+ *  READ_STATE frame scoped to the room (see RoomReadStatePayload). */
+export interface RoomSetAttentionPayload {
+  requestId?: string;
+  room: string;
+  attention: RoomTopicAttention;
+}
+
 export interface RoomTopicListPayload {
   requestId?: string;
   room: string;
@@ -1129,7 +1155,11 @@ export type RoomClientMessage =
     }
   | {
       type: typeof RoomClientMessageType.STATUS;
-      payload: { status: RoomUserStatus; statusText?: string | null };
+      payload: {
+        status: RoomUserStatus;
+        statusText?: string | null;
+        platform?: RoomClientPlatform;
+      };
       timestamp?: number;
     }
   | {
@@ -1213,6 +1243,11 @@ export type RoomClientMessage =
       type: typeof RoomClientMessageType.TOPIC_LIST;
       payload: RoomTopicListPayload;
       timestamp?: number;
+    }
+  | {
+      type: typeof RoomClientMessageType.ROOM_SET_ATTENTION;
+      payload: RoomSetAttentionPayload;
+      timestamp?: number;
     };
 
 export type RoomServerMessage =

package/src/social-client.ts

@@ -657,7 +657,8 @@ export async function listRoomSpacesViaChat(config: RoomSocialConfig): Promise<R
 
 export interface RoomSpaceMember {
   userId: string;
-  role: "owner" | "admin" | "member";
+  /** The ladder role. 'librarian' maintains the generated briefs/ docs. */
+  role: "owner" | "admin" | "librarian" | "member";
   /** Named identity roles (RoomSpaceRole.roleId). */
   roleIds?: string[];
   joinedAt?: string;
@@ -1047,7 +1048,7 @@ export async function changeSpaceMemberRole(
   config: RoomSocialConfig,
   spaceId: string,
   targetUserId: string,
-  role: "admin" | "member",
+  role: "admin" | "librarian" | "member",
 ): Promise<RoomSpaceMember> {
   const result = await socialRequest<{ member: RoomSpaceMember }>(
     config,

package/src/social-types.ts

@@ -144,6 +144,9 @@ export interface RoomDmMessage {
   imageUrl?: string | null;
   /** Aggregated reactions (per-emoji userId lists). Additive. */
   reactions?: Array<{ emoji: string; users: string[] }>;
+  /** Client-minted idempotency tag echoed back on DM sends, so a sender's
+   *  durable queue can settle its optimistic row. Additive (0.4.0). */
+  clientMsgId?: string;
 }
 
 export interface RoomDmHistory {

package/src/types.ts

@@ -8,6 +8,7 @@ export type {
   RoomAuthSuccessPayload,
   RoomBackfillPayload,
   RoomClientMessage,
+  RoomClientPlatform,
   RoomCreatedPayload,
   RoomCreatePayload,
   RoomDmHistoryPayload,
@@ -50,6 +51,7 @@ export type {
   RoomSearchScope,
   RoomServerMessage,
   RoomServerMessageOf,
+  RoomSetAttentionPayload,
   RoomSetReadOnlyPayload,
   RoomSpace,
   RoomSpaceJoinedPayload,

package/src/version.ts

@@ -1,2 +1,2 @@
-export const VERSION = "0.5.1";
-export const RUNNER_VERSION = "0.5.1";
+export const VERSION = "0.6.0";
+export const RUNNER_VERSION = "0.6.0";