@h-rig/transport-plugin 0.0.6-alpha.158

package/README.md

@@ -0,0 +1 @@
+# @h-rig/transport-plugin

package/dist/relay-registry/src/client.d.ts

@@ -0,0 +1,43 @@
+import { Stream } from "effect";
+import type { HeartbeatRequest, ListedRegistryEntry, ProjectionIngestRequest, RegistryDiscoveryFrame, RegistryRunProjection, RegisterRequest, RegistryEntry, RegistrySnapshotFrame, RemoveRequest, WorkerProjectionFrame } from "./schema";
+export type CollabRegistryFilter = {
+    readonly cwd?: string;
+    readonly selectedRepo?: string;
+    readonly githubUserId?: string;
+    readonly namespaceKey?: string;
+};
+export type RegistryClientOptions = {
+    readonly baseUrl: string;
+    readonly namespaceKey: string;
+    readonly fetch?: typeof fetch;
+};
+export type RegistryClient = {
+    registerRoom(room: RegisterRequest): Promise<RegistryEntry>;
+    heartbeatRoom(roomId: string, status: HeartbeatRequest["status"], projection?: RegistryRunProjection): Promise<RegistryEntry>;
+    ingestProjection(input: Omit<ProjectionIngestRequest, "namespaceKey" | "projection"> & {
+        readonly namespaceKey?: string;
+        readonly projection: RegistryRunProjection;
+    }): Promise<RegistryEntry>;
+    listRoomsByOwner(filter: CollabRegistryFilter): Promise<readonly ListedRegistryEntry[]>;
+    removeRoom(roomId: string): Promise<boolean>;
+};
+export type WorkerProjectionConnection = {
+    readonly ready: Promise<void>;
+    push(frame: WorkerProjectionFrame | RegistryRunProjection): void;
+    close(): void;
+};
+export type WorkerProjectionOptions = {
+    readonly baseUrl: string;
+    readonly namespaceKey: string;
+    readonly runId: string;
+    readonly WebSocket?: typeof WebSocket;
+};
+export type DiscoverySubscriptionOptions = {
+    readonly baseUrl: string;
+    readonly WebSocket?: typeof WebSocket;
+};
+export declare function connectWorkerProjection(input: WorkerProjectionOptions): WorkerProjectionConnection;
+export declare function connectWorkerProjection(namespaceKey: string, runId: string, options: Omit<WorkerProjectionOptions, "namespaceKey" | "runId">): WorkerProjectionConnection;
+export declare function subscribeDiscovery(namespaceKey: string, repo: string | null | undefined, options: DiscoverySubscriptionOptions): Stream.Stream<RegistrySnapshotFrame>;
+export declare function createRegistryClient(options: RegistryClientOptions): RegistryClient;
+export type { HeartbeatRequest, ListedRegistryEntry, ProjectionIngestRequest, RegisterRequest, RegistryDiscoveryFrame, RegistryEntry, RegistryRunProjection, RegistrySnapshotFrame, RemoveRequest, WorkerProjectionFrame };

package/dist/relay-registry/src/schema.d.ts

@@ -0,0 +1,317 @@
+import { Schema } from "@rig/contracts";
+import type { RunJournalProjection, RunRecord, UnifiedInboxRequest } from "@rig/contracts";
+export type { RunRecord, UnifiedInboxRequest };
+export declare const RegistryOwner: Schema.Struct<{
+    readonly githubUserId: Schema.String;
+    readonly login: Schema.String;
+    readonly namespaceKey: Schema.String;
+}>;
+export type RegistryOwner = typeof RegistryOwner.Type;
+export declare const REGISTRY_STATUS_VALUES: readonly [...("stopped" | "failed" | "queued" | "running" | "completed" | "created" | "preparing" | "waiting-approval" | "waiting-user-input" | "paused" | "validating" | "reviewing" | "closing-out" | "needs-attention")[], "starting", "waiting-input"];
+export declare const RegistryStatus: Schema.Literals<readonly [...("stopped" | "failed" | "queued" | "running" | "completed" | "created" | "preparing" | "waiting-approval" | "waiting-user-input" | "paused" | "validating" | "reviewing" | "closing-out" | "needs-attention")[], "starting", "waiting-input"]>;
+export type RegistryStatus = typeof RegistryStatus.Type;
+export declare function isRegistryStatus(value: unknown): value is RegistryStatus;
+export declare function coerceRegistryStatus(value: unknown, fallback: RegistryStatus): RegistryStatus;
+/**
+ * The relay is a transport/cache, not the source of truth. Projection payloads
+ * are the journal-derived wire subset of @rig/contracts RunRecord. This package
+ * deliberately does not re-declare the nested runtime schema: it decodes only
+ * owner-scoped envelope fields and carries `projection` verbatim.
+ */
+export type RegistryRunProjection = Pick<RunRecord, "runId" | "taskId" | "title" | "status" | "source" | "startedAt" | "updatedAt" | "completedAt" | "joinLink" | "webLink" | "relayUrl" | "sessionPath" | "prUrl" | "worktreePath" | "pendingApprovals" | "pendingInputs" | "steeringCount" | "stallCount" | "errorSummary" | "timeline" | "collabCwd"> & {
+    readonly cwd?: string | null;
+    readonly dispatchHandle?: string | null;
+    readonly projection?: RunJournalProjection | null;
+};
+export declare const RegistryEntry: Schema.Struct<{
+    readonly roomId: Schema.String;
+    readonly owner: Schema.Struct<{
+        readonly githubUserId: Schema.String;
+        readonly login: Schema.String;
+        readonly namespaceKey: Schema.String;
+    }>;
+    readonly repo: Schema.String;
+    readonly title: Schema.String;
+    readonly status: Schema.Literals<readonly [...("stopped" | "failed" | "queued" | "running" | "completed" | "created" | "preparing" | "waiting-approval" | "waiting-user-input" | "paused" | "validating" | "reviewing" | "closing-out" | "needs-attention")[], "starting", "waiting-input"]>;
+    readonly joinLink: Schema.String;
+    readonly webLink: Schema.String;
+    readonly relayUrl: Schema.String;
+    readonly startedAt: Schema.String;
+    readonly cwd: Schema.optional<Schema.String>;
+    readonly sessionPath: Schema.optional<Schema.String>;
+    readonly heartbeatAt: Schema.String;
+    readonly pid: Schema.optional<Schema.Number>;
+    readonly projection: Schema.optional<Schema.Unknown>;
+}>;
+export type RegistryEntry = typeof RegistryEntry.Type;
+export declare const RegisterRequest: Schema.Struct<{
+    readonly roomId: Schema.String;
+    readonly owner: Schema.Struct<{
+        readonly githubUserId: Schema.String;
+        readonly login: Schema.String;
+        readonly namespaceKey: Schema.String;
+    }>;
+    readonly repo: Schema.String;
+    readonly title: Schema.String;
+    readonly status: Schema.Literals<readonly [...("stopped" | "failed" | "queued" | "running" | "completed" | "created" | "preparing" | "waiting-approval" | "waiting-user-input" | "paused" | "validating" | "reviewing" | "closing-out" | "needs-attention")[], "starting", "waiting-input"]>;
+    readonly joinLink: Schema.String;
+    readonly webLink: Schema.String;
+    readonly relayUrl: Schema.String;
+    readonly startedAt: Schema.String;
+    readonly cwd: Schema.optional<Schema.String>;
+    readonly sessionPath: Schema.optional<Schema.String>;
+    readonly pid: Schema.optional<Schema.Number>;
+    readonly projection: Schema.optional<Schema.Unknown>;
+}>;
+export type RegisterRequest = typeof RegisterRequest.Type;
+export declare const HeartbeatRequest: Schema.Struct<{
+    readonly roomId: Schema.String;
+    readonly namespaceKey: Schema.String;
+    readonly status: Schema.Literals<readonly [...("stopped" | "failed" | "queued" | "running" | "completed" | "created" | "preparing" | "waiting-approval" | "waiting-user-input" | "paused" | "validating" | "reviewing" | "closing-out" | "needs-attention")[], "starting", "waiting-input"]>;
+    readonly projection: Schema.optional<Schema.Unknown>;
+}>;
+export type HeartbeatRequest = typeof HeartbeatRequest.Type;
+/**
+ * HTTP projection ingest:
+ *   POST /registry/projection
+ *   { namespaceKey, roomId?, owner?, repo?, projection: RegistryRunProjection }
+ *
+ * `namespaceKey` is the owner scope. There is no shared secret. If the matching
+ * room already exists, the relay updates that entry. If it is missing, HTTP
+ * ingest may create it only when owner+repo are supplied; worker WS ingest is
+ * update-only.
+ */
+export declare const ProjectionIngestRequest: Schema.Struct<{
+    readonly namespaceKey: Schema.String;
+    readonly roomId: Schema.optional<Schema.String>;
+    readonly owner: Schema.optional<Schema.Struct<{
+        readonly githubUserId: Schema.String;
+        readonly login: Schema.String;
+        readonly namespaceKey: Schema.String;
+    }>>;
+    readonly repo: Schema.optional<Schema.String>;
+    readonly projection: Schema.Unknown;
+}>;
+export type ProjectionIngestRequest = typeof ProjectionIngestRequest.Type;
+export declare const RemoveRequest: Schema.Struct<{
+    readonly namespaceKey: Schema.String;
+    readonly roomId: Schema.String;
+}>;
+export type RemoveRequest = typeof RemoveRequest.Type;
+export declare const ListedRegistryEntry: Schema.Struct<{
+    readonly roomId: Schema.String;
+    readonly owner: Schema.Struct<{
+        readonly githubUserId: Schema.String;
+        readonly login: Schema.String;
+        readonly namespaceKey: Schema.String;
+    }>;
+    readonly repo: Schema.String;
+    readonly title: Schema.String;
+    readonly status: Schema.Literals<readonly [...("stopped" | "failed" | "queued" | "running" | "completed" | "created" | "preparing" | "waiting-approval" | "waiting-user-input" | "paused" | "validating" | "reviewing" | "closing-out" | "needs-attention")[], "starting", "waiting-input"]>;
+    readonly joinLink: Schema.String;
+    readonly webLink: Schema.String;
+    readonly relayUrl: Schema.String;
+    readonly startedAt: Schema.String;
+    readonly heartbeatAt: Schema.String;
+    readonly cwd: Schema.optional<Schema.String>;
+    readonly sessionPath: Schema.optional<Schema.String>;
+    readonly pid: Schema.optional<Schema.Number>;
+    readonly projection: Schema.optional<Schema.Unknown>;
+    readonly stale: Schema.Boolean;
+}>;
+export type ListedRegistryEntry = typeof ListedRegistryEntry.Type;
+export declare const ListResponse: Schema.Struct<{
+    readonly entries: Schema.$Array<Schema.Struct<{
+        readonly roomId: Schema.String;
+        readonly owner: Schema.Struct<{
+            readonly githubUserId: Schema.String;
+            readonly login: Schema.String;
+            readonly namespaceKey: Schema.String;
+        }>;
+        readonly repo: Schema.String;
+        readonly title: Schema.String;
+        readonly status: Schema.Literals<readonly [...("stopped" | "failed" | "queued" | "running" | "completed" | "created" | "preparing" | "waiting-approval" | "waiting-user-input" | "paused" | "validating" | "reviewing" | "closing-out" | "needs-attention")[], "starting", "waiting-input"]>;
+        readonly joinLink: Schema.String;
+        readonly webLink: Schema.String;
+        readonly relayUrl: Schema.String;
+        readonly startedAt: Schema.String;
+        readonly heartbeatAt: Schema.String;
+        readonly cwd: Schema.optional<Schema.String>;
+        readonly sessionPath: Schema.optional<Schema.String>;
+        readonly pid: Schema.optional<Schema.Number>;
+        readonly projection: Schema.optional<Schema.Unknown>;
+        readonly stale: Schema.Boolean;
+    }>>;
+}>;
+export type ListResponse = {
+    readonly entries: readonly ListedRegistryEntry[];
+};
+export declare const RegisterResponse: Schema.Struct<{
+    readonly entry: Schema.Struct<{
+        readonly roomId: Schema.String;
+        readonly owner: Schema.Struct<{
+            readonly githubUserId: Schema.String;
+            readonly login: Schema.String;
+            readonly namespaceKey: Schema.String;
+        }>;
+        readonly repo: Schema.String;
+        readonly title: Schema.String;
+        readonly status: Schema.Literals<readonly [...("stopped" | "failed" | "queued" | "running" | "completed" | "created" | "preparing" | "waiting-approval" | "waiting-user-input" | "paused" | "validating" | "reviewing" | "closing-out" | "needs-attention")[], "starting", "waiting-input"]>;
+        readonly joinLink: Schema.String;
+        readonly webLink: Schema.String;
+        readonly relayUrl: Schema.String;
+        readonly startedAt: Schema.String;
+        readonly cwd: Schema.optional<Schema.String>;
+        readonly sessionPath: Schema.optional<Schema.String>;
+        readonly heartbeatAt: Schema.String;
+        readonly pid: Schema.optional<Schema.Number>;
+        readonly projection: Schema.optional<Schema.Unknown>;
+    }>;
+}>;
+export type RegisterResponse = {
+    readonly entry: RegistryEntry;
+};
+export declare const HeartbeatResponse: Schema.Struct<{
+    readonly entry: Schema.Struct<{
+        readonly roomId: Schema.String;
+        readonly owner: Schema.Struct<{
+            readonly githubUserId: Schema.String;
+            readonly login: Schema.String;
+            readonly namespaceKey: Schema.String;
+        }>;
+        readonly repo: Schema.String;
+        readonly title: Schema.String;
+        readonly status: Schema.Literals<readonly [...("stopped" | "failed" | "queued" | "running" | "completed" | "created" | "preparing" | "waiting-approval" | "waiting-user-input" | "paused" | "validating" | "reviewing" | "closing-out" | "needs-attention")[], "starting", "waiting-input"]>;
+        readonly joinLink: Schema.String;
+        readonly webLink: Schema.String;
+        readonly relayUrl: Schema.String;
+        readonly startedAt: Schema.String;
+        readonly cwd: Schema.optional<Schema.String>;
+        readonly sessionPath: Schema.optional<Schema.String>;
+        readonly heartbeatAt: Schema.String;
+        readonly pid: Schema.optional<Schema.Number>;
+        readonly projection: Schema.optional<Schema.Unknown>;
+    }>;
+}>;
+export type HeartbeatResponse = {
+    readonly entry: RegistryEntry;
+};
+export declare const ProjectionIngestResponse: Schema.Struct<{
+    readonly entry: Schema.Struct<{
+        readonly roomId: Schema.String;
+        readonly owner: Schema.Struct<{
+            readonly githubUserId: Schema.String;
+            readonly login: Schema.String;
+            readonly namespaceKey: Schema.String;
+        }>;
+        readonly repo: Schema.String;
+        readonly title: Schema.String;
+        readonly status: Schema.Literals<readonly [...("stopped" | "failed" | "queued" | "running" | "completed" | "created" | "preparing" | "waiting-approval" | "waiting-user-input" | "paused" | "validating" | "reviewing" | "closing-out" | "needs-attention")[], "starting", "waiting-input"]>;
+        readonly joinLink: Schema.String;
+        readonly webLink: Schema.String;
+        readonly relayUrl: Schema.String;
+        readonly startedAt: Schema.String;
+        readonly cwd: Schema.optional<Schema.String>;
+        readonly sessionPath: Schema.optional<Schema.String>;
+        readonly heartbeatAt: Schema.String;
+        readonly pid: Schema.optional<Schema.Number>;
+        readonly projection: Schema.optional<Schema.Unknown>;
+    }>;
+}>;
+export type ProjectionIngestResponse = {
+    readonly entry: RegistryEntry;
+};
+export declare const RemoveResponse: Schema.Struct<{
+    readonly removed: Schema.Boolean;
+}>;
+export type RemoveResponse = typeof RemoveResponse.Type;
+/**
+ * Discovery WebSocket endpoint:
+ *   GET /registry/ws?namespaceKey=<owner>&repo=<optional>
+ *
+ * Relay -> client. The first frame is a full snapshot. Later mutations are
+ * entry-scoped deltas; subscribeDiscovery folds them back into snapshot frames
+ * for existing callers that consume relay WS snapshots.
+ */
+export declare const RegistrySnapshotFrame: Schema.Struct<{
+    readonly type: Schema.Literal<"registry.snapshot">;
+    readonly namespaceKey: Schema.String;
+    readonly sentAt: Schema.String;
+    readonly entries: Schema.$Array<Schema.Struct<{
+        readonly roomId: Schema.String;
+        readonly owner: Schema.Struct<{
+            readonly githubUserId: Schema.String;
+            readonly login: Schema.String;
+            readonly namespaceKey: Schema.String;
+        }>;
+        readonly repo: Schema.String;
+        readonly title: Schema.String;
+        readonly status: Schema.Literals<readonly [...("stopped" | "failed" | "queued" | "running" | "completed" | "created" | "preparing" | "waiting-approval" | "waiting-user-input" | "paused" | "validating" | "reviewing" | "closing-out" | "needs-attention")[], "starting", "waiting-input"]>;
+        readonly joinLink: Schema.String;
+        readonly webLink: Schema.String;
+        readonly relayUrl: Schema.String;
+        readonly startedAt: Schema.String;
+        readonly heartbeatAt: Schema.String;
+        readonly cwd: Schema.optional<Schema.String>;
+        readonly sessionPath: Schema.optional<Schema.String>;
+        readonly pid: Schema.optional<Schema.Number>;
+        readonly projection: Schema.optional<Schema.Unknown>;
+        readonly stale: Schema.Boolean;
+    }>>;
+}>;
+export type RegistrySnapshotFrame = {
+    readonly type: "registry.snapshot";
+    readonly namespaceKey: string;
+    readonly sentAt: string;
+    readonly entries: readonly ListedRegistryEntry[];
+};
+export declare const RegistryDeltaFrame: Schema.Struct<{
+    readonly type: Schema.Literal<"registry.delta">;
+    readonly namespaceKey: Schema.String;
+    readonly sentAt: Schema.String;
+    readonly action: Schema.Literals<readonly ["upsert", "remove"]>;
+    readonly roomId: Schema.String;
+    readonly entry: Schema.optional<Schema.Struct<{
+        readonly roomId: Schema.String;
+        readonly owner: Schema.Struct<{
+            readonly githubUserId: Schema.String;
+            readonly login: Schema.String;
+            readonly namespaceKey: Schema.String;
+        }>;
+        readonly repo: Schema.String;
+        readonly title: Schema.String;
+        readonly status: Schema.Literals<readonly [...("stopped" | "failed" | "queued" | "running" | "completed" | "created" | "preparing" | "waiting-approval" | "waiting-user-input" | "paused" | "validating" | "reviewing" | "closing-out" | "needs-attention")[], "starting", "waiting-input"]>;
+        readonly joinLink: Schema.String;
+        readonly webLink: Schema.String;
+        readonly relayUrl: Schema.String;
+        readonly startedAt: Schema.String;
+        readonly heartbeatAt: Schema.String;
+        readonly cwd: Schema.optional<Schema.String>;
+        readonly sessionPath: Schema.optional<Schema.String>;
+        readonly pid: Schema.optional<Schema.Number>;
+        readonly projection: Schema.optional<Schema.Unknown>;
+        readonly stale: Schema.Boolean;
+    }>>;
+}>;
+export type RegistryDeltaFrame = {
+    readonly type: "registry.delta";
+    readonly namespaceKey: string;
+    readonly sentAt: string;
+    readonly action: "upsert" | "remove";
+    readonly roomId: string;
+    readonly entry?: ListedRegistryEntry;
+};
+export type RegistryDiscoveryFrame = RegistrySnapshotFrame | RegistryDeltaFrame;
+/**
+ * Worker projection WebSocket endpoint:
+ *   GET /registry/worker?namespaceKey=<owner>&runId=<sessionId>
+ *
+ * Worker -> relay frames are projection updates. Per L7/L8, run state and
+ * control routing both belong to the unified relay surface; opaque collab-room
+ * control remains separate from discovery snapshots.
+ */
+export declare const WorkerProjectionFrame: Schema.Struct<{
+    readonly type: Schema.Literal<"projection">;
+    readonly projection: Schema.Unknown;
+}>;
+export type WorkerProjectionFrame = typeof WorkerProjectionFrame.Type;

package/dist/src/discovery.d.ts

@@ -0,0 +1,33 @@
+import { Stream } from "effect";
+import { type ListedRegistryEntry, type RegistrySnapshotFrame } from "./relay-registry";
+import type { RunDiscoveryFilter as CollabRegistryFilter, LiveRunCollabProjection as LiveCollabProjection } from "@rig/contracts";
+export declare function registryBaseUrl(projectRoot?: string, env?: NodeJS.ProcessEnv): string;
+export type RegistryBackedCollabProjection = LiveCollabProjection & {
+    readonly registryStatus?: ListedRegistryEntry["status"];
+    readonly registryProjection?: unknown;
+};
+export declare function collabFromRegistryEntry(entry: ListedRegistryEntry): RegistryBackedCollabProjection;
+export declare function listActiveRunCollab(projectRoot: string, filter: CollabRegistryFilter): Promise<readonly LiveCollabProjection[]>;
+export declare function defaultListActiveCollabSessions(projectRoot: string, filter: CollabRegistryFilter): Promise<readonly LiveCollabProjection[]>;
+export declare function matchesRun(collab: LiveCollabProjection, runId: string, taskId?: string | null): boolean;
+/** Build the discovery stream from relay registry snapshots only. */
+export declare function runDiscoveryStream(projectRoot: string): Stream.Stream<void>;
+export declare function registrySnapshotStream(projectRoot: string, filter?: CollabRegistryFilter): Stream.Stream<RegistrySnapshotFrame>;
+export type RigExtensionAttachResult = {
+    readonly sessionPath: string | null;
+    readonly joinLink: string | null;
+    readonly collabSessionId: string | null;
+};
+export type AttachViaRelayInput = {
+    readonly runId: string;
+    readonly taskId?: string | null;
+    readonly identityFilter: CollabRegistryFilter;
+    readonly timeoutMs?: number;
+    readonly projectRoot?: string;
+};
+type AttachViaRelayDeps = {
+    readonly listActiveCollabSessions?: (filter: CollabRegistryFilter) => Promise<readonly LiveCollabProjection[]>;
+    readonly discoveryStream?: (projectRoot: string) => Stream.Stream<void>;
+};
+export declare function attachViaRelay(input: AttachViaRelayInput, deps?: AttachViaRelayDeps): Promise<RigExtensionAttachResult | null>;
+export {};