@jmoyers/harness 0.1.10 → 0.1.20

package/src/control-plane/agent-realtime-api.ts

@@ -1,7 +1,16 @@
 import type { PtyExit } from '../pty/pty_host.ts';
+import {
+  parseDirectoryGitStatusRecord as parseContractDirectoryGitStatusRecord,
+  parseDirectoryRecord as parseContractDirectoryRecord,
+  parseRepositoryRecord as parseContractRepositoryRecord,
+  parseTaskRecord as parseContractTaskRecord,
+  type ControlPlaneRepositoryRecord,
+} from '../core/contracts/records.ts';
 import { connectControlPlaneStreamClient, type ControlPlaneStreamClient } from './stream-client.ts';
 import { parseSessionSummaryList, parseSessionSummaryRecord } from './session-summary.ts';
 import {
+  parseStreamSessionRuntimeStatus,
+  parseStreamSessionStatusModel,
   type StreamCommand,
   type StreamObservedEvent,
   type StreamSessionController,
@@ -226,39 +235,6 @@ export interface AgentRepositoryUpdateInput {
 }
 
 export type AgentTaskStatus = 'draft' | 'ready' | 'in-progress' | 'completed';
-export type AgentTaskLinearPriority = 0 | 1 | 2 | 3 | 4;
-
-export interface AgentTaskLinearRecord {
-  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: AgentTaskLinearPriority | null;
-  estimate: number | null;
-  dueDate: string | null;
-  labelIds: readonly string[];
-}
-
-export interface AgentTaskLinearInput {
-  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?: AgentTaskLinearPriority | null;
-  estimate?: number | null;
-  dueDate?: string | null;
-  labelIds?: readonly string[] | null;
-}
 
 export interface AgentTask {
   taskId: string;
@@ -269,7 +245,7 @@ export interface AgentTask {
   scopeKind: 'global' | 'repository' | 'project';
   projectId: string | null;
   title: string;
-  description: string;
+  body: string;
   status: AgentTaskStatus;
   orderIndex: number;
   claimedByControllerId: string | null;
@@ -278,7 +254,6 @@ export interface AgentTask {
   baseBranch: string | null;
   claimedAt: string | null;
   completedAt: string | null;
-  linear: AgentTaskLinearRecord;
   createdAt: string;
   updatedAt: string;
 }
@@ -287,9 +262,8 @@ export interface AgentTaskCreateInput extends AgentScopeQuery {
   taskId?: string;
   repositoryId?: string;
   projectId?: string;
-  title: string;
-  description?: string;
-  linear?: AgentTaskLinearInput;
+  title?: string | null;
+  body: string;
 }
 
 export interface AgentTaskListQuery extends AgentScopeQuery {
@@ -301,11 +275,10 @@ export interface AgentTaskListQuery extends AgentScopeQuery {
 }
 
 export interface AgentTaskUpdateInput {
-  title?: string;
-  description?: string;
+  title?: string | null;
+  body?: string;
   repositoryId?: string | null;
   projectId?: string | null;
-  linear?: AgentTaskLinearInput | null;
 }
 
 export interface AgentTaskClaimInput {
@@ -379,10 +352,6 @@ function readString(value: unknown): string | null {
   return typeof value === 'string' ? value : null;
 }
 
-function readNumber(value: unknown): number | null {
-  return typeof value === 'number' && Number.isFinite(value) ? value : null;
-}
-
 function readBoolean(value: unknown): boolean | null {
   return typeof value === 'boolean' ? value : null;
 }
@@ -413,196 +382,6 @@ function readNullableNumber(value: unknown): number | null | undefined {
   return undefined;
 }
 
-function readStringArray(value: unknown): readonly string[] | undefined {
-  if (!Array.isArray(value)) {
-    return undefined;
-  }
-  if (!value.every((entry) => typeof entry === 'string')) {
-    return undefined;
-  }
-  return [...value];
-}
-
-function defaultTaskLinearRecord(): AgentTaskLinearRecord {
-  return {
-    issueId: null,
-    identifier: null,
-    url: null,
-    teamId: null,
-    projectId: null,
-    projectMilestoneId: null,
-    cycleId: null,
-    stateId: null,
-    assigneeId: null,
-    priority: null,
-    estimate: null,
-    dueDate: null,
-    labelIds: [],
-  };
-}
-
-function parseTaskLinearRecord(value: unknown): AgentTaskLinearRecord | null {
-  if (value === undefined) {
-    return defaultTaskLinearRecord();
-  }
-  const record = asRecord(value);
-  if (record === null) {
-    return null;
-  }
-
-  const issueId = readNullableString(record['issueId']);
-  const identifier = readNullableString(record['identifier']);
-  const url = readNullableString(record['url']);
-  const teamId = readNullableString(record['teamId']);
-  const projectId = readNullableString(record['projectId']);
-  const projectMilestoneId = readNullableString(record['projectMilestoneId']);
-  const cycleId = readNullableString(record['cycleId']);
-  const stateId = readNullableString(record['stateId']);
-  const assigneeId = readNullableString(record['assigneeId']);
-  const priority = readNullableNumber(record['priority']);
-  const estimate = readNullableNumber(record['estimate']);
-  const dueDate = readNullableString(record['dueDate']);
-  const labelIdsRaw = record['labelIds'];
-  const labelIds = labelIdsRaw === undefined ? [] : readStringArray(labelIdsRaw);
-  if (
-    issueId === undefined ||
-    identifier === undefined ||
-    url === undefined ||
-    teamId === undefined ||
-    projectId === undefined ||
-    projectMilestoneId === undefined ||
-    cycleId === undefined ||
-    stateId === undefined ||
-    assigneeId === undefined ||
-    priority === undefined ||
-    estimate === undefined ||
-    dueDate === undefined ||
-    labelIds === undefined
-  ) {
-    return null;
-  }
-  if (priority !== null && !Number.isInteger(priority)) {
-    return null;
-  }
-  if (priority !== null && (priority < 0 || priority > 4)) {
-    return null;
-  }
-  if (estimate !== null && (!Number.isInteger(estimate) || estimate < 0)) {
-    return null;
-  }
-  return {
-    issueId,
-    identifier,
-    url,
-    teamId,
-    projectId,
-    projectMilestoneId,
-    cycleId,
-    stateId,
-    assigneeId,
-    priority: priority as AgentTaskLinearPriority | null,
-    estimate,
-    dueDate,
-    labelIds,
-  };
-}
-
-function parseTaskStatus(value: unknown): AgentTaskStatus | null {
-  if (value === 'draft' || value === 'ready' || value === 'in-progress' || value === 'completed') {
-    return value;
-  }
-  return null;
-}
-
-function parseTaskScopeKind(
-  value: unknown,
-  repositoryId: string | null | undefined,
-  projectId: string | null | undefined,
-): 'global' | 'repository' | 'project' | null {
-  if (value === 'global' || value === 'repository' || value === 'project') {
-    return value;
-  }
-  if (projectId !== null) {
-    return 'project';
-  }
-  if (repositoryId !== null) {
-    return 'repository';
-  }
-  if (value === undefined || value === null) {
-    return 'global';
-  }
-  return null;
-}
-
-function parseRuntimeStatus(value: unknown): StreamSessionRuntimeStatus | null {
-  if (
-    value === 'running' ||
-    value === 'needs-input' ||
-    value === 'completed' ||
-    value === 'exited'
-  ) {
-    return value;
-  }
-  return null;
-}
-
-function parseRuntimeStatusModel(value: unknown): StreamSessionStatusModel | null | undefined {
-  if (value === null) {
-    return null;
-  }
-  const record = asRecord(value);
-  if (record === null) {
-    return undefined;
-  }
-  const runtimeStatus = parseRuntimeStatus(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 phaseHint = readNullableString(record['phaseHint']);
-  const observedAt = readString(record['observedAt']);
-  if (
-    runtimeStatus === null ||
-    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 ||
-    phaseHint === undefined ||
-    (phaseHint !== null &&
-      phaseHint !== 'needs-action' &&
-      phaseHint !== 'working' &&
-      phaseHint !== 'idle') ||
-    observedAt === null
-  ) {
-    return undefined;
-  }
-  return {
-    runtimeStatus,
-    phase,
-    glyph,
-    badge,
-    detailText,
-    attentionReason,
-    lastKnownWork,
-    lastKnownWorkAt,
-    phaseHint,
-    observedAt,
-  };
-}
-
 function parseSignal(value: unknown): NodeJS.Signals | null | undefined {
   if (value === undefined) {
     return undefined;
@@ -642,36 +421,18 @@ function parseExit(value: unknown): PtyExit | null | undefined {
 }
 
 function parseProjectRecord(value: unknown): AgentProject | null {
-  const record = asRecord(value);
-  if (record === null) {
-    return null;
-  }
-  const projectId = readString(record['directoryId']);
-  const tenantId = readString(record['tenantId']);
-  const userId = readString(record['userId']);
-  const workspaceId = readString(record['workspaceId']);
-  const path = readString(record['path']);
-  const createdAt = readString(record['createdAt']);
-  const archivedAt = readNullableString(record['archivedAt']);
-  if (
-    projectId === null ||
-    tenantId === null ||
-    userId === null ||
-    workspaceId === null ||
-    path === null ||
-    createdAt === null ||
-    archivedAt === undefined
-  ) {
+  const parsed = parseContractDirectoryRecord(value);
+  if (parsed === null || parsed.createdAt === null) {
     return null;
   }
   return {
-    projectId,
-    tenantId,
-    userId,
-    workspaceId,
-    path,
-    createdAt,
-    archivedAt,
+    projectId: parsed.directoryId,
+    tenantId: parsed.tenantId,
+    userId: parsed.userId,
+    workspaceId: parsed.workspaceId,
+    path: parsed.path,
+    createdAt: parsed.createdAt,
+    archivedAt: parsed.archivedAt,
   };
 }
 
@@ -772,8 +533,8 @@ function parseThreadRecord(value: unknown): AgentThread | null {
   const agentType = readString(record['agentType']);
   const createdAt = readString(record['createdAt']);
   const archivedAt = readNullableString(record['archivedAt']);
-  const runtimeStatus = parseRuntimeStatus(record['runtimeStatus']);
-  const runtimeStatusModel = parseRuntimeStatusModel(record['runtimeStatusModel']);
+  const runtimeStatus = parseStreamSessionRuntimeStatus(record['runtimeStatus']);
+  const runtimeStatusModel = parseStreamSessionStatusModel(record['runtimeStatusModel']);
   const runtimeLive = readBoolean(record['runtimeLive']);
   const runtimeAttentionReason = readNullableString(record['runtimeAttentionReason']);
   const runtimeProcessId = readNullableNumber(record['runtimeProcessId']);
@@ -822,190 +583,85 @@ function parseThreadRecord(value: unknown): AgentThread | null {
   };
 }
 
-function parseRepositoryRecord(value: unknown): AgentRepository | null {
-  const record = asRecord(value);
-  if (record === null) {
-    return null;
-  }
-  const repositoryId = readString(record['repositoryId']);
-  const tenantId = readString(record['tenantId']);
-  const userId = readString(record['userId']);
-  const workspaceId = readString(record['workspaceId']);
-  const name = readString(record['name']);
-  const remoteUrl = readString(record['remoteUrl']);
-  const defaultBranch = readString(record['defaultBranch']);
-  const metadata = asRecord(record['metadata']);
-  const createdAt = readString(record['createdAt']);
-  const archivedAt = readNullableString(record['archivedAt']);
-  if (
-    repositoryId === null ||
-    tenantId === null ||
-    userId === null ||
-    workspaceId === null ||
-    name === null ||
-    remoteUrl === null ||
-    defaultBranch === null ||
-    metadata === null ||
-    createdAt === null ||
-    archivedAt === undefined
-  ) {
+function toAgentRepository(record: ControlPlaneRepositoryRecord): AgentRepository | null {
+  if (record.createdAt === null) {
     return null;
   }
   return {
-    repositoryId,
-    tenantId,
-    userId,
-    workspaceId,
-    name,
-    remoteUrl,
-    defaultBranch,
-    metadata,
-    createdAt,
-    archivedAt,
+    repositoryId: record.repositoryId,
+    tenantId: record.tenantId,
+    userId: record.userId,
+    workspaceId: record.workspaceId,
+    name: record.name,
+    remoteUrl: record.remoteUrl,
+    defaultBranch: record.defaultBranch,
+    metadata: record.metadata,
+    createdAt: record.createdAt,
+    archivedAt: record.archivedAt,
   };
 }
 
+function parseRepositoryRecord(value: unknown): AgentRepository | null {
+  const parsed = parseContractRepositoryRecord(value);
+  return parsed === null ? null : toAgentRepository(parsed);
+}
+
 function parseProjectGitStatusRecord(value: unknown): AgentProjectGitStatus | null {
-  const record = asRecord(value);
-  if (record === null) {
+  const parsed = parseContractDirectoryGitStatusRecord(value);
+  if (parsed === null) {
     return null;
   }
-  const directoryId = readString(record['directoryId']);
-  const summaryRecord = asRecord(record['summary']);
-  const repositorySnapshotRecord = asRecord(record['repositorySnapshot']);
-  const repositoryId = readNullableString(record['repositoryId']);
-  const observedAt = readString(record['observedAt']);
-  const repositoryRaw = record['repository'];
-  const repository =
-    repositoryRaw === null || repositoryRaw === undefined
-      ? null
-      : parseRepositoryRecord(repositoryRaw);
-  if (
-    directoryId === null ||
-    summaryRecord === null ||
-    repositorySnapshotRecord === null ||
-    repositoryId === undefined ||
-    observedAt === null ||
-    (repositoryRaw !== null && repositoryRaw !== undefined && repository === null)
-  ) {
-    return null;
-  }
-  const branch = readString(summaryRecord['branch']);
-  const changedFiles = readNumber(summaryRecord['changedFiles']);
-  const additions = readNumber(summaryRecord['additions']);
-  const deletions = readNumber(summaryRecord['deletions']);
-  const normalizedRemoteUrl = readNullableString(repositorySnapshotRecord['normalizedRemoteUrl']);
-  const commitCount = readNullableNumber(repositorySnapshotRecord['commitCount']);
-  const lastCommitAt = readNullableString(repositorySnapshotRecord['lastCommitAt']);
-  const shortCommitHash = readNullableString(repositorySnapshotRecord['shortCommitHash']);
-  const inferredName = readNullableString(repositorySnapshotRecord['inferredName']);
-  const defaultBranch = readNullableString(repositorySnapshotRecord['defaultBranch']);
-  if (
-    branch === null ||
-    changedFiles === null ||
-    additions === null ||
-    deletions === null ||
-    normalizedRemoteUrl === undefined ||
-    commitCount === undefined ||
-    lastCommitAt === undefined ||
-    shortCommitHash === undefined ||
-    inferredName === undefined ||
-    defaultBranch === undefined
-  ) {
+  const repository = parsed.repository === null ? null : toAgentRepository(parsed.repository);
+  if (parsed.repository !== null && repository === null) {
     return null;
   }
   return {
-    directoryId,
+    directoryId: parsed.directoryId,
     summary: {
-      branch,
-      changedFiles,
-      additions,
-      deletions,
+      branch: parsed.summary.branch,
+      changedFiles: parsed.summary.changedFiles,
+      additions: parsed.summary.additions,
+      deletions: parsed.summary.deletions,
     },
     repositorySnapshot: {
-      normalizedRemoteUrl,
-      commitCount,
-      lastCommitAt,
-      shortCommitHash,
-      inferredName,
-      defaultBranch,
+      normalizedRemoteUrl: parsed.repositorySnapshot.normalizedRemoteUrl,
+      commitCount: parsed.repositorySnapshot.commitCount,
+      lastCommitAt: parsed.repositorySnapshot.lastCommitAt,
+      shortCommitHash: parsed.repositorySnapshot.shortCommitHash,
+      inferredName: parsed.repositorySnapshot.inferredName,
+      defaultBranch: parsed.repositorySnapshot.defaultBranch,
     },
-    repositoryId,
+    repositoryId: parsed.repositoryId,
     repository,
-    observedAt,
+    observedAt: parsed.observedAt,
   };
 }
 
 function parseTaskRecord(value: unknown): AgentTask | null {
-  const record = asRecord(value);
-  if (record === null) {
-    return null;
-  }
-  const taskId = readString(record['taskId']);
-  const tenantId = readString(record['tenantId']);
-  const userId = readString(record['userId']);
-  const workspaceId = readString(record['workspaceId']);
-  const repositoryId = readNullableString(record['repositoryId']);
-  const projectId = readNullableString(record['projectId']);
-  const title = readString(record['title']);
-  const description = readString(record['description']);
-  const status = parseTaskStatus(record['status']);
-  const scopeKind = parseTaskScopeKind(record['scopeKind'], repositoryId, projectId);
-  const orderIndex = readNumber(record['orderIndex']);
-  const claimedByControllerId = readNullableString(record['claimedByControllerId']);
-  const claimedByProjectId = readNullableString(record['claimedByDirectoryId']);
-  const branchName = readNullableString(record['branchName']);
-  const baseBranch = readNullableString(record['baseBranch']);
-  const claimedAt = readNullableString(record['claimedAt']);
-  const completedAt = readNullableString(record['completedAt']);
-  const linear = parseTaskLinearRecord(record['linear']);
-  const createdAt = readString(record['createdAt']);
-  const updatedAt = readString(record['updatedAt']);
-  if (
-    taskId === null ||
-    tenantId === null ||
-    userId === null ||
-    workspaceId === null ||
-    repositoryId === undefined ||
-    projectId === undefined ||
-    scopeKind === null ||
-    title === null ||
-    description === null ||
-    status === null ||
-    orderIndex === null ||
-    claimedByControllerId === undefined ||
-    claimedByProjectId === undefined ||
-    branchName === undefined ||
-    baseBranch === undefined ||
-    claimedAt === undefined ||
-    completedAt === undefined ||
-    linear === null ||
-    createdAt === null ||
-    updatedAt === null
-  ) {
+  const parsed = parseContractTaskRecord(value);
+  if (parsed === null) {
     return null;
   }
   return {
-    taskId,
-    tenantId,
-    userId,
-    workspaceId,
-    repositoryId,
-    scopeKind,
-    projectId,
-    title,
-    description,
-    status,
-    orderIndex,
-    claimedByControllerId,
-    claimedByProjectId,
-    branchName,
-    baseBranch,
-    claimedAt,
-    completedAt,
-    linear,
-    createdAt,
-    updatedAt,
+    taskId: parsed.taskId,
+    tenantId: parsed.tenantId,
+    userId: parsed.userId,
+    workspaceId: parsed.workspaceId,
+    repositoryId: parsed.repositoryId,
+    scopeKind: parsed.scopeKind,
+    projectId: parsed.projectId,
+    title: parsed.title,
+    body: parsed.body,
+    status: parsed.status,
+    orderIndex: parsed.orderIndex,
+    claimedByControllerId: parsed.claimedByControllerId,
+    claimedByProjectId: parsed.claimedByDirectoryId,
+    branchName: parsed.branchName,
+    baseBranch: parsed.baseBranch,
+    claimedAt: parsed.claimedAt,
+    completedAt: parsed.completedAt,
+    createdAt: parsed.createdAt,
+    updatedAt: parsed.updatedAt,
   };
 }
 
@@ -1883,9 +1539,8 @@ export class HarnessAgentRealtimeClient {
       ...optionalField('workspaceId', input.workspaceId),
       ...optionalField('repositoryId', input.repositoryId),
       ...optionalField('projectId', input.projectId),
-      title: input.title,
-      ...optionalField('description', input.description),
-      ...optionalField('linear', input.linear),
+      ...optionalField('title', input.title),
+      body: input.body,
     });
     return requireParsed(
       result['task'],