@mattstack/rt-client 0.10.1 → 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

@@ -4,7 +4,7 @@
  * its functions against this map so a new command only needs an entry here
  * plus one function, never a change to the transport itself.
  */
-import type { PullRequest, MRDetail } from "@mattstack/glance";
+import type { PullRequest, MRDetail, Pipeline } from "@mattstack/glance";
 export type Discussion = MRDetail["discussions"][number];
 /** What a caller declares it needs, so the daemon can size the sync to cover it. */
 export interface DemandDecl {
@@ -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;
@@ -289,6 +309,265 @@ export interface AgentRecord {
     lastResumedAt?: number;
     finishedAt?: number;
 }
+/** Duplicated shape on purpose (see EventsBusEvent above): mirrors lib/daemon/health.ts's HealthSnapshot. */
+export type HealthLevel = "ok" | "degraded" | "unhealthy";
+export interface HealthMetrics {
+    rss: number;
+    heapUsed: number;
+    external: number;
+    uptimeMs: number;
+    wsClients: number;
+    watchers: number;
+}
+export interface HealthEventLoop {
+    maxLagMs: number;
+    lastStallAt: number | null;
+    lastStallCmd: string | null;
+    stalls: number;
+}
+export interface DaemonIdentity {
+    flavor: "dev" | "prod";
+    version: string;
+    sourceRev: string | null;
+    startedAt: number;
+}
+export interface PingData extends DaemonIdentity {
+    uptime: number;
+    pid: number;
+    health: HealthLevel;
+    eventLoop: HealthEventLoop;
+    heartbeatSeq: number;
+    supervision: {
+        bootAttempts: number;
+        lastReadyAt: number | null;
+        recentFailures: unknown[];
+        lastExit: unknown;
+    };
+}
+export interface StatusData {
+    pid: number;
+    uptime: number;
+    watchedRepos: number;
+    cacheEntries: number;
+    portsCached: number;
+    portCacheAge: number | null;
+    freshness: unknown;
+    identity: DaemonIdentity;
+    health: {
+        level: HealthLevel;
+        reasons: string[];
+    };
+    metrics: HealthMetrics;
+    eventLoop: HealthEventLoop;
+    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. */
+export interface PortEntry {
+    port: number;
+    pid: number;
+    command: string;
+    cwd: string;
+    repo: string | null;
+    worktree: string | null;
+    branch: string | null;
+    relativeDir: string;
+    uptime: string;
+}
+export interface PortsData {
+    ports: PortEntry[];
+    grouped: Record<string, Record<string, PortEntry[]>>;
+    updatedAt: number;
+    age: number | null;
+}
+/** Duplicated shape on purpose: mirrors lib/state/notifier-store.ts's NotificationEvent. */
+export interface RtNotificationEvent {
+    id: string;
+    title: string;
+    message: string;
+    url?: string;
+    category: string;
+    timestamp: number;
+    pids?: number[];
+}
+export interface ReposData {
+    repos: Record<string, {
+        path: string;
+        worktrees: Array<{
+            path: string;
+            branch: string;
+        }>;
+    }>;
+    watched: string[];
+}
+export interface TccCheckData {
+    blocked: Array<{
+        name: string;
+        path: string;
+        error: string;
+    }>;
+    accessible: string[];
+    totalRepos: number;
+    daemonPid: number;
+}
+export interface WorktreeTreeRow {
+    name: string;
+    kind: string;
+    state: string;
+    path: string;
+    branch: string | null;
+    repoName: string;
+    mr: {
+        iid: number;
+        state: string;
+        title: string;
+    } | null;
+    duplicateBranch?: true;
+    [extra: string]: unknown;
+}
+export interface WorktreeListData {
+    trees: WorktreeTreeRow[];
+    dormant?: true;
+    dormantRepos?: string[];
+    message?: string;
+    readyHeld?: true;
+    readyHeldRepos?: string[];
+}
+export interface WorktreeProvisionData {
+    tree: string;
+    path: string;
+    branch: string;
+    wasOnDeck: boolean;
+    readyAt: string | null;
+    branchState: "new" | "tracking-remote" | "existing-clean" | "diverged" | "behind";
+    readyFailed?: true;
+    failedStep?: string;
+}
+export interface WorktreeCreateData {
+    tree: string;
+    path: string;
+}
+export interface WorktreeDisposeData {
+    disposed: string[];
+    refused: Array<{
+        tree: string;
+        reason: string;
+    }>;
+    recoverable: Array<{
+        tree: string;
+        path: string;
+        until: string;
+    }>;
+}
+export interface WorktreeRestoreData {
+    restored: true;
+    path: string;
+    tree: string;
+    readyFailed?: true;
+    failedStep?: string;
+}
+export interface WorktreeFreshenData {
+    ran: string[];
+}
+export interface WorktreeAdoptData {
+    main: string;
+    claimed: string[];
+    unmanaged: string[];
+    disposed: string[];
+    refused: Array<{
+        tree: string;
+        reason: string;
+    }>;
+}
+/** Duplicated shape on purpose: mirrors lib/endpoint/store.ts's EndpointClaim. */
+export interface EndpointClaim {
+    worktree: string;
+    role: string;
+    port: number;
+    ts: number;
+}
+export interface EndpointRoleRef {
+    port: number;
+    url: string;
+    running: boolean;
+}
+export interface EndpointClaimData {
+    role: string;
+    port: number;
+    url: string;
+    refs: Record<string, EndpointRoleRef>;
+}
+export interface EndpointLookupData {
+    claimed: boolean;
+    port: number | null;
+    url: string | null;
+    running: boolean;
+}
+export interface EndpointReleaseData {
+    released: number;
+}
+export interface EndpointStatusData {
+    repos: Record<string, Array<EndpointClaim & {
+        running: boolean;
+    }>>;
+}
+/**
+ * Duplicated shape on purpose: mirrors @mattstack/glance's `JobDetail`
+ * (types.ts), which the package does not re-export from its index.
+ */
+export type MrJobDetail = {
+    type: "trace";
+    content: string;
+} | {
+    type: "bridge";
+    downstreamPipeline: Pipeline;
+};
+export interface DiscussionsWriteData {
+    discussions: Discussion[];
+    fetchedAt: number;
+}
+export interface DiscussionsDiffsData {
+    diffs: Array<{
+        newPath: string;
+        diff: string;
+    }>;
+    truncated: boolean;
+}
+export type MRActionName = "merge" | "rebase" | "approve" | "unapprove" | "setAutoMerge" | "cancelAutoMerge" | "retryJob" | "retryPipeline" | "toggleDraft" | "requestReReview";
 export interface Commands {
     "project-mrs:read": {
         payload: {
@@ -452,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": {
@@ -728,6 +1037,270 @@ export interface Commands {
         };
         data: PaneFocusResult;
     };
+    "cache:read": {
+        payload: {
+            branches?: string[];
+            maxAgeMs?: number;
+            repoIdentity?: string;
+        };
+        data: Record<string, BranchEnrichment>;
+    };
+    /** `source` ("cache"|"fresh"|"empty") rides alongside `data` on the wire, not nested under it. */
+    "branch:enrich": {
+        payload: {
+            branch: string;
+            repoPath?: string;
+            remoteUrl?: string;
+            repoIdentity?: string;
+        };
+        data: BranchEnrichment | null;
+    };
+    /** Fire-and-forget kickoff; wire reply is `{ok, message}`, not `{ok,data}`. */
+    "cache:refresh": {
+        payload: Record<string, never>;
+        data: {
+            message: string;
+        };
+    };
+    "daemon:log-level": {
+        payload: {
+            level?: "trace" | "debug" | "info" | "warn" | "error";
+        };
+        data: {
+            level: string;
+        };
+    };
+    "ping": {
+        payload: Record<string, never>;
+        data: PingData;
+    };
+    "status": {
+        payload: Record<string, never>;
+        data: StatusData;
+    };
+    "tray:status": {
+        payload: Record<string, never>;
+        data: TrayStatusData;
+    };
+    "tcc:check": {
+        payload: Record<string, never>;
+        data: TccCheckData;
+    };
+    "repos": {
+        payload: Record<string, never>;
+        data: ReposData;
+    };
+    "ports": {
+        payload: {
+            repo?: string;
+            refresh?: boolean;
+        };
+        data: PortsData;
+    };
+    "notifications": {
+        payload: Record<string, never>;
+        data: RtNotificationEvent[];
+    };
+    "discussions:refresh": {
+        payload: {
+            repoName: string;
+            iid: number;
+        };
+        data: DiscussionsWriteData;
+    };
+    "discussions:resolve": {
+        payload: {
+            repoName: string;
+            iid: number;
+            discussionId: string;
+            resolved?: boolean;
+        };
+        data: DiscussionsWriteData;
+    };
+    "discussions:reply": {
+        payload: {
+            repoName: string;
+            iid: number;
+            discussionId: string;
+            body: string;
+        };
+        data: DiscussionsWriteData;
+    };
+    "discussions:diffs": {
+        payload: {
+            repoName: string;
+            iid: number;
+        };
+        data: DiscussionsDiffsData;
+    };
+    /** Wire reply is `{ok:true}` on success (no `data`); a failure is `{ok:false,error}`. */
+    "mr:action": {
+        payload: {
+            repoName: string;
+            iid: number;
+            action: MRActionName;
+            args?: unknown[];
+        };
+        data: Record<string, never>;
+    };
+    "mr:fetch-job-detail": {
+        payload: {
+            repoName: string;
+            iid: number;
+            jobId: number;
+            pipelineId?: number;
+        };
+        data: MrJobDetail;
+    };
+    "mr:fetch-job-trace": {
+        payload: {
+            repoName: string;
+            iid: number;
+            jobId: number;
+        };
+        data: string;
+    };
+    "endpoint:claim": {
+        payload: {
+            repo: string;
+            worktree: string;
+            role: string;
+            pid?: number;
+        };
+        data: EndpointClaimData;
+    };
+    "endpoint:lookup": {
+        payload: {
+            repo: string;
+            worktree: string;
+            role: string;
+        };
+        data: EndpointLookupData;
+    };
+    "endpoint:release": {
+        payload: {
+            repo: string;
+            worktree: string;
+            role?: string;
+        };
+        data: EndpointReleaseData;
+    };
+    "endpoint:status": {
+        payload: {
+            repo?: string;
+        };
+        data: EndpointStatusData;
+    };
+    "repos:locate": {
+        payload: {
+            newPath: string;
+            repo?: string;
+            dryRun?: boolean;
+        };
+        data: unknown;
+    };
+    "freshness:reconcile": {
+        payload: Record<string, never>;
+        data: unknown;
+    };
+    /** Wire reply on success is always `{ok:true, repaired}` (no `data`
+     *  wrapper) — `data` here documents the extra field the same way PingData
+     *  does for `ping`, not the literal wire nesting (R3). */
+    "hooks:repair": {
+        payload: {
+            repo: string;
+        };
+        data: {
+            repaired: boolean;
+        };
+    };
+    "hooks:watch": {
+        payload: {
+            repo: string;
+        };
+        data: Record<string, never>;
+    };
+    "sdm:catalog": {
+        payload: {
+            refresh?: boolean;
+        };
+        data: unknown;
+    };
+    "sdm:snapshot": {
+        payload: {
+            force?: boolean;
+        };
+        data: unknown;
+    };
+    "sdm:recents": {
+        payload: Record<string, never>;
+        data: unknown;
+    };
+    "sdm:reconnect": {
+        payload: {
+            key: string;
+        };
+        data: unknown;
+    };
+    "system-processes": {
+        payload: Record<string, never>;
+        data: unknown;
+    };
+    "worktree:provision": {
+        payload: {
+            repoName: string;
+            branch?: string;
+            ticket?: string;
+            ticketTitle?: string;
+            disposal?: "job" | "merge";
+            owner?: string;
+        };
+        data: WorktreeProvisionData;
+    };
+    "worktree:create": {
+        payload: {
+            repoName: string;
+            onDeck?: boolean;
+        };
+        data: WorktreeCreateData;
+    };
+    "worktree:dispose": {
+        payload: {
+            repoName?: string;
+            owner?: string;
+            tree?: string;
+            force?: boolean;
+            callerPid?: number;
+        };
+        data: WorktreeDisposeData;
+    };
+    "worktree:list": {
+        payload: {
+            repoName?: string;
+        };
+        data: WorktreeListData;
+    };
+    "worktree:restore": {
+        payload: {
+            repoName: string;
+            tree: string;
+        };
+        data: WorktreeRestoreData;
+    };
+    "worktree:freshen": {
+        payload: {
+            repoName?: string;
+            tree?: string;
+        };
+        data: WorktreeFreshenData;
+    };
+    "worktree:adopt": {
+        payload: {
+            repoName: string;
+            claim?: boolean;
+        };
+        data: WorktreeAdoptData;
+    };
 }
 export type CommandName = keyof Commands;
 export declare const COMMAND_NAMES: readonly CommandName[];

package/dist/index.d.ts

@@ -1,13 +1,15 @@
 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";
 export { repoNameForPath } from "./repos.ts";
-export { getSetting, listSettings, explainSetting, expandVariables, SCOPE_ORDER } from "./settings/resolve.ts";
+export { decidePlacement, openSmartPane } from "./smart-pane.ts";
+export type { Placement, PlacementOpts, HerdrCall } from "./smart-pane.ts";
+export { getSetting, listSettings, explainSetting, expandVariables, SCOPE_ORDER, setSettingsWarnSink } from "./settings/resolve.ts";
 export type { Scope, Provenance, ResolveOpts, Resolved, InvalidScope, ListedSetting, ExplainRow, ExpandCtx, } from "./settings/resolve.ts";
 export { setSetting, unsetSetting } from "./settings/write.ts";
 export type { SetSettingOpts } from "./settings/write.ts";