@mattstack/rt-client 0.11.1 → 0.13.0

package/README.md

@@ -111,6 +111,10 @@ 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`.
 
+## Runs
+
+`RunStageRow.status` is one of `running | done | failed | redirected`; `rt runs stage-redirect` writes the fourth when the work engine leaves a stage for another one, so a reader that maps statuses to icons or filters must handle all four.
+
 ## License
 
 MIT

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"]) {
@@ -816,6 +828,13 @@ var REGISTRY = [
     migrated: true,
     description: "User-confirmed integration hosts (forgeHost, switchboardUrl), written only by an explicit `rt setup <id> connect --host` after that host validates a real credential. The one trusted source a credential is ever sent to — mattstack.integrations' team-declared host is shown to the user but never auto-used for a fetch."
   },
+  {
+    key: "mattstack.roster",
+    type: "array",
+    scopes: ["team"],
+    merge: "replace",
+    description: "The suite-wide team roster: [{username, name?}] GitLab usernames with optional display names. Any suite app that lists people reads this; hiding someone is the app's own overlay (e.g. boxscore.hiddenMembers)."
+  },
   {
     key: "claude.marketplaces",
     type: "array",
@@ -870,7 +889,7 @@ var REGISTRY = [
     type: "array",
     scopes: ["team"],
     merge: "replace",
-    description: "The authors tab's roster: whose MRs the classic board lists, including hidden-by-default entries. Codeowners tabs list MRs from anyone."
+    description: "The authors tab's roster: whose MRs the classic board lists, including hidden-by-default entries. Codeowners tabs list MRs from anyone. The cross-app roster successor is mattstack.roster; this key remains the board's own list until the board adopts it."
   },
   {
     key: "board.title",
@@ -970,13 +989,6 @@ var REGISTRY = [
     merge: "deep",
     description: "Local working directories the board's review/respond/doctor panes launch from."
   },
-  {
-    key: "board.rtRepos",
-    type: "array",
-    scopes: ["machine"],
-    merge: "replace",
-    description: "rt-registered repo names the board resolves MRs against on this machine."
-  },
   {
     key: "board.triageMaxConcurrent",
     type: "number",
@@ -991,6 +1003,62 @@ var REGISTRY = [
     merge: "replace",
     description: "Local switchboard URL the board's POST /peer/join writer targets."
   },
+  {
+    key: "boxscore.projects",
+    type: "array",
+    scopes: ["team"],
+    merge: "replace",
+    description: 'GitLab projects boxscore scores, as full paths ("group/project").'
+  },
+  {
+    key: "boxscore.linearDoneStates",
+    type: "array",
+    scopes: ["team"],
+    merge: "replace",
+    description: "Linear workflow state names that count as done. Empty means the completed and canceled state types."
+  },
+  {
+    key: "boxscore.sizeBand",
+    type: "object",
+    scopes: ["team"],
+    merge: "deep",
+    description: "MR size health band in changed lines: {tooSmall, tooLarge}. At or below tooSmall, or above tooLarge, is outside the healthy band."
+  },
+  {
+    key: "boxscore.excludeFilePatterns",
+    type: "array",
+    scopes: ["team"],
+    merge: "replace",
+    description: 'Glob patterns for files excluded from addition/deletion counts (e.g. "**/*.json").'
+  },
+  {
+    key: "boxscore.ignoredMrs",
+    type: "array",
+    scopes: ["team"],
+    merge: "replace",
+    description: 'MRs excluded from all metrics: "!123" or "group/project!123".'
+  },
+  {
+    key: "boxscore.botPatterns",
+    type: "array",
+    scopes: ["team"],
+    merge: "replace",
+    description: "Extra regex sources treated as bot accounts, beyond boxscore's built-in detection."
+  },
+  {
+    key: "boxscore.hiddenMembers",
+    type: "array",
+    scopes: ["user"],
+    merge: "replace",
+    description: "Usernames from mattstack.roster hidden from this developer's leaderboard."
+  },
+  {
+    key: "boxscore.defaultRange",
+    type: "string",
+    scopes: ["user"],
+    merge: "replace",
+    description: 'Default comparison window for the API and CLI when none is given: "7d", "30d", or "90d".'
+  },
   {
     key: "gitq.workSlots",
     type: "object",
@@ -1032,7 +1100,8 @@ var REGISTRY = [
     type: "string",
     scopes: ["user"],
     merge: "replace",
-    description: "Base URL of the chat viewer, no trailing slash. When set, rt chat post and the tail's wake lines end with a link to the room or message."
+    default: "https://chat.mattstack",
+    description: "Base URL of the chat viewer, no trailing slash; rt chat post and the tail's wake lines end with a link to the room or message. Defaults to the viewer deck serves on the mattstack TLD."
   },
   {
     key: "chat.herdrWorkspace",
@@ -1935,7 +2004,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.11.1",
+  "version": "0.13.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

@@ -288,6 +288,16 @@ export const REGISTRY: readonly SettingDef[] = [
       "User-confirmed integration hosts (forgeHost, switchboardUrl), written only by an explicit `rt setup <id> connect --host` after that host validates a real credential. The one trusted source a credential is ever sent to — mattstack.integrations' team-declared host is shown to the user but never auto-used for a fetch.",
   },
 
+  // --- mattstack (shared team truth) ---------------------------------------
+  {
+    key: "mattstack.roster",
+    type: "array",
+    scopes: ["team"],
+    merge: "replace",
+    description:
+      "The suite-wide team roster: [{username, name?}] GitLab usernames with optional display names. Any suite app that lists people reads this; hiding someone is the app's own overlay (e.g. boxscore.hiddenMembers).",
+  },
+
   // --- claude (installer-lane) --------------------------------------------
   {
     key: "claude.marketplaces",
@@ -351,7 +361,7 @@ export const REGISTRY: readonly SettingDef[] = [
     type: "array",
     scopes: ["team"],
     merge: "replace",
-    description: "The authors tab's roster: whose MRs the classic board lists, including hidden-by-default entries. Codeowners tabs list MRs from anyone.",
+    description: "The authors tab's roster: whose MRs the classic board lists, including hidden-by-default entries. Codeowners tabs list MRs from anyone. The cross-app roster successor is mattstack.roster; this key remains the board's own list until the board adopts it.",
   },
   {
     key: "board.title",
@@ -455,13 +465,6 @@ export const REGISTRY: readonly SettingDef[] = [
     merge: "deep",
     description: "Local working directories the board's review/respond/doctor panes launch from.",
   },
-  {
-    key: "board.rtRepos",
-    type: "array",
-    scopes: ["machine"],
-    merge: "replace",
-    description: "rt-registered repo names the board resolves MRs against on this machine.",
-  },
   {
     key: "board.triageMaxConcurrent",
     type: "number",
@@ -477,6 +480,66 @@ export const REGISTRY: readonly SettingDef[] = [
     description: "Local switchboard URL the board's POST /peer/join writer targets.",
   },
 
+  // --- boxscore -------------------------------------------------------------
+  // No `default` on any boxscore row: fallbacks live in boxscore's app-side
+  // read (server/config), so an unset key resolves as absent here.
+  {
+    key: "boxscore.projects",
+    type: "array",
+    scopes: ["team"],
+    merge: "replace",
+    description: "GitLab projects boxscore scores, as full paths (\"group/project\").",
+  },
+  {
+    key: "boxscore.linearDoneStates",
+    type: "array",
+    scopes: ["team"],
+    merge: "replace",
+    description: "Linear workflow state names that count as done. Empty means the completed and canceled state types.",
+  },
+  {
+    key: "boxscore.sizeBand",
+    type: "object",
+    scopes: ["team"],
+    merge: "deep",
+    description: "MR size health band in changed lines: {tooSmall, tooLarge}. At or below tooSmall, or above tooLarge, is outside the healthy band.",
+  },
+  {
+    key: "boxscore.excludeFilePatterns",
+    type: "array",
+    scopes: ["team"],
+    merge: "replace",
+    description: "Glob patterns for files excluded from addition/deletion counts (e.g. \"**/*.json\").",
+  },
+  {
+    key: "boxscore.ignoredMrs",
+    type: "array",
+    scopes: ["team"],
+    merge: "replace",
+    description: "MRs excluded from all metrics: \"!123\" or \"group/project!123\".",
+  },
+  {
+    key: "boxscore.botPatterns",
+    type: "array",
+    scopes: ["team"],
+    merge: "replace",
+    description: "Extra regex sources treated as bot accounts, beyond boxscore's built-in detection.",
+  },
+  {
+    key: "boxscore.hiddenMembers",
+    type: "array",
+    scopes: ["user"],
+    merge: "replace",
+    description: "Usernames from mattstack.roster hidden from this developer's leaderboard.",
+  },
+  {
+    key: "boxscore.defaultRange",
+    type: "string",
+    scopes: ["user"],
+    merge: "replace",
+    description: "Default comparison window for the API and CLI when none is given: \"7d\", \"30d\", or \"90d\".",
+  },
+
   // --- gitq ------------------------------------------------------------------
   {
     key: "gitq.workSlots",
@@ -521,7 +584,8 @@ export const REGISTRY: readonly SettingDef[] = [
     type: "string",
     scopes: ["user"],
     merge: "replace",
-    description: "Base URL of the chat viewer, no trailing slash. When set, rt chat post and the tail's wake lines end with a link to the room or message.",
+    default: "https://chat.mattstack",
+    description: "Base URL of the chat viewer, no trailing slash; rt chat post and the tail's wake lines end with a link to the room or message. Defaults to the viewer deck serves on the mattstack TLD.",
   },
   {
     key: "chat.herdrWorkspace",