@myclaw163/clawclaw-cli 0.6.74 → 0.6.77

package/src/pipeline/event-format.ts

@@ -1,501 +1,501 @@
-import { formatEventHint, roleAssignedHint } from './event-hints.js';
-import { projectPlayers } from './player-projection.js';
-
-export interface EventFormatContext {
-  summary?: any | null;
-  seats?: Record<string, number>;
-  isFirstVisibleEvent?: boolean;
-  maxTextLength?: number;
-}
-
-export interface FormattedEvent {
-  line?: number;
-  type: string;
-  tick: number | null;
-  notice?: string;
-  hint?: string;
-  [key: string]: any;
-}
-
-function cleanObject<T extends Record<string, any>>(obj: T): T {
-  for (const key of Object.keys(obj)) {
-    if (obj[key] === undefined) delete obj[key];
-  }
-  return obj;
-}
-
-function text(value: unknown, fallback = '?'): string {
-  if (typeof value === 'string' && value.length > 0) return value;
-  if (typeof value === 'number' && Number.isFinite(value)) return String(value);
-  return fallback;
-}
-
-function numberValue(value: unknown): number | undefined {
-  if (typeof value === 'number' && Number.isFinite(value)) return value;
-  if (typeof value === 'string' && value.trim() !== '') {
-    const parsed = Number(value);
-    if (Number.isFinite(parsed)) return parsed;
-  }
-  return undefined;
-}
-
-function firstString(event: Record<string, any>, keys: string[], fallback = '?'): string {
-  for (const key of keys) {
-    const value = event[key];
-    if (typeof value === 'string' && value.length > 0) return value;
-    if (typeof value === 'number' && Number.isFinite(value)) return String(value);
-  }
-  return fallback;
-}
-
-function firstNumber(event: Record<string, any>, keys: string[]): number | undefined {
-  for (const key of keys) {
-    const value = numberValue(event[key]);
-    if (value !== undefined) return value;
-  }
-  return undefined;
-}
-
-function truncate(value: unknown, maxLength: number): string {
-  const raw = text(value, '');
-  if (raw.length <= maxLength) return raw;
-  return `${raw.slice(0, Math.max(0, maxLength - 1))}…`;
-}
-
-export function seatMapFromSummary(summary: any | null | undefined, extra?: Record<string, number>): Record<string, number> {
-  const seats: Record<string, number> = { ...(extra ?? {}) };
-  const remember = (name: unknown, seat: unknown): void => {
-    if (typeof name !== 'string' || name.length === 0) return;
-    const parsed = numberValue(seat);
-    if (parsed !== undefined) seats[name] = parsed;
-  };
-
-  remember(summary?.you?.name, summary?.you?.seat);
-
-  const collections = [
-    summary?.visible_players,
-    summary?.all_players,
-    summary?.game?.all_players,
-    summary?.meeting?.alive_players,
-  ];
-  for (const collection of collections) {
-    if (!Array.isArray(collection)) continue;
-    for (const player of collection) {
-      if (typeof player === 'string') continue;
-      remember(player?.name ?? player?.agent_name, player?.seat);
-    }
-  }
-
-  const allSeats = summary?.all_seats ?? summary?.game?.all_seats;
-  if (allSeats && typeof allSeats === 'object' && !Array.isArray(allSeats)) {
-    for (const [name, seat] of Object.entries(allSeats)) remember(name, seat);
-  }
-
-  return seats;
-}
-
-function seatForName(name: unknown, ctx: EventFormatContext): number | undefined {
-  if (typeof name !== 'string' || name.length === 0) return undefined;
-  return seatMapFromSummary(ctx.summary, ctx.seats)[name];
-}
-
-function seatLabel(name: unknown, seat: unknown, ctx: EventFormatContext): string {
-  const resolved = numberValue(seat) ?? seatForName(name, ctx);
-  return resolved === undefined ? '?号' : `${resolved}号`;
-}
-
-function playerLabel(name: unknown, seat: unknown, ctx: EventFormatContext): string {
-  return `${seatLabel(name, seat, ctx)}${text(name, '未知玩家')}`;
-}
-
-function playerObject(name: unknown, seat: unknown, ctx: EventFormatContext): Record<string, any> | undefined {
-  if (typeof name !== 'string' || name.length === 0) return undefined;
-  return cleanObject({
-    name,
-    seat: numberValue(seat) ?? seatForName(name, ctx),
-  });
-}
-
-function voteTargetLabel(target: unknown, ctx: EventFormatContext): string {
-  if (target === null || target === undefined) return 'skip';
-  if (typeof target === 'object' && !Array.isArray(target)) {
-    const targetObject = target as Record<string, any>;
-    return playerLabel(targetObject.name ?? targetObject.agent_name, targetObject.seat, ctx);
-  }
-  const raw = text(target, 'skip');
-  return raw === 'skip' ? 'skip' : playerLabel(raw, undefined, ctx);
-}
-
-function formatVotes(votes: unknown, ctx: EventFormatContext): Record<string, string> | undefined {
-  if (!votes || typeof votes !== 'object' || Array.isArray(votes)) return undefined;
-  const out: Record<string, string> = {};
-  for (const [voter, target] of Object.entries(votes)) {
-    out[playerLabel(voter, undefined, ctx)] = voteTargetLabel(target, ctx);
-  }
-  return out;
-}
-
-function teammateNames(event: Record<string, any>): string[] {
-  const raw = Array.isArray(event.crab_teammates)
-    ? event.crab_teammates
-    : Array.isArray(event.teammates)
-      ? event.teammates
-      : [];
-  const names: string[] = [];
-  for (const teammate of raw) {
-    const name = typeof teammate === 'string' ? teammate : teammate?.name;
-    if (typeof name === 'string' && name.length > 0) names.push(name);
-  }
-  return names;
-}
-
-function teammateObjects(event: Record<string, any>, ctx: EventFormatContext): Record<string, any>[] {
-  const raw = Array.isArray(event.crab_teammates)
-    ? event.crab_teammates
-    : Array.isArray(event.teammates)
-      ? event.teammates
-      : [];
-  const teammates: Record<string, any>[] = [];
-  for (const teammate of raw) {
-    const name = typeof teammate === 'string' ? teammate : teammate?.name;
-    const seat = typeof teammate === 'string' ? undefined : teammate?.seat;
-    const normalized = playerObject(name, seat, ctx);
-    if (normalized) teammates.push(normalized);
-  }
-  return teammates;
-}
-
-function prefix(event: Record<string, any>): string {
-  const type = text(event.type, 'event');
-  const tick = numberValue(event.tick);
-  return tick === undefined ? `tick=null ${type}` : `t${tick} ${type}`;
-}
-
-function firstReportedCorpse(event: Record<string, any>): Record<string, any> | null {
-  const corpses = event.reported_corpses;
-  if (Array.isArray(corpses) && corpses.length > 0 && corpses[0] && typeof corpses[0] === 'object') {
-    return corpses[0];
-  }
-  return null;
-}
-
-function shortBody(event: Record<string, any>, ctx: EventFormatContext): string {
-  const maxTextLength = ctx.maxTextLength ?? 100;
-  switch (event.type) {
-    case 'game_started': {
-      const playerCount = numberValue(event.player_count);
-      const countText = playerCount === undefined ? '对局开始' : `对局开始：${playerCount}名玩家`;
-      return `${countText}。地图/座位查 ccl events game_started，身份/任务查 ccl events role_assigned。`;
-    }
-    case 'role_assigned': {
-      const start = ctx.isFirstVisibleEvent ? '对局开始。' : '';
-      return `${start}身份已分配：你是${firstString(event, ['role_display_name', 'role_display', 'role'])}（${firstString(event, ['faction'])}）。`;
-    }
-    case 'kill':
-      return `你在${firstString(event, ['room'])}击杀了${playerLabel(event.target_name, firstNumber(event, ['target_seat', 'target_player_seat']), ctx)}。`;
-    case 'killed':
-      return `你在${firstString(event, ['room'])}被${playerLabel(event.killer_name, firstNumber(event, ['killer_seat', 'killer_player_seat']), ctx)}击杀了，你已死亡。`;
-    case 'murder_witnessed':
-      return `你在${firstString(event, ['room'])}目击${playerLabel(event.killer_name, firstNumber(event, ['killer_seat', 'killer_player_seat']), ctx)}击杀${playerLabel(event.target_name, firstNumber(event, ['target_seat', 'target_player_seat']), ctx)}。`;
-    case 'warrior_shrimp_self_destruct':
-      return `你误杀了${playerLabel(event.target_name, firstNumber(event, ['target_seat', 'target_player_seat']), ctx)}，武士虾自爆出局。`;
-    case 'task_completed': {
-      const fakeNote = event.is_fake_shrimp ? '（伪装）' : '';
-      return `任务完成：${firstString(event, ['task_name'])}${fakeNote}。`;
-    }
-    case 'task_sabotaged':
-      return `破坏任务完成：${firstString(event, ['task_name'])}（${firstString(event, ['room'])}）。`;
-    case 'corpse_spotted':
-      return `我发现了${playerLabel(event.corpse_name, firstNumber(event, ['corpse_seat', 'corpse_player_seat']), ctx)}的尸体，在${firstString(event, ['corpse_room', 'room'])}。`;
-    case 'octopus_time_start':
-      return '章鱼时间开始：剩3人，章鱼存活60秒将获胜，会议已禁用。';
-    case 'emergency_started':
-      return `紧急任务：${firstString(event, ['task_name'])}在${firstString(event, ['room'])}，${text(event.timeout_secs, '?')}秒内处理。`;
-    case 'emergency_resolved':
-      return `紧急任务已解决：${firstString(event, ['task_name'])}。`;
-    case 'meeting_briefing': {
-      const callerName = firstString(event, ['meeting_caller_name', 'caller', 'actor_name']);
-      const caller = playerLabel(callerName, firstNumber(event, ['meeting_caller_seat', 'caller_seat', 'actor_seat']), ctx);
-      const corpse = firstReportedCorpse(event);
-      if (!corpse) return `会议开始：${caller}发起会议。`;
-      const corpseName = text(corpse.name ?? event.corpse_name, '未知玩家');
-      const corpseSeat = numberValue(corpse.seat) ?? firstNumber(event, ['corpse_seat', 'corpse_player_seat']);
-      return `会议开始：${caller}报告${playerLabel(corpseName, corpseSeat, ctx)}尸体。`;
-    }
-    case 'speech':
-      return `${playerLabel(event.actor_name, firstNumber(event, ['actor_seat', 'seat']), ctx)}会议发言：${truncate(event.text ?? event.message, maxTextLength)}`;
-    case 'speech_skipped':
-      return `${playerLabel(event.actor_name, firstNumber(event, ['actor_seat', 'seat']), ctx)}发言超时，被跳过。`;
-    case 'speech_your_turn':
-      return '轮到你发言。立即用 ccl do -s "..."。';
-    case 'vote_phase_start':
-      return '投票阶段开始。前20秒可用 ccl do -s "..." 发弹幕；确认后用 ccl do -v <玩家名|skip> 投票。';
-    case 'vote_cast':
-      return `${playerLabel(event.actor_name, firstNumber(event, ['actor_seat', 'seat']), ctx)}已投票。`;
-    case 'vote_speech_phase_ended':
-      return '投票弹幕窗口已关闭。请用 ccl do -v <玩家名|skip> 完成投票。';
-    case 'exile': {
-      const exiledName = event.result_target ?? event.actor_name;
-      const exiledSeat = firstNumber(event, ['result_target_seat', 'actor_seat', 'seat']);
-      return `会议结束：${playerLabel(exiledName, exiledSeat, ctx)}被放逐。`;
-    }
-    case 'no_exile':
-      return '会议结束：无人被放逐。';
-    case 'meeting_ended':
-      return '会议结束。';
-    case 'death_speech': {
-      const speakerName = event.speaker_name ?? event.actor_name;
-      const speakerSeat = firstNumber(event, ['speaker_seat', 'actor_seat', 'seat']);
-      return `${playerLabel(speakerName, speakerSeat, ctx)}死亡弹幕：${truncate(event.text ?? event.message, maxTextLength)}`;
-    }
-    case 'crab_teammates': {
-      const labels = teammateNames(event).map((name) => playerLabel(name, undefined, ctx));
-      return labels.length > 0 ? `蟹队友：${labels.join('、')}。` : '蟹队友信息已更新。';
-    }
-    case 'wandering_speech':
-      return `${text(event.actor_name, '你')}在${firstString(event, ['room'])}说：${truncate(event.text ?? event.message, maxTextLength)}`;
-    case 'game_over':
-      return `游戏结束：${firstString(event, ['winner_name'], '未知玩家')}获胜（${firstString(event, ['winner'])}），原因 ${firstString(event, ['reason'])}。`;
-    case 'user_left_game':
-      return 'The user left the game from the web page. This match has ended; stop playing and do not restart unless the user asks.';
-    case 'match_waiting':
-      return `仍在匹配队列，已等待${text(event.waited_secs, '?')}秒。`;
-    case 'match_timeout':
-      return `匹配超时，累计等待${text(event.waited_secs, '?')}秒。询问用户是否重试。`;
-    case 'robot_speak_rule':
-      return `发言提示：${truncate(event.message ?? event.text, maxTextLength)}`;
-    case 'strategy_alert':
-      return truncate(event.message ?? event.text, maxTextLength);
-    case 'game_start':
-      return '事件流已连接，等待身份分配。';
-    case 'heartbeat':
-      return '事件流正常，暂无新事件。';
-    case 'snapshot':
-      return '当前状态快照。';
-    case 'not_logged_in':
-      return '未登录。';
-    case 'not_ready':
-      return '游戏运行时未就绪。请运行 ccl game start。';
-    case 'error':
-      return text(event.message ?? event.error, '发生错误。');
-    default:
-      return truncate(event.message ?? event.hint ?? event.type, maxTextLength);
-  }
-}
-
-export function formatEventMessage(event: Record<string, any>, ctx: EventFormatContext = {}): string {
-  return `${prefix(event)} ${shortBody(event, ctx)}`;
-}
-
-function taskKindForEvents(task: any, event: Record<string, any>): string | undefined {
-  if (typeof task?.kind === 'string' && task.kind.length > 0) return task.kind;
-  if (typeof task?.task_kind === 'string' && task.task_kind.length > 0) return task.task_kind;
-  if (task?.is_fake_shrimp === true) return 'fake_shrimp';
-  if (event.faction === 'crab' && task?.is_fake_shrimp === false) return 'crab_sabotage';
-  return undefined;
-}
-
-function compactRoleAssignedForEvents(event: Record<string, any>): FormattedEvent {
-  const tasks = Array.isArray(event.assigned_tasks)
-    ? event.assigned_tasks.map((task: any) => cleanObject({
-      name: task?.name,
-      room: task?.room,
-      kind: taskKindForEvents(task, event),
-    }))
-    : undefined;
-  const taskKinds = Array.isArray(tasks)
-    ? Array.from(new Set(tasks.map((task: any) => task.kind).filter((kind: any) => typeof kind === 'string')))
-    : [];
-  const useTopLevelTaskKind = taskKinds.length === 1;
-  const compactTasks = Array.isArray(tasks)
-    ? tasks.map((task: any) => {
-      if (!useTopLevelTaskKind) return task;
-      const { kind: _kind, ...rest } = task;
-      return rest;
-    })
-    : undefined;
-  const hasFakeTask = taskKinds.includes('fake_shrimp') || event.fake_task_briefing;
-  return cleanObject({
-    type: text(event.type, 'event'),
-    tick: numberValue(event.tick) ?? null,
-    room: event.room,
-    role: event.role,
-    role_display: event.role_display_name ?? event.role_display,
-    faction: event.faction,
-    win_condition: event.role_description,
-    task_kind: useTopLevelTaskKind ? taskKinds[0] : undefined,
-    task_note: hasFakeTask ? 'Fake shrimp tasks: disguise only; no lobster progress.' : undefined,
-    tasks: compactTasks,
-    hint: roleAssignedHint(event),
-  });
-}
-
-function stripBackendHint(event: Record<string, any>): Record<string, any> {
-  const { hint: _hint, ...rest } = event;
-  return { ...rest };
-}
-
-function compactVoteCastForEvents(event: Record<string, any>, ctx: EventFormatContext): FormattedEvent {
-  const {
-    hint: _hint,
-    target: _target,
-    target_name: _targetName,
-    target_seat: _targetSeat,
-    target_player_seat: _targetPlayerSeat,
-    ...rest
-  } = event;
-  return cleanObject({
-    ...rest,
-    type: text(rest.type, 'event'),
-    tick: numberValue(rest.tick) ?? null,
-    hint: formatEventHint(event, ctx),
-  });
-}
-
-function compactCrabTeammatesForEvents(event: Record<string, any>, ctx: EventFormatContext): FormattedEvent {
-  const {
-    hint: _hint,
-    teammates: _teammates,
-    crab_teammates: _crabTeammates,
-    ...rest
-  } = event;
-  return cleanObject({
-    ...rest,
-    type: text(rest.type, 'event'),
-    tick: numberValue(rest.tick) ?? null,
-    crab_teammates: teammateObjects(event, ctx),
-    hint: formatEventHint(event, ctx),
-  });
-}
-
-function compactMeetingResultForEvents(event: Record<string, any>, ctx: EventFormatContext): FormattedEvent {
-  const {
-    hint: _hint,
-    votes: _votes,
-    ...rest
-  } = event;
-  const exiledName = event.type === 'exile'
-    ? event.result_target ?? event.actor_name
-    : undefined;
-  const exiledSeat = event.type === 'exile'
-    ? firstNumber(event, ['result_target_seat', 'actor_seat', 'seat'])
-    : undefined;
-  return cleanObject({
-    ...rest,
-    type: text(rest.type, 'event'),
-    tick: numberValue(rest.tick) ?? null,
-    meeting_ended: true,
-    result: event.type === 'exile' ? 'exiled' : 'no_exile',
-    exiled_player: playerObject(exiledName, exiledSeat, ctx),
-    votes: formatVotes(event.votes, ctx),
-    hint: formatEventHint(event, ctx),
-  });
-}
-
-export function compactEventForEvents(
-  event: Record<string, any>,
-  ctx: EventFormatContext = {},
-): FormattedEvent {
-  if (event.type === 'role_assigned') return compactRoleAssignedForEvents(event);
-
-  if (event.type === 'meeting_briefing') {
-    const { room: _room, hint: _hint, ...rest } = event;
-    return cleanObject({
-      ...rest,
-      type: text(rest.type, 'event'),
-      tick: numberValue(rest.tick) ?? null,
-      hint: formatEventHint(event, ctx),
-    });
-  }
-
-  if (event.type === 'vote_cast') return compactVoteCastForEvents(event, ctx);
-  if (event.type === 'crab_teammates') return compactCrabTeammatesForEvents(event, ctx);
-  if (event.type === 'exile' || event.type === 'no_exile') return compactMeetingResultForEvents(event, ctx);
-
-  const compact = stripBackendHint(event);
-  return cleanObject({
-    ...compact,
-    type: text(compact.type, 'event'),
-    tick: numberValue(compact.tick) ?? null,
-    hint: formatEventHint(event, ctx),
-  });
-}
-
-export function compactEventFields(
-  event: Record<string, any>,
-  ctx: EventFormatContext = {},
-  line?: number,
-): FormattedEvent {
-  return cleanObject({
-    line,
-    ...compactEventForEvents(event, ctx),
-  });
-}
-
-export function compactStateForEvents(
-  summary: any | null | undefined,
-  events: Array<Record<string, any>> = [],
-): Record<string, any> | null {
-  if (!summary || typeof summary !== 'object') return null;
-  const you = summary.you ?? {};
-  const meeting = summary.meeting ?? null;
-  const alivePlayers = Array.isArray(meeting?.alive_players) ? meeting.alive_players : undefined;
-  const votesSubmitted = Array.isArray(meeting?.votes_submitted) ? meeting.votes_submitted : undefined;
-  return cleanObject({
-    phase: summary.phase,
-    tick: summary.tick,
-    you: cleanObject({
-      name: you.name,
-      seat: you.seat,
-      role: you.role,
-      role_display: you.role_display,
-      faction: you.faction,
-      alive: you.alive ?? you.is_alive,
-      room: you.room,
-      kill_cooldown_secs: you.kill_cooldown_secs,
-      kills_remaining: you.kills_remaining,
-      doing_task: you.doing_task,
-    }),
-    game: summary.game ?? cleanObject({
-      game_id: summary.game_id,
-      alive_count: summary.alive_count,
-      task_progress: summary.task_progress,
-    }),
-    players: projectPlayers({ summary, events }),
-    meeting: meeting
-      ? cleanObject({
-        caller: meeting.caller,
-        sub_phase: meeting.sub_phase,
-        current_speaker: meeting.current_speaker,
-        is_my_turn: meeting.is_my_turn,
-        alive_count: alivePlayers?.length,
-        votes_submitted_count: votesSubmitted?.length,
-      })
-      : undefined,
-    urgent: summary.urgent,
-    automation: summary.automation,
-  });
-}
-
-export function shortStateText(summary: any | null | undefined): string {
-  if (!summary || typeof summary !== 'object') return 'state unavailable';
-  const phase = text(summary.phase, 'unknown');
-  const sub = typeof summary.meeting?.sub_phase === 'string' ? `/${summary.meeting.sub_phase}` : '';
-  const parts = [`${phase}${sub}`];
-  const you = summary.you ?? {};
-  if (you.name) {
-    const alive = you.alive ?? you.is_alive;
-    if (typeof alive === 'boolean') parts.push(`you=${you.name} ${alive ? 'alive' : 'dead'}`);
-    else parts.push(`you=${you.name}`);
-  }
-  const speaker = summary.meeting?.current_speaker;
-  if (speaker) parts.push(`speaker=${summary.meeting?.is_my_turn ? 'you' : speaker}`);
-  const alivePlayers = summary.meeting?.alive_players;
-  const aliveCount = Array.isArray(alivePlayers)
-    ? alivePlayers.length
-    : summary.game?.alive_count ?? summary.alive_count;
-  if (aliveCount !== undefined) parts.push(`alive=${aliveCount}`);
-  if (summary.urgent?.emergency_active) parts.push('urgent=emergency');
-  if (summary.urgent?.corpse_nearby) parts.push('urgent=corpse');
-  return parts.join('; ');
-}
+import { formatEventHint, roleAssignedHint } from './event-hints.js';
+import { projectPlayers } from './player-projection.js';
+
+export interface EventFormatContext {
+  summary?: any | null;
+  seats?: Record<string, number>;
+  isFirstVisibleEvent?: boolean;
+  maxTextLength?: number;
+}
+
+export interface FormattedEvent {
+  line?: number;
+  type: string;
+  tick: number | null;
+  notice?: string;
+  hint?: string;
+  [key: string]: any;
+}
+
+function cleanObject<T extends Record<string, any>>(obj: T): T {
+  for (const key of Object.keys(obj)) {
+    if (obj[key] === undefined) delete obj[key];
+  }
+  return obj;
+}
+
+function text(value: unknown, fallback = '?'): string {
+  if (typeof value === 'string' && value.length > 0) return value;
+  if (typeof value === 'number' && Number.isFinite(value)) return String(value);
+  return fallback;
+}
+
+function numberValue(value: unknown): number | undefined {
+  if (typeof value === 'number' && Number.isFinite(value)) return value;
+  if (typeof value === 'string' && value.trim() !== '') {
+    const parsed = Number(value);
+    if (Number.isFinite(parsed)) return parsed;
+  }
+  return undefined;
+}
+
+function firstString(event: Record<string, any>, keys: string[], fallback = '?'): string {
+  for (const key of keys) {
+    const value = event[key];
+    if (typeof value === 'string' && value.length > 0) return value;
+    if (typeof value === 'number' && Number.isFinite(value)) return String(value);
+  }
+  return fallback;
+}
+
+function firstNumber(event: Record<string, any>, keys: string[]): number | undefined {
+  for (const key of keys) {
+    const value = numberValue(event[key]);
+    if (value !== undefined) return value;
+  }
+  return undefined;
+}
+
+function truncate(value: unknown, maxLength: number): string {
+  const raw = text(value, '');
+  if (raw.length <= maxLength) return raw;
+  return `${raw.slice(0, Math.max(0, maxLength - 1))}…`;
+}
+
+export function seatMapFromSummary(summary: any | null | undefined, extra?: Record<string, number>): Record<string, number> {
+  const seats: Record<string, number> = { ...(extra ?? {}) };
+  const remember = (name: unknown, seat: unknown): void => {
+    if (typeof name !== 'string' || name.length === 0) return;
+    const parsed = numberValue(seat);
+    if (parsed !== undefined) seats[name] = parsed;
+  };
+
+  remember(summary?.you?.name, summary?.you?.seat);
+
+  const collections = [
+    summary?.visible_players,
+    summary?.all_players,
+    summary?.game?.all_players,
+    summary?.meeting?.alive_players,
+  ];
+  for (const collection of collections) {
+    if (!Array.isArray(collection)) continue;
+    for (const player of collection) {
+      if (typeof player === 'string') continue;
+      remember(player?.name ?? player?.agent_name, player?.seat);
+    }
+  }
+
+  const allSeats = summary?.all_seats ?? summary?.game?.all_seats;
+  if (allSeats && typeof allSeats === 'object' && !Array.isArray(allSeats)) {
+    for (const [name, seat] of Object.entries(allSeats)) remember(name, seat);
+  }
+
+  return seats;
+}
+
+function seatForName(name: unknown, ctx: EventFormatContext): number | undefined {
+  if (typeof name !== 'string' || name.length === 0) return undefined;
+  return seatMapFromSummary(ctx.summary, ctx.seats)[name];
+}
+
+function seatLabel(name: unknown, seat: unknown, ctx: EventFormatContext): string {
+  const resolved = numberValue(seat) ?? seatForName(name, ctx);
+  return resolved === undefined ? '?号' : `${resolved}号`;
+}
+
+function playerLabel(name: unknown, seat: unknown, ctx: EventFormatContext): string {
+  return `${seatLabel(name, seat, ctx)}${text(name, '未知玩家')}`;
+}
+
+function playerObject(name: unknown, seat: unknown, ctx: EventFormatContext): Record<string, any> | undefined {
+  if (typeof name !== 'string' || name.length === 0) return undefined;
+  return cleanObject({
+    name,
+    seat: numberValue(seat) ?? seatForName(name, ctx),
+  });
+}
+
+function voteTargetLabel(target: unknown, ctx: EventFormatContext): string {
+  if (target === null || target === undefined) return 'skip';
+  if (typeof target === 'object' && !Array.isArray(target)) {
+    const targetObject = target as Record<string, any>;
+    return playerLabel(targetObject.name ?? targetObject.agent_name, targetObject.seat, ctx);
+  }
+  const raw = text(target, 'skip');
+  return raw === 'skip' ? 'skip' : playerLabel(raw, undefined, ctx);
+}
+
+function formatVotes(votes: unknown, ctx: EventFormatContext): Record<string, string> | undefined {
+  if (!votes || typeof votes !== 'object' || Array.isArray(votes)) return undefined;
+  const out: Record<string, string> = {};
+  for (const [voter, target] of Object.entries(votes)) {
+    out[playerLabel(voter, undefined, ctx)] = voteTargetLabel(target, ctx);
+  }
+  return out;
+}
+
+function teammateNames(event: Record<string, any>): string[] {
+  const raw = Array.isArray(event.crab_teammates)
+    ? event.crab_teammates
+    : Array.isArray(event.teammates)
+      ? event.teammates
+      : [];
+  const names: string[] = [];
+  for (const teammate of raw) {
+    const name = typeof teammate === 'string' ? teammate : teammate?.name;
+    if (typeof name === 'string' && name.length > 0) names.push(name);
+  }
+  return names;
+}
+
+function teammateObjects(event: Record<string, any>, ctx: EventFormatContext): Record<string, any>[] {
+  const raw = Array.isArray(event.crab_teammates)
+    ? event.crab_teammates
+    : Array.isArray(event.teammates)
+      ? event.teammates
+      : [];
+  const teammates: Record<string, any>[] = [];
+  for (const teammate of raw) {
+    const name = typeof teammate === 'string' ? teammate : teammate?.name;
+    const seat = typeof teammate === 'string' ? undefined : teammate?.seat;
+    const normalized = playerObject(name, seat, ctx);
+    if (normalized) teammates.push(normalized);
+  }
+  return teammates;
+}
+
+function prefix(event: Record<string, any>): string {
+  const type = text(event.type, 'event');
+  const tick = numberValue(event.tick);
+  return tick === undefined ? `tick=null ${type}` : `t${tick} ${type}`;
+}
+
+function firstReportedCorpse(event: Record<string, any>): Record<string, any> | null {
+  const corpses = event.reported_corpses;
+  if (Array.isArray(corpses) && corpses.length > 0 && corpses[0] && typeof corpses[0] === 'object') {
+    return corpses[0];
+  }
+  return null;
+}
+
+function shortBody(event: Record<string, any>, ctx: EventFormatContext): string {
+  const maxTextLength = ctx.maxTextLength ?? 100;
+  switch (event.type) {
+    case 'game_started': {
+      const playerCount = numberValue(event.player_count);
+      const countText = playerCount === undefined ? '对局开始' : `对局开始：${playerCount}名玩家`;
+      return `${countText}。地图/座位查 ccl events game_started，身份/任务查 ccl events role_assigned。`;
+    }
+    case 'role_assigned': {
+      const start = ctx.isFirstVisibleEvent ? '对局开始。' : '';
+      return `${start}身份已分配：你是${firstString(event, ['role_display_name', 'role_display', 'role'])}（${firstString(event, ['faction'])}）。`;
+    }
+    case 'kill':
+      return `你在${firstString(event, ['room'])}击杀了${playerLabel(event.target_name, firstNumber(event, ['target_seat', 'target_player_seat']), ctx)}。`;
+    case 'killed':
+      return `你在${firstString(event, ['room'])}被${playerLabel(event.killer_name, firstNumber(event, ['killer_seat', 'killer_player_seat']), ctx)}击杀了，你已死亡。`;
+    case 'murder_witnessed':
+      return `你在${firstString(event, ['room'])}目击${playerLabel(event.killer_name, firstNumber(event, ['killer_seat', 'killer_player_seat']), ctx)}击杀${playerLabel(event.target_name, firstNumber(event, ['target_seat', 'target_player_seat']), ctx)}。`;
+    case 'warrior_shrimp_self_destruct':
+      return `你误杀了${playerLabel(event.target_name, firstNumber(event, ['target_seat', 'target_player_seat']), ctx)}，武士虾自爆出局。`;
+    case 'task_completed': {
+      const fakeNote = event.is_fake_shrimp ? '（伪装）' : '';
+      return `任务完成：${firstString(event, ['task_name'])}${fakeNote}。`;
+    }
+    case 'task_sabotaged':
+      return `破坏任务完成：${firstString(event, ['task_name'])}（${firstString(event, ['room'])}）。`;
+    case 'corpse_spotted':
+      return `我发现了${playerLabel(event.corpse_name, firstNumber(event, ['corpse_seat', 'corpse_player_seat']), ctx)}的尸体，在${firstString(event, ['corpse_room', 'room'])}。`;
+    case 'octopus_time_start':
+      return '章鱼时间开始：剩3人，章鱼存活60秒将获胜，会议已禁用。';
+    case 'emergency_started':
+      return `紧急任务：${firstString(event, ['task_name'])}在${firstString(event, ['room'])}，${text(event.timeout_secs, '?')}秒内处理。`;
+    case 'emergency_resolved':
+      return `紧急任务已解决：${firstString(event, ['task_name'])}。`;
+    case 'meeting_briefing': {
+      const callerName = firstString(event, ['meeting_caller_name', 'caller', 'actor_name']);
+      const caller = playerLabel(callerName, firstNumber(event, ['meeting_caller_seat', 'caller_seat', 'actor_seat']), ctx);
+      const corpse = firstReportedCorpse(event);
+      if (!corpse) return `会议开始：${caller}发起会议。`;
+      const corpseName = text(corpse.name ?? event.corpse_name, '未知玩家');
+      const corpseSeat = numberValue(corpse.seat) ?? firstNumber(event, ['corpse_seat', 'corpse_player_seat']);
+      return `会议开始：${caller}报告${playerLabel(corpseName, corpseSeat, ctx)}尸体。`;
+    }
+    case 'speech':
+      return `${playerLabel(event.actor_name, firstNumber(event, ['actor_seat', 'seat']), ctx)}会议发言：${truncate(event.text ?? event.message, maxTextLength)}`;
+    case 'speech_skipped':
+      return `${playerLabel(event.actor_name, firstNumber(event, ['actor_seat', 'seat']), ctx)}发言超时，被跳过。`;
+    case 'speech_your_turn':
+      return '轮到你发言。立即用 ccl do -s "..."。';
+    case 'vote_phase_start':
+      return '投票阶段开始。前20秒可用 ccl do -s "..." 发弹幕；确认后用 ccl do -v <玩家名|skip> 投票。';
+    case 'vote_cast':
+      return `${playerLabel(event.actor_name, firstNumber(event, ['actor_seat', 'seat']), ctx)}已投票。`;
+    case 'vote_speech_phase_ended':
+      return '投票弹幕窗口已关闭。请用 ccl do -v <玩家名|skip> 完成投票。';
+    case 'exile': {
+      const exiledName = event.result_target ?? event.actor_name;
+      const exiledSeat = firstNumber(event, ['result_target_seat', 'actor_seat', 'seat']);
+      return `会议结束：${playerLabel(exiledName, exiledSeat, ctx)}被放逐。`;
+    }
+    case 'no_exile':
+      return '会议结束：无人被放逐。';
+    case 'meeting_ended':
+      return '会议结束。';
+    case 'death_speech': {
+      const speakerName = event.speaker_name ?? event.actor_name;
+      const speakerSeat = firstNumber(event, ['speaker_seat', 'actor_seat', 'seat']);
+      return `${playerLabel(speakerName, speakerSeat, ctx)}死亡弹幕：${truncate(event.text ?? event.message, maxTextLength)}`;
+    }
+    case 'crab_teammates': {
+      const labels = teammateNames(event).map((name) => playerLabel(name, undefined, ctx));
+      return labels.length > 0 ? `蟹队友：${labels.join('、')}。` : '蟹队友信息已更新。';
+    }
+    case 'wandering_speech':
+      return `${text(event.actor_name, '你')}在${firstString(event, ['room'])}说：${truncate(event.text ?? event.message, maxTextLength)}`;
+    case 'game_over':
+      return `游戏结束：${firstString(event, ['winner_name'], '未知玩家')}获胜（${firstString(event, ['winner'])}），原因 ${firstString(event, ['reason'])}。`;
+    case 'user_left_game':
+      return 'The user left the game from the web page. This match has ended; stop playing and do not restart unless the user asks.';
+    case 'match_waiting':
+      return `仍在匹配队列，已等待${text(event.waited_secs, '?')}秒。`;
+    case 'match_timeout':
+      return `匹配超时，累计等待${text(event.waited_secs, '?')}秒。询问用户是否重试。`;
+    case 'robot_speak_rule':
+      return `发言提示：${truncate(event.message ?? event.text, maxTextLength)}`;
+    case 'strategy_alert':
+      return truncate(event.message ?? event.text, maxTextLength);
+    case 'game_start':
+      return '事件流已连接，等待身份分配。';
+    case 'heartbeat':
+      return '事件流正常，暂无新事件。';
+    case 'snapshot':
+      return '当前状态快照。';
+    case 'not_logged_in':
+      return '未登录。';
+    case 'not_ready':
+      return '游戏运行时未就绪。请运行 ccl game start。';
+    case 'error':
+      return text(event.message ?? event.error, '发生错误。');
+    default:
+      return truncate(event.message ?? event.hint ?? event.type, maxTextLength);
+  }
+}
+
+export function formatEventMessage(event: Record<string, any>, ctx: EventFormatContext = {}): string {
+  return `${prefix(event)} ${shortBody(event, ctx)}`;
+}
+
+function taskKindForEvents(task: any, event: Record<string, any>): string | undefined {
+  if (typeof task?.kind === 'string' && task.kind.length > 0) return task.kind;
+  if (typeof task?.task_kind === 'string' && task.task_kind.length > 0) return task.task_kind;
+  if (task?.is_fake_shrimp === true) return 'fake_shrimp';
+  if (event.faction === 'crab' && task?.is_fake_shrimp === false) return 'crab_sabotage';
+  return undefined;
+}
+
+function compactRoleAssignedForEvents(event: Record<string, any>): FormattedEvent {
+  const tasks = Array.isArray(event.assigned_tasks)
+    ? event.assigned_tasks.map((task: any) => cleanObject({
+      name: task?.name,
+      room: task?.room,
+      kind: taskKindForEvents(task, event),
+    }))
+    : undefined;
+  const taskKinds = Array.isArray(tasks)
+    ? Array.from(new Set(tasks.map((task: any) => task.kind).filter((kind: any) => typeof kind === 'string')))
+    : [];
+  const useTopLevelTaskKind = taskKinds.length === 1;
+  const compactTasks = Array.isArray(tasks)
+    ? tasks.map((task: any) => {
+      if (!useTopLevelTaskKind) return task;
+      const { kind: _kind, ...rest } = task;
+      return rest;
+    })
+    : undefined;
+  const hasFakeTask = taskKinds.includes('fake_shrimp') || event.fake_task_briefing;
+  return cleanObject({
+    type: text(event.type, 'event'),
+    tick: numberValue(event.tick) ?? null,
+    room: event.room,
+    role: event.role,
+    role_display: event.role_display_name ?? event.role_display,
+    faction: event.faction,
+    win_condition: event.role_description,
+    task_kind: useTopLevelTaskKind ? taskKinds[0] : undefined,
+    task_note: hasFakeTask ? 'Fake shrimp tasks: disguise only; no lobster progress.' : undefined,
+    tasks: compactTasks,
+    hint: roleAssignedHint(event),
+  });
+}
+
+function stripBackendHint(event: Record<string, any>): Record<string, any> {
+  const { hint: _hint, ...rest } = event;
+  return { ...rest };
+}
+
+function compactVoteCastForEvents(event: Record<string, any>, ctx: EventFormatContext): FormattedEvent {
+  const {
+    hint: _hint,
+    target: _target,
+    target_name: _targetName,
+    target_seat: _targetSeat,
+    target_player_seat: _targetPlayerSeat,
+    ...rest
+  } = event;
+  return cleanObject({
+    ...rest,
+    type: text(rest.type, 'event'),
+    tick: numberValue(rest.tick) ?? null,
+    hint: formatEventHint(event, ctx),
+  });
+}
+
+function compactCrabTeammatesForEvents(event: Record<string, any>, ctx: EventFormatContext): FormattedEvent {
+  const {
+    hint: _hint,
+    teammates: _teammates,
+    crab_teammates: _crabTeammates,
+    ...rest
+  } = event;
+  return cleanObject({
+    ...rest,
+    type: text(rest.type, 'event'),
+    tick: numberValue(rest.tick) ?? null,
+    crab_teammates: teammateObjects(event, ctx),
+    hint: formatEventHint(event, ctx),
+  });
+}
+
+function compactMeetingResultForEvents(event: Record<string, any>, ctx: EventFormatContext): FormattedEvent {
+  const {
+    hint: _hint,
+    votes: _votes,
+    ...rest
+  } = event;
+  const exiledName = event.type === 'exile'
+    ? event.result_target ?? event.actor_name
+    : undefined;
+  const exiledSeat = event.type === 'exile'
+    ? firstNumber(event, ['result_target_seat', 'actor_seat', 'seat'])
+    : undefined;
+  return cleanObject({
+    ...rest,
+    type: text(rest.type, 'event'),
+    tick: numberValue(rest.tick) ?? null,
+    meeting_ended: true,
+    result: event.type === 'exile' ? 'exiled' : 'no_exile',
+    exiled_player: playerObject(exiledName, exiledSeat, ctx),
+    votes: formatVotes(event.votes, ctx),
+    hint: formatEventHint(event, ctx),
+  });
+}
+
+export function compactEventForEvents(
+  event: Record<string, any>,
+  ctx: EventFormatContext = {},
+): FormattedEvent {
+  if (event.type === 'role_assigned') return compactRoleAssignedForEvents(event);
+
+  if (event.type === 'meeting_briefing') {
+    const { room: _room, hint: _hint, ...rest } = event;
+    return cleanObject({
+      ...rest,
+      type: text(rest.type, 'event'),
+      tick: numberValue(rest.tick) ?? null,
+      hint: formatEventHint(event, ctx),
+    });
+  }
+
+  if (event.type === 'vote_cast') return compactVoteCastForEvents(event, ctx);
+  if (event.type === 'crab_teammates') return compactCrabTeammatesForEvents(event, ctx);
+  if (event.type === 'exile' || event.type === 'no_exile') return compactMeetingResultForEvents(event, ctx);
+
+  const compact = stripBackendHint(event);
+  return cleanObject({
+    ...compact,
+    type: text(compact.type, 'event'),
+    tick: numberValue(compact.tick) ?? null,
+    hint: formatEventHint(event, ctx),
+  });
+}
+
+export function compactEventFields(
+  event: Record<string, any>,
+  ctx: EventFormatContext = {},
+  line?: number,
+): FormattedEvent {
+  return cleanObject({
+    line,
+    ...compactEventForEvents(event, ctx),
+  });
+}
+
+export function compactStateForEvents(
+  summary: any | null | undefined,
+  events: Array<Record<string, any>> = [],
+): Record<string, any> | null {
+  if (!summary || typeof summary !== 'object') return null;
+  const you = summary.you ?? {};
+  const meeting = summary.meeting ?? null;
+  const alivePlayers = Array.isArray(meeting?.alive_players) ? meeting.alive_players : undefined;
+  const votesSubmitted = Array.isArray(meeting?.votes_submitted) ? meeting.votes_submitted : undefined;
+  return cleanObject({
+    phase: summary.phase,
+    tick: summary.tick,
+    you: cleanObject({
+      name: you.name,
+      seat: you.seat,
+      role: you.role,
+      role_display: you.role_display,
+      faction: you.faction,
+      alive: you.alive ?? you.is_alive,
+      room: you.room,
+      kill_cooldown_secs: you.kill_cooldown_secs,
+      kills_remaining: you.kills_remaining,
+      doing_task: you.doing_task,
+    }),
+    game: summary.game ?? cleanObject({
+      game_id: summary.game_id,
+      alive_count: summary.alive_count,
+      task_progress: summary.task_progress,
+    }),
+    players: projectPlayers({ summary, events }),
+    meeting: meeting
+      ? cleanObject({
+        caller: meeting.caller,
+        sub_phase: meeting.sub_phase,
+        current_speaker: meeting.current_speaker,
+        is_my_turn: meeting.is_my_turn,
+        alive_count: alivePlayers?.length,
+        votes_submitted_count: votesSubmitted?.length,
+      })
+      : undefined,
+    urgent: summary.urgent,
+    automation: summary.automation,
+  });
+}
+
+export function shortStateText(summary: any | null | undefined): string {
+  if (!summary || typeof summary !== 'object') return 'state unavailable';
+  const phase = text(summary.phase, 'unknown');
+  const sub = typeof summary.meeting?.sub_phase === 'string' ? `/${summary.meeting.sub_phase}` : '';
+  const parts = [`${phase}${sub}`];
+  const you = summary.you ?? {};
+  if (you.name) {
+    const alive = you.alive ?? you.is_alive;
+    if (typeof alive === 'boolean') parts.push(`you=${you.name} ${alive ? 'alive' : 'dead'}`);
+    else parts.push(`you=${you.name}`);
+  }
+  const speaker = summary.meeting?.current_speaker;
+  if (speaker) parts.push(`speaker=${summary.meeting?.is_my_turn ? 'you' : speaker}`);
+  const alivePlayers = summary.meeting?.alive_players;
+  const aliveCount = Array.isArray(alivePlayers)
+    ? alivePlayers.length
+    : summary.game?.alive_count ?? summary.alive_count;
+  if (aliveCount !== undefined) parts.push(`alive=${aliveCount}`);
+  if (summary.urgent?.emergency_active) parts.push('urgent=emergency');
+  if (summary.urgent?.corpse_nearby) parts.push('urgent=corpse');
+  return parts.join('; ');
+}