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

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

@@ -0,0 +1,12 @@
+/** Operator-facing active-run classification.
+ *
+ * The canonical run-journal vocabulary intentionally keeps `needs-attention` as
+ * non-terminal so resume/steer/closeout state machines can still act on it.
+ * OpenTUI/task projections need a narrower meaning: only runs that are actively
+ * occupying a task slot should render as the task's active run. Legacy/closeout
+ * statuses from older authority files are treated conservatively as inactive so
+ * merged/closed runs do not pin task rows forever.
+ */
+export declare const OPERATOR_INACTIVE_RUN_STATUSES: ReadonlySet<string>;
+export declare function normalizeRunStatusToken(status: unknown): string;
+export declare function isOperatorActiveRunStatus(status: unknown): boolean;

package/dist/src/run-status.js

@@ -0,0 +1,38 @@
+// @bun
+// packages/contracts/src/run-status.ts
+var OPERATOR_INACTIVE_RUN_STATUSES = new Set([
+  "completed",
+  "complete",
+  "done",
+  "success",
+  "succeeded",
+  "passed",
+  "failed",
+  "failure",
+  "error",
+  "errored",
+  "stopped",
+  "cancelled",
+  "canceled",
+  "aborted",
+  "abort",
+  "merged",
+  "closed",
+  "skipped",
+  "needs-attention",
+  "needs_attention"
+]);
+function normalizeRunStatusToken(status) {
+  return String(status ?? "").trim().toLowerCase().replace(/\s+/g, "-");
+}
+function isOperatorActiveRunStatus(status) {
+  const normalized = normalizeRunStatusToken(status);
+  if (!normalized)
+    return false;
+  return !OPERATOR_INACTIVE_RUN_STATUSES.has(normalized);
+}
+export {
+  normalizeRunStatusToken,
+  isOperatorActiveRunStatus,
+  OPERATOR_INACTIVE_RUN_STATUSES
+};

package/dist/src/runtime.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/server.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/serviceFabric.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/terminal.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/validation.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/workspace.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/ws.d.ts

@@ -84,6 +84,9 @@ export declare const WebSocketRequest: 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;
         readonly _tag: Schema.tag<"rig.createAdhocRun">;
     }>, Schema.Struct<{
@@ -97,6 +100,10 @@ export declare const WebSocketRequest: 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;
         readonly _tag: Schema.tag<"rig.createTaskRun">;
     }>, Schema.Struct<{
@@ -125,6 +132,13 @@ export declare const WebSocketRequest: Schema.Struct<{
         readonly attachments: Schema.optional<Schema.$Array<Schema.Unknown>>;
         readonly createdAt: Schema.String;
         readonly _tag: Schema.tag<"rig.submitRunMessage">;
+    }>, 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;
+        readonly _tag: Schema.tag<"rig.queueRunSteering">;
     }>, Schema.Struct<{
         readonly commandId: Schema.brand<Schema.Trim, "CommandId">;
         readonly runId: Schema.brand<Schema.Trim, "RunId">;

package/dist/src/ws.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");
@@ -2208,6 +2211,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",
@@ -2286,6 +2290,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({
@@ -2299,6 +2306,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({
@@ -2327,6 +2338,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,
@@ -2818,6 +2842,7 @@ var WebSocketRequestBody = Schema20.Union([
   tagRequestBody(RIG_WS_METHODS.enqueueTask, RigEnqueueTaskInput),
   tagRequestBody(RIG_WS_METHODS.resumeRun, RigResumeRunInput),
   tagRequestBody(RIG_WS_METHODS.submitRunMessage, RigSubmitRunMessageInput),
+  tagRequestBody(RIG_WS_METHODS.queueRunSteering, RigQueueRunSteeringInput),
   tagRequestBody(RIG_WS_METHODS.interruptRun, RigInterruptRunInput),
   tagRequestBody(RIG_WS_METHODS.stopRun, RigStopRunInput),
   tagRequestBody(RIG_WS_METHODS.resolveApproval, RigResolveApprovalInput),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@h-rig/contracts",
-  "version": "0.0.6-alpha.90",
+  "version": "0.0.6-alpha.91",
   "type": "module",
   "description": "Rig package",
   "license": "UNLICENSED",