@mattstack/rt-client 0.19.1 → 0.21.0

package/README.md

@@ -104,6 +104,7 @@ const stop = createRelay({                                     // one daemon sub
 | `chatPost` / `chatDm` / `chatDmOpen` / `chatRead` / `chatMessages` / `chatMark` | messages: post, DM, open a DM room without posting, read-and-advance, page, advance the cursor |
 | `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` |
+| `paneSend` | type a line into a pane; `accepted`, `queued` or `refused`, plus an optional `continuation` the daemon types once the pane's turn has ended |
 | `createRelay` / `subscribe` | the event stream; `daemonHealth` the reachability probe |
 
 Pass `{ sockPath }` as the trailing options to reach a non-default daemon

package/dist/client.d.ts

@@ -183,6 +183,9 @@ export declare function paneSend(a: Commands["pane:send"]["payload"], o?: RtClie
 /** 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"]>>;
+/** Never triggers a sweep; a plain read of the last one's snapshot. */
+export declare function reconcilerStatus(o?: RtClientOptions): Promise<RtResponse<Commands["reconciler:status"]["data"]>>;
+export declare function reconcilerClear(a: Commands["reconciler:clear"]["payload"], o?: RtClientOptions): Promise<RtResponse<Commands["reconciler:clear"]["data"]>>;
 export declare function gateOpen(a: Commands["gate:open"]["payload"], o?: RtClientOptions): Promise<RtResponse<Commands["gate:open"]["data"]>>;
 export declare function gateAnswer(a: Commands["gate:answer"]["payload"], o?: RtClientOptions): Promise<RtResponse<Commands["gate:answer"]["data"]>>;
 /** Daemon clamps its own wait to 240s (gates-store.ts); the client abort

package/dist/commands.d.ts

@@ -102,6 +102,8 @@ export interface EventsBusEvent {
     value gates-store.ts's release tracking (CAS winner or loser) reacts to. */
 export declare const GATE_BY_PANE = "pane";
 export type GateStatus = "open" | "answered" | "parked" | "closed";
+/** Reconciler's view of an agent's liveness; also the value `GateRow.executor` is stamped with. */
+export type ExecutorState = "live" | "blocked" | "hidden" | "gone" | "cleared" | "unknown";
 export type GateOption = string | {
     value: string;
     label: string;
@@ -111,6 +113,7 @@ export interface GateOrigin {
     tabId?: string;
     runId?: string;
     worktree?: string;
+    surface?: string;
     presentation?: "form" | "wait";
 }
 export interface GateQuestion {
@@ -143,7 +146,10 @@ export interface GateRow {
     openedAt: number;
     parkedAt: number | null;
     closedAt: number | null;
-    closedReason: "abandoned" | "superseded" | "pruned" | null;
+    /** "resolved" is stamped only by the reconciler's auto-recovery close
+        (a blocked/gone pane came back); every other closer uses one of the
+        other three. */
+    closedReason: "abandoned" | "superseded" | "pruned" | "resolved" | null;
     /** Set only when `closedReason` is "superseded": the id of the gate that superseded this one. */
     supersededBy: string | null;
     agent: string | null;
@@ -152,12 +158,17 @@ export interface GateRow {
         session: string;
     } | null;
     delivery: {
-        outcome: "delivered" | "dead-pane";
+        outcome: "delivered" | "dead-pane" | "confirmed" | "stuck";
         at: number;
     } | null;
     released: boolean;
     owner: string | null;
     escalatedAt: number | null;
+    /** Set by answer-time execution handling: an answered gate whose executor
+        couldn't be resumed. Cleared (absent) once resumption succeeds. */
+    execution?: "unassigned";
+    /** Stamped by the reconciler sweep for open/parked rows only. */
+    executor?: ExecutorState;
 }
 export interface GateSubscription {
     id: string;
@@ -213,7 +224,7 @@ export interface HerdStatusData {
         openGate: string | null;
         paneStatus: string | null;
         lastGateStatus: GateStatus | null;
-        lastGateDelivery: "delivered" | "dead-pane" | null;
+        lastGateDelivery: "delivered" | "dead-pane" | "confirmed" | "stuck" | null;
     }>;
     unread: number;
     lifecycleConnected: boolean;
@@ -345,10 +356,14 @@ export interface InviteResult {
 }
 /** Duplicated shape on purpose: mirrors lib/daemon/inject.ts's InjectResult. */
 export type PaneDelivery = "accepted" | "queued" | "refused";
+/** `continuation` is present only when the daemon scheduled a second line for after the target's current turn. */
 export interface PaneSendResult {
     paneId: string;
     delivered: PaneDelivery;
     reason?: string;
+    continuation?: {
+        delivered: "deferred";
+    };
 }
 /** `attendTab` is set only for a `bg:` ref: focus for a background pane IS
     the attend flow (a visible tab running a terminal attach), and this is
@@ -431,6 +446,23 @@ export interface RunDetail {
     schemaAhead: boolean;
 }
 export type AgentSurface = "herdr" | "headless";
+/** The reconciler's per-agent snapshot: one row per agent it knows about, live or not. */
+export interface ExecutorView {
+    agentId: string;
+    repo: string | null;
+    subject: string | null;
+    surface: AgentSurface;
+    sessionId: string;
+    paneRef: string | null;
+    state: ExecutorState;
+    since: number;
+    openGateIds: string[];
+}
+export interface ReconcilerStatus {
+    sweptAt: number;
+    herdrReachable: boolean;
+    executors: ExecutorView[];
+}
 export interface AgentRecord {
     id: string;
     repo: string;
@@ -444,6 +476,12 @@ export interface AgentRecord {
     label?: string;
     caller?: string;
     handle?: string;
+    /** The gate-protocol subject stamped as RT_GATE_SUBJECT at launch. Left
+        undefined when the caller passed none (RT_GATE_SUBJECT still falls
+        back to "agent:<id>" at launch time); an explicit value is persisted
+        so a resume re-stamps the same one, AND gates whether the gate-fork
+        PreToolUse hook gets injected at all. */
+    subject?: string;
     paneId?: string;
     tabId?: string;
     workspaceId?: string;
@@ -1096,6 +1134,7 @@ export interface Commands {
             herdrSocket?: string;
             handle?: string;
             bg?: boolean;
+            subject?: string;
         };
         data: AgentRecord;
     };
@@ -1182,6 +1221,7 @@ export interface Commands {
             paneId: string;
             text: string;
             callerPane?: string;
+            continuation?: string;
         };
         data: PaneSendResult;
     };
@@ -1360,6 +1400,20 @@ export interface Commands {
         payload: Record<string, never>;
         data: unknown;
     };
+    /** Read-only: the last sweep's snapshot. Never triggers a sweep itself. */
+    "reconciler:status": {
+        payload: Record<string, never>;
+        data: ReconcilerStatus;
+    };
+    /** Manual override: marks the agent cleared and closes its open/parked gates (reconciler.ts's clear()). */
+    "reconciler:clear": {
+        payload: {
+            agentId: string;
+        };
+        data: {
+            cleared: true;
+        };
+    };
     "gate:open": {
         payload: {
             subject: string;

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, 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, gateOpen, gateAnswer, gateWait, gateList, gatePark, gateClose, gateSubscribe, gateUnsubscribe, gateSubscriptions, herdStart, herdSpawn, herdAsk, herdMilestone, herdAnswer, herdReport, herdGates, herdStatus, herdList, herdResume, herdClose, herdAttend, herdWrapUp, herdStopHidden, bgEnsure, bgStatus, bgStop, bgRelease, } 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, reconcilerStatus, reconcilerClear, gateOpen, gateAnswer, gateWait, gateList, gatePark, gateClose, gateSubscribe, gateUnsubscribe, gateSubscriptions, herdStart, herdSpawn, herdAsk, herdMilestone, herdAnswer, herdReport, herdGates, herdStatus, herdList, herdResume, herdClose, herdAttend, herdWrapUp, herdStopHidden, bgEnsure, bgStatus, bgStop, bgRelease, } from "./client.ts";
 export { COMMAND_NAMES, GATE_BY_PANE, gateOptionValue, gateOptionLabel } 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, GateStatus, GateOption, GateOrigin, GateQuestion, GateAnswer, GateRow, GateSubscription, HerdInfo, HerdListRow, HerdJobInfo, HerdStatusData, } 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, ExecutorState, ExecutorView, ReconcilerStatus, ChatPane, PaneAccount, PaneDirectory, InviteResult, PaneDelivery, PaneSendResult, PaneFocusResult, GateStatus, GateOption, GateOrigin, GateQuestion, GateAnswer, GateRow, GateSubscription, HerdInfo, HerdListRow, HerdJobInfo, HerdStatusData, } 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

@@ -5,7 +5,7 @@ var __require = /* @__PURE__ */ createRequire(import.meta.url);
 import { homedir } from "os";
 import { join } from "path";
 function defaultSock() {
-  return join(process.env.HOME ?? homedir(), ".mattstack", "rt", "rt.sock");
+  return process.env.RT_DAEMON_SOCK || join(process.env.HOME ?? homedir(), ".mattstack", "rt", "rt.sock");
 }
 var DEFAULT_SOCK = defaultSock();
 async function rtCommand(cmd, payload, opts = {}) {
@@ -205,7 +205,7 @@ function eventsList(payload, o = {}) {
 }
 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", "env", "herdrSocket", "handle", "bg"]) {
+  for (const k of ["prompt", "surface", "model", "effort", "account", "label", "caller", "workspace", "tab", "extraArgs", "env", "herdrSocket", "handle", "bg", "subject"]) {
     if (a[k] !== undefined)
       payload[k] = a[k];
   }
@@ -265,6 +265,8 @@ function paneSend(a, o = {}) {
   const payload = { paneId: a.paneId, text: a.text };
   if (a.callerPane !== undefined)
     payload.callerPane = a.callerPane;
+  if (a.continuation !== undefined)
+    payload.continuation = a.continuation;
   return rtCommand("pane:send", payload, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 30000 });
 }
 function paneFocus(a, o = {}) {
@@ -273,6 +275,12 @@ function paneFocus(a, o = {}) {
     payload.callerWorkspace = a.callerWorkspace;
   return rtCommand("pane:focus", payload, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 1e4 });
 }
+function reconcilerStatus(o = {}) {
+  return rtCommand("reconciler:status", {}, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 1e4 });
+}
+function reconcilerClear(a, o = {}) {
+  return rtCommand("reconciler:clear", { agentId: a.agentId }, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 1e4 });
+}
 function gateOpen(a, o = {}) {
   const payload = { subject: a.subject, kind: a.kind, questions: a.questions };
   for (const k of ["meta", "agent", "pane", "nudge", "context", "origin"])
@@ -478,6 +486,8 @@ var COMMAND_NAMES = [
   "endpoint:status",
   "repos:locate",
   "freshness:reconcile",
+  "reconciler:status",
+  "reconciler:clear",
   "gate:open",
   "gate:answer",
   "gate:wait",
@@ -830,7 +840,7 @@ var REGISTRY = [
     scopes: ["user"],
     default: [],
     merge: "replace",
-    description: 'Event-bus glob rules that raise a desktop notification: [{pattern, category, title, message, subjectPrefix?, url?, owner?}]. pattern is matched against the events-bus topic (Bun.Glob semantics); title/message may interpolate `{field}` from the event payload, plus the computed `{question}` field (the event payload\'s first question label, `payload.questions[0].label`, empty string when absent); optional subjectPrefix matches the event payload\'s subject as a prefix. The optional url is interpolated the same way as title/message and becomes the notification\'s Open target; a gate rule should set it. The optional owner field (only literal "human" is valid) suppresses events whose payload.owner starts with "herd:", allowing gate rules to skip herd-owned events. A typical setup pairs a gate/opened rule with owner: "human" (human-owned gates notify) and a gate/escalated rule without owner (all escalations notify, whether human or herd). A fresh key, not an ownership-latch port, so a default is fine here.'
+    description: 'Event-bus glob rules that raise a desktop notification: [{pattern, category, title, message, subjectPrefix?, url?, owner?, surface?}]. pattern is matched against the events-bus topic (Bun.Glob semantics); title/message may interpolate `{field}` from the event payload, plus the computed `{question}` field (the event payload\'s first question label, `payload.questions[0].label`, empty string when absent); optional subjectPrefix matches the event payload\'s subject as a prefix. The optional url is interpolated the same way as title/message and becomes the notification\'s Open target; a gate rule should set it. The optional owner field (only literal "human" is valid) suppresses events whose payload.owner starts with "herd:", allowing gate rules to skip herd-owned events. The optional surface field (a string) matches only events whose payload.origin.surface equals the given value, allowing a rule to fire only for gates opened by a specific surface (e.g. surface: "board" matches only board-originated gates). A typical setup pairs a gate/opened rule with owner: "human" (human-owned gates notify) and a gate/escalated rule without owner (all escalations notify, whether human or herd). A board-specific rule can combine surface: "board" with a board URL to open the decision queue directly. A fresh key, not an ownership-latch port, so a default is fine here.'
   },
   {
     key: "rt.cron",
@@ -1031,6 +1041,14 @@ var REGISTRY = [
     merge: "replace",
     description: 'The machine\'s intended flavor, "dev" or "prod". Normally written by `rt settings dev-mode` after a successful handoff; a manual `rt settings set` is the blessed repair escape hatch — the daemon park loop converges on whatever this says. Unset ⇒ derived from the dev wrapper\'s presence.'
   },
+  {
+    key: "setup.waived",
+    type: "array",
+    scopes: ["machine"],
+    default: [],
+    merge: "replace",
+    description: "Finish-gated setup rows the user skipped on this Mac through `rt setup waive` (today only tool.fast-browser-extension); the wizard's Finish no longer waits on them. Machine-only: a loaded Chrome extension is a per-profile fact and the choice is per machine, so it never travels with a team or user store."
+  },
   {
     key: "rt.integrations",
     type: "object",
@@ -2253,6 +2271,8 @@ export {
   resolveNameToIdentity,
   resolveForgeToken,
   repoNameForPath,
+  reconcilerStatus,
+  reconcilerClear,
   readStore,
   readProjectMRs,
   readMrsByBranch,

package/package.json

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

package/src/client.ts

@@ -356,7 +356,7 @@ export function agentStart(
   a: Commands["agent:start"]["payload"], o: RtClientOptions = {},
 ): Promise<RtResponse<AgentRecord>> {
   const payload: Record<string, unknown> = { repo: a.repo, cwd: a.cwd };
-  for (const k of ["prompt", "surface", "model", "effort", "account", "label", "caller", "workspace", "tab", "extraArgs", "env", "herdrSocket", "handle", "bg"] as const) {
+  for (const k of ["prompt", "surface", "model", "effort", "account", "label", "caller", "workspace", "tab", "extraArgs", "env", "herdrSocket", "handle", "bg", "subject"] as const) {
     if (a[k] !== undefined) payload[k] = a[k];
   }
   return rtCommand<AgentRecord>("agent:start", payload, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 30_000 });
@@ -432,6 +432,7 @@ export function paneSend(
 ): 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;
+  if (a.continuation !== undefined) payload.continuation = a.continuation;
   return rtCommand<Commands["pane:send"]["data"]>("pane:send", payload, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 30_000 });
 }
 
@@ -446,6 +447,20 @@ export function paneFocus(
   return rtCommand<Commands["pane:focus"]["data"]>("pane:focus", payload, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 10_000 });
 }
 
+// ─── Reconciler (executor state; lib/daemon/reconciler.ts) ────────────────
+
+/** Never triggers a sweep; a plain read of the last one's snapshot. */
+export function reconcilerStatus(o: RtClientOptions = {}): Promise<RtResponse<Commands["reconciler:status"]["data"]>> {
+  return rtCommand<Commands["reconciler:status"]["data"]>("reconciler:status", {}, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 10_000 });
+}
+
+export function reconcilerClear(
+  a: Commands["reconciler:clear"]["payload"],
+  o: RtClientOptions = {},
+): Promise<RtResponse<Commands["reconciler:clear"]["data"]>> {
+  return rtCommand<Commands["reconciler:clear"]["data"]>("reconciler:clear", { agentId: a.agentId }, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 10_000 });
+}
+
 // ─── Gates (BOARD-20/21 gate facility) ─────────────────────────────────────
 
 export function gateOpen(

package/src/commands.ts

@@ -95,12 +95,15 @@ export interface EventsBusEvent { id: number; topic: string; payload: unknown; e
 export const GATE_BY_PANE = "pane";
 
 export type GateStatus = "open" | "answered" | "parked" | "closed";
+/** Reconciler's view of an agent's liveness; also the value `GateRow.executor` is stamped with. */
+export type ExecutorState = "live" | "blocked" | "hidden" | "gone" | "cleared" | "unknown";
 export type GateOption = string | { value: string; label: string };
 export interface GateOrigin {
   paneId?: string;
   tabId?: string;
   runId?: string;
   worktree?: string;
+  surface?: string;
   presentation?: "form" | "wait";
 }
 export interface GateQuestion { id: string; label: string; multi: boolean; options: GateOption[] }
@@ -118,15 +121,23 @@ export interface GateRow {
   origin?: GateOrigin | null;
   status: GateStatus; answer: GateAnswer | null;
   openedAt: number; parkedAt: number | null; closedAt: number | null;
-  closedReason: "abandoned" | "superseded" | "pruned" | null;
+  /** "resolved" is stamped only by the reconciler's auto-recovery close
+      (a blocked/gone pane came back); every other closer uses one of the
+      other three. */
+  closedReason: "abandoned" | "superseded" | "pruned" | "resolved" | null;
   /** Set only when `closedReason` is "superseded": the id of the gate that superseded this one. */
   supersededBy: string | null;
   agent: string | null; pane: string | null;
   nudge: { session: string } | null;
-  delivery: { outcome: "delivered" | "dead-pane"; at: number } | null;
+  delivery: { outcome: "delivered" | "dead-pane" | "confirmed" | "stuck"; at: number } | null;
   released: boolean;
   owner: string | null;
   escalatedAt: number | null;
+  /** Set by answer-time execution handling: an answered gate whose executor
+      couldn't be resumed. Cleared (absent) once resumption succeeds. */
+  execution?: "unassigned";
+  /** Stamped by the reconciler sweep for open/parked rows only. */
+  executor?: ExecutorState;
 }
 
 export interface GateSubscription {
@@ -147,7 +158,7 @@ export interface HerdJobInfo { herd: string; name: string; worktree: string; bra
 /** `lastGateStatus`/`lastGateDelivery` come from the job's `lastGate` row: an `answered` gate whose delivery is `dead-pane` is the "answered, worker not woken" case the shepherd must act on. */
 export interface HerdStatusData {
   herd: HerdInfo;
-  jobs: Array<HerdJobInfo & { openGate: string | null; paneStatus: string | null; lastGateStatus: GateStatus | null; lastGateDelivery: "delivered" | "dead-pane" | null }>;
+  jobs: Array<HerdJobInfo & { openGate: string | null; paneStatus: string | null; lastGateStatus: GateStatus | null; lastGateDelivery: "delivered" | "dead-pane" | "confirmed" | "stuck" | null }>;
   unread: number;
   lifecycleConnected: boolean;
   hiddenUp: boolean | null;
@@ -251,7 +262,8 @@ 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 }
+/** `continuation` is present only when the daemon scheduled a second line for after the target's current turn. */
+export interface PaneSendResult { paneId: string; delivered: PaneDelivery; reason?: string; continuation?: { delivered: "deferred" } }
 /** `attendTab` is set only for a `bg:` ref: focus for a background pane IS
     the attend flow (a visible tab running a terminal attach), and this is
     that tab's id. */
@@ -305,11 +317,36 @@ export interface RunDetail { run: RunSummary; stages: RunStageRow[]; fields: Run
 
 export type AgentSurface = "herdr" | "headless";
 
+/** The reconciler's per-agent snapshot: one row per agent it knows about, live or not. */
+export interface ExecutorView {
+  agentId: string;
+  repo: string | null;
+  subject: string | null;
+  surface: AgentSurface;
+  sessionId: string;
+  paneRef: string | null;
+  state: ExecutorState;
+  since: number;
+  openGateIds: string[];
+}
+
+export interface ReconcilerStatus {
+  sweptAt: number;
+  herdrReachable: boolean;
+  executors: ExecutorView[];
+}
+
 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; handle?: string;
+  /** The gate-protocol subject stamped as RT_GATE_SUBJECT at launch. Left
+      undefined when the caller passed none (RT_GATE_SUBJECT still falls
+      back to "agent:<id>" at launch time); an explicit value is persisted
+      so a resume re-stamps the same one, AND gates whether the gate-fork
+      PreToolUse hook gets injected at all. */
+  subject?: string;
   paneId?: string; tabId?: string; workspaceId?: string;
   extraArgs?: string; exitCode?: number; resultPath?: string;
   createdAt: number; lastResumedAt?: number; finishedAt?: number;
@@ -568,7 +605,7 @@ export interface Commands {
   "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; env?: Record<string, string>; herdrSocket?: string; handle?: string; bg?: boolean }; data: AgentRecord };
+  "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; env?: Record<string, string>; herdrSocket?: string; handle?: string; bg?: boolean; subject?: string }; 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[] } };
@@ -581,7 +618,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 };
+  "pane:send": { payload: { paneId: string; text: string; callerPane?: string; continuation?: string }; data: PaneSendResult };
   /** `callerWorkspace` (HERDR_WORKSPACE_ID) is required only for a `bg:`
       ref, whose focus opens an attend tab in the caller's own workspace. */
   "pane:focus": { payload: { paneId: string; callerWorkspace?: string }; data: PaneFocusResult };
@@ -619,6 +656,12 @@ export interface Commands {
   "repos:locate": { payload: { newPath: string; repo?: string; dryRun?: boolean }; data: unknown };
   "freshness:reconcile": { payload: Record<string, never>; data: unknown };
 
+  // ─── Reconciler (executor state; lib/daemon/reconciler.ts) ───────────────
+  /** Read-only: the last sweep's snapshot. Never triggers a sweep itself. */
+  "reconciler:status": { payload: Record<string, never>; data: ReconcilerStatus };
+  /** Manual override: marks the agent cleared and closes its open/parked gates (reconciler.ts's clear()). */
+  "reconciler:clear": { payload: { agentId: string }; data: { cleared: true } };
+
   // ─── Gate facility (BOARD-20/21) ─────────────────────────────────────────
   "gate:open": { payload: { subject: string; kind: string; questions: GateQuestion[]; meta?: Record<string, unknown>; agent?: string; pane?: string; nudge?: { session: string }; context?: string; origin?: GateOrigin }; data: { id: string; supersededId: string | null } };
   /**
@@ -769,6 +812,8 @@ export const COMMAND_NAMES: readonly CommandName[] = [
   "endpoint:status",
   "repos:locate",
   "freshness:reconcile",
+  "reconciler:status",
+  "reconciler:clear",
   "gate:open",
   "gate:answer",
   "gate:wait",

package/src/index.ts

@@ -45,6 +45,8 @@ export {
   chatInvite,
   paneSend,
   paneFocus,
+  reconcilerStatus,
+  reconcilerClear,
   gateOpen,
   gateAnswer,
   gateWait,
@@ -104,6 +106,9 @@ export type {
   AgentRecord,
   AgentSurface,
   AgentStatus,
+  ExecutorState,
+  ExecutorView,
+  ReconcilerStatus,
   ChatPane,
   PaneAccount,
   PaneDirectory,

package/src/settings/registry-defs.ts

@@ -85,7 +85,7 @@ export const REGISTRY: readonly SettingDef[] = [
     scopes: ["user"],
     default: [],
     merge: "replace",
-    description: "Event-bus glob rules that raise a desktop notification: [{pattern, category, title, message, subjectPrefix?, url?, owner?}]. pattern is matched against the events-bus topic (Bun.Glob semantics); title/message may interpolate `{field}` from the event payload, plus the computed `{question}` field (the event payload's first question label, `payload.questions[0].label`, empty string when absent); optional subjectPrefix matches the event payload's subject as a prefix. The optional url is interpolated the same way as title/message and becomes the notification's Open target; a gate rule should set it. The optional owner field (only literal \"human\" is valid) suppresses events whose payload.owner starts with \"herd:\", allowing gate rules to skip herd-owned events. A typical setup pairs a gate/opened rule with owner: \"human\" (human-owned gates notify) and a gate/escalated rule without owner (all escalations notify, whether human or herd). A fresh key, not an ownership-latch port, so a default is fine here.",
+    description: "Event-bus glob rules that raise a desktop notification: [{pattern, category, title, message, subjectPrefix?, url?, owner?, surface?}]. pattern is matched against the events-bus topic (Bun.Glob semantics); title/message may interpolate `{field}` from the event payload, plus the computed `{question}` field (the event payload's first question label, `payload.questions[0].label`, empty string when absent); optional subjectPrefix matches the event payload's subject as a prefix. The optional url is interpolated the same way as title/message and becomes the notification's Open target; a gate rule should set it. The optional owner field (only literal \"human\" is valid) suppresses events whose payload.owner starts with \"herd:\", allowing gate rules to skip herd-owned events. The optional surface field (a string) matches only events whose payload.origin.surface equals the given value, allowing a rule to fire only for gates opened by a specific surface (e.g. surface: \"board\" matches only board-originated gates). A typical setup pairs a gate/opened rule with owner: \"human\" (human-owned gates notify) and a gate/escalated rule without owner (all escalations notify, whether human or herd). A board-specific rule can combine surface: \"board\" with a board URL to open the decision queue directly. A fresh key, not an ownership-latch port, so a default is fine here.",
   },
   {
     key: "rt.cron",
@@ -295,6 +295,15 @@ export const REGISTRY: readonly SettingDef[] = [
     merge: "replace",
     description: "The machine's intended flavor, \"dev\" or \"prod\". Normally written by `rt settings dev-mode` after a successful handoff; a manual `rt settings set` is the blessed repair escape hatch — the daemon park loop converges on whatever this says. Unset ⇒ derived from the dev wrapper's presence.",
   },
+  {
+    key: "setup.waived",
+    type: "array",
+    scopes: ["machine"],
+    default: [],
+    merge: "replace",
+    description:
+      "Finish-gated setup rows the user skipped on this Mac through `rt setup waive` (today only tool.fast-browser-extension); the wizard's Finish no longer waits on them. Machine-only: a loaded Chrome extension is a per-profile fact and the choice is per machine, so it never travels with a team or user store.",
+  },
   {
     key: "rt.integrations",
     type: "object",

package/src/transport.ts

@@ -38,8 +38,13 @@ export interface RtClientOptions {
 // lib/, so this literal cannot import rtDir(). repo-tools/lib/rt-paths.ts is
 // the authority — change there first, mirror here (same convention as
 // settings/paths.ts's call-time `home()`).
+//
+// RT_DAEMON_SOCK wins over the HOME-derived default (same pattern as
+// lib/daemon-client.ts's RT_APP_SOCKET for tray.sock): an isolated daemon
+// (per-agent launch, an e2e run) points every rt-client caller, including
+// the `rt` CLI's own subcommands, at its own socket without repointing HOME.
 function defaultSock(): string {
-  return join(process.env.HOME ?? homedir(), ".mattstack", "rt", "rt.sock");
+  return process.env.RT_DAEMON_SOCK || join(process.env.HOME ?? homedir(), ".mattstack", "rt", "rt.sock");
 }
 
 /**