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。

4.9 KB
Raw Blame
/**
 * agentIslandActivity —— 灵动岛 per-session 实时活动快照(renderer 侧镜像)。
 *
 * 主进程(agent-island/service.ts)每次 publish 把所有运行中会话的轻量活动快照
 * (phase / compactDetail / interactionKind / attention)经 IPC 广播过来;这里维护
 * 一份 Map<sessionId, activity> 供侧栏置顶卡片/列表显示"任务执行中的逐步活动 + 等待
 * 交互态"。与原生灵动岛同源数据,且不依赖灵动岛 UI 开关(主进程关闭岛时仍广播)。
 *
 * 性能:主进程每次都发全量新数组,这里做 diff —— 内容未变的会话**复用旧条目引用**,
 * 于是按 sessionId 选择的 hook 在该会话未变时拿到稳定引用,不会无谓重渲染(灵动岛
 * 动画计时器会让 publish 较频繁,这点很关键)。
 */

import { useCallback, useSyncExternalStore } from 'react';

import type { AgentIslandSessionActivity } from '../../shared/agentIsland';

let activityMap: ReadonlyMap<string, AgentIslandSessionActivity> = new Map();
const listeners = new Set<() => void>();
let subscribed = false;

function emit(): void {
  for (const l of listeners) l();
}

function sameActivity(a: AgentIslandSessionActivity, b: AgentIslandSessionActivity): boolean {
  return (
    a.phase === b.phase &&
    a.workingPhase === b.workingPhase &&
    a.recordStatus === b.recordStatus &&
    a.compactDetail === b.compactDetail &&
    a.currentActionSummary === b.currentActionSummary &&
    a.interactionKind === b.interactionKind &&
    a.attention === b.attention &&
    a.startedAtMs === b.startedAtMs &&
    a.lastActivityAtMs === b.lastActivityAtMs &&
    a.workflow?.key === b.workflow?.key &&
    a.workflow?.label === b.workflow?.label &&
    a.workflow?.waitingOn === b.workflow?.waitingOn &&
    a.turnGeneration === b.turnGeneration &&
    a.gracefulStopState === b.gracefulStopState &&
    a.source === b.source
  );
}

/** 收到全量列表 → 构建新 Map,内容未变的条目复用旧引用;无实质变化则不通知。 */
function applyList(list: AgentIslandSessionActivity[]): void {
  const next = new Map<string, AgentIslandSessionActivity>();
  let changed = list.length !== activityMap.size;
  for (const incoming of list) {
    const prev = activityMap.get(incoming.sessionId);
    if (prev && sameActivity(prev, incoming)) {
      next.set(incoming.sessionId, prev); // 稳定引用
    } else {
      next.set(incoming.sessionId, incoming);
      changed = true;
    }
  }
  if (!changed) {
    for (const id of activityMap.keys()) {
      if (!next.has(id)) {
        changed = true;
        break;
      }
    }
  }
  if (!changed) return;
  activityMap = next;
  emit();
}

function ensureSubscribed(): void {
  if (subscribed) return;
  subscribed = true;
  try {
    window.electronAPI.agentIsland.onSessionActivity(applyList);
  } catch {
    // preload 不可用(异常环境)——保持空 Map,卡片回退到现状显示。
  }
}

/** Start mirroring before a non-React reader needs the latest snapshot. */
export function ensureAgentIslandActivitySubscribed(): void {
  ensureSubscribed();
}

/**
 * Whether Main still keeps this session running after its turn ended.
 *
 * Agent Island defers an Orca Lead's completion while Workers still owe it
 * reports, so the Lead stays `running` here. A paused input queue also holds the
 * island completion; it keeps its existing renderer completion and is excluded.
 */
export function isSessionCompletionHeldByAgentIsland(
  sessionId: string,
  hasPausedQueue: boolean,
): boolean {
  if (hasPausedQueue) return false;
  return activityMap.get(sessionId)?.phase === 'running';
}

function subscribe(cb: () => void): () => void {
  ensureSubscribed();
  listeners.add(cb);
  return () => {
    listeners.delete(cb);
  };
}

/** 按 sessionId 取该会话的实时活动;无则 null。引用稳定(见上)。 */
export function useAgentIslandActivity(sessionId: string): AgentIslandSessionActivity | null {
  const getSnapshot = useCallback(() => activityMap.get(sessionId) ?? null, [sessionId]);
  return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
}

/**
 * 整张活动表。给「一次渲染里要看很多会话」的列表用(伙伴侧栏按 canonical 会话
 * 判断谁在说话),这类地方没法逐行调 useAgentIslandActivity。
 *
 * 直接返回内部 Map:它只在内容真的变了时才换引用(见 applyList),所以拿它当
 * useSyncExternalStore 的快照是安全的 —— 无变化的 publish 不会引发重渲染。
 * 调用方只读,不要改。
 */
export function useAgentIslandActivityMap(): ReadonlyMap<string, AgentIslandSessionActivity> {
  return useSyncExternalStore(subscribe, getActivityMap, getActivityMap);
}

function getActivityMap(): ReadonlyMap<string, AgentIslandSessionActivity> {
  return activityMap;
}

/** 测试缝:清掉进程内快照,避免用例之间互相看到对方的活动。 */
export function __resetAgentIslandActivityForTests(): void {
  activityMap = new Map();
  emit();
}