@jmoyers/harness 0.1.11 → 0.1.20

package/src/control-plane/stream-protocol.ts

@@ -10,6 +10,17 @@ export type StreamPromptCaptureSource = 'otlp-log' | 'hook-notify' | 'history';
 export type StreamPromptConfidence = 'high' | 'medium' | 'low';
 export type StreamSessionControllerType = 'human' | 'agent' | 'automation';
 export type StreamSessionDisplayPhase = 'needs-action' | 'starting' | 'working' | 'idle' | 'exited';
+export type StreamSessionActivityHint = 'needs-action' | 'working' | 'idle';
+
+export function isStreamSessionRuntimeStatus(value: unknown): value is StreamSessionRuntimeStatus {
+  return (
+    value === 'running' || value === 'needs-input' || value === 'completed' || value === 'exited'
+  );
+}
+
+export function parseStreamSessionRuntimeStatus(value: unknown): StreamSessionRuntimeStatus | null {
+  return isStreamSessionRuntimeStatus(value) ? value : null;
+}
 
 export interface StreamSessionController {
   controllerId: string;
@@ -35,7 +46,7 @@ export interface StreamSessionStatusModel {
   attentionReason: string | null;
   lastKnownWork: string | null;
   lastKnownWorkAt: string | null;
-  phaseHint: 'needs-action' | 'working' | 'idle' | null;
+  activityHint: StreamSessionActivityHint | null;
   observedAt: string;
 }
 
@@ -131,27 +142,10 @@ interface ConversationDeleteCommand {
 
 type StreamTaskStatus = 'draft' | 'ready' | 'in-progress' | 'completed';
 type StreamTaskScopeKind = 'global' | 'repository' | 'project';
-type StreamTaskLinearPriority = 0 | 1 | 2 | 3 | 4;
 type StreamProjectTaskFocusMode = 'balanced' | 'own-only';
 type StreamProjectThreadSpawnMode = 'new-thread' | 'reuse-thread';
 type StreamAutomationPolicyScope = 'global' | 'repository' | 'project';
 
-interface StreamTaskLinearInput {
-  issueId?: string | null;
-  identifier?: string | null;
-  url?: string | null;
-  teamId?: string | null;
-  projectId?: string | null;
-  projectMilestoneId?: string | null;
-  cycleId?: string | null;
-  stateId?: string | null;
-  assigneeId?: string | null;
-  priority?: StreamTaskLinearPriority | null;
-  estimate?: number | null;
-  dueDate?: string | null;
-  labelIds?: readonly string[] | null;
-}
-
 interface RepositoryUpsertCommand {
   type: 'repository.upsert';
   repositoryId?: string;
@@ -200,9 +194,8 @@ interface TaskCreateCommand {
   workspaceId?: string;
   repositoryId?: string;
   projectId?: string;
-  title: string;
-  description?: string;
-  linear?: StreamTaskLinearInput;
+  title?: string | null;
+  body: string;
 }
 
 interface TaskGetCommand {
@@ -225,11 +218,10 @@ interface TaskListCommand {
 interface TaskUpdateCommand {
   type: 'task.update';
   taskId: string;
-  title?: string;
-  description?: string;
+  title?: string | null;
+  body?: string;
   repositoryId?: string | null;
   projectId?: string | null;
-  linear?: StreamTaskLinearInput | null;
 }
 
 interface TaskDeleteCommand {
@@ -329,6 +321,12 @@ interface GitHubProjectPrCommand {
   directoryId: string;
 }
 
+interface GitHubProjectReviewCommand {
+  type: 'github.project-review';
+  directoryId: string;
+  forceRefresh?: boolean;
+}
+
 interface GitHubPrListCommand {
   type: 'github.pr-list';
   tenantId?: string;
@@ -366,6 +364,16 @@ interface GitHubRepoMyPrsUrlCommand {
   repositoryId: string;
 }
 
+interface LinearIssueImportCommand {
+  type: 'linear.issue.import';
+  url: string;
+  tenantId?: string;
+  userId?: string;
+  workspaceId?: string;
+  repositoryId?: string;
+  projectId?: string;
+}
+
 interface StreamSubscribeCommand {
   type: 'stream.subscribe';
   tenantId?: string;
@@ -524,10 +532,12 @@ export type StreamCommand =
   | AutomationPolicyGetCommand
   | AutomationPolicySetCommand
   | GitHubProjectPrCommand
+  | GitHubProjectReviewCommand
   | GitHubPrListCommand
   | GitHubPrCreateCommand
   | GitHubPrJobsListCommand
   | GitHubRepoMyPrsUrlCommand
+  | LinearIssueImportCommand
   | StreamSubscribeCommand
   | StreamUnsubscribeCommand
   | SessionListCommand
@@ -1097,6 +1107,13 @@ function parsePromptConfidence(value: unknown): StreamPromptConfidence | null {
   return null;
 }
 
+function parseSessionActivityHint(value: unknown): StreamSessionActivityHint | undefined {
+  if (value === 'needs-action' || value === 'working' || value === 'idle') {
+    return value;
+  }
+  return undefined;
+}
+
 function parseTelemetrySummary(value: unknown): StreamTelemetrySummary | null | undefined {
   if (value === undefined) {
     return undefined;
@@ -1131,7 +1148,9 @@ function parseTelemetrySummary(value: unknown): StreamTelemetrySummary | null |
   };
 }
 
-function parseSessionStatusModel(value: unknown): StreamSessionStatusModel | null | undefined {
+export function parseStreamSessionStatusModel(
+  value: unknown,
+): StreamSessionStatusModel | null | undefined {
   if (value === undefined) {
     return undefined;
   }
@@ -1153,14 +1172,15 @@ function parseSessionStatusModel(value: unknown): StreamSessionStatusModel | nul
     record['lastKnownWork'] === null ? null : readString(record['lastKnownWork']);
   const lastKnownWorkAt =
     record['lastKnownWorkAt'] === null ? null : readString(record['lastKnownWorkAt']);
-  const phaseHint = record['phaseHint'] === null ? null : readString(record['phaseHint']);
+  const activityHintValue = record['activityHint'];
+  const activityHint =
+    activityHintValue === undefined || activityHintValue === null
+      ? null
+      : parseSessionActivityHint(activityHintValue);
   const observedAt = readString(record['observedAt']);
   if (
     runtimeStatus === null ||
-    (runtimeStatus !== 'running' &&
-      runtimeStatus !== 'needs-input' &&
-      runtimeStatus !== 'completed' &&
-      runtimeStatus !== 'exited') ||
+    !isStreamSessionRuntimeStatus(runtimeStatus) ||
     phase === null ||
     (phase !== 'needs-action' &&
       phase !== 'starting' &&
@@ -1175,11 +1195,7 @@ function parseSessionStatusModel(value: unknown): StreamSessionStatusModel | nul
     (attentionReason === null && record['attentionReason'] !== null) ||
     (lastKnownWork === null && record['lastKnownWork'] !== null) ||
     (lastKnownWorkAt === null && record['lastKnownWorkAt'] !== null) ||
-    (phaseHint === null && record['phaseHint'] !== null) ||
-    (phaseHint !== null &&
-      phaseHint !== 'needs-action' &&
-      phaseHint !== 'working' &&
-      phaseHint !== 'idle') ||
+    activityHint === undefined ||
     observedAt === null
   ) {
     return undefined;
@@ -1193,7 +1209,7 @@ function parseSessionStatusModel(value: unknown): StreamSessionStatusModel | nul
     attentionReason,
     lastKnownWork,
     lastKnownWorkAt,
-    phaseHint,
+    activityHint,
     observedAt,
   };
 }
@@ -1599,7 +1615,7 @@ function parseStreamObservedEvent(value: unknown): StreamObservedEvent | null {
     const sessionId = readString(record['sessionId']);
     const status = readString(record['status']);
     const attentionReason = readString(record['attentionReason']);
-    const statusModel = parseSessionStatusModel(record['statusModel']);
+    const statusModel = parseStreamSessionStatusModel(record['statusModel']);
     const live = readBoolean(record['live']);
     const ts = readString(record['ts']);
     const directoryId = readString(record['directoryId']);