@mattstack/rt-client 0.9.0 → 0.10.1

package/README.md

@@ -90,7 +90,7 @@ await chatPost({ handle: 'matt', room: 'build', body: 'on it' });
 
 const health = await daemonHealth();                           // { reachable, error? }, never throws
 const stop = createRelay({                                     // one daemon subscription, republished
-  match: t => t.startsWith('chat/'),                            // `chat/<room>/msg`, `chat/wake/<handle>`
+  match: t => t.startsWith('chat/'),                            // `chat/<room>/msg`
   topic: 'chat',
   publish: (topic, data) => server.publish(topic, data),
 });
@@ -98,20 +98,18 @@ const stop = createRelay({                                     // one daemon sub
 
 | Function | Daemon verb |
 | --- | --- |
-| `chatSignIn` / `chatSignOut` / `chatAway` / `chatBack` / `chatPulse` | presence: the buddy-list row and its heartbeats |
+| `chatSignIn` / `chatSignOut` / `chatAway` / `chatBack` | presence: the buddy-list row and its session heartbeat |
 | `chatBuddies` / `chatWho` / `chatRooms` | the roster, one room's members, a handle's rooms |
 | `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` |
 | `createRelay` / `subscribe` | the event stream; `daemonHealth` the reachability probe |
 
 Pass `{ sockPath }` as the trailing options to reach a non-default daemon
-socket. The verbs, their payloads and the wake protocol are specified in
-repo-tools `docs/superpowers/specs/2026-08-23-rt-chat-design.md` and
-`2026-08-24-rt-chat-presence-design.md`; the agent-facing rules are
-`skills/rt-chat/SKILL.md`.
+socket. The verbs and their payloads are specified in repo-tools
+`docs/superpowers/specs/2026-08-28-rt-chat-delivery-v2-design.md`; the
+agent-facing rules are `skills/rt-chat/SKILL.md`.
 
 ## License
 

package/dist/client.d.ts

@@ -96,35 +96,8 @@ export declare function chatMessages(a: {
 }, o?: RtClientOptions): Promise<RtResponse<{
     messages: ChatMessage[];
 }>>;
-export declare function chatArm(a: {
-    handle: string;
-    room?: string;
-    sessionId?: string;
-}, o?: RtClientOptions): Promise<RtResponse<Record<string, never>>>;
-export declare function chatTouch(a: {
-    handle: string;
-    room?: string;
-    sessionId?: string;
-}, o?: RtClientOptions): Promise<RtResponse<Record<string, never>>>;
-export declare function chatDisarm(a: {
-    handle: string;
-    sessionId?: string;
-}, o?: RtClientOptions): Promise<RtResponse<Record<string, never>>>;
-export declare function chatUnreadWaking(a: {
-    handle: string;
-    room?: string;
-}, o?: RtClientOptions): Promise<RtResponse<{
-    rooms: {
-        room: string;
-        count: number;
-        mentions: number;
-        maxId: number;
-    }[];
-}>>;
 export declare function chatSignIn(a: Commands["chat:sign-in"]["payload"], o?: RtClientOptions): Promise<RtResponse<Commands["chat:sign-in"]["data"]>>;
-export declare function chatSignOut(a: {
-    sessionId: string;
-}, o?: RtClientOptions): Promise<RtResponse<Record<string, never>>>;
+export declare function chatSignOut(a: Commands["chat:sign-out"]["payload"], o?: RtClientOptions): Promise<RtResponse<Commands["chat:sign-out"]["data"]>>;
 export declare function chatAway(a: {
     sessionId: string;
     text: string;
@@ -137,20 +110,6 @@ export declare function chatBuddies(o?: RtClientOptions): Promise<RtResponse<{
         status: BuddyStatus;
     }>;
 }>>;
-export declare function chatPulse(a: {
-    sessionId: string;
-    cwd?: string;
-    repo?: string;
-    branch?: string;
-    pane?: string;
-}, o?: RtClientOptions): Promise<RtResponse<{
-    unread: {
-        dms: number;
-        mentions: number;
-        rooms: number;
-    };
-    status: BuddyStatus;
-}>>;
 export declare function chatDm(a: {
     from: string;
     to: string;
@@ -199,3 +158,6 @@ export declare function paneDirectories(a: Commands["pane:directories"]["payload
 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"]>>;
+/** Brings a herdr pane to the front. The daemon routes this to the tray, which
+    owns the herdr focus and the native terminal-window raise. */
+export declare function paneFocus(a: Commands["pane:focus"]["payload"], o?: RtClientOptions): Promise<RtResponse<Commands["pane:focus"]["data"]>>;

package/dist/commands.d.ts

@@ -99,8 +99,6 @@ export interface ChatMember {
     joinedAt: number;
     lastReadId: number;
     wakeOn: WakeMode;
-    lastSeenAt?: number;
-    armedAt?: number;
     cwd?: string;
     pane?: string;
     /** Presence-joined by chat:who's handler — the only place this type is ever returned, and it always attaches one. */
@@ -137,7 +135,7 @@ export interface RoomSummary {
  * above: mirrors lib/state/presence-store.ts's types, which rt-client
  * cannot import.
  */
-export type BuddyStatus = "live" | "idle" | "deaf" | "offline";
+export type BuddyStatus = "live" | "idle" | "offline";
 export interface PresenceRow {
     sessionId: string;
     handle: string;
@@ -149,8 +147,6 @@ export interface PresenceRow {
     statusText?: string;
     signedInAt: number;
     lastSeenAt: number;
-    tailSeenAt?: number;
-    armedAt?: number;
     signedOutAt?: number;
 }
 export type AgentStatus = "idle" | "working" | "blocked" | "done" | "unknown";
@@ -193,6 +189,10 @@ export interface PaneSendResult {
     delivered: PaneDelivery;
     reason?: string;
 }
+export interface PaneFocusResult {
+    paneId: string;
+    focused: boolean;
+}
 export type Attention = {
     needs: boolean;
     reason: "failed" | "stale" | "stranded" | "blocked" | null;
@@ -278,6 +278,7 @@ export interface AgentRecord {
     account?: string;
     label?: string;
     caller?: string;
+    handle?: string;
     paneId?: string;
     tabId?: string;
     workspaceId?: string;
@@ -511,65 +512,56 @@ export interface Commands {
             messages: ChatMessage[];
         };
     };
-    "chat:arm": {
-        payload: {
-            handle: string;
-            room?: string;
-            sessionId?: string;
-        };
-        data: Record<string, never>;
-    };
-    "chat:touch": {
-        payload: {
-            handle: string;
-            room?: string;
-            sessionId?: string;
-        };
-        data: Record<string, never>;
-    };
-    "chat:disarm": {
-        payload: {
-            handle: string;
-            sessionId?: string;
-        };
-        data: Record<string, never>;
-    };
-    "chat:unread-waking": {
-        payload: {
-            handle: string;
-            room?: string;
-        };
-        data: {
-            rooms: {
-                room: string;
-                count: number;
-                mentions: number;
-                maxId: number;
-            }[];
-        };
-    };
-    /** No `baseHandle` means "draw me a first name": the daemon picks the least recently used pool name no live session holds. */
+    /**
+     * No `baseHandle` means "draw me a first name": the daemon picks the least
+     * recently used pool name no live session holds. `viaPane` resolves
+     * `sessionId` daemon-side from herdr's `session.snapshot` for the pane id
+     * in `pane`, rather than trusting a caller-supplied id -- the caller may
+     * have none of its own (a human or another agent signing a target pane in
+     * on its behalf); the response's `sessionId` and `room` are then the only
+     * way that caller learns what got signed in and joined, since it has
+     * nothing local to derive either from.
+     */
     "chat:sign-in": {
         payload: {
-            sessionId: string;
+            sessionId?: string;
             baseHandle?: string;
             cwd?: string;
             repo?: string;
             branch?: string;
             pane?: string;
             statusText?: string;
+            viaPane?: boolean;
+            /** `viaPane` only: overrides the pane-cwd-derived room outright. */
+            room?: string;
+            /** `viaPane` only: skip room derivation/join entirely, same as --no-room on the non-pane path. */
+            noRoom?: boolean;
         };
         data: {
             handle: string;
             baseHandle: string;
             reclaimed: boolean;
+            sessionId: string;
+            room: string | null;
         };
     };
+    /**
+     * `viaPane` mirrors `chat:sign-in`'s: the daemon resolves `pane` to a
+     * session id via herdr's `session.snapshot` rather than trusting a
+     * caller-supplied one, so a process signing another pane out (herdr-chat,
+     * or a human invoking a target pane) needs neither that pane's session id
+     * nor its own. The response's `sessionId` is the RESOLVED id, the only way
+     * such a caller learns which session file to delete locally.
+     */
     "chat:sign-out": {
         payload: {
+            sessionId?: string;
+            pane?: string;
+            viaPane?: boolean;
+        };
+        data: {
             sessionId: string;
         };
-        data: Record<string, never>;
     };
     "chat:away": {
         payload: {
@@ -592,24 +584,6 @@ export interface Commands {
             }>;
         };
     };
-    /** `unread`'s three fields are disjoint and sum to the true total: `dms` is DM-room waking count; `mentions` is non-DM waking mentions; `rooms` is non-DM waking count minus those mentions (never negative). */
-    "chat:pulse": {
-        payload: {
-            sessionId: string;
-            cwd?: string;
-            repo?: string;
-            branch?: string;
-            pane?: string;
-        };
-        data: {
-            unread: {
-                dms: number;
-                mentions: number;
-                rooms: number;
-            };
-            status: BuddyStatus;
-        };
-    };
     "chat:dm": {
         payload: {
             from: string;
@@ -748,6 +722,12 @@ export interface Commands {
         };
         data: PaneSendResult;
     };
+    "pane:focus": {
+        payload: {
+            paneId: string;
+        };
+        data: PaneFocusResult;
+    };
 }
 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, chatArchive, chatDmOpen, eventsHead, agentStart, agentResume, agentGet, agentList, paneList, panePeek, paneSpawn, paneAccounts, paneDirectories, chatInvite, paneSend, } from "./client.ts";
+export { readProjectMRs, readDiscussions, readMrsByBranch, readBranchCache, resolveForgeToken, listRuns, getRun, abandonRun, chatJoin, chatLeave, chatPost, chatRead, chatRooms, chatWho, chatMark, chatMessages, chatSignIn, chatSignOut, chatAway, chatBack, chatBuddies, chatDm, chatArchive, chatDmOpen, eventsHead, agentStart, agentResume, agentGet, agentList, paneList, panePeek, paneSpawn, paneAccounts, paneDirectories, chatInvite, paneSend, paneFocus, } 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, PaneDelivery, PaneSendResult, } 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, PaneFocusResult, } 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

@@ -117,36 +117,10 @@ function chatMessages(a, o = {}) {
     payload.limit = a.limit;
   return rtCommand("chat:messages", payload, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 1e4 });
 }
-function chatArm(a, o = {}) {
-  const payload = { handle: a.handle };
-  if (a.room !== undefined)
-    payload.room = a.room;
-  if (a.sessionId !== undefined)
-    payload.sessionId = a.sessionId;
-  return rtCommand("chat:arm", payload, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 1e4 });
-}
-function chatTouch(a, o = {}) {
-  const payload = { handle: a.handle };
-  if (a.room !== undefined)
-    payload.room = a.room;
-  if (a.sessionId !== undefined)
-    payload.sessionId = a.sessionId;
-  return rtCommand("chat:touch", payload, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 1e4 });
-}
-function chatDisarm(a, o = {}) {
-  const payload = { handle: a.handle };
+function chatSignIn(a, o = {}) {
+  const payload = {};
   if (a.sessionId !== undefined)
     payload.sessionId = a.sessionId;
-  return rtCommand("chat:disarm", payload, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 1e4 });
-}
-function chatUnreadWaking(a, o = {}) {
-  const payload = { handle: a.handle };
-  if (a.room !== undefined)
-    payload.room = a.room;
-  return rtCommand("chat:unread-waking", payload, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 1e4 });
-}
-function chatSignIn(a, o = {}) {
-  const payload = { sessionId: a.sessionId };
   if (a.baseHandle !== undefined)
     payload.baseHandle = a.baseHandle;
   if (a.cwd !== undefined)
@@ -159,10 +133,23 @@ function chatSignIn(a, o = {}) {
     payload.pane = a.pane;
   if (a.statusText !== undefined)
     payload.statusText = a.statusText;
+  if (a.viaPane !== undefined)
+    payload.viaPane = a.viaPane;
+  if (a.room !== undefined)
+    payload.room = a.room;
+  if (a.noRoom !== undefined)
+    payload.noRoom = a.noRoom;
   return rtCommand("chat:sign-in", payload, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 1e4 });
 }
 function chatSignOut(a, o = {}) {
-  return rtCommand("chat:sign-out", { sessionId: a.sessionId }, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 1e4 });
+  const payload = {};
+  if (a.sessionId !== undefined)
+    payload.sessionId = a.sessionId;
+  if (a.pane !== undefined)
+    payload.pane = a.pane;
+  if (a.viaPane !== undefined)
+    payload.viaPane = a.viaPane;
+  return rtCommand("chat:sign-out", payload, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 1e4 });
 }
 function chatAway(a, o = {}) {
   return rtCommand("chat:away", { sessionId: a.sessionId, text: a.text }, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 1e4 });
@@ -173,18 +160,6 @@ function chatBack(a, o = {}) {
 function chatBuddies(o = {}) {
   return rtCommand("chat:buddies", {}, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 1e4 });
 }
-function chatPulse(a, o = {}) {
-  const payload = { sessionId: a.sessionId };
-  if (a.cwd !== undefined)
-    payload.cwd = a.cwd;
-  if (a.repo !== undefined)
-    payload.repo = a.repo;
-  if (a.branch !== undefined)
-    payload.branch = a.branch;
-  if (a.pane !== undefined)
-    payload.pane = a.pane;
-  return rtCommand("chat:pulse", payload, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 1e4 });
-}
 function chatDm(a, o = {}) {
   const payload = { from: a.from, to: a.to, body: a.body };
   if (a.sessionId !== undefined)
@@ -267,6 +242,9 @@ function paneSend(a, o = {}) {
     payload.callerPane = a.callerPane;
   return rtCommand("pane:send", payload, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 30000 });
 }
+function paneFocus(a, o = {}) {
+  return rtCommand("pane:focus", { paneId: a.paneId }, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 1e4 });
+}
 // src/commands.ts
 var COMMAND_NAMES = [
   "project-mrs:read",
@@ -289,16 +267,11 @@ var COMMAND_NAMES = [
   "chat:who",
   "chat:mark",
   "chat:messages",
-  "chat:arm",
-  "chat:touch",
-  "chat:disarm",
-  "chat:unread-waking",
   "chat:sign-in",
   "chat:sign-out",
   "chat:away",
   "chat:back",
   "chat:buddies",
-  "chat:pulse",
   "chat:dm",
   "chat:archive",
   "chat:dm-open",
@@ -312,7 +285,8 @@ var COMMAND_NAMES = [
   "pane:accounts",
   "pane:directories",
   "pane:spawn",
-  "pane:send"
+  "pane:send",
+  "pane:focus"
 ];
 // src/relay.ts
 var DEFAULT_WS_URL = "ws://127.0.0.1:9401/ws";
@@ -1764,6 +1738,7 @@ export {
   paneSend,
   panePeek,
   paneList,
+  paneFocus,
   paneDirectories,
   paneAccounts,
   normalizeRemote,
@@ -1783,13 +1758,10 @@ export {
   createRelay,
   clearIdentityMemo,
   chatWho,
-  chatUnreadWaking,
-  chatTouch,
   chatSignOut,
   chatSignIn,
   chatRooms,
   chatRead,
-  chatPulse,
   chatPost,
   chatMessages,
   chatMark,
@@ -1798,11 +1770,9 @@ export {
   chatInvite,
   chatDmOpen,
   chatDm,
-  chatDisarm,
   chatBuddies,
   chatBack,
   chatAway,
-  chatArm,
   chatArchive,
   allDefs,
   agentStart,

package/package.json

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

package/src/client.ts

@@ -220,65 +220,35 @@ export function chatMessages(
   return rtCommand<{ messages: ChatMessage[] }>("chat:messages", payload, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 10_000 });
 }
 
-export function chatArm(
-  a: { handle: string; room?: string; sessionId?: string },
-  o: RtClientOptions = {},
-): Promise<RtResponse<Record<string, never>>> {
-  const payload: Record<string, unknown> = { handle: a.handle };
-  if (a.room !== undefined) payload.room = a.room;
-  if (a.sessionId !== undefined) payload.sessionId = a.sessionId;
-  return rtCommand<Record<string, never>>("chat:arm", payload, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 10_000 });
-}
-
-export function chatTouch(
-  a: { handle: string; room?: string; sessionId?: string },
-  o: RtClientOptions = {},
-): Promise<RtResponse<Record<string, never>>> {
-  const payload: Record<string, unknown> = { handle: a.handle };
-  if (a.room !== undefined) payload.room = a.room;
-  if (a.sessionId !== undefined) payload.sessionId = a.sessionId;
-  return rtCommand<Record<string, never>>("chat:touch", payload, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 10_000 });
-}
-
-export function chatDisarm(
-  a: { handle: string; sessionId?: string },
-  o: RtClientOptions = {},
-): Promise<RtResponse<Record<string, never>>> {
-  const payload: Record<string, unknown> = { handle: a.handle };
-  if (a.sessionId !== undefined) payload.sessionId = a.sessionId;
-  return rtCommand<Record<string, never>>("chat:disarm", payload, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 10_000 });
-}
-
-export function chatUnreadWaking(
-  a: { handle: string; room?: string },
-  o: RtClientOptions = {},
-): Promise<RtResponse<{ rooms: { room: string; count: number; mentions: number; maxId: number }[] }>> {
-  const payload: Record<string, unknown> = { handle: a.handle };
-  if (a.room !== undefined) payload.room = a.room;
-  return rtCommand<{ rooms: { room: string; count: number; mentions: number; maxId: number }[] }>("chat:unread-waking", payload, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 10_000 });
-}
-
 // ─── Presence ──────────────────────────────────────────────────────────
 
 export function chatSignIn(
   a: Commands["chat:sign-in"]["payload"],
   o: RtClientOptions = {},
 ): Promise<RtResponse<Commands["chat:sign-in"]["data"]>> {
-  const payload: Record<string, unknown> = { sessionId: a.sessionId };
+  const payload: Record<string, unknown> = {};
+  if (a.sessionId !== undefined) payload.sessionId = a.sessionId;
   if (a.baseHandle !== undefined) payload.baseHandle = a.baseHandle;
   if (a.cwd !== undefined) payload.cwd = a.cwd;
   if (a.repo !== undefined) payload.repo = a.repo;
   if (a.branch !== undefined) payload.branch = a.branch;
   if (a.pane !== undefined) payload.pane = a.pane;
   if (a.statusText !== undefined) payload.statusText = a.statusText;
+  if (a.viaPane !== undefined) payload.viaPane = a.viaPane;
+  if (a.room !== undefined) payload.room = a.room;
+  if (a.noRoom !== undefined) payload.noRoom = a.noRoom;
   return rtCommand<Commands["chat:sign-in"]["data"]>("chat:sign-in", payload, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 10_000 });
 }
 
 export function chatSignOut(
-  a: { sessionId: string },
+  a: Commands["chat:sign-out"]["payload"],
   o: RtClientOptions = {},
-): Promise<RtResponse<Record<string, never>>> {
-  return rtCommand<Record<string, never>>("chat:sign-out", { sessionId: a.sessionId }, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 10_000 });
+): Promise<RtResponse<Commands["chat:sign-out"]["data"]>> {
+  const payload: Record<string, unknown> = {};
+  if (a.sessionId !== undefined) payload.sessionId = a.sessionId;
+  if (a.pane !== undefined) payload.pane = a.pane;
+  if (a.viaPane !== undefined) payload.viaPane = a.viaPane;
+  return rtCommand<Commands["chat:sign-out"]["data"]>("chat:sign-out", payload, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 10_000 });
 }
 
 export function chatAway(
@@ -301,22 +271,6 @@ export function chatBuddies(
   return rtCommand<{ buddies: Array<PresenceRow & { status: BuddyStatus }> }>("chat:buddies", {}, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 10_000 });
 }
 
-export function chatPulse(
-  a: { sessionId: string; cwd?: string; repo?: string; branch?: string; pane?: string },
-  o: RtClientOptions = {},
-): Promise<RtResponse<{ unread: { dms: number; mentions: number; rooms: number }; status: BuddyStatus }>> {
-  const payload: Record<string, unknown> = { sessionId: a.sessionId };
-  if (a.cwd !== undefined) payload.cwd = a.cwd;
-  if (a.repo !== undefined) payload.repo = a.repo;
-  if (a.branch !== undefined) payload.branch = a.branch;
-  if (a.pane !== undefined) payload.pane = a.pane;
-  return rtCommand<{ unread: { dms: number; mentions: number; rooms: number }; status: BuddyStatus }>(
-    "chat:pulse",
-    payload,
-    { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 10_000 },
-  );
-}
-
 export function chatDm(
   a: { from: string; to: string; body: string; sessionId?: string },
   o: RtClientOptions = {},
@@ -434,3 +388,12 @@ export function paneSend(
   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 });
 }
+
+/** Brings a herdr pane to the front. The daemon routes this to the tray, which
+    owns the herdr focus and the native terminal-window raise. */
+export function paneFocus(
+  a: Commands["pane:focus"]["payload"],
+  o: RtClientOptions = {},
+): Promise<RtResponse<Commands["pane:focus"]["data"]>> {
+  return rtCommand<Commands["pane:focus"]["data"]>("pane:focus", { paneId: a.paneId }, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 10_000 });
+}

package/src/commands.ts

@@ -92,8 +92,6 @@ export interface ChatMember {
   joinedAt: number;
   lastReadId: number;
   wakeOn: WakeMode;
-  lastSeenAt?: number;
-  armedAt?: number;
   cwd?: string;
   pane?: string;
   /** Presence-joined by chat:who's handler — the only place this type is ever returned, and it always attaches one. */
@@ -130,7 +128,7 @@ export interface RoomSummary {
  * above: mirrors lib/state/presence-store.ts's types, which rt-client
  * cannot import.
  */
-export type BuddyStatus = "live" | "idle" | "deaf" | "offline";
+export type BuddyStatus = "live" | "idle" | "offline";
 
 export interface PresenceRow {
   sessionId: string;
@@ -143,8 +141,6 @@ export interface PresenceRow {
   statusText?: string;
   signedInAt: number;
   lastSeenAt: number;
-  tailSeenAt?: number;
-  armedAt?: number;
   signedOutAt?: number;
 }
 
@@ -170,6 +166,7 @@ export interface InviteResult { paneId: string; delivered: "accepted" | "queued"
 /** 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 interface PaneFocusResult { paneId: string; focused: boolean }
 
 // SKILLS-53: one judgment, computed once in rt, so the console and the tray
 // never derive two verdicts that can disagree.
@@ -223,7 +220,7 @@ export interface AgentRecord {
   id: string; repo: string; cwd: string; provider: string;
   surface: AgentSurface; sessionId: string;
   model?: string; effort?: string; account?: string;
-  label?: string; caller?: string;
+  label?: string; caller?: string; handle?: string;
   paneId?: string; tabId?: string; workspaceId?: string;
   extraArgs?: string; exitCode?: number; resultPath?: string;
   createdAt: number; lastResumedAt?: number; finishedAt?: number;
@@ -293,27 +290,51 @@ export interface Commands {
   "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[] } };
-  "chat:arm": { payload: { handle: string; room?: string; sessionId?: string }; data: Record<string, never> };
-  "chat:touch": { payload: { handle: string; room?: string; sessionId?: string }; data: Record<string, never> };
-  "chat:disarm": { payload: { handle: string; sessionId?: string }; data: Record<string, never> };
-  "chat:unread-waking": { payload: { handle: string; room?: string }; data: { rooms: { room: string; count: number; mentions: number; maxId: number }[] } };
 
   // A session id keys these to one signed-in handle, not a room-membership
   // handle string.
-  /** No `baseHandle` means "draw me a first name": the daemon picks the least recently used pool name no live session holds. */
+  /**
+   * No `baseHandle` means "draw me a first name": the daemon picks the least
+   * recently used pool name no live session holds. `viaPane` resolves
+   * `sessionId` daemon-side from herdr's `session.snapshot` for the pane id
+   * in `pane`, rather than trusting a caller-supplied id -- the caller may
+   * have none of its own (a human or another agent signing a target pane in
+   * on its behalf); the response's `sessionId` and `room` are then the only
+   * way that caller learns what got signed in and joined, since it has
+   * nothing local to derive either from.
+   */
   "chat:sign-in": {
-    payload: { sessionId: string; baseHandle?: string; cwd?: string; repo?: string; branch?: string; pane?: string; statusText?: string };
-    data: { handle: string; baseHandle: string; reclaimed: boolean };
+    payload: {
+      sessionId?: string;
+      baseHandle?: string;
+      cwd?: string;
+      repo?: string;
+      branch?: string;
+      pane?: string;
+      statusText?: string;
+      viaPane?: boolean;
+      /** `viaPane` only: overrides the pane-cwd-derived room outright. */
+      room?: string;
+      /** `viaPane` only: skip room derivation/join entirely, same as --no-room on the non-pane path. */
+      noRoom?: boolean;
+    };
+    data: { handle: string; baseHandle: string; reclaimed: boolean; sessionId: string; room: string | null };
+  };
+  /**
+   * `viaPane` mirrors `chat:sign-in`'s: the daemon resolves `pane` to a
+   * session id via herdr's `session.snapshot` rather than trusting a
+   * caller-supplied one, so a process signing another pane out (herdr-chat,
+   * or a human invoking a target pane) needs neither that pane's session id
+   * nor its own. The response's `sessionId` is the RESOLVED id, the only way
+   * such a caller learns which session file to delete locally.
+   */
+  "chat:sign-out": {
+    payload: { sessionId?: string; pane?: string; viaPane?: boolean };
+    data: { sessionId: string };
   };
-  "chat:sign-out": { payload: { sessionId: string }; data: Record<string, never> };
   "chat:away": { payload: { sessionId: string; text: string }; data: Record<string, never> };
   "chat:back": { payload: { sessionId: string }; data: Record<string, never> };
   "chat:buddies": { payload: Record<string, never>; data: { buddies: Array<PresenceRow & { status: BuddyStatus }> } };
-  /** `unread`'s three fields are disjoint and sum to the true total: `dms` is DM-room waking count; `mentions` is non-DM waking mentions; `rooms` is non-DM waking count minus those mentions (never negative). */
-  "chat:pulse": {
-    payload: { sessionId: string; cwd?: string; repo?: string; branch?: string; pane?: string };
-    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 } };
@@ -333,6 +354,7 @@ export interface Commands {
     data: { pane: ChatPane; ready: boolean };
   };
   "pane:send": { payload: { paneId: string; text: string; callerPane?: string }; data: PaneSendResult };
+  "pane:focus": { payload: { paneId: string }; data: PaneFocusResult };
 }
 
 export type CommandName = keyof Commands;
@@ -358,16 +380,11 @@ export const COMMAND_NAMES: readonly CommandName[] = [
   "chat:who",
   "chat:mark",
   "chat:messages",
-  "chat:arm",
-  "chat:touch",
-  "chat:disarm",
-  "chat:unread-waking",
   "chat:sign-in",
   "chat:sign-out",
   "chat:away",
   "chat:back",
   "chat:buddies",
-  "chat:pulse",
   "chat:dm",
   "chat:archive",
   "chat:dm-open",
@@ -382,4 +399,5 @@ export const COMMAND_NAMES: readonly CommandName[] = [
   "pane:directories",
   "pane:spawn",
   "pane:send",
+  "pane:focus",
 ];

package/src/index.ts

@@ -18,16 +18,11 @@ export {
   chatWho,
   chatMark,
   chatMessages,
-  chatArm,
-  chatTouch,
-  chatDisarm,
-  chatUnreadWaking,
   chatSignIn,
   chatSignOut,
   chatAway,
   chatBack,
   chatBuddies,
-  chatPulse,
   chatDm,
   chatArchive,
   chatDmOpen,
@@ -43,6 +38,7 @@ export {
   paneDirectories,
   chatInvite,
   paneSend,
+  paneFocus,
 } from "./client.ts";
 
 export { COMMAND_NAMES } from "./commands.ts";
@@ -80,6 +76,7 @@ export type {
   InviteResult,
   PaneDelivery,
   PaneSendResult,
+  PaneFocusResult,
 } from "./commands.ts";
 
 export { subscribe, createRelay, DEFAULT_WS_URL } from "./relay.ts";