@mattstack/rt-client 0.6.2 → 0.7.0

package/README.md

@@ -100,8 +100,8 @@ const stop = createRelay({                                     // one daemon sub
 | --- | --- |
 | `chatSignIn` / `chatSignOut` / `chatAway` / `chatBack` / `chatPulse` | presence: the buddy-list row and its heartbeats |
 | `chatBuddies` / `chatWho` / `chatRooms` | the roster, one room's members, a handle's rooms |
-| `chatJoin` / `chatLeave` | membership (`wakeOn: mention \| all \| none`) |
-| `chatPost` / `chatDm` / `chatRead` / `chatMessages` / `chatMark` | messages: post, DM, read-and-advance, page, advance the cursor |
+| `chatJoin` / `chatLeave` / `chatArchive` | membership (`wakeOn: mention \| all \| none`); archive parks a room for everyone until a post revives it |
+| `chatPost` / `chatDm` / `chatDmOpen` / `chatRead` / `chatMessages` / `chatMark` | messages: post, DM, open a DM room without posting, read-and-advance, page, advance the cursor |
 | `chatArm` / `chatTouch` / `chatDisarm` / `chatUnreadWaking` | the tail's wake protocol; the CLI's `rt chat tail` uses these |
 | `paneList` / `panePeek` / `paneSpawn` / `paneAccounts` / `paneDirectories` | herdr panes: list with presence joined, peek a screen, start claude in a tab, cswap accounts, directory suggestions |
 | `chatInvite` | type `/chat:join <room>` into a pane; `accepted`, `queued` or `refused` |

package/dist/client.d.ts

@@ -76,6 +76,7 @@ export declare function chatRead(a: {
 }>>;
 export declare function chatRooms(a: {
     handle: string;
+    includeArchived?: boolean;
 }, o?: RtClientOptions): Promise<RtResponse<{
     rooms: RoomSummary[];
 }>>;
@@ -171,6 +172,22 @@ export declare function chatDm(a: {
     id: number;
     recipients: string[];
 }>>;
+export declare function chatArchive(a: {
+    room: string;
+    handle: string;
+    archived: boolean;
+}, o?: RtClientOptions): Promise<RtResponse<{
+    room: string;
+    archivedAt: number | null;
+}>>;
+export declare function chatDmOpen(a: {
+    from: string;
+    to: string;
+    sessionId?: string;
+}, o?: RtClientOptions): Promise<RtResponse<{
+    room: string;
+    created: boolean;
+}>>;
 export declare function eventsHead(o?: RtClientOptions): Promise<RtResponse<{
     cursor: number;
 }>>;

package/dist/commands.d.ts

@@ -129,6 +129,8 @@ export interface RoomSummary {
     };
     /** Set only by chat:rooms's left join against chat_room_defaults; undefined for a room never stamped a default (every DM room included). */
     defaultWake?: WakeMode;
+    /** Set only when chat:rooms was asked for archived rooms; absent on an open room. */
+    archivedAt?: number;
 }
 /**
  * Duplicated shape on purpose, same reasoning as ChatMember/ChatMessage
@@ -471,6 +473,7 @@ export interface Commands {
     "chat:rooms": {
         payload: {
             handle: string;
+            includeArchived?: boolean;
         };
         data: {
             rooms: RoomSummary[];
@@ -611,6 +614,28 @@ export interface Commands {
             recipients: string[];
         };
     };
+    "chat:archive": {
+        payload: {
+            room: string;
+            handle: string;
+            archived: boolean;
+        };
+        data: {
+            room: string;
+            archivedAt: number | null;
+        };
+    };
+    "chat:dm-open": {
+        payload: {
+            from: string;
+            to: string;
+            sessionId?: string;
+        };
+        data: {
+            room: string;
+            created: boolean;
+        };
+    };
     "agent:start": {
         payload: {
             repo: string;

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 export { rtCommand, DEFAULT_SOCK } from "./transport.ts";
 export type { RtResponse, RtClientOptions } from "./transport.ts";
-export { readProjectMRs, readDiscussions, readMrsByBranch, readBranchCache, resolveForgeToken, listRuns, getRun, abandonRun, chatJoin, chatLeave, chatPost, chatRead, chatRooms, chatWho, chatMark, chatMessages, chatArm, chatTouch, chatDisarm, chatUnreadWaking, chatSignIn, chatSignOut, chatAway, chatBack, chatBuddies, chatPulse, chatDm, eventsHead, agentStart, agentResume, agentGet, agentList, paneList, panePeek, paneSpawn, paneAccounts, paneDirectories, chatInvite, } from "./client.ts";
+export { readProjectMRs, readDiscussions, readMrsByBranch, readBranchCache, resolveForgeToken, listRuns, getRun, abandonRun, chatJoin, chatLeave, chatPost, chatRead, chatRooms, chatWho, chatMark, chatMessages, chatArm, chatTouch, chatDisarm, chatUnreadWaking, chatSignIn, chatSignOut, chatAway, chatBack, chatBuddies, chatPulse, chatDm, chatArchive, chatDmOpen, eventsHead, agentStart, agentResume, agentGet, agentList, paneList, panePeek, paneSpawn, paneAccounts, paneDirectories, chatInvite, } from "./client.ts";
 export { COMMAND_NAMES } from "./commands.ts";
 export type { Discussion, DemandDecl, ProjectMRsScope, ProjectMRsData, DiscussionsData, MrByBranchEntry, MrByBranchData, BranchEnrichment, Commands, CommandName, ForgeSlug, ForgeTokenData, Attention, RunSummary, RunStageRow, RunFieldRow, RunDecisionRow, RunDetail, WakeMode, ChatMember, ChatMessage, RoomSummary, BuddyStatus, PresenceRow, AgentRecord, AgentSurface, AgentStatus, ChatPane, PaneAccount, PaneDirectory, InviteResult, } from "./commands.ts";
 export { subscribe, createRelay, DEFAULT_WS_URL } from "./relay.ts";

package/dist/index.js

@@ -95,7 +95,10 @@ function chatRead(a, o = {}) {
   return rtCommand("chat:read", payload, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 1e4 });
 }
 function chatRooms(a, o = {}) {
-  return rtCommand("chat:rooms", { handle: a.handle }, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 1e4 });
+  const payload = { handle: a.handle };
+  if (a.includeArchived === true)
+    payload.includeArchived = true;
+  return rtCommand("chat:rooms", payload, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 1e4 });
 }
 function chatWho(a, o = {}) {
   return rtCommand("chat:who", { room: a.room }, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 1e4 });
@@ -186,6 +189,15 @@ function chatDm(a, o = {}) {
     payload.sessionId = a.sessionId;
   return rtCommand("chat:dm", payload, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 1e4 });
 }
+function chatArchive(a, o = {}) {
+  return rtCommand("chat:archive", { room: a.room, handle: a.handle, archived: a.archived }, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 1e4 });
+}
+function chatDmOpen(a, o = {}) {
+  const payload = { from: a.from, to: a.to };
+  if (a.sessionId !== undefined)
+    payload.sessionId = a.sessionId;
+  return rtCommand("chat:dm-open", payload, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 1e4 });
+}
 function eventsHead(o = {}) {
   return rtCommand("events:head", {}, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 1e4 });
 }
@@ -280,6 +292,8 @@ var COMMAND_NAMES = [
   "chat:buddies",
   "chat:pulse",
   "chat:dm",
+  "chat:archive",
+  "chat:dm-open",
   "agent:start",
   "agent:resume",
   "agent:get",
@@ -1772,12 +1786,14 @@ export {
   chatLeave,
   chatJoin,
   chatInvite,
+  chatDmOpen,
   chatDm,
   chatDisarm,
   chatBuddies,
   chatBack,
   chatAway,
   chatArm,
+  chatArchive,
   allDefs,
   agentStart,
   agentResume,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mattstack/rt-client",
-  "version": "0.6.2",
+  "version": "0.7.0",
   "type": "module",
   "exports": {
     ".": {

package/src/client.ts

@@ -186,10 +186,12 @@ export function chatRead(
 }
 
 export function chatRooms(
-  a: { handle: string },
+  a: { handle: string; includeArchived?: boolean },
   o: RtClientOptions = {},
 ): Promise<RtResponse<{ rooms: RoomSummary[] }>> {
-  return rtCommand<{ rooms: RoomSummary[] }>("chat:rooms", { handle: a.handle }, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 10_000 });
+  const payload: Record<string, unknown> = { handle: a.handle };
+  if (a.includeArchived === true) payload.includeArchived = true;
+  return rtCommand<{ rooms: RoomSummary[] }>("chat:rooms", payload, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 10_000 });
 }
 
 export function chatWho(
@@ -323,6 +325,26 @@ export function chatDm(
   return rtCommand<{ room: string; id: number; recipients: string[] }>("chat:dm", payload, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 10_000 });
 }
 
+export function chatArchive(
+  a: { room: string; handle: string; archived: boolean },
+  o: RtClientOptions = {},
+): Promise<RtResponse<{ room: string; archivedAt: number | null }>> {
+  return rtCommand<{ room: string; archivedAt: number | null }>(
+    "chat:archive",
+    { room: a.room, handle: a.handle, archived: a.archived },
+    { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 10_000 },
+  );
+}
+
+export function chatDmOpen(
+  a: { from: string; to: string; sessionId?: string },
+  o: RtClientOptions = {},
+): Promise<RtResponse<{ room: string; created: boolean }>> {
+  const payload: Record<string, unknown> = { from: a.from, to: a.to };
+  if (a.sessionId !== undefined) payload.sessionId = a.sessionId;
+  return rtCommand<{ room: string; created: boolean }>("chat:dm-open", payload, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 10_000 });
+}
+
 export function eventsHead(o: RtClientOptions = {}): Promise<RtResponse<{ cursor: number }>> {
   return rtCommand<{ cursor: number }>("events:head", {}, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 10_000 });
 }

package/src/commands.ts

@@ -121,6 +121,8 @@ export interface RoomSummary {
   participants?: { a: string; b: string };
   /** Set only by chat:rooms's left join against chat_room_defaults; undefined for a room never stamped a default (every DM room included). */
   defaultWake?: WakeMode;
+  /** Set only when chat:rooms was asked for archived rooms; absent on an open room. */
+  archivedAt?: number;
 }
 
 /**
@@ -283,7 +285,7 @@ export interface Commands {
   "chat:leave": { payload: { room: string; handle: string }; data: Record<string, never> };
   "chat:post": { payload: { room: string; handle: string; body: string; mentions?: string[] }; data: { id: number; recipients: string[] } };
   "chat:read": { payload: { handle: string; room?: string; limit?: number; sinceMs?: number }; data: { rooms: { room: string; messages: ChatMessage[] }[] } };
-  "chat:rooms": { payload: { handle: string }; data: { rooms: RoomSummary[] } };
+  "chat:rooms": { payload: { handle: string; includeArchived?: boolean }; data: { rooms: RoomSummary[] } };
   "chat:who": { payload: { room: string }; data: { members: ChatMember[] } };
   "chat:mark": { payload: { handle: string; room?: string }; data: Record<string, never> };
   "chat:messages": { payload: { room: string; before?: number; limit?: number }; data: { messages: ChatMessage[] } };
@@ -308,6 +310,8 @@ export interface Commands {
     data: { unread: { dms: number; mentions: number; rooms: number }; status: BuddyStatus };
   };
   "chat:dm": { payload: { from: string; to: string; body: string; sessionId?: string }; data: { room: string; id: number; recipients: string[] } };
+  "chat:archive": { payload: { room: string; handle: string; archived: boolean }; data: { room: string; archivedAt: number | null } };
+  "chat:dm-open": { payload: { from: string; to: string; sessionId?: string }; data: { room: string; created: boolean } };
 
   // ─── Agent handoff (rt agent) ────────────────────────────────────────────
   "agent:start": { payload: { repo: string; cwd: string; prompt?: string; surface?: AgentSurface; model?: string; effort?: string; account?: string; label?: string; caller?: string; workspace?: string; tab?: string; extraArgs?: string }; data: AgentRecord };
@@ -359,6 +363,8 @@ export const COMMAND_NAMES: readonly CommandName[] = [
   "chat:buddies",
   "chat:pulse",
   "chat:dm",
+  "chat:archive",
+  "chat:dm-open",
   "agent:start",
   "agent:resume",
   "agent:get",

package/src/index.ts

@@ -29,6 +29,8 @@ export {
   chatBuddies,
   chatPulse,
   chatDm,
+  chatArchive,
+  chatDmOpen,
   eventsHead,
   agentStart,
   agentResume,