packages/cli/src/tui-session-status.ts

/*
 * Licensed to the Apache Software Foundation (ASF) under one
 * or more contributor license agreements.  See the NOTICE file
 * distributed with this work for additional information
 * regarding copyright ownership.  The ASF licenses this file
 * to you under the Apache License, Version 2.0 (the
 * "License"); you may not use this file except in compliance
 * with the License.  You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing,
 * software distributed under the License is distributed on an
 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
 * KIND, either express or implied.  See the License for the
 * specific language governing permissions and limitations
 * under the License.
 */

import type { SessionSummary } from '@maka/core/session';
import {
  defineUiMessageCatalog,
  resolveUiMessageCatalog,
  type UiLocale,
} from '@maka/core/ui-locale';
import { TUI_COPY_RESOURCES } from './tui-copy-catalog.js';

interface TuiSessionStatusCopy {
  readonly running: string;
  readonly waitingForUser: string;
  readonly permissionRequired: string;
  readonly connectionRequired: string;
  readonly signInRequired: string;
  readonly stopped: string;
}

const TUI_SESSION_STATUS_COPY = resolveUiMessageCatalog(
  defineUiMessageCatalog<TuiSessionStatusCopy>()(TUI_COPY_RESOURCES['session-status']),
);

/**
 * Present the runtime Session state as compact picker copy.
 *
 * Persisted `running` is only credible when the Runtime Host also reports a
 * live Turn. Non-actionable blocked reasons remain ordinary resumable rows,
 * matching Desktop's display projection rather than exposing bookkeeping
 * noise as a broken Session.
 */
export function sessionStatusBadge(
  session: Pick<SessionSummary, 'status' | 'blockedReason' | 'runningTurnIds'>,
  locale: UiLocale,
): string | undefined {
  const copy = TUI_SESSION_STATUS_COPY[locale];
  switch (session.status) {
    case 'active':
      return undefined;
    case 'running':
      return session.runningTurnIds?.length ? copy.running : undefined;
    case 'waiting_for_user':
      return session.blockedReason === 'permission_required'
        ? copy.permissionRequired
        : copy.waitingForUser;
    case 'blocked':
      switch (session.blockedReason) {
        case 'NO_REAL_CONNECTION':
          return copy.connectionRequired;
        case 'auth':
          return copy.signInRequired;
        case 'permission_required':
          return copy.permissionRequired;
        case 'tool_failed':
        case 'unknown':
        case undefined:
          return undefined;
      }
    case 'aborted':
      return copy.stopped;
  }
}