@mattstack/rt-client 0.11.0 → 0.11.1

package/dist/client.d.ts

@@ -1,5 +1,5 @@
 import type { RtResponse, RtClientOptions } from "./transport.ts";
-import type { DemandDecl, ProjectMRsData, DiscussionsData, MrByBranchData, BranchEnrichment, ForgeSlug, ForgeTokenData, RunSummary, RunDetail, WakeMode, ChatMember, ChatMessage, RoomSummary, BuddyStatus, PresenceRow, AgentRecord, Commands } from "./commands.ts";
+import type { DemandDecl, ProjectMRsData, DiscussionsData, MrByBranchData, BranchEnrichment, ForgeSlug, ForgeTokenData, RunSummary, RunDetail, WakeMode, ChatMember, ChatMessage, ChatClaimOutcome, RoomSummary, BuddyStatus, PresenceRow, AgentRecord, Commands } from "./commands.ts";
 /**
  * One repo's project open-MR store. A cold repo forces a full paginated sync
  * on the daemon side when maxAgeMs demands it, which can run tens of seconds
@@ -59,9 +59,29 @@ export declare function chatPost(a: {
     handle: string;
     body: string;
     mentions?: string[];
+    quiet?: boolean;
 }, o?: RtClientOptions): Promise<RtResponse<{
     id: number;
     recipients: string[];
+    others: number;
+}>>;
+export declare function chatAck(a: {
+    id: number;
+    handle: string;
+}, o?: RtClientOptions): Promise<RtResponse<{
+    author: string;
+    room: string;
+    already: boolean;
+}>>;
+export declare function chatClaim(a: {
+    id: number;
+    handle: string;
+}, o?: RtClientOptions): Promise<RtResponse<ChatClaimOutcome>>;
+export declare function chatRelease(a: {
+    id: number;
+    handle: string;
+}, o?: RtClientOptions): Promise<RtResponse<{
+    holder: string;
 }>>;
 export declare function chatRead(a: {
     handle: string;

package/dist/commands.d.ts

@@ -22,6 +22,10 @@ export interface ProjectMRsScope {
     sections?: string[];
     /** Demanded sections not yet swept for this client. */
     uncoveredSections?: string[];
+    /** Section headers in the default-branch CODEOWNERS at the last deep or
+        backfill. `[]` when the project has none. Absent from a pre-knownSections
+        daemon or before the first sweep that demanded a section. */
+    knownSections?: string[];
 }
 export interface ProjectMRsData {
     mrs: Record<string, {
@@ -113,6 +117,22 @@ export interface ChatMessage {
     replyTo?: number;
     postedAt: number;
 }
+/** `claimed` is the only outcome that woke anyone; `previousHolder` marks a takeover of an expired claim. */
+export type ChatClaimOutcome = {
+    outcome: "claimed";
+    author: string;
+    room: string;
+    previousHolder?: string;
+} | {
+    outcome: "held";
+    author: string;
+    room: string;
+} | {
+    outcome: "lost";
+    holder: string;
+    claimedAt: number;
+    expiresAt: number;
+};
 export interface RoomSummary {
     room: string;
     memberCount: number;
@@ -347,6 +367,15 @@ export interface StatusData {
         dormant: false;
     };
 }
+/** Duplicated shape on purpose: mirrors lib/worktree/ready-held.ts's ReadyHeldRepo. */
+export interface ReadyHeldRepo {
+    /** Serialized repo identity. A key, never displayed. */
+    repo: string;
+    /** Decoded display name. Never sent back as a key. */
+    label: string;
+    hash: string;
+    approveCommand: string;
+}
 export interface TrayStatusData {
     pid: number;
     uptime: number;
@@ -364,6 +393,8 @@ export interface TrayStatusData {
     };
     metrics: HealthMetrics;
     eventLoop: HealthEventLoop;
+    /** Optional because a daemon older than RT-98 does not send it. */
+    worktreeReadyHeld?: ReadyHeldRepo[];
 }
 /** Duplicated shape on purpose: mirrors lib/port-scanner.ts's PortEntry. */
 export interface PortEntry {
@@ -700,16 +731,46 @@ export interface Commands {
         };
         data: Record<string, never>;
     };
+    /** `others` counts the room's members besides the author, so a caller can tell "woke nobody of 7" from "nobody else is here". */
     "chat:post": {
         payload: {
             room: string;
             handle: string;
             body: string;
             mentions?: string[];
+            quiet?: boolean;
         };
         data: {
             id: number;
             recipients: string[];
+            others: number;
+        };
+    };
+    "chat:ack": {
+        payload: {
+            id: number;
+            handle: string;
+        };
+        data: {
+            author: string;
+            room: string;
+            already: boolean;
+        };
+    };
+    "chat:claim": {
+        payload: {
+            id: number;
+            handle: string;
+        };
+        data: ChatClaimOutcome;
+    };
+    "chat:release": {
+        payload: {
+            id: number;
+            handle: string;
+        };
+        data: {
+            holder: string;
         };
     };
     "chat:read": {

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, 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 { readProjectMRs, readDiscussions, readMrsByBranch, readBranchCache, resolveForgeToken, listRuns, getRun, abandonRun, chatJoin, chatLeave, chatAck, chatClaim, chatRelease, 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, PaneFocusResult, } 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, ChatClaimOutcome, 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

@@ -82,8 +82,19 @@ function chatPost(a, o = {}) {
   const payload = { room: a.room, handle: a.handle, body: a.body };
   if (a.mentions !== undefined)
     payload.mentions = a.mentions;
+  if (a.quiet)
+    payload.quiet = true;
   return rtCommand("chat:post", payload, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 1e4 });
 }
+function chatAck(a, o = {}) {
+  return rtCommand("chat:ack", { id: a.id, handle: a.handle }, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 1e4 });
+}
+function chatClaim(a, o = {}) {
+  return rtCommand("chat:claim", { id: a.id, handle: a.handle }, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 1e4 });
+}
+function chatRelease(a, o = {}) {
+  return rtCommand("chat:release", { id: a.id, handle: a.handle }, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 1e4 });
+}
 function chatRead(a, o = {}) {
   const payload = { handle: a.handle };
   if (a.room !== undefined)
@@ -259,6 +270,9 @@ var COMMAND_NAMES = [
   "runs:list",
   "runs:get",
   "runs:abandon",
+  "chat:ack",
+  "chat:claim",
+  "chat:release",
   "chat:join",
   "chat:leave",
   "chat:post",
@@ -1931,6 +1945,7 @@ export {
   chatSignOut,
   chatSignIn,
   chatRooms,
+  chatRelease,
   chatRead,
   chatPost,
   chatMessages,
@@ -1940,10 +1955,12 @@ export {
   chatInvite,
   chatDmOpen,
   chatDm,
+  chatClaim,
   chatBuddies,
   chatBack,
   chatAway,
   chatArchive,
+  chatAck,
   allDefs,
   agentStart,
   agentResume,

package/package.json

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

package/src/client.ts

@@ -18,6 +18,7 @@ import type {
   WakeMode,
   ChatMember,
   ChatMessage,
+  ChatClaimOutcome,
   RoomSummary,
   BuddyStatus,
   PresenceRow,
@@ -166,12 +167,32 @@ export function chatLeave(
 }
 
 export function chatPost(
-  a: { room: string; handle: string; body: string; mentions?: string[] },
+  a: { room: string; handle: string; body: string; mentions?: string[]; quiet?: boolean },
   o: RtClientOptions = {},
-): Promise<RtResponse<{ id: number; recipients: string[] }>> {
+): Promise<RtResponse<{ id: number; recipients: string[]; others: number }>> {
   const payload: Record<string, unknown> = { room: a.room, handle: a.handle, body: a.body };
   if (a.mentions !== undefined) payload.mentions = a.mentions;
-  return rtCommand<{ id: number; recipients: string[] }>("chat:post", payload, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 10_000 });
+  if (a.quiet) payload.quiet = true;
+  return rtCommand<{ id: number; recipients: string[]; others: number }>("chat:post", payload, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 10_000 });
+}
+
+export function chatAck(
+  a: { id: number; handle: string },
+  o: RtClientOptions = {},
+): Promise<RtResponse<{ author: string; room: string; already: boolean }>> {
+  return rtCommand<{ author: string; room: string; already: boolean }>(
+    "chat:ack",
+    { id: a.id, handle: a.handle },
+    { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 10_000 },
+  );
+}
+
+export function chatClaim(a: { id: number; handle: string }, o: RtClientOptions = {}): Promise<RtResponse<ChatClaimOutcome>> {
+  return rtCommand<ChatClaimOutcome>("chat:claim", { id: a.id, handle: a.handle }, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 10_000 });
+}
+
+export function chatRelease(a: { id: number; handle: string }, o: RtClientOptions = {}): Promise<RtResponse<{ holder: string }>> {
+  return rtCommand<{ holder: string }>("chat:release", { id: a.id, handle: a.handle }, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 10_000 });
 }
 
 export function chatRead(

package/src/commands.ts

@@ -25,6 +25,10 @@ export interface ProjectMRsScope {
   sections?: string[];
   /** Demanded sections not yet swept for this client. */
   uncoveredSections?: string[];
+  /** Section headers in the default-branch CODEOWNERS at the last deep or
+      backfill. `[]` when the project has none. Absent from a pre-knownSections
+      daemon or before the first sweep that demanded a section. */
+  knownSections?: string[];
 }
 
 export interface ProjectMRsData {
@@ -108,6 +112,12 @@ export interface ChatMessage {
   postedAt: number;
 }
 
+/** `claimed` is the only outcome that woke anyone; `previousHolder` marks a takeover of an expired claim. */
+export type ChatClaimOutcome =
+  | { outcome: "claimed"; author: string; room: string; previousHolder?: string }
+  | { outcome: "held"; author: string; room: string }
+  | { outcome: "lost"; holder: string; claimedAt: number; expiresAt: number };
+
 export interface RoomSummary {
   room: string;
   memberCount: number;
@@ -254,11 +264,23 @@ export interface StatusData {
   worktreePool: { dormant: true; repos: string[]; message: string } | { dormant: false };
 }
 
+/** Duplicated shape on purpose: mirrors lib/worktree/ready-held.ts's ReadyHeldRepo. */
+export interface ReadyHeldRepo {
+  /** Serialized repo identity. A key, never displayed. */
+  repo: string;
+  /** Decoded display name. Never sent back as a key. */
+  label: string;
+  hash: string;
+  approveCommand: string;
+}
+
 export interface TrayStatusData {
   pid: number; uptime: number; memoryUsage: number; watchedRepos: number; cacheEntries: number;
   portsCached: number; portCacheAge: number | null; lastRefresh: number | null;
   portsByRepo: Record<string, number>; pendingNotifications: number;
   health: { level: HealthLevel; reasons: string[] }; metrics: HealthMetrics; eventLoop: HealthEventLoop;
+  /** Optional because a daemon older than RT-98 does not send it. */
+  worktreeReadyHeld?: ReadyHeldRepo[];
 }
 
 /** Duplicated shape on purpose: mirrors lib/port-scanner.ts's PortEntry. */
@@ -405,7 +427,11 @@ export interface Commands {
   "runs:abandon": { payload: { runId: string; repo?: string; reason?: string }; data: { ok: boolean } };
   "chat:join": { payload: { room: string; handle: string; wakeOn?: WakeMode; cwd?: string; pane?: string }; data: { handle: string; memberCount: number; unread: number } };
   "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[] } };
+  /** `others` counts the room's members besides the author, so a caller can tell "woke nobody of 7" from "nobody else is here". */
+  "chat:post": { payload: { room: string; handle: string; body: string; mentions?: string[]; quiet?: boolean }; data: { id: number; recipients: string[]; others: number } };
+  "chat:ack": { payload: { id: number; handle: string }; data: { author: string; room: string; already: boolean } };
+  "chat:claim": { payload: { id: number; handle: string }; data: ChatClaimOutcome };
+  "chat:release": { payload: { id: number; handle: string }; data: { holder: string } };
   "chat:read": { payload: { handle: string; room?: string; limit?: number; sinceMs?: number }; data: { rooms: { room: string; messages: ChatMessage[] }[] } };
   "chat:rooms": { payload: { handle: string; includeArchived?: boolean }; data: { rooms: RoomSummary[] } };
   "chat:who": { payload: { room: string }; data: { members: ChatMember[] } };
@@ -547,6 +573,9 @@ export const COMMAND_NAMES: readonly CommandName[] = [
   "runs:list",
   "runs:get",
   "runs:abandon",
+  "chat:ack",
+  "chat:claim",
+  "chat:release",
   "chat:join",
   "chat:leave",
   "chat:post",

package/src/index.ts

@@ -12,6 +12,9 @@ export {
   abandonRun,
   chatJoin,
   chatLeave,
+  chatAck,
+  chatClaim,
+  chatRelease,
   chatPost,
   chatRead,
   chatRooms,
@@ -64,6 +67,7 @@ export type {
   WakeMode,
   ChatMember,
   ChatMessage,
+  ChatClaimOutcome,
   RoomSummary,
   BuddyStatus,
   PresenceRow,