@h-rig/contracts 0.0.6-alpha.90 → 0.0.6-alpha.91

package/dist/src/ipc.d.ts

@@ -1,7 +1,7 @@
 import type { GitCheckoutInput, GitCreateBranchInput, GitCreateWorktreeInput, GitCreateWorktreeResult, GitInitInput, GitListBranchesInput, GitListBranchesResult, GitPullInput, GitPullResult, GitReadWorkingTreePatchInput, GitReadWorkingTreePatchResult, GitRemoveWorktreeInput, GitRunStackedActionInput, GitRunStackedActionResult, GitStatusInput, GitStatusResult } from "./git";
 import type { ProjectListDirectoryInput, ProjectListDirectoryResult, ProjectSearchEntriesInput, ProjectSearchEntriesResult, ProjectReadFileInput, ProjectReadFileResult, ProjectWriteFileInput, ProjectWriteFileResult } from "./project";
 import type { ServerConfig } from "./server";
-import type { RigCreateAdhocRunInput, RigCreateTaskRunInput, RigDeleteRunInput, RigEnqueueTaskInput, RigGetRunLogsInput, RigGetRunLogsResult, RigGetTaskArtifactsResult, RigRunLogAppendedPayload, RigGetWorkspaceInput, RigGetWorkspaceResult, RigListWorkspacesResult, RigMutationResult, RigInterruptRunInput, RigResumeRunInput, RigResolveApprovalInput, RigResolveUserInputInput, RigSnapshot, RigStopRunInput, RigSubmitRunMessageInput } from "./rig";
+import type { RigCreateAdhocRunInput, RigCreateTaskRunInput, RigDeleteRunInput, RigEnqueueTaskInput, RigGetRunLogsInput, RigGetRunLogsResult, RigGetTaskArtifactsResult, RigRunLogAppendedPayload, RigGetWorkspaceInput, RigGetWorkspaceResult, RigListWorkspacesResult, RigMutationResult, RigInterruptRunInput, RigQueueRunSteeringInput, RigQueueRunSteeringResult, RigResumeRunInput, RigResolveApprovalInput, RigResolveUserInputInput, RigSnapshot, RigStopRunInput, RigSubmitRunMessageInput } from "./rig";
 import type { TerminalClearInput, TerminalCloseInput, TerminalEvent, TerminalOpenInput, TerminalResizeInput, TerminalSessionSnapshot, TerminalWriteInput } from "./terminal";
 import type { ServerUpsertKeybindingInput, ServerUpsertKeybindingResult } from "./server";
 import type { ClientOrchestrationCommand, OrchestrationGetFullThreadDiffInput, OrchestrationGetFullThreadDiffResult, OrchestrationGetTurnDiffInput, OrchestrationGetTurnDiffResult, OrchestrationEvent, OrchestrationReadModel } from "./orchestration";
@@ -165,6 +165,7 @@ export interface NativeApi {
         enqueueTask: (input: RigEnqueueTaskInput) => Promise<RigMutationResult>;
         resumeRun: (input: RigResumeRunInput) => Promise<RigMutationResult>;
         submitRunMessage: (input: RigSubmitRunMessageInput) => Promise<RigMutationResult>;
+        queueRunSteering: (input: RigQueueRunSteeringInput) => Promise<RigQueueRunSteeringResult>;
         interruptRun: (input: RigInterruptRunInput) => Promise<RigMutationResult>;
         stopRun: (input: RigStopRunInput) => Promise<RigMutationResult>;
         resolveApproval: (input: RigResolveApprovalInput) => Promise<RigMutationResult>;

package/dist/src/keybindings.js

@@ -16,6 +16,9 @@ var WorkspaceId = makeEntityId("WorkspaceId");
 var GraphId = makeEntityId("GraphId");
 var TaskId = makeEntityId("TaskId");
 var RunId = makeEntityId("RunId");
+var SafePathSegment = TrimmedNonEmptyString.check(Schema.isPattern(/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/)).pipe(Schema.brand("SafePathSegment"));
+var SafeRunId = TrimmedNonEmptyString.check(Schema.isPattern(/^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$/)).pipe(Schema.brand("SafeRunId"));
+var SafeGitRefComponent = TrimmedNonEmptyString.check(Schema.isPattern(/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/)).pipe(Schema.brand("SafeGitRefComponent"));
 var EngineRuntimeId = makeEntityId("EngineRuntimeId");
 var ConversationId = makeEntityId("ConversationId");
 var ActionId = makeEntityId("ActionId");

package/dist/src/orchestration.js

@@ -29,6 +29,9 @@ var WorkspaceId = makeEntityId("WorkspaceId");
 var GraphId = makeEntityId("GraphId");
 var TaskId = makeEntityId("TaskId");
 var RunId = makeEntityId("RunId");
+var SafePathSegment = TrimmedNonEmptyString.check(Schema2.isPattern(/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/)).pipe(Schema2.brand("SafePathSegment"));
+var SafeRunId = TrimmedNonEmptyString.check(Schema2.isPattern(/^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$/)).pipe(Schema2.brand("SafeRunId"));
+var SafeGitRefComponent = TrimmedNonEmptyString.check(Schema2.isPattern(/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/)).pipe(Schema2.brand("SafeGitRefComponent"));
 var EngineRuntimeId = makeEntityId("EngineRuntimeId");
 var ConversationId = makeEntityId("ConversationId");
 var ActionId = makeEntityId("ActionId");

package/dist/src/policy.js

@@ -16,6 +16,9 @@ var WorkspaceId = makeEntityId("WorkspaceId");
 var GraphId = makeEntityId("GraphId");
 var TaskId = makeEntityId("TaskId");
 var RunId = makeEntityId("RunId");
+var SafePathSegment = TrimmedNonEmptyString.check(Schema.isPattern(/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/)).pipe(Schema.brand("SafePathSegment"));
+var SafeRunId = TrimmedNonEmptyString.check(Schema.isPattern(/^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$/)).pipe(Schema.brand("SafeRunId"));
+var SafeGitRefComponent = TrimmedNonEmptyString.check(Schema.isPattern(/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/)).pipe(Schema.brand("SafeGitRefComponent"));
 var EngineRuntimeId = makeEntityId("EngineRuntimeId");
 var ConversationId = makeEntityId("ConversationId");
 var ActionId = makeEntityId("ActionId");

package/dist/src/project.js

@@ -16,6 +16,9 @@ var WorkspaceId = makeEntityId("WorkspaceId");
 var GraphId = makeEntityId("GraphId");
 var TaskId = makeEntityId("TaskId");
 var RunId = makeEntityId("RunId");
+var SafePathSegment = TrimmedNonEmptyString.check(Schema.isPattern(/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/)).pipe(Schema.brand("SafePathSegment"));
+var SafeRunId = TrimmedNonEmptyString.check(Schema.isPattern(/^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$/)).pipe(Schema.brand("SafeRunId"));
+var SafeGitRefComponent = TrimmedNonEmptyString.check(Schema.isPattern(/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/)).pipe(Schema.brand("SafeGitRefComponent"));
 var EngineRuntimeId = makeEntityId("EngineRuntimeId");
 var ConversationId = makeEntityId("ConversationId");
 var ActionId = makeEntityId("ActionId");

package/dist/src/provider.js

@@ -16,6 +16,9 @@ var WorkspaceId = makeEntityId("WorkspaceId");
 var GraphId = makeEntityId("GraphId");
 var TaskId = makeEntityId("TaskId");
 var RunId = makeEntityId("RunId");
+var SafePathSegment = TrimmedNonEmptyString.check(Schema.isPattern(/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/)).pipe(Schema.brand("SafePathSegment"));
+var SafeRunId = TrimmedNonEmptyString.check(Schema.isPattern(/^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$/)).pipe(Schema.brand("SafeRunId"));
+var SafeGitRefComponent = TrimmedNonEmptyString.check(Schema.isPattern(/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/)).pipe(Schema.brand("SafeGitRefComponent"));
 var EngineRuntimeId = makeEntityId("EngineRuntimeId");
 var ConversationId = makeEntityId("ConversationId");
 var ActionId = makeEntityId("ActionId");

package/dist/src/providerRuntime.js

@@ -16,6 +16,9 @@ var WorkspaceId = makeEntityId("WorkspaceId");
 var GraphId = makeEntityId("GraphId");
 var TaskId = makeEntityId("TaskId");
 var RunId = makeEntityId("RunId");
+var SafePathSegment = TrimmedNonEmptyString.check(Schema.isPattern(/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/)).pipe(Schema.brand("SafePathSegment"));
+var SafeRunId = TrimmedNonEmptyString.check(Schema.isPattern(/^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$/)).pipe(Schema.brand("SafeRunId"));
+var SafeGitRefComponent = TrimmedNonEmptyString.check(Schema.isPattern(/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/)).pipe(Schema.brand("SafeGitRefComponent"));
 var EngineRuntimeId = makeEntityId("EngineRuntimeId");
 var ConversationId = makeEntityId("ConversationId");
 var ActionId = makeEntityId("ActionId");

package/dist/src/remote.js

@@ -16,6 +16,9 @@ var WorkspaceId = makeEntityId("WorkspaceId");
 var GraphId = makeEntityId("GraphId");
 var TaskId = makeEntityId("TaskId");
 var RunId = makeEntityId("RunId");
+var SafePathSegment = TrimmedNonEmptyString.check(Schema.isPattern(/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/)).pipe(Schema.brand("SafePathSegment"));
+var SafeRunId = TrimmedNonEmptyString.check(Schema.isPattern(/^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$/)).pipe(Schema.brand("SafeRunId"));
+var SafeGitRefComponent = TrimmedNonEmptyString.check(Schema.isPattern(/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/)).pipe(Schema.brand("SafeGitRefComponent"));
 var EngineRuntimeId = makeEntityId("EngineRuntimeId");
 var ConversationId = makeEntityId("ConversationId");
 var ActionId = makeEntityId("ActionId");

package/dist/src/review.js

@@ -16,6 +16,9 @@ var WorkspaceId = makeEntityId("WorkspaceId");
 var GraphId = makeEntityId("GraphId");
 var TaskId = makeEntityId("TaskId");
 var RunId = makeEntityId("RunId");
+var SafePathSegment = TrimmedNonEmptyString.check(Schema.isPattern(/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/)).pipe(Schema.brand("SafePathSegment"));
+var SafeRunId = TrimmedNonEmptyString.check(Schema.isPattern(/^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$/)).pipe(Schema.brand("SafeRunId"));
+var SafeGitRefComponent = TrimmedNonEmptyString.check(Schema.isPattern(/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/)).pipe(Schema.brand("SafeGitRefComponent"));
 var EngineRuntimeId = makeEntityId("EngineRuntimeId");
 var ConversationId = makeEntityId("ConversationId");
 var ActionId = makeEntityId("ActionId");

package/dist/src/rig.d.ts

@@ -11,6 +11,7 @@ export declare const RIG_WS_METHODS: {
     readonly enqueueTask: "rig.enqueueTask";
     readonly resumeRun: "rig.resumeRun";
     readonly submitRunMessage: "rig.submitRunMessage";
+    readonly queueRunSteering: "rig.queueRunSteering";
     readonly interruptRun: "rig.interruptRun";
     readonly stopRun: "rig.stopRun";
     readonly resolveApproval: "rig.resolveApproval";
@@ -656,6 +657,9 @@ export declare const RigCreateAdhocRunInput: Schema.Struct<{
     readonly executionTarget: Schema.optional<Schema.Literals<readonly ["local", "remote"]>>;
     readonly remoteHostId: Schema.optional<Schema.String>;
     readonly initialPrompt: Schema.optional<Schema.String>;
+    readonly baselineMode: Schema.optional<Schema.Literals<readonly ["head", "dirty-snapshot"]>>;
+    readonly prMode: Schema.optional<Schema.Literals<readonly ["auto", "ask", "off"]>>;
+    readonly initiatedBy: Schema.optional<Schema.String>;
     readonly createdAt: Schema.String;
 }>;
 export type RigCreateAdhocRunInput = typeof RigCreateAdhocRunInput.Type;
@@ -670,6 +674,10 @@ export declare const RigCreateTaskRunInput: Schema.Struct<{
     readonly interactionMode: Schema.withDecodingDefault<Schema.Literals<readonly ["default", "plan"]>>;
     readonly executionTarget: Schema.optional<Schema.Literals<readonly ["local", "remote"]>>;
     readonly remoteHostId: Schema.optional<Schema.String>;
+    readonly initialPrompt: Schema.optional<Schema.String>;
+    readonly baselineMode: Schema.optional<Schema.Literals<readonly ["head", "dirty-snapshot"]>>;
+    readonly prMode: Schema.optional<Schema.Literals<readonly ["auto", "ask", "off"]>>;
+    readonly initiatedBy: Schema.optional<Schema.String>;
     readonly createdAt: Schema.String;
 }>;
 export type RigCreateTaskRunInput = typeof RigCreateTaskRunInput.Type;
@@ -703,6 +711,28 @@ export declare const RigSubmitRunMessageInput: Schema.Struct<{
     readonly createdAt: Schema.String;
 }>;
 export type RigSubmitRunMessageInput = typeof RigSubmitRunMessageInput.Type;
+export declare const RigQueueRunSteeringInput: Schema.Struct<{
+    readonly commandId: Schema.brand<Schema.Trim, "CommandId">;
+    readonly runId: Schema.brand<Schema.Trim, "RunId">;
+    readonly message: Schema.Trim;
+    readonly actor: Schema.optional<Schema.String>;
+    readonly createdAt: Schema.String;
+}>;
+export type RigQueueRunSteeringInput = typeof RigQueueRunSteeringInput.Type;
+export declare const RigQueueRunSteeringResult: Schema.Struct<{
+    readonly sequence: Schema.Int;
+    readonly runId: Schema.brand<Schema.Trim, "RunId">;
+    readonly queued: Schema.Boolean;
+    readonly message: Schema.Struct<{
+        readonly id: Schema.Trim;
+        readonly runId: Schema.brand<Schema.Trim, "RunId">;
+        readonly message: Schema.Trim;
+        readonly actor: Schema.Trim;
+        readonly createdAt: Schema.String;
+        readonly delivered: Schema.Boolean;
+    }>;
+}>;
+export type RigQueueRunSteeringResult = typeof RigQueueRunSteeringResult.Type;
 export declare const RigInterruptRunInput: Schema.Struct<{
     readonly commandId: Schema.brand<Schema.Trim, "CommandId">;
     readonly runId: Schema.brand<Schema.Trim, "RunId">;

package/dist/src/rig.js

@@ -19,6 +19,9 @@ var WorkspaceId = makeEntityId("WorkspaceId");
 var GraphId = makeEntityId("GraphId");
 var TaskId = makeEntityId("TaskId");
 var RunId = makeEntityId("RunId");
+var SafePathSegment = TrimmedNonEmptyString.check(Schema.isPattern(/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/)).pipe(Schema.brand("SafePathSegment"));
+var SafeRunId = TrimmedNonEmptyString.check(Schema.isPattern(/^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$/)).pipe(Schema.brand("SafeRunId"));
+var SafeGitRefComponent = TrimmedNonEmptyString.check(Schema.isPattern(/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/)).pipe(Schema.brand("SafeGitRefComponent"));
 var EngineRuntimeId = makeEntityId("EngineRuntimeId");
 var ConversationId = makeEntityId("ConversationId");
 var ActionId = makeEntityId("ActionId");
@@ -2209,6 +2212,7 @@ var RIG_WS_METHODS = {
   enqueueTask: "rig.enqueueTask",
   resumeRun: "rig.resumeRun",
   submitRunMessage: "rig.submitRunMessage",
+  queueRunSteering: "rig.queueRunSteering",
   interruptRun: "rig.interruptRun",
   stopRun: "rig.stopRun",
   resolveApproval: "rig.resolveApproval",
@@ -2294,6 +2298,9 @@ var RigCreateAdhocRunInput = Schema14.Struct({
   executionTarget: Schema14.optional(RunExecutionTarget),
   remoteHostId: Schema14.optional(Schema14.String),
   initialPrompt: Schema14.optional(Schema14.String),
+  baselineMode: Schema14.optional(Schema14.Literals(["head", "dirty-snapshot"])),
+  prMode: Schema14.optional(Schema14.Literals(["auto", "ask", "off"])),
+  initiatedBy: Schema14.optional(Schema14.String),
   createdAt: IsoDateTime
 });
 var RigCreateTaskRunInput = Schema14.Struct({
@@ -2307,6 +2314,10 @@ var RigCreateTaskRunInput = Schema14.Struct({
   interactionMode: ProviderInteractionMode.pipe(Schema14.withDecodingDefault(() => DEFAULT_PROVIDER_INTERACTION_MODE)),
   executionTarget: Schema14.optional(RunExecutionTarget),
   remoteHostId: Schema14.optional(Schema14.String),
+  initialPrompt: Schema14.optional(Schema14.String),
+  baselineMode: Schema14.optional(Schema14.Literals(["head", "dirty-snapshot"])),
+  prMode: Schema14.optional(Schema14.Literals(["auto", "ask", "off"])),
+  initiatedBy: Schema14.optional(Schema14.String),
   createdAt: IsoDateTime
 });
 var RigEnqueueTaskInput = Schema14.Struct({
@@ -2335,6 +2346,19 @@ var RigSubmitRunMessageInput = Schema14.Struct({
   attachments: Schema14.optional(Schema14.Array(Schema14.Unknown)),
   createdAt: IsoDateTime
 });
+var RigQueueRunSteeringInput = Schema14.Struct({
+  commandId: CommandId,
+  runId: RunId,
+  message: TrimmedNonEmptyString,
+  actor: Schema14.optional(Schema14.String),
+  createdAt: IsoDateTime
+});
+var RigQueueRunSteeringResult = Schema14.Struct({
+  sequence: NonNegativeInt,
+  runId: RunId,
+  queued: Schema14.Boolean,
+  message: RigQueuedRunSteeringMessage
+});
 var RigInterruptRunInput = Schema14.Struct({
   commandId: CommandId,
   runId: RunId,
@@ -2380,6 +2404,8 @@ export {
   RigReplayEventsInput,
   RigRawRunLogEntry,
   RigQueuedRunSteeringMessage,
+  RigQueueRunSteeringResult,
+  RigQueueRunSteeringInput,
   RigMutationResult,
   RigListWorkspacesResult,
   RigListWorkspacesInput,

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

@@ -538,7 +538,7 @@ export declare const decodeRunJournalEvent: (input: unknown, options?: import("e
     readonly seq: number;
     readonly reason?: string | null | undefined;
     readonly actor?: {
-        readonly kind: "server" | "system" | "operator" | "agent";
+        readonly kind: "server" | "system" | "agent" | "operator";
         readonly id?: string | null | undefined;
     } | undefined;
 } | {
@@ -639,7 +639,7 @@ export declare const decodeRunJournalEvent: (input: unknown, options?: import("e
     readonly type: "approval-resolved";
     readonly requestId: string;
     readonly actor: {
-        readonly kind: "server" | "system" | "operator" | "agent";
+        readonly kind: "server" | "system" | "agent" | "operator";
         readonly id?: string | null | undefined;
     };
     readonly seq: number;
@@ -662,7 +662,7 @@ export declare const decodeRunJournalEvent: (input: unknown, options?: import("e
         readonly [x: string]: string;
     };
     readonly actor: {
-        readonly kind: "server" | "system" | "operator" | "agent";
+        readonly kind: "server" | "system" | "agent" | "operator";
         readonly id?: string | null | undefined;
     };
     readonly seq: number;
@@ -673,7 +673,7 @@ export declare const decodeRunJournalEvent: (input: unknown, options?: import("e
     readonly text: string;
     readonly type: "steering";
     readonly actor: {
-        readonly kind: "server" | "system" | "operator" | "agent";
+        readonly kind: "server" | "system" | "agent" | "operator";
         readonly id?: string | null | undefined;
     };
     readonly seq: number;

package/dist/src/run-journal.js

@@ -16,6 +16,9 @@ var WorkspaceId = makeEntityId("WorkspaceId");
 var GraphId = makeEntityId("GraphId");
 var TaskId = makeEntityId("TaskId");
 var RunId = makeEntityId("RunId");
+var SafePathSegment = TrimmedNonEmptyString.check(Schema.isPattern(/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/)).pipe(Schema.brand("SafePathSegment"));
+var SafeRunId = TrimmedNonEmptyString.check(Schema.isPattern(/^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$/)).pipe(Schema.brand("SafeRunId"));
+var SafeGitRefComponent = TrimmedNonEmptyString.check(Schema.isPattern(/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/)).pipe(Schema.brand("SafeGitRefComponent"));
 var EngineRuntimeId = makeEntityId("EngineRuntimeId");
 var ConversationId = makeEntityId("ConversationId");
 var ActionId = makeEntityId("ActionId");

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

@@ -0,0 +1,53 @@
+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;
+/**
+ * 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 {};