Skip to content

πŸ™Œ OpenHands: AI-Driven Development

4.4 KB
Raw Blame
import { I18nKey } from "#/i18n/declaration";
import { AppConversationStartTaskStatus } from "#/api/conversation-service/agent-server-conversation-service.types";
import { ExecutionStatus } from "#/types/agent-server/core/base/common";
import { WebSocketConnectionState } from "#/contexts/conversation-websocket-context";

const ACTIVE_EXECUTION_STATUSES: ReadonlySet<ExecutionStatus> = new Set([
  ExecutionStatus.IDLE,
  ExecutionStatus.RUNNING,
  ExecutionStatus.WAITING_FOR_CONFIRMATION,
  ExecutionStatus.FINISHED,
]);

export function isExecutionActive(
  status: ExecutionStatus | null | undefined,
): boolean {
  return !!status && ACTIVE_EXECUTION_STATUSES.has(status);
}

export function isExecutionPaused(
  status: ExecutionStatus | null | undefined,
): boolean {
  return status === ExecutionStatus.PAUSED;
}

export function isExecutionErrored(
  status: ExecutionStatus | null | undefined,
): boolean {
  return status === ExecutionStatus.ERROR || status === ExecutionStatus.STUCK;
}

export function getTaskStatusI18nKey(
  taskStatus: AppConversationStartTaskStatus,
): I18nKey {
  switch (taskStatus) {
    case "WAITING_FOR_SANDBOX":
      return I18nKey.COMMON$WAITING_FOR_SANDBOX;
    case "SETTING_UP_GIT_HOOKS":
      return I18nKey.STATUS$SETTING_UP_GIT_HOOKS;
    case "SETTING_UP_SKILLS":
      return I18nKey.STATUS$SETTING_UP_SKILLS;
    // Terminal states map to their own localized keys so any caller that
    // delegates here (now or in the future) gets a correct label instead of
    // silently falling through to STARTING_CONVERSATION. Callers that need a
    // context-specific terminal label (e.g. getStatusCode's
    // AGENT_STATUS$ERROR_OCCURRED, or getStatusText's taskDetail precedence)
    // still handle these states before delegating.
    case "READY":
      return I18nKey.CONVERSATION$READY;
    case "ERROR":
      return I18nKey.COMMON$ERROR;
    // These collapse to the generic "Starting" label. `default` is unreachable
    // for the typed union but is kept as a runtime safety net: the start-task
    // API may report a new status before this enum is updated, in which case we
    // degrade to "Starting" rather than throwing (see FUTURE_STATUS_FROM_CLOUD).
    case "STARTING_CONVERSATION":
    case "WORKING":
    case "PREPARING_REPOSITORY":
    case "RUNNING_SETUP_SCRIPT":
    default:
      return I18nKey.CONVERSATION$STARTING_CONVERSATION;
  }
}

export function getStatusCode(
  webSocketConnectionState: WebSocketConnectionState,
  executionStatus: ExecutionStatus | null,
  taskStatus?: AppConversationStartTaskStatus | null,
  subConversationTaskStatus?: AppConversationStartTaskStatus | null,
  // Distinguishes a connection drop-and-recover from the very first
  // connect, so a background-tab reconnect reads "Reconnecting" instead of
  // the more alarming-sounding (and less accurate) "Connecting".
  hasConnectedOnce?: boolean,
) {
  if (
    taskStatus === "ERROR" ||
    subConversationTaskStatus === "ERROR" ||
    executionStatus === "error"
  ) {
    return I18nKey.AGENT_STATUS$ERROR_OCCURRED;
  }

  if (taskStatus && taskStatus !== "READY") {
    return getTaskStatusI18nKey(taskStatus);
  }

  if (executionStatus === ExecutionStatus.PAUSED) {
    return I18nKey.CHAT_INTERFACE$STOPPED;
  }

  // Websocket has disconnected...
  if (webSocketConnectionState && webSocketConnectionState !== "OPEN") {
    switch (webSocketConnectionState) {
      case "CLOSED":
      case "CLOSING":
        return I18nKey.CHAT_INTERFACE$DISCONNECTED;
      case "CONNECTING":
        return hasConnectedOnce
          ? I18nKey.CHAT_INTERFACE$RECONNECTING
          : I18nKey.CHAT_INTERFACE$CONNECTING;
      default:
        throw new Error(
          `Unknown WebsocketConnectionState: ${webSocketConnectionState}`,
        );
    }
  }

  if (executionStatus && executionStatus !== ExecutionStatus.STUCK) {
    switch (executionStatus) {
      case ExecutionStatus.IDLE:
        return I18nKey.AGENT_STATUS$WAITING_FOR_TASK;
      case ExecutionStatus.RUNNING:
        return I18nKey.AGENT_STATUS$RUNNING_TASK;
      case ExecutionStatus.WAITING_FOR_CONFIRMATION:
        return I18nKey.AGENT_STATUS$WAITING_FOR_USER_CONFIRMATION;
      case ExecutionStatus.FINISHED:
        return I18nKey.CHAT_INTERFACE$AGENT_FINISHED_MESSAGE;
      default:
        throw new Error(`Unknown executionStatus: ${executionStatus}`);
    }
  }

  return I18nKey.CHAT_INTERFACE$AGENT_ERROR_MESSAGE;
}