@openmarket/rooms-client 0.4.1 → 0.5.0

package/dist/agent/sidebar-model.d.ts

@@ -74,6 +74,9 @@ export declare class SidebarModel {
     constructor(deps: SidebarModelDeps);
     snapshot(): SidebarSnapshot;
     onUpdate(listener: () => void): () => void;
+    /** Apply a same-user realtime DM counter without refetching the full room
+     *  directory. Username is the stable DM key used by the sidebar model. */
+    applyDmUnread(username: string, unread: number): void;
     /**
      * Post-mutation refresh: if a poll-triggered load is already in flight it
      * may predate the caller's writes, so wait it out and load AGAIN. Readers

package/dist/agent/sidebar-model.js

@@ -112,6 +112,34 @@ export class SidebarModel {
             this.listeners.delete(listener);
         };
     }
+    /** Apply a same-user realtime DM counter without refetching the full room
+     *  directory. Username is the stable DM key used by the sidebar model. */
+    applyDmUnread(username, unread) {
+        const key = normalizeDmUsername(username);
+        if (!key)
+            return;
+        const normalizedUnread = Number.isFinite(unread) ? Math.max(0, Math.floor(unread)) : 0;
+        let found = false;
+        let changed = false;
+        const next = this.snapshotValue.dms.map((dm) => {
+            if (normalizeDmUsername(dm.username) !== key)
+                return dm;
+            found = true;
+            if (dm.unread === normalizedUnread)
+                return dm;
+            changed = true;
+            return { ...dm, unread: normalizedUnread };
+        });
+        if (!found && normalizedUnread > 0) {
+            next.push({ username: username.replace(/^@+/, ""), unread: normalizedUnread });
+            changed = true;
+        }
+        if (!changed)
+            return;
+        this.snapshotValue = { ...this.snapshotValue, dms: next };
+        for (const listener of this.listeners)
+            listener();
+    }
     /**
      * Post-mutation refresh: if a poll-triggered load is already in flight it
      * may predate the caller's writes, so wait it out and load AGAIN. Readers
@@ -160,3 +188,6 @@ export class SidebarModel {
         });
     }
 }
+function normalizeDmUsername(username) {
+    return username.trim().replace(/^@+/, "").toLowerCase();
+}

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-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 RoomAccessMode, type RoomAttachmentInput, type RoomAuditLogPayload, type RoomAuthSuccessPayload, type RoomBackfillPayload, type RoomClientPlatform, type RoomDmHistoryResultPayload, type RoomDmInboxUpdatedPayload, type RoomDmMessageDeletedPayload, type RoomDmMessageEditedPayload, type RoomDmMessagePayload, type RoomDmOpenedPayload, type RoomDmPinsResultPayload, type RoomDmReactionUpdatedPayload, type RoomForwardMetadata, 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;
@@ -212,6 +212,10 @@ export interface RoomDmSendRequest {
      *  URL. Stored on the message's imageUrl; the client signs keys on render.
      *  Additive — omitted for text-only sends. */
     imageUrl?: string;
+    metadata?: RoomForwardMetadata;
+}
+export interface RoomDmReplyRequest extends RoomDmSendRequest {
+    replyTo: string;
 }
 export interface RoomDmReadRequest {
     username?: string;
@@ -238,6 +242,9 @@ export { workspaceRoomName } from "./names.js";
 export declare function listRooms(config: RoomClientConfig, request?: RoomListRequest): Promise<RoomListResult>;
 export declare function createRoom(config: RoomClientConfig, request: RoomCreateRequest): Promise<RoomCreateResult>;
 export declare function inviteRoom(config: RoomClientConfig, request: RoomInviteRequest): Promise<RoomInviteResult>;
+/** Invite over an already-authenticated socket. Long-lived GUI/TUI sessions
+ * use this path so a one-shot invite cannot create a second connection. */
+export declare function inviteRoomOnClient(client: RoomWsClient, request: RoomInviteRequest, timeoutMs?: number): Promise<RoomInvitedPayload>;
 export declare function removeRoomMember(config: RoomClientConfig, request: RoomRemoveMemberRequest): Promise<RoomRemoveMemberResult>;
 export declare function reportRoomTarget(config: RoomClientConfig, request: RoomReportRequest): Promise<RoomReportResult>;
 export declare function muteRoomMember(config: RoomClientConfig, request: RoomMuteRequest): Promise<RoomMuteResult>;
@@ -260,20 +267,20 @@ export declare function openRoomDmOnClient(client: RoomWsClient, request: RoomDm
 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. */
+export declare function replyRoomDmOnClient(client: RoomWsClient, request: RoomDmReplyRequest, timeoutMs?: number): Promise<RoomDmMessagePayload>;
+/** Edit one of my DM messages and wait for the correlated relay update. */
 export declare function editRoomDmOnClient(client: RoomWsClient, request: {
     conversationId?: string;
     username?: string;
     messageId: string;
     content: string;
-}): void;
+}, timeoutMs?: number): Promise<RoomDmMessageEditedPayload>;
 /** Soft-delete one of my DM messages. The relay fans out DM_MESSAGE_DELETED. */
 export declare function deleteRoomDmOnClient(client: RoomWsClient, request: {
     conversationId?: string;
     username?: string;
     messageId: string;
-}): void;
+}, timeoutMs?: number): Promise<RoomDmMessageDeletedPayload>;
 /** Toggle a reaction on a DM message. The relay fans out DM_REACTION_UPDATED. */
 export declare function reactRoomDmOnClient(client: RoomWsClient, request: {
     conversationId?: string;
@@ -281,7 +288,23 @@ export declare function reactRoomDmOnClient(client: RoomWsClient, request: {
     messageId: string;
     emoji: string;
     op: "add" | "remove";
+}, timeoutMs?: number): Promise<RoomDmReactionUpdatedPayload>;
+/** Set shared pin state for a DM message. The relay fans out DM_PIN_UPDATED. */
+export declare function pinRoomDmOnClient(client: RoomWsClient, request: {
+    conversationId?: string;
+    username?: string;
+    messageId: string;
 }): void;
+export declare function unpinRoomDmOnClient(client: RoomWsClient, request: {
+    conversationId?: string;
+    username?: string;
+    messageId: string;
+}): void;
+export declare function requestRoomDmPinsOnClient(client: RoomWsClient, request: {
+    conversationId?: string;
+    username?: string;
+    limit?: number;
+}, timeoutMs?: number): Promise<RoomDmPinsResultPayload>;
 export declare function peekRoom(config: RoomClientConfig, options: RoomPeekOptions): Promise<RoomBackfillPayload>;
 export declare function sayRoom(config: RoomClientConfig, options: RoomSayOptions): Promise<RoomSayResult>;
 export declare function joinRoom(config: RoomClientConfig, options: RoomJoinOptions): Promise<RoomJoinedSession>;
@@ -297,7 +320,7 @@ export declare function attachRejoinOnReconnect(client: RoomWsClient, options: R
  * (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 postRoomMessage(client: RoomWsClient, room: string, text: string, inReplyTo?: number, attachments?: RoomAttachmentInput[], topicId?: string, clientMsgId?: string, metadata?: RoomForwardMetadata): string;
 export declare function sendRoomTyping(client: RoomWsClient, room: string, state: "start" | "stop"): void;
 export declare function sendRoomStatus(client: RoomWsClient, status: RoomUserStatus, statusText?: string | null, platform?: RoomClientPlatform): void;
 /**

package/dist/client.js

@@ -101,9 +101,7 @@ async function createRoomViaWebSocket(config, request) {
 export async function inviteRoom(config, request) {
     // `@user` and `user` are the same person: strip the typing syntax once,
     // before either transport (the relay resolves the bare name).
-    const normalized = request.username
-        ? { ...request, username: request.username.trim().replace(/^@+/, "") }
-        : request;
+    const normalized = normalizeRoomInviteRequest(request);
     if (!config.webSocketCtor) {
         try {
             return await inviteRoomViaHttp(config, normalized);
@@ -119,24 +117,35 @@ async function inviteRoomViaWebSocket(config, request) {
     const client = new RoomWsClient(config);
     try {
         const auth = await client.connect();
-        const requestId = randomUUID();
-        client.send({
-            type: RoomClientMessageType.INVITE,
-            payload: {
-                requestId,
-                room: request.room,
-                ...(request.username ? { username: request.username } : {}),
-                ...(request.userId ? { userId: request.userId } : {}),
-            },
-            timestamp: Date.now(),
-        });
-        const invited = await client.waitFor(RoomServerMessageType.ROOM_INVITED, (msg) => msg.payload.requestId === requestId, undefined, requestId);
-        return { auth, invite: invited.payload };
+        return { auth, invite: await inviteRoomOnClient(client, request) };
     }
     finally {
         client.close();
     }
 }
+/** Invite over an already-authenticated socket. Long-lived GUI/TUI sessions
+ * use this path so a one-shot invite cannot create a second connection. */
+export async function inviteRoomOnClient(client, request, timeoutMs) {
+    const normalized = normalizeRoomInviteRequest(request);
+    const requestId = randomUUID();
+    client.send({
+        type: RoomClientMessageType.INVITE,
+        payload: {
+            requestId,
+            room: normalized.room,
+            ...(normalized.username ? { username: normalized.username } : {}),
+            ...(normalized.userId ? { userId: normalized.userId } : {}),
+        },
+        timestamp: Date.now(),
+    });
+    const invited = await client.waitFor(RoomServerMessageType.ROOM_INVITED, (msg) => msg.payload.requestId === requestId, timeoutMs, requestId);
+    return invited.payload;
+}
+function normalizeRoomInviteRequest(request) {
+    return request.username
+        ? { ...request, username: request.username.trim().replace(/^@+/, "") }
+        : request;
+}
 export async function removeRoomMember(config, request) {
     if (!config.webSocketCtor) {
         try {
@@ -480,6 +489,7 @@ export async function sendRoomDmOnClient(client, request, timeoutMs) {
             ...(request.username ? { username: request.username } : {}),
             ...(request.conversationId ? { conversationId: request.conversationId } : {}),
             ...(request.imageUrl ? { imageUrl: request.imageUrl } : {}),
+            ...(request.metadata ? { metadata: request.metadata } : {}),
         },
         timestamp: Date.now(),
     });
@@ -488,12 +498,35 @@ export async function sendRoomDmOnClient(client, request, timeoutMs) {
         msg.payload.message.clientMsgId === clientMsgId, timeoutMs, requestId);
     return sent.payload;
 }
-/** Edit one of my DM messages. Fire-and-forget over the WS; the relay fans out
- *  DM_MESSAGE_EDITED to both participants. */
-export function editRoomDmOnClient(client, request) {
+export async function replyRoomDmOnClient(client, request, timeoutMs) {
+    const requestId = randomUUID();
+    const clientMsgId = request.clientMsgId ?? randomUUID();
+    client.send({
+        type: RoomClientMessageType.DM_REPLY,
+        payload: {
+            requestId,
+            content: request.content,
+            replyTo: request.replyTo,
+            clientMsgId,
+            ...(request.username ? { username: request.username } : {}),
+            ...(request.conversationId ? { conversationId: request.conversationId } : {}),
+            ...(request.imageUrl ? { imageUrl: request.imageUrl } : {}),
+            ...(request.metadata ? { metadata: request.metadata } : {}),
+        },
+        timestamp: Date.now(),
+    });
+    const sent = await client.waitFor(RoomServerMessageType.DM_MESSAGE, (msg) => msg.payload.requestId === requestId ||
+        msg.payload.clientMsgId === clientMsgId ||
+        msg.payload.message.clientMsgId === clientMsgId, timeoutMs, requestId);
+    return sent.payload;
+}
+/** Edit one of my DM messages and wait for the correlated relay update. */
+export async function editRoomDmOnClient(client, request, timeoutMs) {
+    const requestId = randomUUID();
     client.send({
         type: RoomClientMessageType.DM_EDIT,
         payload: {
+            requestId,
             messageId: request.messageId,
             content: request.content,
             ...(request.conversationId ? { conversationId: request.conversationId } : {}),
@@ -501,24 +534,32 @@ export function editRoomDmOnClient(client, request) {
         },
         timestamp: Date.now(),
     });
+    const updated = await client.waitFor(RoomServerMessageType.DM_MESSAGE_EDITED, (msg) => msg.payload.requestId === requestId, timeoutMs, requestId);
+    return updated.payload;
 }
 /** Soft-delete one of my DM messages. The relay fans out DM_MESSAGE_DELETED. */
-export function deleteRoomDmOnClient(client, request) {
+export async function deleteRoomDmOnClient(client, request, timeoutMs) {
+    const requestId = randomUUID();
     client.send({
         type: RoomClientMessageType.DM_DELETE,
         payload: {
+            requestId,
             messageId: request.messageId,
             ...(request.conversationId ? { conversationId: request.conversationId } : {}),
             ...(request.username ? { username: request.username } : {}),
         },
         timestamp: Date.now(),
     });
+    const updated = await client.waitFor(RoomServerMessageType.DM_MESSAGE_DELETED, (msg) => msg.payload.requestId === requestId, timeoutMs, requestId);
+    return updated.payload;
 }
 /** Toggle a reaction on a DM message. The relay fans out DM_REACTION_UPDATED. */
-export function reactRoomDmOnClient(client, request) {
+export async function reactRoomDmOnClient(client, request, timeoutMs) {
+    const requestId = randomUUID();
     client.send({
         type: RoomClientMessageType.DM_REACT,
         payload: {
+            requestId,
             messageId: request.messageId,
             emoji: request.emoji,
             op: request.op,
@@ -527,6 +568,46 @@ export function reactRoomDmOnClient(client, request) {
         },
         timestamp: Date.now(),
     });
+    const updated = await client.waitFor(RoomServerMessageType.DM_REACTION_UPDATED, (msg) => msg.payload.requestId === requestId, timeoutMs, requestId);
+    return updated.payload;
+}
+/** Set shared pin state for a DM message. The relay fans out DM_PIN_UPDATED. */
+export function pinRoomDmOnClient(client, request) {
+    client.send({
+        type: RoomClientMessageType.DM_PIN,
+        payload: {
+            messageId: request.messageId,
+            ...(request.conversationId ? { conversationId: request.conversationId } : {}),
+            ...(request.username ? { username: request.username } : {}),
+        },
+        timestamp: Date.now(),
+    });
+}
+export function unpinRoomDmOnClient(client, request) {
+    client.send({
+        type: RoomClientMessageType.DM_UNPIN,
+        payload: {
+            messageId: request.messageId,
+            ...(request.conversationId ? { conversationId: request.conversationId } : {}),
+            ...(request.username ? { username: request.username } : {}),
+        },
+        timestamp: Date.now(),
+    });
+}
+export async function requestRoomDmPinsOnClient(client, request, timeoutMs) {
+    const requestId = randomUUID();
+    client.send({
+        type: RoomClientMessageType.DM_PINS,
+        payload: {
+            requestId,
+            ...(request.conversationId ? { conversationId: request.conversationId } : {}),
+            ...(request.username ? { username: request.username } : {}),
+            ...(request.limit ? { limit: request.limit } : {}),
+        },
+        timestamp: Date.now(),
+    });
+    const result = await client.waitFor(RoomServerMessageType.DM_PINS, (message) => message.payload.requestId === requestId, timeoutMs, requestId);
+    return result.payload;
 }
 export async function peekRoom(config, options) {
     if (!config.webSocketCtor) {
@@ -641,7 +722,7 @@ export function attachRejoinOnReconnect(client, options, latestSeq, onRejoined,
  * (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) {
+export function postRoomMessage(client, room, text, inReplyTo, attachments, topicId, clientMsgId, metadata) {
     const msgId = clientMsgId ?? randomUUID();
     client.send({
         type: RoomClientMessageType.POST,
@@ -652,6 +733,7 @@ export function postRoomMessage(client, room, text, inReplyTo, attachments, topi
             clientMsgId: msgId,
             ...(inReplyTo !== undefined ? { inReplyTo } : {}),
             ...(topicId ? { topicId } : {}),
+            ...(metadata ? { metadata } : {}),
         },
         timestamp: Date.now(),
     });

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

@@ -37,10 +37,14 @@ export declare const RoomClientMessageType: {
     readonly DM_OPEN: "DM_OPEN";
     readonly DM_HISTORY: "DM_HISTORY";
     readonly DM_SEND: "DM_SEND";
+    readonly DM_REPLY: "DM_REPLY";
     readonly DM_READ: "DM_READ";
     readonly DM_EDIT: "DM_EDIT";
     readonly DM_DELETE: "DM_DELETE";
     readonly DM_REACT: "DM_REACT";
+    readonly DM_PIN: "DM_PIN";
+    readonly DM_UNPIN: "DM_UNPIN";
+    readonly DM_PINS: "DM_PINS";
     readonly TOPIC_CREATE: "TOPIC_CREATE";
     readonly TOPIC_RENAME: "TOPIC_RENAME";
     readonly TOPIC_MOVE: "TOPIC_MOVE";
@@ -94,6 +98,8 @@ export declare const RoomServerMessageType: {
     readonly DM_MESSAGE_EDITED: "DM_MESSAGE_EDITED";
     readonly DM_MESSAGE_DELETED: "DM_MESSAGE_DELETED";
     readonly DM_REACTION_UPDATED: "DM_REACTION_UPDATED";
+    readonly DM_PIN_UPDATED: "DM_PIN_UPDATED";
+    readonly DM_PINS: "DM_PINS";
     readonly TOPIC: "TOPIC";
     readonly TOPICS: "TOPICS";
     readonly TOPIC_UPDATED: "TOPIC_UPDATED";
@@ -225,6 +231,19 @@ export interface RoomLedgerEntry {
     pinnedAt?: string | number | Date | null | undefined;
     attachments?: RoomAttachment[] | undefined;
     roomRole?: RoomRole | null | undefined;
+    metadata?: (Record<string, unknown> & Partial<RoomForwardMetadata>) | undefined;
+}
+export type RoomForwardedFrom = {
+    kind: "room";
+    room: string;
+    seq: number;
+    handle: string;
+} | {
+    kind: "dm";
+    handle: string;
+};
+export interface RoomForwardMetadata {
+    forwardedFrom: RoomForwardedFrom;
 }
 export interface RoomAttachment {
     /**
@@ -472,12 +491,14 @@ export interface RoomDmMessage {
     createdAt?: string | number | undefined;
     /** Sealed DM: content is '' and the opaque envelope rides here. */
     secret?: RoomLedgerSecretPayload | null | undefined;
-    metadata?: Record<string, unknown> | undefined;
+    metadata?: (Record<string, unknown> & Partial<RoomForwardMetadata>) | undefined;
     /** Legacy public chat-image URL (renders as-is, no signing). */
     imageUrl?: string | null | undefined;
     /** Private, signed, scanned DM attachments (dm-attachments/ keyspace).
      *  Additive: old messages carry none and render unchanged. */
     attachments?: RoomAttachment[] | undefined;
+    /** Shared pin state. Legacy messages omit it and read as unpinned. */
+    pinned?: boolean | undefined;
 }
 export interface RoomDmOpenPayload {
     requestId?: string;
@@ -502,6 +523,11 @@ export interface RoomDmSendPayload {
     /** DM-attachment key or legacy public image URL; stored on the message's
      *  imageUrl. Additive — text-only sends omit it. */
     imageUrl?: string;
+    metadata?: RoomForwardMetadata | undefined;
+}
+/** Client → server: send a DM whose parent is another message in the same conversation. */
+export interface RoomDmReplyPayload extends RoomDmSendPayload {
+    replyTo: string;
 }
 /** Client → server: edit one of my DM messages (sealed messages are rejected). */
 export interface RoomDmEditPayload {
@@ -520,6 +546,7 @@ export interface RoomDmDeletePayload {
 }
 /** Server → both participants: a DM message was edited. */
 export interface RoomDmMessageEditedPayload {
+    requestId?: string;
     conversationId: string;
     messageId: string;
     content: string;
@@ -528,6 +555,7 @@ export interface RoomDmMessageEditedPayload {
 }
 /** Server → both participants: a DM message was soft-deleted (tombstone). */
 export interface RoomDmMessageDeletedPayload {
+    requestId?: string;
     conversationId: string;
     messageId: string;
     deletedAt: string | number;
@@ -544,6 +572,7 @@ export interface RoomDmReactPayload {
 }
 /** Server → both participants: a DM message's aggregated reactions changed. */
 export interface RoomDmReactionUpdatedPayload {
+    requestId?: string;
     conversationId: string;
     messageId: string;
     reactions: Array<{
@@ -552,6 +581,31 @@ export interface RoomDmReactionUpdatedPayload {
     }>;
     participant: RoomDmParticipant;
 }
+export interface RoomDmPinPayload {
+    requestId?: string;
+    conversationId?: string;
+    username?: string;
+    messageId: string;
+}
+export interface RoomDmPinsPayload {
+    requestId?: string;
+    conversationId?: string;
+    username?: string;
+    limit?: number;
+}
+export interface RoomDmPinUpdatedPayload {
+    requestId?: string;
+    conversationId: string;
+    participant: RoomDmParticipant;
+    messageId: string;
+    pinned: boolean;
+}
+export interface RoomDmPinsResultPayload {
+    requestId?: string;
+    conversationId: string;
+    participant: RoomDmParticipant;
+    pins: RoomDmMessage[];
+}
 export interface RoomDmReadPayload {
     requestId?: string;
     username?: string;
@@ -889,6 +943,7 @@ export type RoomClientMessage = {
         clientMsgId?: string;
         reason?: string;
         requestId?: string;
+        metadata?: RoomForwardMetadata;
     };
     timestamp?: number;
 } | {
@@ -1074,6 +1129,10 @@ export type RoomClientMessage = {
     type: typeof RoomClientMessageType.DM_SEND;
     payload: RoomDmSendPayload;
     timestamp?: number;
+} | {
+    type: typeof RoomClientMessageType.DM_REPLY;
+    payload: RoomDmReplyPayload;
+    timestamp?: number;
 } | {
     type: typeof RoomClientMessageType.DM_READ;
     payload: RoomDmReadPayload;
@@ -1090,6 +1149,18 @@ export type RoomClientMessage = {
     type: typeof RoomClientMessageType.DM_REACT;
     payload: RoomDmReactPayload;
     timestamp?: number;
+} | {
+    type: typeof RoomClientMessageType.DM_PIN;
+    payload: RoomDmPinPayload;
+    timestamp?: number;
+} | {
+    type: typeof RoomClientMessageType.DM_UNPIN;
+    payload: RoomDmPinPayload;
+    timestamp?: number;
+} | {
+    type: typeof RoomClientMessageType.DM_PINS;
+    payload: RoomDmPinsPayload;
+    timestamp?: number;
 } | {
     type: typeof RoomClientMessageType.TOPIC_CREATE;
     payload: RoomTopicCreatePayload;
@@ -1296,6 +1367,14 @@ export type RoomServerMessage = {
     type: typeof RoomServerMessageType.DM_REACTION_UPDATED;
     payload: RoomDmReactionUpdatedPayload;
     timestamp: number;
+} | {
+    type: typeof RoomServerMessageType.DM_PIN_UPDATED;
+    payload: RoomDmPinUpdatedPayload;
+    timestamp: number;
+} | {
+    type: typeof RoomServerMessageType.DM_PINS;
+    payload: RoomDmPinsResultPayload;
+    timestamp: number;
 } | {
     type: typeof RoomServerMessageType.TOPIC;
     payload: RoomTopicResultPayload;

package/dist/shared/rooms-protocol.js

@@ -37,10 +37,14 @@ export const RoomClientMessageType = {
     DM_OPEN: "DM_OPEN",
     DM_HISTORY: "DM_HISTORY",
     DM_SEND: "DM_SEND",
+    DM_REPLY: "DM_REPLY",
     DM_READ: "DM_READ",
     DM_EDIT: "DM_EDIT",
     DM_DELETE: "DM_DELETE",
     DM_REACT: "DM_REACT",
+    DM_PIN: "DM_PIN",
+    DM_UNPIN: "DM_UNPIN",
+    DM_PINS: "DM_PINS",
     TOPIC_CREATE: "TOPIC_CREATE",
     TOPIC_RENAME: "TOPIC_RENAME",
     TOPIC_MOVE: "TOPIC_MOVE",
@@ -93,6 +97,8 @@ export const RoomServerMessageType = {
     DM_MESSAGE_EDITED: "DM_MESSAGE_EDITED",
     DM_MESSAGE_DELETED: "DM_MESSAGE_DELETED",
     DM_REACTION_UPDATED: "DM_REACTION_UPDATED",
+    DM_PIN_UPDATED: "DM_PIN_UPDATED",
+    DM_PINS: "DM_PINS",
     TOPIC: "TOPIC",
     TOPICS: "TOPICS",
     TOPIC_UPDATED: "TOPIC_UPDATED",

package/dist/social-client.d.ts

@@ -330,6 +330,12 @@ export declare function listRoomChannelMembers(config: RoomSocialConfig, roomId:
 export declare function removeSpaceMember(config: RoomSocialConfig, spaceId: string, targetUserId: string): Promise<{
     removed?: boolean;
 }>;
+/** Leave a server as the authenticated caller. This is deliberately separate
+ * from the manager-only member-removal route so clients never send their own
+ * userId as authorization data. */
+export declare function leaveSpace(config: RoomSocialConfig, spaceId: string): Promise<{
+    left?: boolean;
+}>;
 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>;

package/dist/social-client.js

@@ -500,6 +500,14 @@ export async function listRoomChannelMembers(config, roomId, options = {}) {
 export async function removeSpaceMember(config, spaceId, targetUserId) {
     return socialRequest(config, `/spaces/${encodeURIComponent(spaceId)}/members/${encodeURIComponent(targetUserId)}`, { method: "DELETE" });
 }
+/** Leave a server as the authenticated caller. This is deliberately separate
+ * from the manager-only member-removal route so clients never send their own
+ * userId as authorization data. */
+export async function leaveSpace(config, spaceId) {
+    return socialRequest(config, `/spaces/${encodeURIComponent(spaceId)}/membership`, {
+        method: "DELETE",
+    });
+}
 export async function changeSpaceMemberRole(config, spaceId, targetUserId, role) {
     const result = await socialRequest(config, `/spaces/${encodeURIComponent(spaceId)}/members/${encodeURIComponent(targetUserId)}/role`, { method: "PATCH", body: { role } });
     return result.member;

package/dist/social-types.d.ts

@@ -130,6 +130,8 @@ export interface RoomDmMessage {
         emoji: string;
         users: string[];
     }>;
+    /** Shared pin state. Additive; absent means unpinned. */
+    pinned?: boolean;
     /** 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;

package/dist/types.d.ts

@@ -1,2 +1,2 @@
-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 type { RoomAccessMode, RoomAttachment, RoomAttachmentInput, RoomAuditEntry, RoomAuditLogPayload, RoomAuditLogRequestPayload, RoomAuthSuccessPayload, RoomBackfillPayload, RoomClientMessage, RoomClientPlatform, RoomCreatedPayload, RoomCreatePayload, RoomDmHistoryPayload, RoomDmHistoryResultPayload, RoomDmInboxUpdatedPayload, RoomDmMessage, RoomDmMessageDeletedPayload, RoomDmMessageEditedPayload, RoomDmMessagePayload, RoomDmOpenedPayload, RoomDmOpenPayload, RoomDmParticipant, RoomDmPinsResultPayload, RoomDmPinUpdatedPayload, RoomDmReactionUpdatedPayload, RoomDmReadPayload, RoomDmReplyPayload, RoomDmSendPayload, RoomEntryUpdatedPayload, RoomErrorPayload, RoomForwardedFrom, RoomForwardMetadata, 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.6.0";
-export declare const RUNNER_VERSION = "0.6.0";
+export declare const VERSION = "0.7.0";
+export declare const RUNNER_VERSION = "0.7.0";

package/dist/version.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openmarket/rooms-client",
-  "version": "0.4.1",
+  "version": "0.5.0",
   "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",
@@ -17,7 +17,12 @@
     "bun": ">=1.3.0",
     "node": ">=22"
   },
-  "files": ["src", "dist", "README.md", "LICENSE"],
+  "files": [
+    "src",
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
   "publishConfig": {
     "access": "public"
   },

package/src/agent/sidebar-model.ts

@@ -186,6 +186,30 @@ export class SidebarModel {
     };
   }
 
+  /** Apply a same-user realtime DM counter without refetching the full room
+   *  directory. Username is the stable DM key used by the sidebar model. */
+  applyDmUnread(username: string, unread: number): void {
+    const key = normalizeDmUsername(username);
+    if (!key) return;
+    const normalizedUnread = Number.isFinite(unread) ? Math.max(0, Math.floor(unread)) : 0;
+    let found = false;
+    let changed = false;
+    const next = this.snapshotValue.dms.map((dm) => {
+      if (normalizeDmUsername(dm.username) !== key) return dm;
+      found = true;
+      if (dm.unread === normalizedUnread) return dm;
+      changed = true;
+      return { ...dm, unread: normalizedUnread };
+    });
+    if (!found && normalizedUnread > 0) {
+      next.push({ username: username.replace(/^@+/, ""), unread: normalizedUnread });
+      changed = true;
+    }
+    if (!changed) return;
+    this.snapshotValue = { ...this.snapshotValue, dms: next };
+    for (const listener of this.listeners) listener();
+  }
+
   /**
    * Post-mutation refresh: if a poll-triggered load is already in flight it
    * may predate the caller's writes, so wait it out and load AGAIN. Readers
@@ -233,3 +257,7 @@ export class SidebarModel {
     });
   }
 }
+
+function normalizeDmUsername(username: string): string {
+  return username.trim().replace(/^@+/, "").toLowerCase();
+}

package/src/client.ts

@@ -16,8 +16,13 @@ import {
   type RoomClientPlatform,
   type RoomDmHistoryResultPayload,
   type RoomDmInboxUpdatedPayload,
+  type RoomDmMessageDeletedPayload,
+  type RoomDmMessageEditedPayload,
   type RoomDmMessagePayload,
   type RoomDmOpenedPayload,
+  type RoomDmPinsResultPayload,
+  type RoomDmReactionUpdatedPayload,
+  type RoomForwardMetadata,
   type RoomFriendPresence,
   type RoomInvitedPayload,
   type RoomLedgerEntry,
@@ -292,6 +297,11 @@ export interface RoomDmSendRequest {
    *  URL. Stored on the message's imageUrl; the client signs keys on render.
    *  Additive — omitted for text-only sends. */
   imageUrl?: string;
+  metadata?: RoomForwardMetadata;
+}
+
+export interface RoomDmReplyRequest extends RoomDmSendRequest {
+  replyTo: string;
 }
 
 export interface RoomDmReadRequest {
@@ -433,9 +443,7 @@ export async function inviteRoom(
 ): Promise<RoomInviteResult> {
   // `@user` and `user` are the same person: strip the typing syntax once,
   // before either transport (the relay resolves the bare name).
-  const normalized: RoomInviteRequest = request.username
-    ? { ...request, username: request.username.trim().replace(/^@+/, "") }
-    : request;
+  const normalized = normalizeRoomInviteRequest(request);
   if (!config.webSocketCtor) {
     try {
       return await inviteRoomViaHttp(config, normalized);
@@ -453,29 +461,46 @@ async function inviteRoomViaWebSocket(
   const client = new RoomWsClient(config);
   try {
     const auth = await client.connect();
-    const requestId = randomUUID();
-    client.send({
-      type: RoomClientMessageType.INVITE,
-      payload: {
-        requestId,
-        room: request.room,
-        ...(request.username ? { username: request.username } : {}),
-        ...(request.userId ? { userId: request.userId } : {}),
-      },
-      timestamp: Date.now(),
-    });
-    const invited = await client.waitFor(
-      RoomServerMessageType.ROOM_INVITED,
-      (msg) => msg.payload.requestId === requestId,
-      undefined,
-      requestId,
-    );
-    return { auth, invite: invited.payload };
+    return { auth, invite: await inviteRoomOnClient(client, request) };
   } finally {
     client.close();
   }
 }
 
+/** Invite over an already-authenticated socket. Long-lived GUI/TUI sessions
+ * use this path so a one-shot invite cannot create a second connection. */
+export async function inviteRoomOnClient(
+  client: RoomWsClient,
+  request: RoomInviteRequest,
+  timeoutMs?: number,
+): Promise<RoomInvitedPayload> {
+  const normalized = normalizeRoomInviteRequest(request);
+  const requestId = randomUUID();
+  client.send({
+    type: RoomClientMessageType.INVITE,
+    payload: {
+      requestId,
+      room: normalized.room,
+      ...(normalized.username ? { username: normalized.username } : {}),
+      ...(normalized.userId ? { userId: normalized.userId } : {}),
+    },
+    timestamp: Date.now(),
+  });
+  const invited = await client.waitFor(
+    RoomServerMessageType.ROOM_INVITED,
+    (msg) => msg.payload.requestId === requestId,
+    timeoutMs,
+    requestId,
+  );
+  return invited.payload;
+}
+
+function normalizeRoomInviteRequest(request: RoomInviteRequest): RoomInviteRequest {
+  return request.username
+    ? { ...request, username: request.username.trim().replace(/^@+/, "") }
+    : request;
+}
+
 export async function removeRoomMember(
   config: RoomClientConfig,
   request: RoomRemoveMemberRequest,
@@ -969,6 +994,7 @@ export async function sendRoomDmOnClient(
       ...(request.username ? { username: request.username } : {}),
       ...(request.conversationId ? { conversationId: request.conversationId } : {}),
       ...(request.imageUrl ? { imageUrl: request.imageUrl } : {}),
+      ...(request.metadata ? { metadata: request.metadata } : {}),
     },
     timestamp: Date.now(),
   });
@@ -984,15 +1010,50 @@ export async function sendRoomDmOnClient(
   return sent.payload;
 }
 
-/** Edit one of my DM messages. Fire-and-forget over the WS; the relay fans out
- *  DM_MESSAGE_EDITED to both participants. */
-export function editRoomDmOnClient(
+export async function replyRoomDmOnClient(
+  client: RoomWsClient,
+  request: RoomDmReplyRequest,
+  timeoutMs?: number,
+): Promise<RoomDmMessagePayload> {
+  const requestId = randomUUID();
+  const clientMsgId = request.clientMsgId ?? randomUUID();
+  client.send({
+    type: RoomClientMessageType.DM_REPLY,
+    payload: {
+      requestId,
+      content: request.content,
+      replyTo: request.replyTo,
+      clientMsgId,
+      ...(request.username ? { username: request.username } : {}),
+      ...(request.conversationId ? { conversationId: request.conversationId } : {}),
+      ...(request.imageUrl ? { imageUrl: request.imageUrl } : {}),
+      ...(request.metadata ? { metadata: request.metadata } : {}),
+    },
+    timestamp: Date.now(),
+  });
+  const sent = await client.waitFor(
+    RoomServerMessageType.DM_MESSAGE,
+    (msg) =>
+      msg.payload.requestId === requestId ||
+      msg.payload.clientMsgId === clientMsgId ||
+      msg.payload.message.clientMsgId === clientMsgId,
+    timeoutMs,
+    requestId,
+  );
+  return sent.payload;
+}
+
+/** Edit one of my DM messages and wait for the correlated relay update. */
+export async function editRoomDmOnClient(
   client: RoomWsClient,
   request: { conversationId?: string; username?: string; messageId: string; content: string },
-): void {
+  timeoutMs?: number,
+): Promise<RoomDmMessageEditedPayload> {
+  const requestId = randomUUID();
   client.send({
     type: RoomClientMessageType.DM_EDIT,
     payload: {
+      requestId,
       messageId: request.messageId,
       content: request.content,
       ...(request.conversationId ? { conversationId: request.conversationId } : {}),
@@ -1000,26 +1061,43 @@ export function editRoomDmOnClient(
     },
     timestamp: Date.now(),
   });
+  const updated = await client.waitFor(
+    RoomServerMessageType.DM_MESSAGE_EDITED,
+    (msg) => msg.payload.requestId === requestId,
+    timeoutMs,
+    requestId,
+  );
+  return updated.payload;
 }
 
 /** Soft-delete one of my DM messages. The relay fans out DM_MESSAGE_DELETED. */
-export function deleteRoomDmOnClient(
+export async function deleteRoomDmOnClient(
   client: RoomWsClient,
   request: { conversationId?: string; username?: string; messageId: string },
-): void {
+  timeoutMs?: number,
+): Promise<RoomDmMessageDeletedPayload> {
+  const requestId = randomUUID();
   client.send({
     type: RoomClientMessageType.DM_DELETE,
     payload: {
+      requestId,
       messageId: request.messageId,
       ...(request.conversationId ? { conversationId: request.conversationId } : {}),
       ...(request.username ? { username: request.username } : {}),
     },
     timestamp: Date.now(),
   });
+  const updated = await client.waitFor(
+    RoomServerMessageType.DM_MESSAGE_DELETED,
+    (msg) => msg.payload.requestId === requestId,
+    timeoutMs,
+    requestId,
+  );
+  return updated.payload;
 }
 
 /** Toggle a reaction on a DM message. The relay fans out DM_REACTION_UPDATED. */
-export function reactRoomDmOnClient(
+export async function reactRoomDmOnClient(
   client: RoomWsClient,
   request: {
     conversationId?: string;
@@ -1028,10 +1106,13 @@ export function reactRoomDmOnClient(
     emoji: string;
     op: "add" | "remove";
   },
-): void {
+  timeoutMs?: number,
+): Promise<RoomDmReactionUpdatedPayload> {
+  const requestId = randomUUID();
   client.send({
     type: RoomClientMessageType.DM_REACT,
     payload: {
+      requestId,
       messageId: request.messageId,
       emoji: request.emoji,
       op: request.op,
@@ -1040,6 +1121,69 @@ export function reactRoomDmOnClient(
     },
     timestamp: Date.now(),
   });
+  const updated = await client.waitFor(
+    RoomServerMessageType.DM_REACTION_UPDATED,
+    (msg) => msg.payload.requestId === requestId,
+    timeoutMs,
+    requestId,
+  );
+  return updated.payload;
+}
+
+/** Set shared pin state for a DM message. The relay fans out DM_PIN_UPDATED. */
+export function pinRoomDmOnClient(
+  client: RoomWsClient,
+  request: { conversationId?: string; username?: string; messageId: string },
+): void {
+  client.send({
+    type: RoomClientMessageType.DM_PIN,
+    payload: {
+      messageId: request.messageId,
+      ...(request.conversationId ? { conversationId: request.conversationId } : {}),
+      ...(request.username ? { username: request.username } : {}),
+    },
+    timestamp: Date.now(),
+  });
+}
+
+export function unpinRoomDmOnClient(
+  client: RoomWsClient,
+  request: { conversationId?: string; username?: string; messageId: string },
+): void {
+  client.send({
+    type: RoomClientMessageType.DM_UNPIN,
+    payload: {
+      messageId: request.messageId,
+      ...(request.conversationId ? { conversationId: request.conversationId } : {}),
+      ...(request.username ? { username: request.username } : {}),
+    },
+    timestamp: Date.now(),
+  });
+}
+
+export async function requestRoomDmPinsOnClient(
+  client: RoomWsClient,
+  request: { conversationId?: string; username?: string; limit?: number },
+  timeoutMs?: number,
+): Promise<RoomDmPinsResultPayload> {
+  const requestId = randomUUID();
+  client.send({
+    type: RoomClientMessageType.DM_PINS,
+    payload: {
+      requestId,
+      ...(request.conversationId ? { conversationId: request.conversationId } : {}),
+      ...(request.username ? { username: request.username } : {}),
+      ...(request.limit ? { limit: request.limit } : {}),
+    },
+    timestamp: Date.now(),
+  });
+  const result = await client.waitFor(
+    RoomServerMessageType.DM_PINS,
+    (message) => message.payload.requestId === requestId,
+    timeoutMs,
+    requestId,
+  );
+  return result.payload;
 }
 
 export async function peekRoom(
@@ -1195,6 +1339,7 @@ export function postRoomMessage(
   attachments?: RoomAttachmentInput[],
   topicId?: string,
   clientMsgId?: string,
+  metadata?: RoomForwardMetadata,
 ): string {
   const msgId = clientMsgId ?? randomUUID();
   client.send({
@@ -1206,6 +1351,7 @@ export function postRoomMessage(
       clientMsgId: msgId,
       ...(inReplyTo !== undefined ? { inReplyTo } : {}),
       ...(topicId ? { topicId } : {}),
+      ...(metadata ? { metadata } : {}),
     },
     timestamp: Date.now(),
   });

package/src/shared/rooms-protocol.ts

@@ -37,10 +37,14 @@ export const RoomClientMessageType = {
   DM_OPEN: "DM_OPEN",
   DM_HISTORY: "DM_HISTORY",
   DM_SEND: "DM_SEND",
+  DM_REPLY: "DM_REPLY",
   DM_READ: "DM_READ",
   DM_EDIT: "DM_EDIT",
   DM_DELETE: "DM_DELETE",
   DM_REACT: "DM_REACT",
+  DM_PIN: "DM_PIN",
+  DM_UNPIN: "DM_UNPIN",
+  DM_PINS: "DM_PINS",
   TOPIC_CREATE: "TOPIC_CREATE",
   TOPIC_RENAME: "TOPIC_RENAME",
   TOPIC_MOVE: "TOPIC_MOVE",
@@ -97,6 +101,8 @@ export const RoomServerMessageType = {
   DM_MESSAGE_EDITED: "DM_MESSAGE_EDITED",
   DM_MESSAGE_DELETED: "DM_MESSAGE_DELETED",
   DM_REACTION_UPDATED: "DM_REACTION_UPDATED",
+  DM_PIN_UPDATED: "DM_PIN_UPDATED",
+  DM_PINS: "DM_PINS",
   TOPIC: "TOPIC",
   TOPICS: "TOPICS",
   TOPIC_UPDATED: "TOPIC_UPDATED",
@@ -253,6 +259,23 @@ export interface RoomLedgerEntry {
   pinnedAt?: string | number | Date | null | undefined;
   attachments?: RoomAttachment[] | undefined;
   roomRole?: RoomRole | null | undefined;
+  metadata?: (Record<string, unknown> & Partial<RoomForwardMetadata>) | undefined;
+}
+
+export type RoomForwardedFrom =
+  | {
+      kind: "room";
+      room: string;
+      seq: number;
+      handle: string;
+    }
+  | {
+      kind: "dm";
+      handle: string;
+    };
+
+export interface RoomForwardMetadata {
+  forwardedFrom: RoomForwardedFrom;
 }
 
 export interface RoomAttachment {
@@ -560,12 +583,14 @@ export interface RoomDmMessage {
   createdAt?: string | number | undefined;
   /** Sealed DM: content is '' and the opaque envelope rides here. */
   secret?: RoomLedgerSecretPayload | null | undefined;
-  metadata?: Record<string, unknown> | undefined;
+  metadata?: (Record<string, unknown> & Partial<RoomForwardMetadata>) | undefined;
   /** Legacy public chat-image URL (renders as-is, no signing). */
   imageUrl?: string | null | undefined;
   /** Private, signed, scanned DM attachments (dm-attachments/ keyspace).
    *  Additive: old messages carry none and render unchanged. */
   attachments?: RoomAttachment[] | undefined;
+  /** Shared pin state. Legacy messages omit it and read as unpinned. */
+  pinned?: boolean | undefined;
 }
 
 export interface RoomDmOpenPayload {
@@ -593,6 +618,12 @@ export interface RoomDmSendPayload {
   /** DM-attachment key or legacy public image URL; stored on the message's
    *  imageUrl. Additive — text-only sends omit it. */
   imageUrl?: string;
+  metadata?: RoomForwardMetadata | undefined;
+}
+
+/** Client → server: send a DM whose parent is another message in the same conversation. */
+export interface RoomDmReplyPayload extends RoomDmSendPayload {
+  replyTo: string;
 }
 
 /** Client → server: edit one of my DM messages (sealed messages are rejected). */
@@ -614,6 +645,7 @@ export interface RoomDmDeletePayload {
 
 /** Server → both participants: a DM message was edited. */
 export interface RoomDmMessageEditedPayload {
+  requestId?: string;
   conversationId: string;
   messageId: string;
   content: string;
@@ -623,6 +655,7 @@ export interface RoomDmMessageEditedPayload {
 
 /** Server → both participants: a DM message was soft-deleted (tombstone). */
 export interface RoomDmMessageDeletedPayload {
+  requestId?: string;
   conversationId: string;
   messageId: string;
   deletedAt: string | number;
@@ -641,12 +674,42 @@ export interface RoomDmReactPayload {
 
 /** Server → both participants: a DM message's aggregated reactions changed. */
 export interface RoomDmReactionUpdatedPayload {
+  requestId?: string;
   conversationId: string;
   messageId: string;
   reactions: Array<{ emoji: string; users: string[] }>;
   participant: RoomDmParticipant;
 }
 
+export interface RoomDmPinPayload {
+  requestId?: string;
+  conversationId?: string;
+  username?: string;
+  messageId: string;
+}
+
+export interface RoomDmPinsPayload {
+  requestId?: string;
+  conversationId?: string;
+  username?: string;
+  limit?: number;
+}
+
+export interface RoomDmPinUpdatedPayload {
+  requestId?: string;
+  conversationId: string;
+  participant: RoomDmParticipant;
+  messageId: string;
+  pinned: boolean;
+}
+
+export interface RoomDmPinsResultPayload {
+  requestId?: string;
+  conversationId: string;
+  participant: RoomDmParticipant;
+  pins: RoomDmMessage[];
+}
+
 export interface RoomDmReadPayload {
   requestId?: string;
   username?: string;
@@ -1014,6 +1077,7 @@ export type RoomClientMessage =
         clientMsgId?: string;
         reason?: string;
         requestId?: string;
+        metadata?: RoomForwardMetadata;
       };
       timestamp?: number;
     }
@@ -1189,6 +1253,11 @@ export type RoomClientMessage =
       payload: RoomDmSendPayload;
       timestamp?: number;
     }
+  | {
+      type: typeof RoomClientMessageType.DM_REPLY;
+      payload: RoomDmReplyPayload;
+      timestamp?: number;
+    }
   | {
       type: typeof RoomClientMessageType.DM_READ;
       payload: RoomDmReadPayload;
@@ -1209,6 +1278,21 @@ export type RoomClientMessage =
       payload: RoomDmReactPayload;
       timestamp?: number;
     }
+  | {
+      type: typeof RoomClientMessageType.DM_PIN;
+      payload: RoomDmPinPayload;
+      timestamp?: number;
+    }
+  | {
+      type: typeof RoomClientMessageType.DM_UNPIN;
+      payload: RoomDmPinPayload;
+      timestamp?: number;
+    }
+  | {
+      type: typeof RoomClientMessageType.DM_PINS;
+      payload: RoomDmPinsPayload;
+      timestamp?: number;
+    }
   | {
       type: typeof RoomClientMessageType.TOPIC_CREATE;
       payload: RoomTopicCreatePayload;
@@ -1461,6 +1545,16 @@ export type RoomServerMessage =
       payload: RoomDmReactionUpdatedPayload;
       timestamp: number;
     }
+  | {
+      type: typeof RoomServerMessageType.DM_PIN_UPDATED;
+      payload: RoomDmPinUpdatedPayload;
+      timestamp: number;
+    }
+  | {
+      type: typeof RoomServerMessageType.DM_PINS;
+      payload: RoomDmPinsResultPayload;
+      timestamp: number;
+    }
   | {
       type: typeof RoomServerMessageType.TOPIC;
       payload: RoomTopicResultPayload;

package/src/social-client.ts

@@ -1044,6 +1044,18 @@ export async function removeSpaceMember(
   );
 }
 
+/** Leave a server as the authenticated caller. This is deliberately separate
+ * from the manager-only member-removal route so clients never send their own
+ * userId as authorization data. */
+export async function leaveSpace(
+  config: RoomSocialConfig,
+  spaceId: string,
+): Promise<{ left?: boolean }> {
+  return socialRequest(config, `/spaces/${encodeURIComponent(spaceId)}/membership`, {
+    method: "DELETE",
+  });
+}
+
 export async function changeSpaceMemberRole(
   config: RoomSocialConfig,
   spaceId: string,

package/src/social-types.ts

@@ -144,6 +144,8 @@ export interface RoomDmMessage {
   imageUrl?: string | null;
   /** Aggregated reactions (per-emoji userId lists). Additive. */
   reactions?: Array<{ emoji: string; users: string[] }>;
+  /** Shared pin state. Additive; absent means unpinned. */
+  pinned?: boolean;
   /** 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;

package/src/types.ts

@@ -15,14 +15,22 @@ export type {
   RoomDmHistoryResultPayload,
   RoomDmInboxUpdatedPayload,
   RoomDmMessage,
+  RoomDmMessageDeletedPayload,
+  RoomDmMessageEditedPayload,
   RoomDmMessagePayload,
   RoomDmOpenedPayload,
   RoomDmOpenPayload,
   RoomDmParticipant,
+  RoomDmPinsResultPayload,
+  RoomDmPinUpdatedPayload,
+  RoomDmReactionUpdatedPayload,
   RoomDmReadPayload,
+  RoomDmReplyPayload,
   RoomDmSendPayload,
   RoomEntryUpdatedPayload,
   RoomErrorPayload,
+  RoomForwardedFrom,
+  RoomForwardMetadata,
   RoomFriendPresence,
   RoomInvitedPayload,
   RoomInvitePayload,

package/src/version.ts

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