Enterprise agent platform for building, deploying, and operating AI teammates.
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,
}
}