@h-rig/contracts 0.0.6-alpha.13 → 0.0.6-alpha.130

package/dist/src/run-record.d.ts

@@ -0,0 +1,45 @@
+import type { RunJournalProjection } from "./run-journal";
+import type { RigRunTimelineEntry } from "./run-timeline";
+export type UnifiedInboxRequest = {
+    readonly requestId: string;
+    readonly kind: "approval" | "input";
+    readonly title: string;
+    readonly body?: string | null;
+    readonly options?: readonly string[];
+    readonly requestedAt: string | null;
+    readonly source: "run";
+};
+/** Unified operator-facing run record shared by CLI, cockpit, relay, and client projection logic. */
+export interface RunRecord {
+    readonly runId: string;
+    readonly taskId: string | null;
+    readonly title: string;
+    /** RunStatus from the folded journal, or a liveness-derived fallback. */
+    readonly status: string;
+    readonly source: "local" | "remote";
+    /** True when the run is currently discoverable (registry heartbeat or local host). */
+    readonly live: boolean;
+    readonly stale: boolean;
+    readonly startedAt: string | null;
+    readonly updatedAt: string | null;
+    readonly completedAt: string | null;
+    readonly joinLink: string | null;
+    readonly webLink: string | null;
+    readonly relayUrl: string | null;
+    readonly sessionPath: string | null;
+    readonly prUrl: string | null;
+    readonly worktreePath: string | null;
+    readonly pendingApprovals: number;
+    readonly pendingInputs: number;
+    readonly steeringCount: number;
+    readonly stallCount: number;
+    readonly errorSummary?: string | null;
+    /** Timeline entries folded from the same OMP session custom entries as the journal. */
+    readonly timeline: RigRunTimelineEntry[];
+    /** Pending rig.run.* approvals/inputs only; rig.workflow.inbox.* is intentionally dead. */
+    readonly inbox: UnifiedInboxRequest[];
+    /** Live collab cwd when present in registry/discovery. */
+    readonly collabCwd: string | null;
+    /** The full folded journal (empty projection when no journal was readable). */
+    readonly projection: RunJournalProjection;
+}

package/dist/src/run-record.js

@@ -0,0 +1 @@
+// @bun

package/dist/src/run-session-journal.d.ts

@@ -0,0 +1,89 @@
+import { type RunJournalEvent, type RunJournalProjection } from "./run-journal";
+type DistributiveOmit<T, K extends PropertyKey> = T extends unknown ? Omit<T, K> : never;
+export type RunJournalEventInit = DistributiveOmit<RunJournalEvent, "v" | "seq" | "at" | "runId">;
+export declare const RIG_RUN_STATUS_CHANGED = "rig.run.status-changed";
+export declare const RIG_RUN_RECORD_PATCH = "rig.run.record-patch";
+export declare const RIG_RUN_TIMELINE_ENTRY = "rig.run.timeline-entry";
+export declare const RIG_RUN_LOG_ENTRY = "rig.run.log-entry";
+export declare const RIG_RUN_APPROVAL_REQUESTED = "rig.run.approval-requested";
+export declare const RIG_RUN_APPROVAL_RESOLVED = "rig.run.approval-resolved";
+export declare const RIG_RUN_INPUT_REQUESTED = "rig.run.input-requested";
+export declare const RIG_RUN_INPUT_RESOLVED = "rig.run.input-resolved";
+export declare const RIG_RUN_STEERING = "rig.run.steering";
+export declare const RIG_RUN_ADOPTED = "rig.run.adopted";
+export declare const RIG_RUN_STALL_DETECTED = "rig.run.stall-detected";
+export declare const RIG_RUN_CLOSEOUT_PHASE = "rig.run.closeout-phase";
+export declare const RIG_STOP_SENTINEL = "<<RIG_STOP";
+export declare const RIG_STOP_SENTINEL_END = ">>";
+export declare function buildStopSentinel(runId: string, reason?: string | null, requestedBy?: string): string;
+export declare function parseStopSentinel(text: string, expectedRunId: string): {
+    reason: string | null;
+} | null;
+export declare const RIG_PAUSE_SENTINEL = "<<RIG_PAUSE";
+export declare const RIG_RESUME_SENTINEL = "<<RIG_RESUME";
+export declare const RIG_CONTROL_SENTINEL_END = ">>";
+export declare function buildPauseSentinel(runId: string, requestedBy?: string): string;
+export declare function parsePauseSentinel(text: string, expectedRunId: string): {
+    requestedBy: string | null;
+} | null;
+export declare function buildResumeSentinel(runId: string, requestedBy?: string): string;
+export declare function parseResumeSentinel(text: string, expectedRunId: string): {
+    requestedBy: string | null;
+} | null;
+export type RunInboxResolutionSentinel = {
+    kind: "approval";
+    requestId: string;
+    decision: "approve" | "reject";
+    note?: string | null;
+    requestedBy: string | null;
+} | {
+    kind: "input";
+    requestId: string;
+    answers: Record<string, string>;
+    requestedBy: string | null;
+};
+export declare const RIG_INBOX_RESOLUTION_SENTINEL = "<<RIG_INBOX_RESOLUTION";
+export type RunInboxResolutionInit = {
+    kind: "approval";
+    requestId: string;
+    decision: "approve" | "reject";
+    note?: string | null;
+} | {
+    kind: "input";
+    requestId: string;
+    answers: Record<string, string>;
+};
+export declare function buildInboxResolutionSentinel(runId: string, resolution: RunInboxResolutionInit, requestedBy?: string): string;
+export declare function parseInboxResolutionSentinel(text: string, expectedRunId: string): RunInboxResolutionSentinel | null;
+/**
+ * The OMP session id embedded in a session journal filename
+ * (`<ISO-timestamp>_<sessionId>.jsonl`). This is a run's CANONICAL id — the same
+ * id OMP hosts as the collab roomId and the relay registry + operator CLI key on.
+ * A run's dispatch/worktree id is different; this is what links them, so stop /
+ * steer / discovery all resolve a run by one id (the OMP session id).
+ */
+export declare function sessionIdFromSessionFile(sessionPath: string | null | undefined): string | null;
+export declare const CUSTOM_TYPE_FOR: {
+    readonly "status-changed": "rig.run.status-changed";
+    readonly "record-patch": "rig.run.record-patch";
+    readonly "timeline-entry": "rig.run.timeline-entry";
+    readonly "log-entry": "rig.run.log-entry";
+    readonly "approval-requested": "rig.run.approval-requested";
+    readonly "approval-resolved": "rig.run.approval-resolved";
+    readonly "input-requested": "rig.run.input-requested";
+    readonly "input-resolved": "rig.run.input-resolved";
+    readonly steering: "rig.run.steering";
+    readonly adopted: "rig.run.adopted";
+    readonly "stall-detected": "rig.run.stall-detected";
+    readonly "closeout-phase": "rig.run.closeout-phase";
+};
+export type RunSessionCustomType = (typeof CUSTOM_TYPE_FOR)[RunJournalEvent["type"]];
+export declare const TYPE_FOR_CUSTOM: Readonly<Record<RunSessionCustomType, RunJournalEvent["type"]>>;
+export type RunSessionCustomEntry = {
+    type: string;
+    customType?: string;
+    data?: unknown;
+};
+export declare function isRunSessionCustomType(customType: string | undefined): customType is RunSessionCustomType;
+export declare function foldRunSessionEntries(entries: ReadonlyArray<RunSessionCustomEntry>, runId: string): RunJournalProjection;
+export {};