Skip to content

armgit / cindy

Public Imported from GitHub
0

Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。

6.6 KB
Raw Blame
import { getSessionListActivityAt } from '@cindy/maker-shared/session-activity';
/**
 * sessionRightStatus —— 会话行右侧状态槽的档位判定(纯函数,便于单测)。
 *
 * 与桌面版侧栏 `sidebarRightStatus.ts` 同一套五档优先级与全端统一色表:
 *   1. error(出错未读)          → 红点(--card-status-error / colors.statusError)
 *   2. awaiting(等待回复/选择)  → TapTap 蓝点(colors.statusAwaiting)
 *   3. running                    → spinner 动画(中性色,橙色语义由行首 vendor icon 呼吸表达)
 *   4. done(完成未读)           → 绿点(colors.statusDone)
 *   5. time                       → 最近活动时间文字
 *
 * 手机端信号来源(与桌面的 attention store 对应关系):
 *   - liveActivity(桌面 main 的会话活动 relay,#368):phase 四态 + attention 未读标志。
 *     attention 的已读语义由 main 侧维护(error 未读要等真实展示才清,与桌面一致),
 *     手机端只消费,不自己猜。
 *   - pendingInteractionCount:实时待处理交互数(ask-user / 权限 / 计划审阅)——
 *     即使 liveActivity 缺失(relay 断连)也能点亮 awaiting。
 *   - scheduleUnreadCount / scheduleHasUnreadFailedRun:同桌面自动化运行账本。
 */
import {
  projectSessionActivity,
  resolveSessionRightStatus,
  resolveCollapsedGroupRightStatus,
  type SessionRightStatus,
  type SessionInterruptionState,
} from '@cindy/maker-shared/session-activity';

type SessionRow = import('@cindy/maker-shared/session-list').RemoteSessionListItem;
export type MobileSessionRightStatus = SessionRightStatus;

export function latestMobileSessionRow(item: SessionRow): SessionRow {
  return (
    item.automationGroup?.items.reduce((a, b) =>
      Date.parse(getSessionListActivityAt(b.session) ?? b.session.createdAt) >
      Date.parse(getSessionListActivityAt(a.session) ?? a.session.createdAt)
        ? b
        : a,
    ) ?? item
  );
}

export interface MobileSessionRightStatusInput {
  interruption?: SessionInterruptionState;
  /** liveActivity.phase(缺失 = 无 relay 数据)。 */
  livePhase: 'running' | 'needs-interaction' | 'completed' | 'error' | undefined;
  /** liveActivity.attention === true(未读标志,main 侧维护已读语义)。 */
  liveAttention: boolean;
  /** 实时待处理交互数(ask-user / 权限 / 计划审阅)。 */
  pendingInteractionCount: number;
  /** 会话(或其绑定 schedule)是否正在运行。 */
  running: boolean;
  /** 定时任务未读运行数。 */
  scheduleUnreadCount: number;
  scheduleHasUnreadFailedRun?: boolean;
}

export function resolveMobileSessionRightStatus({
  interruption,
  livePhase,
  liveAttention,
  pendingInteractionCount,
  running,
  scheduleUnreadCount,
  scheduleHasUnreadFailedRun = false,
}: MobileSessionRightStatusInput): MobileSessionRightStatus {
  return resolveSessionRightStatus(
    projectSessionActivity({
      interruption,
      sessionId: '',
      livePhase,
      running,
      waitingForUser: pendingInteractionCount > 0,
      terminal: scheduleHasUnreadFailedRun ? 'error' : scheduleUnreadCount > 0 ? 'completed' : null,
      attention:
        liveAttention ||
        pendingInteractionCount > 0 ||
        scheduleUnreadCount > 0 ||
        scheduleHasUnreadFailedRun,
    }),
  );
}

/** 单个会话行(不含自动化组聚合)的右槽档位;running 为调用方已知的运行态。 */
function resolveSingleRowStatus(row: SessionRow, running: boolean): MobileSessionRightStatus {
  return resolveMobileSessionRightStatus({
    interruption: row.session,
    livePhase: row.liveActivity?.phase,
    liveAttention: row.liveActivity?.attention === true,
    pendingInteractionCount: row.pendingInteractionCount,
    running: running || isRowRunning(row),
    scheduleUnreadCount: row.scheduleInfo?.unreadCount ?? 0,
    scheduleHasUnreadFailedRun: row.scheduleInfo?.hasUnreadFailedRun,
  });
}

function isRowRunning(row: SessionRow): boolean {
  return row.liveActivity?.phase === 'running' || row.scheduleInfo?.running === true;
}

/** Group header mirrors the latest run; collapsed errors remain discoverable. */
export function resolveMobileSessionRowStatus(
  item: import('@cindy/maker-shared/session-list').RemoteSessionListItem,
  running: boolean,
  expanded = false,
): { status: MobileSessionRightStatus; target: import('@cindy/maker-shared/session-list').RemoteSessionListItem } {
  const children = item.automationGroup?.items;
  const latest = latestMobileSessionRow(item);
  const error = children?.find((row) => resolveSingleRowStatus(row, false) === 'error');
  const hasDone = children?.some((row) => resolveSingleRowStatus(row, false) === 'done');
  return {
    status: resolveCollapsedGroupRightStatus({
      collapsed: !expanded,
      latestKind: resolveSingleRowStatus(latest, running),
      tone: error ? 'error' : hasDone ? 'done' : null,
    }),
    target: !expanded && error ? error : latest,
  };
}

export type MobileCollapsedGroupDot = 'error' | 'awaiting' | 'done';

export interface MobileCollapsedGroupStatus {
  /** 组内任一任务在跑:组头图标转橙色呼吸(对齐桌面 ProjectNode 的 lamp.running)。 */
  running: boolean;
  /** 组头右槽唯一一颗点:红 > 蓝 > 绿;无需关注时为 null。运行态不占右槽。 */
  dot: MobileCollapsedGroupDot | null;
}

const COLLAPSED_DOT_RANK: Record<MobileCollapsedGroupDot, number> = { error: 3, awaiting: 2, done: 1 };

/**
 * 收起的项目 / 对话组组头汇总(与桌面侧栏收起项目同一规则):
 * - 计入组内全部任务(含「查看全部」之外、自动化组折叠起来的每次运行),不只看可见前 N 行;
 * - 每个任务按自己行上的右槽档位取色:出错未读红、等你回复蓝、完成未读绿;
 *   任务重新在跑时其旧的完成未读不再点绿(行级 running 已压过 done),出错红点照常保留;
 * - 多个任务同时有点时只显示最高一档;运行态单独返回,由组头图标呼吸表达。
 */
export function resolveMobileCollapsedGroupStatus(
  items: readonly SessionRow[],
  isSessionRunning: (sessionId: string) => boolean,
): MobileCollapsedGroupStatus {
  let running = false;
  let dot: MobileCollapsedGroupDot | null = null;
  for (const item of items) {
    for (const row of item.automationGroup?.items ?? [item]) {
      const rowRunning = isSessionRunning(row.session.id) || isRowRunning(row);
      if (rowRunning) running = true;
      const status = resolveSingleRowStatus(row, rowRunning);
      if (status === 'running' || status === 'time') continue;
      if (!dot || COLLAPSED_DOT_RANK[status] > COLLAPSED_DOT_RANK[dot]) dot = status;
    }
  }
  return { running, dot };
}