@mattstack/rt-client 0.6.2 → 0.8.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;
 }>>;
@@ -191,3 +208,5 @@ export declare function paneSpawn(a: Commands["pane:spawn"]["payload"], o?: RtCl
 export declare function paneAccounts(o?: RtClientOptions): Promise<RtResponse<Commands["pane:accounts"]["data"]>>;
 export declare function paneDirectories(a: Commands["pane:directories"]["payload"], o?: RtClientOptions): Promise<RtResponse<Commands["pane:directories"]["data"]>>;
 export declare function chatInvite(a: Commands["chat:invite"]["payload"], o?: RtClientOptions): Promise<RtResponse<Commands["chat:invite"]["data"]>>;
+/** A working target holds the connection through its prompt wait, so the budget matches chatInvite's 30s. */
+export declare function paneSend(a: Commands["pane:send"]["payload"], o?: RtClientOptions): Promise<RtResponse<Commands["pane:send"]["data"]>>;

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
@@ -184,6 +186,13 @@ export interface InviteResult {
     delivered: "accepted" | "queued" | "refused";
     reason?: string;
 }
+/** Duplicated shape on purpose: mirrors lib/daemon/inject.ts's InjectResult. */
+export type PaneDelivery = "accepted" | "queued" | "refused";
+export interface PaneSendResult {
+    paneId: string;
+    delivered: PaneDelivery;
+    reason?: string;
+}
 export type Attention = {
     needs: boolean;
     reason: "failed" | "stale" | "stranded" | "blocked" | null;
@@ -471,6 +480,7 @@ export interface Commands {
     "chat:rooms": {
         payload: {
             handle: string;
+            includeArchived?: boolean;
         };
         data: {
             rooms: RoomSummary[];
@@ -611,6 +621,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;
@@ -633,6 +665,8 @@ export interface Commands {
             id: string;
             prompt?: string;
             surface?: AgentSurface;
+            workspace?: string;
+            tab?: string;
         };
         data: AgentRecord;
     };
@@ -704,6 +738,14 @@ export interface Commands {
             ready: boolean;
         };
     };
+    "pane:send": {
+        payload: {
+            paneId: string;
+            text: string;
+            callerPane?: string;
+        };
+        data: PaneSendResult;
+    };
 }
 export type CommandName = keyof Commands;
 export declare const COMMAND_NAMES: readonly CommandName[];

package/dist/index.d.ts

@@ -1,8 +1,8 @@
 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, paneSend, } 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 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, PaneDelivery, PaneSendResult, } from "./commands.ts";
 export { subscribe, createRelay, DEFAULT_WS_URL } from "./relay.ts";
 export type { RelayEventType } from "./relay.ts";
 export { daemonHealth } from "./health.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 });
 }
@@ -199,10 +211,10 @@ function agentStart(a, o = {}) {
 }
 function agentResume(a, o = {}) {
   const payload = { id: a.id };
-  if (a.prompt !== undefined)
-    payload.prompt = a.prompt;
-  if (a.surface !== undefined)
-    payload.surface = a.surface;
+  for (const k of ["prompt", "surface", "workspace", "tab"]) {
+    if (a[k] !== undefined)
+      payload[k] = a[k];
+  }
   return rtCommand("agent:resume", payload, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 30000 });
 }
 function agentGet(a, o = {}) {
@@ -247,6 +259,12 @@ function chatInvite(a, o = {}) {
     payload.callerPane = a.callerPane;
   return rtCommand("chat:invite", payload, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 30000 });
 }
+function paneSend(a, o = {}) {
+  const payload = { paneId: a.paneId, text: a.text };
+  if (a.callerPane !== undefined)
+    payload.callerPane = a.callerPane;
+  return rtCommand("pane:send", payload, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 30000 });
+}
 // src/commands.ts
 var COMMAND_NAMES = [
   "project-mrs:read",
@@ -280,6 +298,8 @@ var COMMAND_NAMES = [
   "chat:buddies",
   "chat:pulse",
   "chat:dm",
+  "chat:archive",
+  "chat:dm-open",
   "agent:start",
   "agent:resume",
   "agent:get",
@@ -289,7 +309,8 @@ var COMMAND_NAMES = [
   "pane:peek",
   "pane:accounts",
   "pane:directories",
-  "pane:spawn"
+  "pane:spawn",
+  "pane:send"
 ];
 // src/relay.ts
 var DEFAULT_WS_URL = "ws://127.0.0.1:9401/ws";
@@ -1738,6 +1759,7 @@ export {
   readBranchCache,
   parseIdentity,
   paneSpawn,
+  paneSend,
   panePeek,
   paneList,
   paneDirectories,
@@ -1772,12 +1794,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.8.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 });
 }
@@ -343,8 +365,9 @@ export function agentResume(
   a: Commands["agent:resume"]["payload"], o: RtClientOptions = {},
 ): Promise<RtResponse<AgentRecord>> {
   const payload: Record<string, unknown> = { id: a.id };
-  if (a.prompt !== undefined) payload.prompt = a.prompt;
-  if (a.surface !== undefined) payload.surface = a.surface;
+  for (const k of ["prompt", "surface", "workspace", "tab"] as const) {
+    if (a[k] !== undefined) payload[k] = a[k];
+  }
   return rtCommand<AgentRecord>("agent:resume", payload, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 30_000 });
 }
 
@@ -400,3 +423,13 @@ export function chatInvite(
   if (a.callerPane !== undefined) payload.callerPane = a.callerPane;
   return rtCommand<Commands["chat:invite"]["data"]>("chat:invite", payload, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 30_000 });
 }
+
+/** A working target holds the connection through its prompt wait, so the budget matches chatInvite's 30s. */
+export function paneSend(
+  a: Commands["pane:send"]["payload"],
+  o: RtClientOptions = {},
+): Promise<RtResponse<Commands["pane:send"]["data"]>> {
+  const payload: Record<string, unknown> = { paneId: a.paneId, text: a.text };
+  if (a.callerPane !== undefined) payload.callerPane = a.callerPane;
+  return rtCommand<Commands["pane:send"]["data"]>("pane:send", payload, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 30_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;
 }
 
 /**
@@ -165,6 +167,10 @@ export interface PaneAccount { slot: number; email: string; alias?: string; head
 export interface PaneDirectory { path: string; repo: string; branch?: string }
 export interface InviteResult { paneId: string; delivered: "accepted" | "queued" | "refused"; reason?: string }
 
+/** Duplicated shape on purpose: mirrors lib/daemon/inject.ts's InjectResult. */
+export type PaneDelivery = "accepted" | "queued" | "refused";
+export interface PaneSendResult { paneId: string; delivered: PaneDelivery; reason?: string }
+
 // SKILLS-53: one judgment, computed once in rt, so the console and the tray
 // never derive two verdicts that can disagree.
 export type Attention = {
@@ -283,7 +289,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,10 +314,12 @@ 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 };
-  "agent:resume": { payload: { id: string; prompt?: string; surface?: AgentSurface }; data: AgentRecord };
+  "agent:resume": { payload: { id: string; prompt?: string; surface?: AgentSurface; workspace?: string; tab?: string }; data: AgentRecord };
   "agent:get": { payload: { id: string }; data: AgentRecord };
   "agent:list": { payload: { repo?: string }; data: { agents: AgentRecord[] } };
   "chat:invite": { payload: { paneId: string; room: string; note?: string; from: string; callerPane?: string }; data: InviteResult };
@@ -323,6 +331,7 @@ export interface Commands {
     payload: { cwd: string; account?: string; model?: string; effort?: string; prompt?: string; workspace?: string };
     data: { pane: ChatPane; ready: boolean };
   };
+  "pane:send": { payload: { paneId: string; text: string; callerPane?: string }; data: PaneSendResult };
 }
 
 export type CommandName = keyof Commands;
@@ -359,6 +368,8 @@ export const COMMAND_NAMES: readonly CommandName[] = [
   "chat:buddies",
   "chat:pulse",
   "chat:dm",
+  "chat:archive",
+  "chat:dm-open",
   "agent:start",
   "agent:resume",
   "agent:get",
@@ -369,4 +380,5 @@ export const COMMAND_NAMES: readonly CommandName[] = [
   "pane:accounts",
   "pane:directories",
   "pane:spawn",
+  "pane:send",
 ];

package/src/index.ts

@@ -29,6 +29,8 @@ export {
   chatBuddies,
   chatPulse,
   chatDm,
+  chatArchive,
+  chatDmOpen,
   eventsHead,
   agentStart,
   agentResume,
@@ -40,6 +42,7 @@ export {
   paneAccounts,
   paneDirectories,
   chatInvite,
+  paneSend,
 } from "./client.ts";
 
 export { COMMAND_NAMES } from "./commands.ts";
@@ -75,6 +78,8 @@ export type {
   PaneAccount,
   PaneDirectory,
   InviteResult,
+  PaneDelivery,
+  PaneSendResult,
 } from "./commands.ts";
 
 export { subscribe, createRelay, DEFAULT_WS_URL } from "./relay.ts";