@mattstack/rt-client 0.3.0 → 0.4.0

package/dist/client.d.ts

@@ -1,5 +1,5 @@
 import type { RtResponse, RtClientOptions } from "./transport.ts";
-import type { DemandDecl, ProjectMRsData, DiscussionsData, MrByBranchData, ForgeSlug, ForgeTokenData, RunSummary, RunDetail } from "./commands.ts";
+import type { DemandDecl, ProjectMRsData, DiscussionsData, MrByBranchData, ForgeSlug, ForgeTokenData, RunSummary, RunDetail, WakeMode, ChatMember, ChatMessage, RoomSummary } 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
@@ -25,3 +25,90 @@ export declare function listRuns(repo?: string, opts?: RtClientOptions): Promise
     runs: RunSummary[];
 }>>;
 export declare function getRun(runId: string, repo?: string, opts?: RtClientOptions): Promise<RtResponse<RunDetail>>;
+/**
+ * SKILLS-54. rt's only write path into run state, so a wedged run can be
+ * resolved by a person instead of lying in the data forever. The write happens
+ * in the daemon and is attributed there; consumers never touch the run DB.
+ */
+export declare function abandonRun(runId: string, repo?: string, reason?: string, opts?: RtClientOptions): Promise<RtResponse<{
+    ok: boolean;
+}>>;
+export declare function chatJoin(a: {
+    room: string;
+    handle: string;
+    wakeOn?: WakeMode;
+    cwd?: string;
+    pane?: string;
+}, o?: RtClientOptions): Promise<RtResponse<{
+    handle: string;
+    memberCount: number;
+    unread: number;
+}>>;
+export declare function chatLeave(a: {
+    room: string;
+    handle: string;
+}, o?: RtClientOptions): Promise<RtResponse<Record<string, never>>>;
+export declare function chatPost(a: {
+    room: string;
+    handle: string;
+    body: string;
+}, o?: RtClientOptions): Promise<RtResponse<{
+    id: number;
+    recipients: string[];
+}>>;
+export declare function chatRead(a: {
+    handle: string;
+    room?: string;
+    limit?: number;
+    sinceMs?: number;
+}, o?: RtClientOptions): Promise<RtResponse<{
+    rooms: {
+        room: string;
+        messages: ChatMessage[];
+    }[];
+}>>;
+export declare function chatRooms(a: {
+    handle: string;
+}, o?: RtClientOptions): Promise<RtResponse<{
+    rooms: RoomSummary[];
+}>>;
+export declare function chatWho(a: {
+    room: string;
+}, o?: RtClientOptions): Promise<RtResponse<{
+    members: ChatMember[];
+}>>;
+export declare function chatMark(a: {
+    handle: string;
+    room?: string;
+}, o?: RtClientOptions): Promise<RtResponse<Record<string, never>>>;
+export declare function chatMessages(a: {
+    room: string;
+    before?: number;
+    limit?: number;
+}, o?: RtClientOptions): Promise<RtResponse<{
+    messages: ChatMessage[];
+}>>;
+export declare function chatArm(a: {
+    handle: string;
+    room?: string;
+}, o?: RtClientOptions): Promise<RtResponse<Record<string, never>>>;
+export declare function chatTouch(a: {
+    handle: string;
+}, o?: RtClientOptions): Promise<RtResponse<Record<string, never>>>;
+export declare function chatDisarm(a: {
+    handle: string;
+}, o?: RtClientOptions): Promise<RtResponse<Record<string, never>>>;
+export declare function chatUnreadWaking(a: {
+    handle: string;
+    room?: string;
+}, o?: RtClientOptions): Promise<RtResponse<{
+    rooms: {
+        room: string;
+        count: number;
+        mentions: number;
+        maxId: number;
+    }[];
+}>>;
+export declare function eventsHead(o?: RtClientOptions): Promise<RtResponse<{
+    cursor: number;
+}>>;

package/dist/commands.d.ts

@@ -55,6 +55,44 @@ export interface EventsBusEvent {
     payload: unknown;
     emittedAt: number;
 }
+/**
+ * Duplicated shape on purpose, same reasoning as EventsBusEvent above:
+ * these mirror lib/state/chat-store.ts's types, which rt-client cannot
+ * import (it's outside lib/state/ and outside this package entirely).
+ */
+export type WakeMode = "mention" | "all" | "none";
+export interface ChatMember {
+    room: string;
+    handle: string;
+    joinedAt: number;
+    lastReadId: number;
+    wakeOn: WakeMode;
+    lastSeenAt?: number;
+    armedAt?: number;
+    cwd?: string;
+    pane?: string;
+}
+export interface ChatMessage {
+    id: number;
+    room: string;
+    handle: string;
+    body: string;
+    mentions: string[];
+    replyTo?: number;
+    postedAt: number;
+}
+export interface RoomSummary {
+    room: string;
+    memberCount: number;
+    unread: number;
+    mentions: number;
+    lastPostedAt?: number;
+}
+export type Attention = {
+    needs: boolean;
+    reason: "failed" | "stale" | "stranded" | null;
+    evidence: string;
+};
 export interface RunSummary {
     id: string;
     repo: string;
@@ -65,6 +103,18 @@ export interface RunSummary {
     spawned_by: string | null;
     started_at: number;
     ended_at: number | null;
+    pack_commits: string | null;
+    pack_dirty: number;
+    attention: Attention;
+    /** Max over stage, field, and decision timestamps; falls back to
+        `started_at` when the run has produced no events yet. The board orders
+        by silence, so this — not `started_at` — is its sort key. */
+    last_event_at: number;
+    /** Denormalized from the run's `ticket` / `branch` fields so the LIST view
+        can render and search them without a detail fetch per row. Null when
+        the run has not produced that field yet. */
+    ticket: string | null;
+    branch: string | null;
 }
 export interface RunStageRow {
     name: string;
@@ -72,6 +122,8 @@ export interface RunStageRow {
     attempt: number;
     started_at: number | null;
     ended_at: number | null;
+    reason: string | null;
+    detail_path: string | null;
 }
 export interface RunFieldRow {
     key: string;
@@ -204,6 +256,12 @@ export interface Commands {
             cursor: number;
         };
     };
+    "events:head": {
+        payload: Record<string, never>;
+        data: {
+            cursor: number;
+        };
+    };
     "runs:list": {
         payload: {
             repo?: string;
@@ -219,6 +277,128 @@ export interface Commands {
         };
         data: RunDetail;
     };
+    "runs:abandon": {
+        payload: {
+            runId: string;
+            repo?: string;
+            reason?: string;
+        };
+        data: {
+            ok: boolean;
+        };
+    };
+    "chat:join": {
+        payload: {
+            room: string;
+            handle: string;
+            wakeOn?: WakeMode;
+            cwd?: string;
+            pane?: string;
+        };
+        data: {
+            handle: string;
+            memberCount: number;
+            unread: number;
+        };
+    };
+    "chat:leave": {
+        payload: {
+            room: string;
+            handle: string;
+        };
+        data: Record<string, never>;
+    };
+    "chat:post": {
+        payload: {
+            room: string;
+            handle: string;
+            body: string;
+        };
+        data: {
+            id: number;
+            recipients: string[];
+        };
+    };
+    "chat:read": {
+        payload: {
+            handle: string;
+            room?: string;
+            limit?: number;
+            sinceMs?: number;
+        };
+        data: {
+            rooms: {
+                room: string;
+                messages: ChatMessage[];
+            }[];
+        };
+    };
+    "chat:rooms": {
+        payload: {
+            handle: string;
+        };
+        data: {
+            rooms: RoomSummary[];
+        };
+    };
+    "chat:who": {
+        payload: {
+            room: string;
+        };
+        data: {
+            members: ChatMember[];
+        };
+    };
+    "chat:mark": {
+        payload: {
+            handle: string;
+            room?: string;
+        };
+        data: Record<string, never>;
+    };
+    "chat:messages": {
+        payload: {
+            room: string;
+            before?: number;
+            limit?: number;
+        };
+        data: {
+            messages: ChatMessage[];
+        };
+    };
+    "chat:arm": {
+        payload: {
+            handle: string;
+            room?: string;
+        };
+        data: Record<string, never>;
+    };
+    "chat:touch": {
+        payload: {
+            handle: string;
+        };
+        data: Record<string, never>;
+    };
+    "chat:disarm": {
+        payload: {
+            handle: string;
+        };
+        data: Record<string, never>;
+    };
+    "chat:unread-waking": {
+        payload: {
+            handle: string;
+            room?: string;
+        };
+        data: {
+            rooms: {
+                room: string;
+                count: number;
+                mentions: number;
+                maxId: number;
+            }[];
+        };
+    };
 }
 export type CommandName = keyof Commands;
 export declare const COMMAND_NAMES: readonly CommandName[];

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, resolveForgeToken } from "./client.ts";
+export { readProjectMRs, readDiscussions, readMrsByBranch, resolveForgeToken, listRuns, getRun, abandonRun, chatJoin, chatLeave, chatPost, chatRead, chatRooms, chatWho, chatMark, chatMessages, chatArm, chatTouch, chatDisarm, chatUnreadWaking, eventsHead, } from "./client.ts";
 export { COMMAND_NAMES } from "./commands.ts";
-export type { Discussion, DemandDecl, ProjectMRsScope, ProjectMRsData, DiscussionsData, MrByBranchEntry, MrByBranchData, Commands, CommandName, ForgeSlug, ForgeTokenData, } from "./commands.ts";
+export type { Discussion, DemandDecl, ProjectMRsScope, ProjectMRsData, DiscussionsData, MrByBranchEntry, MrByBranchData, Commands, CommandName, ForgeSlug, ForgeTokenData, Attention, RunSummary, RunStageRow, RunFieldRow, RunDecisionRow, RunDetail, WakeMode, ChatMember, ChatMessage, RoomSummary, } from "./commands.ts";
 export { subscribe, DEFAULT_WS_URL } from "./relay.ts";
 export type { RelayEventType } from "./relay.ts";
 export { repoNameForPath } from "./repos.ts";
@@ -15,4 +15,4 @@ export type { SettingDef, SettingScope } from "./settings/registry-machinery.ts"
 export { REGISTRY } from "./settings/registry-defs.ts";
 export { readStore, listTeams } from "./settings/stores.ts";
 export type { StoreFile } from "./settings/stores.ts";
-export { normalizeRemote, identityFromRemote, deriveRepoIdentity, clearIdentityMemo } from "./settings/identity.ts";
+export { normalizeRemote, identityFromRemote, deriveRepoIdentity, clearIdentityMemo, serializeIdentity, parseIdentity, resolveNameToIdentity, type RepoIdentity, } from "./settings/identity.ts";