Skip to content

Enterprise agent platform for building, deploying, and operating AI teammates.

2.8 KB
Raw Blame
import { normalizeTaskStatus } from "./task-status"

export type TaskTerminalStatus = "completed" | "failed"
export type TaskCompletionOutcome = "completed" | "partial" | "blocked"

export const normalizeCompletionOutcome = (value: unknown): TaskCompletionOutcome | undefined =>
  value === "completed" || value === "partial" || value === "blocked" ? value : undefined

type TaskCompletedRecord = {
  data?: unknown
  success?: unknown
  status?: unknown
  task?: {
    status?: unknown
    [key: string]: unknown
  }
  result?: unknown
  output?: unknown
  file_outputs?: unknown
  chat_response?: unknown
  metadata?: unknown
  completion_outcome?: unknown
  error_code?: unknown
  error_details?: unknown
}

export type NormalizedTaskCompletion = {
  success: boolean
  status: TaskTerminalStatus
  task?: TaskCompletedRecord["task"]
  result?: unknown
  output?: unknown
  fileOutputs: Array<string | Record<string, unknown>>
  chatResponse?: unknown
  metadata?: unknown
  completionOutcome?: TaskCompletionOutcome
  errorCode?: string
  errorDetails?: Record<string, unknown>
}

const asRecord = (value: unknown): TaskCompletedRecord | null => {
  return value && typeof value === "object" ? (value as TaskCompletedRecord) : null
}

const normalizeTerminalStatus = (value: unknown): TaskTerminalStatus | null => {
  const normalized = normalizeTaskStatus(value)
  if (normalized === "completed") return "completed"
  if (normalized === "failed") return "failed"
  return null
}

export const normalizeTaskCompletedMessage = (
  message: unknown
): NormalizedTaskCompletion => {
  const root = asRecord(message) || {}
  const payload = asRecord(root.data) || root
  const taskStatus = normalizeTerminalStatus(payload.task?.status)
  const payloadStatus = normalizeTerminalStatus(payload.status)
  const explicitStatus = taskStatus || payloadStatus
  const success =
    explicitStatus
      ? explicitStatus === "completed"
      : typeof payload.success === "boolean"
      ? payload.success
      : false
  const status = explicitStatus || (success ? "completed" : "failed")
  const fileOutputs = Array.isArray(payload.file_outputs)
    ? (payload.file_outputs as Array<string | Record<string, unknown>>)
    : []

  return {
    success,
    status,
    task: payload.task,
    result: payload.result,
    output: payload.output,
    fileOutputs,
    chatResponse: payload.chat_response,
    metadata: payload.metadata,
    completionOutcome: status === "completed" ? normalizeCompletionOutcome(payload.completion_outcome) : undefined,
    errorCode: typeof payload.error_code === "string" ? payload.error_code : undefined,
    errorDetails:
      payload.error_details &&
      typeof payload.error_details === "object" &&
      !Array.isArray(payload.error_details)
        ? (payload.error_details as Record<string, unknown>)
        : undefined,
  }
}