@mattstack/rt-client 0.15.1 → 0.16.0

package/dist/commands.d.ts

@@ -102,12 +102,25 @@ 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";
+export type GateOption = string | {
+    value: string;
+    label: string;
+};
+export interface GateOrigin {
+    paneId?: string;
+    tabId?: string;
+    runId?: string;
+    worktree?: string;
+    presentation?: "form" | "wait";
+}
 export interface GateQuestion {
     id: string;
     label: string;
     multi: boolean;
-    options: string[];
+    options: GateOption[];
 }
+export declare function gateOptionValue(o: GateOption): string;
+export declare function gateOptionLabel(o: GateOption): string;
 export interface GateAnswer {
     answers: Record<string, string | string[] | {
         value: string | string[];
@@ -122,6 +135,8 @@ export interface GateRow {
     kind: string;
     questions: GateQuestion[];
     meta: Record<string, unknown> | null;
+    context?: string | null;
+    origin?: GateOrigin | null;
     status: GateStatus;
     answer: GateAnswer | null;
     openedAt: number;
@@ -1276,6 +1291,8 @@ export interface Commands {
             nudge?: {
                 session: string;
             };
+            context?: string;
+            origin?: GateOrigin;
         };
         data: {
             id: 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, } from "./client.ts";
-export { COMMAND_NAMES, GATE_BY_PANE } 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, GateQuestion, GateAnswer, GateRow, GateSubscription, } from "./commands.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, } 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

@@ -272,7 +272,7 @@ function paneFocus(a, o = {}) {
 }
 function gateOpen(a, o = {}) {
   const payload = { subject: a.subject, kind: a.kind, questions: a.questions };
-  for (const k of ["meta", "agent", "pane", "nudge"])
+  for (const k of ["meta", "agent", "pane", "nudge", "context", "origin"])
     if (a[k] !== undefined)
       payload[k] = a[k];
   return rtCommand("gate:open", payload, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 1e4 });
@@ -314,6 +314,12 @@ function gateSubscriptions(a, o = {}) {
 }
 // src/commands.ts
 var GATE_BY_PANE = "pane";
+function gateOptionValue(o) {
+  return typeof o === "string" ? o : o.value;
+}
+function gateOptionLabel(o) {
+  return typeof o === "string" ? o : o.label || o.value;
+}
 var COMMAND_NAMES = [
   "project-mrs:read",
   "discussions:read",
@@ -2107,6 +2113,8 @@ export {
   gateSubscriptions,
   gateSubscribe,
   gatePark,
+  gateOptionValue,
+  gateOptionLabel,
   gateOpen,
   gateList,
   gateClose,

package/package.json

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

package/src/client.ts

@@ -451,7 +451,7 @@ export function gateOpen(
   o: RtClientOptions = {},
 ): Promise<RtResponse<Commands["gate:open"]["data"]>> {
   const payload: Record<string, unknown> = { subject: a.subject, kind: a.kind, questions: a.questions };
-  for (const k of ["meta", "agent", "pane", "nudge"] as const) if (a[k] !== undefined) payload[k] = a[k];
+  for (const k of ["meta", "agent", "pane", "nudge", "context", "origin"] as const) if (a[k] !== undefined) payload[k] = a[k];
   return rtCommand<Commands["gate:open"]["data"]>("gate:open", payload, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 10_000 });
 }
 

package/src/commands.ts

@@ -95,11 +95,27 @@ export interface EventsBusEvent { id: number; topic: string; payload: unknown; e
 export const GATE_BY_PANE = "pane";
 
 export type GateStatus = "open" | "answered" | "parked" | "closed";
-export interface GateQuestion { id: string; label: string; multi: boolean; options: string[] }
+export type GateOption = string | { value: string; label: string };
+export interface GateOrigin {
+  paneId?: string;
+  tabId?: string;
+  runId?: string;
+  worktree?: string;
+  presentation?: "form" | "wait";
+}
+export interface GateQuestion { id: string; label: string; multi: boolean; options: GateOption[] }
+export function gateOptionValue(o: GateOption): string {
+  return typeof o === "string" ? o : o.value;
+}
+export function gateOptionLabel(o: GateOption): string {
+  return typeof o === "string" ? o : (o.label || o.value);
+}
 export interface GateAnswer { answers: Record<string, string | string[] | { value: string | string[]; note?: string }>; by: string; answeredAt: number }
 export interface GateRow {
   id: string; subject: string; kind: string;
   questions: GateQuestion[]; meta: Record<string, unknown> | null;
+  context?: string | null;
+  origin?: GateOrigin | null;
   status: GateStatus; answer: GateAnswer | null;
   openedAt: number; parkedAt: number | null; closedAt: number | null;
   closedReason: "abandoned" | "superseded" | "pruned" | null;
@@ -574,7 +590,7 @@ export interface Commands {
   "freshness:reconcile": { payload: Record<string, never>; data: unknown };
 
   // ─── 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 } }; data: { id: string; supersededId: string | null } };
+  "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 } };
   /**
    * A CAS loss is a DEFINED OUTCOME, not an error: `ok:true` with
    * `conflict:true` and the WINNING row, so every consumer gets the winner

package/src/index.ts

@@ -56,7 +56,7 @@ export {
   gateSubscriptions,
 } from "./client.ts";
 
-export { COMMAND_NAMES, GATE_BY_PANE } from "./commands.ts";
+export { COMMAND_NAMES, GATE_BY_PANE, gateOptionValue, gateOptionLabel } from "./commands.ts";
 export type {
   Discussion,
   DemandDecl,
@@ -94,6 +94,8 @@ export type {
   PaneSendResult,
   PaneFocusResult,
   GateStatus,
+  GateOption,
+  GateOrigin,
   GateQuestion,
   GateAnswer,
   GateRow,