@jmoyers/harness 0.1.11 → 0.1.20

package/src/control-plane/session-summary.ts

@@ -1,10 +1,12 @@
 import type { PtyExit } from '../pty/pty_host.ts';
-import type {
-  StreamSessionController,
-  StreamSessionControllerType,
-  StreamSessionRuntimeStatus,
-  StreamSessionStatusModel,
-  StreamTelemetrySummary,
+import {
+  isStreamSessionRuntimeStatus,
+  parseStreamSessionStatusModel,
+  type StreamSessionController,
+  type StreamSessionControllerType,
+  type StreamSessionRuntimeStatus,
+  type StreamSessionStatusModel,
+  type StreamTelemetrySummary,
 } from './stream-protocol.ts';
 
 interface StreamSessionSummary {
@@ -187,79 +189,6 @@ function readSessionController(value: unknown): StreamSessionController | null |
   };
 }
 
-function readSessionStatusModel(value: unknown): StreamSessionStatusModel | null | undefined {
-  if (value === undefined) {
-    return undefined;
-  }
-  if (value === null) {
-    return null;
-  }
-  const record = asRecord(value);
-  if (record === null) {
-    return undefined;
-  }
-  const runtimeStatus = readString(record['runtimeStatus']);
-  const phase = readString(record['phase']);
-  const glyph = readString(record['glyph']);
-  const badge = readString(record['badge']);
-  const detailText = readString(record['detailText']);
-  const attentionReason = readNullableString(record['attentionReason']);
-  const lastKnownWork = readNullableString(record['lastKnownWork']);
-  const lastKnownWorkAt = readNullableString(record['lastKnownWorkAt']);
-  const phaseHintRaw = readNullableString(record['phaseHint']);
-  const observedAt = readString(record['observedAt']);
-  if (
-    runtimeStatus === null ||
-    !isRuntimeStatus(runtimeStatus) ||
-    phase === null ||
-    (phase !== 'needs-action' &&
-      phase !== 'starting' &&
-      phase !== 'working' &&
-      phase !== 'idle' &&
-      phase !== 'exited') ||
-    glyph === null ||
-    (glyph !== '▲' && glyph !== '◔' && glyph !== '◆' && glyph !== '○' && glyph !== '■') ||
-    badge === null ||
-    (badge !== 'NEED' && badge !== 'RUN ' && badge !== 'DONE' && badge !== 'EXIT') ||
-    detailText === null ||
-    attentionReason === undefined ||
-    lastKnownWork === undefined ||
-    lastKnownWorkAt === undefined ||
-    phaseHintRaw === undefined ||
-    observedAt === null
-  ) {
-    return undefined;
-  }
-  const phaseHint =
-    phaseHintRaw === null ||
-    phaseHintRaw === 'needs-action' ||
-    phaseHintRaw === 'working' ||
-    phaseHintRaw === 'idle'
-      ? phaseHintRaw
-      : undefined;
-  if (phaseHint === undefined) {
-    return undefined;
-  }
-  return {
-    runtimeStatus,
-    phase,
-    glyph,
-    badge,
-    detailText,
-    attentionReason,
-    lastKnownWork,
-    lastKnownWorkAt,
-    phaseHint,
-    observedAt,
-  };
-}
-
-function isRuntimeStatus(value: string): value is StreamSessionRuntimeStatus {
-  return (
-    value === 'running' || value === 'needs-input' || value === 'completed' || value === 'exited'
-  );
-}
-
 export function parseSessionSummaryRecord(value: unknown): StreamSessionSummary | null {
   const record = asRecord(value);
   if (record === null) {
@@ -280,12 +209,12 @@ export function parseSessionSummaryRecord(value: unknown): StreamSessionSummary
     workspaceId === null ||
     worktreeId === null ||
     status === null ||
-    !isRuntimeStatus(status)
+    !isStreamSessionRuntimeStatus(status)
   ) {
     return null;
   }
   const attentionReason = readNullableString(record['attentionReason']);
-  const statusModel = readSessionStatusModel(record['statusModel']);
+  const statusModel = parseStreamSessionStatusModel(record['statusModel']);
   const latestCursor = readNullableNumber(record['latestCursor']);
   const processId = readNullableNumber(record['processId']);
   const attachedClients = readNumber(record['attachedClients']);

package/src/control-plane/status/reducer-base.ts

@@ -8,7 +8,7 @@ import type { AgentStatusProjectionInput, AgentStatusReducer } from './agent-sta
 
 interface WorkProjection {
   readonly text: string | null;
-  readonly phaseHint: 'needs-action' | 'working' | 'idle' | null;
+  readonly activityHint: 'needs-action' | 'working' | 'idle' | null;
 }
 
 function normalizeText(value: string | null): string | null {
@@ -40,7 +40,7 @@ function eventIsNewer(observedAt: string, previousObservedAt: string | null): bo
 
 function phaseFromRuntimeStatus(
   runtimeStatus: StreamSessionRuntimeStatus,
-  phaseHint: WorkProjection['phaseHint'],
+  activityHint: WorkProjection['activityHint'],
 ): StreamSessionDisplayPhase {
   if (runtimeStatus === 'needs-input') {
     return 'needs-action';
@@ -48,13 +48,13 @@ function phaseFromRuntimeStatus(
   if (runtimeStatus === 'exited') {
     return 'exited';
   }
-  if (phaseHint === 'working') {
+  if (activityHint === 'working') {
     return 'working';
   }
-  if (phaseHint === 'needs-action') {
+  if (activityHint === 'needs-action') {
     return 'needs-action';
   }
-  if (phaseHint === 'idle') {
+  if (activityHint === 'idle') {
     return 'idle';
   }
   if (runtimeStatus === 'running') {
@@ -118,14 +118,14 @@ export abstract class BaseAgentStatusReducer implements AgentStatusReducer {
   project(input: AgentStatusProjectionInput): StreamSessionStatusModel | null {
     const previous = input.previous;
     let workText = previous?.lastKnownWork ?? null;
-    let workPhaseHint = previous?.phaseHint ?? null;
+    let workActivityHint = previous?.activityHint ?? null;
     let workObservedAt = previous?.lastKnownWorkAt ?? null;
 
     if (input.telemetry !== null && eventIsNewer(input.telemetry.observedAt, workObservedAt)) {
       const projected = this.projectFromTelemetry(input.telemetry);
       if (projected !== null) {
         workText = projected.text;
-        workPhaseHint = projected.phaseHint;
+        workActivityHint = projected.activityHint;
         workObservedAt = input.telemetry.observedAt;
       }
     }
@@ -133,19 +133,19 @@ export abstract class BaseAgentStatusReducer implements AgentStatusReducer {
     if (
       input.runtimeStatus === 'completed' &&
       eventIsNewer(input.observedAt, workObservedAt) &&
-      workPhaseHint !== 'needs-action'
+      workActivityHint !== 'needs-action'
     ) {
       workText = 'inactive';
-      workPhaseHint = 'idle';
+      workActivityHint = 'idle';
       workObservedAt = input.observedAt;
     }
     if (input.runtimeStatus === 'exited' && eventIsNewer(input.observedAt, workObservedAt)) {
       workText = 'exited';
-      workPhaseHint = 'idle';
+      workActivityHint = 'idle';
       workObservedAt = input.observedAt;
     }
 
-    const phase = phaseFromRuntimeStatus(input.runtimeStatus, workPhaseHint);
+    const phase = phaseFromRuntimeStatus(input.runtimeStatus, workActivityHint);
     const normalizedAttentionReason = normalizeText(input.attentionReason);
     const detailText =
       (input.runtimeStatus === 'needs-input' ? normalizedAttentionReason : null) ??
@@ -162,7 +162,7 @@ export abstract class BaseAgentStatusReducer implements AgentStatusReducer {
       attentionReason: normalizedAttentionReason,
       lastKnownWork: workText,
       lastKnownWorkAt: workObservedAt,
-      phaseHint: workPhaseHint,
+      activityHint: workActivityHint,
       observedAt: input.observedAt,
     };
   }

package/src/control-plane/status/reducers/claude-status-reducer.ts

@@ -14,12 +14,12 @@ export class ClaudeStatusReducer extends BaseAgentStatusReducer {
 
   protected override projectFromTelemetry(
     telemetry: StreamTelemetrySummary,
-  ): { text: string | null; phaseHint: 'needs-action' | 'working' | 'idle' | null } | null {
+  ): { text: string | null; activityHint: 'needs-action' | 'working' | 'idle' | null } | null {
     const eventName = normalize(telemetry.eventName);
     if (eventName === 'claude.userpromptsubmit' || eventName === 'claude.pretooluse') {
       return {
         text: 'active',
-        phaseHint: 'working',
+        activityHint: 'working',
       };
     }
     if (
@@ -29,7 +29,7 @@ export class ClaudeStatusReducer extends BaseAgentStatusReducer {
     ) {
       return {
         text: 'inactive',
-        phaseHint: 'idle',
+        activityHint: 'idle',
       };
     }
     return null;

package/src/control-plane/status/reducers/codex-status-reducer.ts

@@ -14,19 +14,19 @@ export class CodexStatusReducer extends BaseAgentStatusReducer {
 
   protected override projectFromTelemetry(
     telemetry: StreamTelemetrySummary,
-  ): { text: string | null; phaseHint: 'needs-action' | 'working' | 'idle' | null } | null {
+  ): { text: string | null; activityHint: 'needs-action' | 'working' | 'idle' | null } | null {
     const eventName = normalize(telemetry.eventName);
     const summary = normalize(telemetry.summary);
     if (eventName === 'codex.user_prompt') {
       return {
         text: 'active',
-        phaseHint: 'working',
+        activityHint: 'working',
       };
     }
     if (eventName === 'codex.turn.e2e_duration_ms') {
       return {
         text: 'inactive',
-        phaseHint: 'idle',
+        activityHint: 'idle',
       };
     }
     if (eventName === 'codex.sse_event') {
@@ -39,7 +39,7 @@ export class CodexStatusReducer extends BaseAgentStatusReducer {
       ) {
         return {
           text: 'active',
-          phaseHint: 'working',
+          activityHint: 'working',
         };
       }
     }

package/src/control-plane/status/reducers/cursor-status-reducer.ts

@@ -14,7 +14,7 @@ export class CursorStatusReducer extends BaseAgentStatusReducer {
 
   protected override projectFromTelemetry(
     telemetry: StreamTelemetrySummary,
-  ): { text: string | null; phaseHint: 'needs-action' | 'working' | 'idle' | null } | null {
+  ): { text: string | null; activityHint: 'needs-action' | 'working' | 'idle' | null } | null {
     const eventName = normalize(telemetry.eventName);
     if (
       eventName === 'cursor.beforesubmitprompt' ||
@@ -23,13 +23,13 @@ export class CursorStatusReducer extends BaseAgentStatusReducer {
     ) {
       return {
         text: 'active',
-        phaseHint: 'working',
+        activityHint: 'working',
       };
     }
     if (eventName === 'cursor.stop' || eventName === 'cursor.sessionend') {
       return {
         text: 'inactive',
-        phaseHint: 'idle',
+        activityHint: 'idle',
       };
     }
     return null;

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

@@ -26,7 +26,17 @@ interface PendingCommand {
   reject: (error: Error) => void;
 }
 
-export class ControlPlaneStreamClient {
+export interface ControlPlaneStreamClient {
+  onEnvelope(listener: (envelope: StreamServerEnvelope) => void): () => void;
+  sendCommand(command: StreamCommand): Promise<Record<string, unknown>>;
+  authenticate(token: string): Promise<void>;
+  sendInput(sessionId: string, data: Buffer): void;
+  sendResize(sessionId: string, cols: number, rows: number): void;
+  sendSignal(sessionId: string, signal: StreamSignal): void;
+  close(): void;
+}
+
+class ControlPlaneStreamClientImpl implements ControlPlaneStreamClient {
   private readonly socket: Socket;
   private readonly listeners = new Set<(envelope: StreamServerEnvelope) => void>();
   private readonly pending = new Map<string, PendingCommand>();
@@ -380,7 +390,7 @@ export async function connectControlPlaneStreamClient(
     }
   }
 
-  const client = new ControlPlaneStreamClient(socket);
+  const client = new ControlPlaneStreamClientImpl(socket);
   if (typeof options.authToken === 'string') {
     await client.authenticate(options.authToken);
   }

package/src/control-plane/stream-command-parser.ts

@@ -3,7 +3,6 @@ import type { StreamCommand } from './stream-protocol.ts';
 type StreamCommandType = StreamCommand['type'];
 type CommandRecord = Record<string, unknown>;
 type CommandParser = (record: CommandRecord) => StreamCommand | null;
-type ParsedTaskLinearInput = NonNullable<Extract<StreamCommand, { type: 'task.create' }>['linear']>;
 const INVALID_OPTIONAL = Symbol('invalid-optional');
 
 function asRecord(value: unknown): CommandRecord | null {
@@ -95,115 +94,6 @@ function readOptionalNullableString(
   return value;
 }
 
-function readOptionalNullableNonNegativeInteger(
-  record: CommandRecord,
-  field: string,
-): number | null | undefined | typeof INVALID_OPTIONAL {
-  const value = record[field];
-  if (value === undefined) {
-    return undefined;
-  }
-  if (value === null) {
-    return null;
-  }
-  if (typeof value !== 'number' || !Number.isInteger(value) || value < 0) {
-    return INVALID_OPTIONAL;
-  }
-  return value;
-}
-
-function parseTaskLinearInput(value: unknown): ParsedTaskLinearInput | null {
-  const record = asRecord(value);
-  if (record === null) {
-    return null;
-  }
-  const issueId = readOptionalNullableString(record, 'issueId');
-  const identifier = readOptionalNullableString(record, 'identifier');
-  const url = readOptionalNullableString(record, 'url');
-  const teamId = readOptionalNullableString(record, 'teamId');
-  const projectId = readOptionalNullableString(record, 'projectId');
-  const projectMilestoneId = readOptionalNullableString(record, 'projectMilestoneId');
-  const cycleId = readOptionalNullableString(record, 'cycleId');
-  const stateId = readOptionalNullableString(record, 'stateId');
-  const assigneeId = readOptionalNullableString(record, 'assigneeId');
-  const dueDate = readOptionalNullableString(record, 'dueDate');
-  const priority = readOptionalNullableNonNegativeInteger(record, 'priority');
-  const estimate = readOptionalNullableNonNegativeInteger(record, 'estimate');
-  const labelsRaw = record['labelIds'];
-  let labelIds: string[] | null | undefined;
-  if (labelsRaw !== undefined) {
-    if (labelsRaw === null) {
-      labelIds = null;
-    } else if (Array.isArray(labelsRaw) && labelsRaw.every((entry) => typeof entry === 'string')) {
-      labelIds = [...labelsRaw];
-    } else {
-      return null;
-    }
-  }
-
-  if (
-    issueId === INVALID_OPTIONAL ||
-    identifier === INVALID_OPTIONAL ||
-    url === INVALID_OPTIONAL ||
-    teamId === INVALID_OPTIONAL ||
-    projectId === INVALID_OPTIONAL ||
-    projectMilestoneId === INVALID_OPTIONAL ||
-    cycleId === INVALID_OPTIONAL ||
-    stateId === INVALID_OPTIONAL ||
-    assigneeId === INVALID_OPTIONAL ||
-    dueDate === INVALID_OPTIONAL ||
-    priority === INVALID_OPTIONAL ||
-    estimate === INVALID_OPTIONAL
-  ) {
-    return null;
-  }
-  if (priority !== undefined && priority !== null && priority > 4) {
-    return null;
-  }
-
-  const out: ParsedTaskLinearInput = {};
-  if (issueId !== undefined) {
-    out.issueId = issueId;
-  }
-  if (identifier !== undefined) {
-    out.identifier = identifier;
-  }
-  if (url !== undefined) {
-    out.url = url;
-  }
-  if (teamId !== undefined) {
-    out.teamId = teamId;
-  }
-  if (projectId !== undefined) {
-    out.projectId = projectId;
-  }
-  if (projectMilestoneId !== undefined) {
-    out.projectMilestoneId = projectMilestoneId;
-  }
-  if (cycleId !== undefined) {
-    out.cycleId = cycleId;
-  }
-  if (stateId !== undefined) {
-    out.stateId = stateId;
-  }
-  if (assigneeId !== undefined) {
-    out.assigneeId = assigneeId;
-  }
-  if (priority !== undefined) {
-    out.priority = priority as 0 | 1 | 2 | 3 | 4 | null;
-  }
-  if (estimate !== undefined) {
-    out.estimate = estimate;
-  }
-  if (dueDate !== undefined) {
-    out.dueDate = dueDate;
-  }
-  if (labelIds !== undefined) {
-    out.labelIds = labelIds;
-  }
-  return out;
-}
-
 function parseSessionControllerType(value: unknown): 'human' | 'agent' | 'automation' | null {
   if (value === 'human' || value === 'agent' || value === 'automation') {
     return value;
@@ -586,32 +476,38 @@ function parseRepositoryArchive(record: CommandRecord): StreamCommand | null {
 }
 
 function parseTaskCreate(record: CommandRecord): StreamCommand | null {
-  const title = readString(record['title']);
-  if (title === null) {
+  const body = readString(record['body']);
+  if (body === null) {
     return null;
   }
+  const title = readOptionalNullableString(record, 'title');
   const taskId = readOptionalString(record, 'taskId');
   const tenantId = readOptionalString(record, 'tenantId');
   const userId = readOptionalString(record, 'userId');
   const workspaceId = readOptionalString(record, 'workspaceId');
   const repositoryId = readOptionalString(record, 'repositoryId');
   const projectId = readOptionalString(record, 'projectId');
-  const description = readOptionalString(record, 'description');
   if (
+    title === INVALID_OPTIONAL ||
     taskId === undefined ||
     tenantId === undefined ||
     userId === undefined ||
     workspaceId === undefined ||
     repositoryId === undefined ||
-    projectId === undefined ||
-    description === undefined
+    projectId === undefined
   ) {
     return null;
   }
+  if (repositoryId === null && projectId === null) {
+    return null;
+  }
   const command: StreamCommand = {
     type: 'task.create',
-    title,
+    body,
   };
+  if (title !== undefined) {
+    command.title = title;
+  }
   if (taskId !== null) {
     command.taskId = taskId;
   }
@@ -630,16 +526,6 @@ function parseTaskCreate(record: CommandRecord): StreamCommand | null {
   if (projectId !== null) {
     command.projectId = projectId;
   }
-  if (description !== null) {
-    command.description = description;
-  }
-  if (record['linear'] !== undefined) {
-    const linear = parseTaskLinearInput(record['linear']);
-    if (linear === null) {
-      return null;
-    }
-    command.linear = linear;
-  }
   return command;
 }
 
@@ -728,9 +614,9 @@ function parseTaskUpdate(record: CommandRecord): StreamCommand | null {
   if (taskId === null) {
     return null;
   }
-  const title = readOptionalString(record, 'title');
-  const description = readOptionalString(record, 'description');
-  if (title === undefined || description === undefined) {
+  const title = readOptionalNullableString(record, 'title');
+  const body = readOptionalString(record, 'body');
+  if (title === INVALID_OPTIONAL || body === undefined) {
     return null;
   }
   let repositoryId: string | null | undefined;
@@ -753,16 +639,19 @@ function parseTaskUpdate(record: CommandRecord): StreamCommand | null {
   } else {
     return null;
   }
+  if (repositoryId === null && projectId === null) {
+    return null;
+  }
 
   const command: StreamCommand = {
     type: 'task.update',
     taskId,
   };
-  if (title !== null) {
+  if (title !== undefined) {
     command.title = title;
   }
-  if (description !== null) {
-    command.description = description;
+  if (body !== null) {
+    command.body = body;
   }
   if (repositoryId !== undefined) {
     command.repositoryId = repositoryId;
@@ -770,17 +659,6 @@ function parseTaskUpdate(record: CommandRecord): StreamCommand | null {
   if (projectId !== undefined) {
     command.projectId = projectId;
   }
-  if (record['linear'] !== undefined) {
-    if (record['linear'] === null) {
-      command.linear = null;
-    } else {
-      const linear = parseTaskLinearInput(record['linear']);
-      if (linear === null) {
-        return null;
-      }
-      command.linear = linear;
-    }
-  }
   return command;
 }
 
@@ -1109,6 +987,25 @@ function parseGitHubProjectPr(record: CommandRecord): StreamCommand | null {
   };
 }
 
+function parseGitHubProjectReview(record: CommandRecord): StreamCommand | null {
+  const directoryId = readString(record['directoryId']);
+  const forceRefresh = readOptionalBoolean(record, 'forceRefresh');
+  if (directoryId === null) {
+    return null;
+  }
+  if (forceRefresh === undefined) {
+    return null;
+  }
+  const command: StreamCommand = {
+    type: 'github.project-review',
+    directoryId,
+  };
+  if (forceRefresh !== null) {
+    command.forceRefresh = forceRefresh;
+  }
+  return command;
+}
+
 function parseGitHubPrList(record: CommandRecord): StreamCommand | null {
   const tenantId = readOptionalString(record, 'tenantId');
   const userId = readOptionalString(record, 'userId');
@@ -1256,6 +1153,47 @@ function parseGitHubRepoMyPrsUrl(record: CommandRecord): StreamCommand | null {
   };
 }
 
+function parseLinearIssueImport(record: CommandRecord): StreamCommand | null {
+  const url = readString(record['url']);
+  if (url === null) {
+    return null;
+  }
+  const tenantId = readOptionalString(record, 'tenantId');
+  const userId = readOptionalString(record, 'userId');
+  const workspaceId = readOptionalString(record, 'workspaceId');
+  const repositoryId = readOptionalString(record, 'repositoryId');
+  const projectId = readOptionalString(record, 'projectId');
+  if (
+    tenantId === undefined ||
+    userId === undefined ||
+    workspaceId === undefined ||
+    repositoryId === undefined ||
+    projectId === undefined
+  ) {
+    return null;
+  }
+  const command: StreamCommand = {
+    type: 'linear.issue.import',
+    url,
+  };
+  if (tenantId !== null) {
+    command.tenantId = tenantId;
+  }
+  if (userId !== null) {
+    command.userId = userId;
+  }
+  if (workspaceId !== null) {
+    command.workspaceId = workspaceId;
+  }
+  if (repositoryId !== null) {
+    command.repositoryId = repositoryId;
+  }
+  if (projectId !== null) {
+    command.projectId = projectId;
+  }
+  return command;
+}
+
 function parseStreamSubscribe(record: CommandRecord): StreamCommand | null {
   const tenantId = readOptionalString(record, 'tenantId');
   const userId = readOptionalString(record, 'userId');
@@ -1664,10 +1602,12 @@ export const DEFAULT_STREAM_COMMAND_PARSERS: StreamCommandParserRegistry = {
   'automation.policy-get': parseAutomationPolicyGet,
   'automation.policy-set': parseAutomationPolicySet,
   'github.project-pr': parseGitHubProjectPr,
+  'github.project-review': parseGitHubProjectReview,
   'github.pr-list': parseGitHubPrList,
   'github.pr-create': parseGitHubPrCreate,
   'github.pr-jobs-list': parseGitHubPrJobsList,
   'github.repo-my-prs-url': parseGitHubRepoMyPrsUrl,
+  'linear.issue.import': parseLinearIssueImport,
   'stream.subscribe': parseStreamSubscribe,
   'stream.unsubscribe': parseStreamUnsubscribe,
   'session.list': parseSessionList,