@mattstack/rt-client 0.12.0 → 0.14.0

package/dist/client.d.ts

@@ -159,6 +159,11 @@ export declare function chatDmOpen(a: {
 export declare function eventsHead(o?: RtClientOptions): Promise<RtResponse<{
     cursor: number;
 }>>;
+export declare function eventsEmit(topic: string, payload?: unknown, o?: RtClientOptions): Promise<RtResponse<{
+    id: number;
+}>>;
+export declare function eventsWait(payload: Commands["events:wait"]["payload"], o?: RtClientOptions): Promise<RtResponse<Commands["events:wait"]["data"]>>;
+export declare function eventsList(payload: Commands["events:list"]["payload"], o?: RtClientOptions): Promise<RtResponse<Commands["events:list"]["data"]>>;
 export declare function agentStart(a: Commands["agent:start"]["payload"], o?: RtClientOptions): Promise<RtResponse<AgentRecord>>;
 export declare function agentResume(a: Commands["agent:resume"]["payload"], o?: RtClientOptions): Promise<RtResponse<AgentRecord>>;
 export declare function agentGet(a: {

package/dist/commands.d.ts

@@ -185,6 +185,8 @@ export interface ChatPane {
         status: BuddyStatus;
         rooms: string[];
     };
+    /** herdr's per-pane focus flag; false when herdr itself is backgrounded */
+    focused?: boolean;
 }
 export interface PaneAccount {
     slot: number;

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, 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 { 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, eventsEmit, eventsWait, eventsList, 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, 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";

package/dist/index.js

@@ -189,6 +189,18 @@ function chatDmOpen(a, o = {}) {
 function eventsHead(o = {}) {
   return rtCommand("events:head", {}, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 1e4 });
 }
+function eventsEmit(topic, payload, o = {}) {
+  const p = { topic };
+  if (payload !== undefined)
+    p.payload = payload;
+  return rtCommand("events:emit", p, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 1e4 });
+}
+function eventsWait(payload, o = {}) {
+  return rtCommand("events:wait", payload, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 250000 });
+}
+function eventsList(payload, o = {}) {
+  return rtCommand("events:list", payload, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 1e4 });
+}
 function agentStart(a, o = {}) {
   const payload = { repo: a.repo, cwd: a.cwd };
   for (const k of ["prompt", "surface", "model", "effort", "account", "label", "caller", "workspace", "tab", "extraArgs"]) {
@@ -618,6 +630,14 @@ var REGISTRY = [
     migrated: true,
     description: "Desktop notification preferences (which events notify, sound on/off)."
   },
+  {
+    key: "rt.notify.eventBridges",
+    type: "array",
+    scopes: ["user"],
+    default: [],
+    merge: "replace",
+    description: "Event-bus glob rules that raise a desktop notification: [{pattern, category, title, message}]. pattern is matched against the events-bus topic (Bun.Glob semantics); title/message may interpolate `{field}` from the event payload. A fresh key, not an ownership-latch port, so a default is fine here."
+  },
   {
     key: "rt.cron",
     type: "object",
@@ -935,6 +955,13 @@ var REGISTRY = [
     merge: "replace",
     description: "Days of MR inactivity before the board flags it stale, for this developer."
   },
+  {
+    key: "board.gateGraceMinutes",
+    type: "number",
+    scopes: ["user"],
+    merge: "replace",
+    description: "Minutes an unanswered review gate stays open before the board parks the review (closes the pane, keeps the gate open). Default 90."
+  },
   {
     key: "board.workspaces",
     type: "object",
@@ -964,11 +991,25 @@ var REGISTRY = [
     description: "This developer's triage user-intent flags (which triage sweeps run automatically); a sibling flat key of board.triage.doctorSkill, not its container — the board reader assembles the two independently."
   },
   {
-    key: "board.claudeCommand",
+    key: "board.agent.account",
     type: "string",
-    scopes: ["machine"],
+    scopes: ["user", "machine"],
+    merge: "replace",
+    description: "cswap account the board's review/respond/doctor panes launch under; unset uses the default claude profile. Replaces the retired board.claudeCommand."
+  },
+  {
+    key: "board.agent.model",
+    type: "string",
+    scopes: ["user", "machine"],
+    merge: "replace",
+    description: "Default --model for the board's review/respond/doctor panes; unset omits the flag."
+  },
+  {
+    key: "board.agent.effort",
+    type: "string",
+    scopes: ["user", "machine"],
     merge: "replace",
-    description: "Local command used to launch Claude Code for the board's review/respond/doctor panes."
+    description: "Default --effort for the board's review/respond/doctor panes; unset omits the flag."
   },
   {
     key: "board.cwds",
@@ -1992,7 +2033,10 @@ export {
   getDef,
   explainSetting,
   expandVariables,
+  eventsWait,
+  eventsList,
   eventsHead,
+  eventsEmit,
   deriveRepoIdentity,
   decidePlacement,
   daemonHealth,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mattstack/rt-client",
-  "version": "0.12.0",
+  "version": "0.14.0",
   "type": "module",
   "exports": {
     ".": {
@@ -18,7 +18,7 @@
     "./test/fake-daemon.ts": "./test/fake-daemon.ts"
   },
   "peerDependencies": {
-    "@mattstack/glance": ">=0.13.0"
+    "@mattstack/glance": ">=0.23.0"
   },
   "dependencies": {
     "jsonc-parser": "^3.3.1"

package/src/client.ts

@@ -325,6 +325,30 @@ export function eventsHead(o: RtClientOptions = {}): Promise<RtResponse<{ cursor
   return rtCommand<{ cursor: number }>("events:head", {}, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 10_000 });
 }
 
+export function eventsEmit(
+  topic: string,
+  payload?: unknown,
+  o: RtClientOptions = {},
+): Promise<RtResponse<{ id: number }>> {
+  const p: Record<string, unknown> = { topic };
+  if (payload !== undefined) p.payload = payload;
+  return rtCommand<{ id: number }>("events:emit", p, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 10_000 });
+}
+
+export function eventsWait(
+  payload: Commands["events:wait"]["payload"],
+  o: RtClientOptions = {},
+): Promise<RtResponse<Commands["events:wait"]["data"]>> {
+  return rtCommand<Commands["events:wait"]["data"]>("events:wait", payload, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 250_000 });
+}
+
+export function eventsList(
+  payload: Commands["events:list"]["payload"],
+  o: RtClientOptions = {},
+): Promise<RtResponse<Commands["events:list"]["data"]>> {
+  return rtCommand<Commands["events:list"]["data"]>("events:list", payload, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 10_000 });
+}
+
 // ─── Agent handoff (rt agent) ─────────────────────────────────────────────
 
 export function agentStart(

package/src/commands.ts

@@ -167,6 +167,8 @@ export interface ChatPane {
   agentStatus: AgentStatus;
   sessionId?: string;
   presence?: { handle: string; status: BuddyStatus; rooms: string[] };
+  /** herdr's per-pane focus flag; false when herdr itself is backgrounded */
+  focused?: boolean;
 }
 
 export interface PaneAccount { slot: number; email: string; alias?: string; headroom?: string }

package/src/index.ts

@@ -30,6 +30,9 @@ export {
   chatArchive,
   chatDmOpen,
   eventsHead,
+  eventsEmit,
+  eventsWait,
+  eventsList,
   agentStart,
   agentResume,
   agentGet,

package/src/settings/registry-defs.ts

@@ -79,6 +79,14 @@ export const REGISTRY: readonly SettingDef[] = [
     migrated: true,
     description: "Desktop notification preferences (which events notify, sound on/off).",
   },
+  {
+    key: "rt.notify.eventBridges",
+    type: "array",
+    scopes: ["user"],
+    default: [],
+    merge: "replace",
+    description: "Event-bus glob rules that raise a desktop notification: [{pattern, category, title, message}]. pattern is matched against the events-bus topic (Bun.Glob semantics); title/message may interpolate `{field}` from the event payload. A fresh key, not an ownership-latch port, so a default is fine here.",
+  },
   {
     key: "rt.cron",
     type: "object",
@@ -421,6 +429,13 @@ export const REGISTRY: readonly SettingDef[] = [
     merge: "replace",
     description: "Days of MR inactivity before the board flags it stale, for this developer.",
   },
+  {
+    key: "board.gateGraceMinutes",
+    type: "number",
+    scopes: ["user"],
+    merge: "replace",
+    description: "Minutes an unanswered review gate stays open before the board parks the review (closes the pane, keeps the gate open). Default 90.",
+  },
   {
     key: "board.workspaces",
     type: "object",
@@ -452,11 +467,25 @@ export const REGISTRY: readonly SettingDef[] = [
 
   // --- board (machine) ---------------------------------------------------
   {
-    key: "board.claudeCommand",
+    key: "board.agent.account",
     type: "string",
-    scopes: ["machine"],
+    scopes: ["user", "machine"],
+    merge: "replace",
+    description: "cswap account the board's review/respond/doctor panes launch under; unset uses the default claude profile. Replaces the retired board.claudeCommand.",
+  },
+  {
+    key: "board.agent.model",
+    type: "string",
+    scopes: ["user", "machine"],
+    merge: "replace",
+    description: "Default --model for the board's review/respond/doctor panes; unset omits the flag.",
+  },
+  {
+    key: "board.agent.effort",
+    type: "string",
+    scopes: ["user", "machine"],
     merge: "replace",
-    description: "Local command used to launch Claude Code for the board's review/respond/doctor panes.",
+    description: "Default --effort for the board's review/respond/doctor panes; unset omits the flag.",
   },
   {
     key: "board.cwds",