@within-7/minto 0.1.7 → 0.2.0

package/dist/utils/agentTranscripts.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/utils/agentTranscripts.ts"],
+  "sourcesContent": ["/**\n * Agent Transcripts System\n *\n * Provides persistent storage for agent execution history, enabling:\n * - Resume interrupted agent executions\n * - View agent execution history\n * - Debug and audit agent behavior\n *\n * Storage location: ~/.minto/transcripts/{agentId}.json\n */\n\nimport {\n  existsSync,\n  readFileSync,\n  writeFileSync,\n  mkdirSync,\n  readdirSync,\n  unlinkSync,\n} from 'fs'\nimport { join } from 'path'\nimport { homedir } from 'os'\nimport { EventEmitter } from 'events'\nimport type { Message as MessageType } from '@query'\nimport { debug as debugLogger } from './debugLogger'\n\n/**\n * Event types for transcript updates\n */\nexport type TranscriptEventType =\n  | 'created'\n  | 'updated'\n  | 'message_appended'\n  | 'status_changed'\n  | 'completed'\n  | 'failed'\n  | 'interrupted'\n\n/**\n * Event payload for transcript events\n */\nexport interface TranscriptEvent {\n  type: TranscriptEventType\n  agentId: string\n  toolUseId?: string\n  transcript: AgentTranscript\n  previousStatus?: AgentStatus\n}\n\n/**\n * AgentTranscript Event Emitter\n *\n * Provides real-time event notification for transcript changes,\n * enabling UI components to react immediately without polling.\n *\n * Performance optimizations:\n * - Throttled message_appended events to reduce UI re-renders\n * - Immediate emission for status changes and critical events\n * - Batched updates for high-frequency events\n *\n * Usage:\n * ```typescript\n * // Subscribe to all updates\n * transcriptEmitter.on('update', (event) => { ... })\n *\n * // Subscribe to specific agent updates\n * transcriptEmitter.on('update:agent-123', (transcript) => { ... })\n *\n * // Subscribe to specific event types\n * transcriptEmitter.on('status_changed', (event) => { ... })\n * ```\n */\nclass AgentTranscriptEmitter extends EventEmitter {\n  private static instance: AgentTranscriptEmitter\n\n  // Throttle configuration\n  private static readonly THROTTLE_INTERVAL = 100 // ms between message_appended events\n  private static readonly HIGH_PRIORITY_EVENTS: TranscriptEventType[] = [\n    'created',\n    'completed',\n    'failed',\n    'interrupted',\n    'status_changed',\n  ]\n\n  // Throttle state per agent\n  private throttleState: Map<\n    string,\n    {\n      lastEmitTime: number\n      pendingEvent: TranscriptEvent | null\n      timeoutId: ReturnType<typeof setTimeout> | null\n    }\n  > = new Map()\n\n  private constructor() {\n    super()\n    // Increase max listeners for concurrent agent scenarios\n    this.setMaxListeners(100)\n  }\n\n  static getInstance(): AgentTranscriptEmitter {\n    if (!AgentTranscriptEmitter.instance) {\n      AgentTranscriptEmitter.instance = new AgentTranscriptEmitter()\n    }\n    return AgentTranscriptEmitter.instance\n  }\n\n  /**\n   * Get or create throttle state for an agent\n   */\n  private getThrottleState(agentId: string) {\n    let state = this.throttleState.get(agentId)\n    if (!state) {\n      state = {\n        lastEmitTime: 0,\n        pendingEvent: null,\n        timeoutId: null,\n      }\n      this.throttleState.set(agentId, state)\n    }\n    return state\n  }\n\n  /**\n   * Clean up throttle state for an agent (call when agent completes)\n   */\n  private cleanupThrottleState(agentId: string): void {\n    const state = this.throttleState.get(agentId)\n    if (state?.timeoutId) {\n      clearTimeout(state.timeoutId)\n    }\n    this.throttleState.delete(agentId)\n  }\n\n  /**\n   * Internal emit that actually sends the event\n   */\n  private doEmit(event: TranscriptEvent): void {\n    // Emit general update event\n    this.emit('update', event)\n\n    // Emit agent-specific event\n    this.emit(`update:${event.agentId}`, event.transcript)\n\n    // Emit toolUseId-specific event (for Task tool UI updates)\n    if (event.toolUseId) {\n      this.emit(`update:toolUse:${event.toolUseId}`, event.transcript)\n    }\n\n    // Emit event-type specific event\n    this.emit(event.type, event)\n\n    debugLogger.trace('TRANSCRIPT_EVENT_EMITTED', {\n      type: event.type,\n      agentId: event.agentId,\n      status: event.transcript.status,\n    })\n  }\n\n  /**\n   * Emit a transcript update event\n   *\n   * High-priority events (status changes, completion) are emitted immediately.\n   * Low-priority events (message_appended) are throttled to reduce UI flickering.\n   */\n  emitUpdate(event: TranscriptEvent): void {\n    // High-priority events: emit immediately\n    if (AgentTranscriptEmitter.HIGH_PRIORITY_EVENTS.includes(event.type)) {\n      // Clean up throttle state on completion events\n      if (\n        event.type === 'completed' ||\n        event.type === 'failed' ||\n        event.type === 'interrupted'\n      ) {\n        // Flush any pending event first\n        const state = this.throttleState.get(event.agentId)\n        if (state?.pendingEvent) {\n          this.doEmit(state.pendingEvent)\n        }\n        this.cleanupThrottleState(event.agentId)\n      }\n\n      this.doEmit(event)\n      return\n    }\n\n    // Low-priority events: apply throttling\n    const state = this.getThrottleState(event.agentId)\n    const now = Date.now()\n    const timeSinceLastEmit = now - state.lastEmitTime\n\n    if (timeSinceLastEmit >= AgentTranscriptEmitter.THROTTLE_INTERVAL) {\n      // Enough time has passed, emit immediately\n      state.lastEmitTime = now\n      state.pendingEvent = null\n      if (state.timeoutId) {\n        clearTimeout(state.timeoutId)\n        state.timeoutId = null\n      }\n      this.doEmit(event)\n    } else {\n      // Store as pending and schedule delayed emit\n      state.pendingEvent = event\n\n      if (!state.timeoutId) {\n        const delay =\n          AgentTranscriptEmitter.THROTTLE_INTERVAL - timeSinceLastEmit\n        state.timeoutId = setTimeout(() => {\n          const currentState = this.throttleState.get(event.agentId)\n          if (currentState?.pendingEvent) {\n            currentState.lastEmitTime = Date.now()\n            const pendingEvent = currentState.pendingEvent\n            currentState.pendingEvent = null\n            currentState.timeoutId = null\n            this.doEmit(pendingEvent)\n          }\n        }, delay)\n      }\n    }\n  }\n\n  /**\n   * Subscribe to updates for a specific agent\n   */\n  onAgentUpdate(\n    agentId: string,\n    callback: (transcript: AgentTranscript) => void,\n  ): () => void {\n    const eventName = `update:${agentId}`\n    this.on(eventName, callback)\n    return () => this.off(eventName, callback)\n  }\n\n  /**\n   * Subscribe to updates for a specific toolUseId\n   */\n  onToolUseUpdate(\n    toolUseId: string,\n    callback: (transcript: AgentTranscript) => void,\n  ): () => void {\n    const eventName = `update:toolUse:${toolUseId}`\n    this.on(eventName, callback)\n    return () => this.off(eventName, callback)\n  }\n\n  /**\n   * Subscribe to all updates (any agent)\n   */\n  onAnyUpdate(callback: (event: TranscriptEvent) => void): () => void {\n    this.on('update', callback)\n    return () => this.off('update', callback)\n  }\n\n  /**\n   * Subscribe to status change events\n   */\n  onStatusChange(callback: (event: TranscriptEvent) => void): () => void {\n    this.on('status_changed', callback)\n    return () => this.off('status_changed', callback)\n  }\n}\n\n// Export singleton instance\nexport const transcriptEmitter = AgentTranscriptEmitter.getInstance()\n\n/**\n * Agent execution status\n */\nexport type AgentStatus = 'running' | 'completed' | 'failed' | 'interrupted'\n\n/**\n * Token usage statistics\n */\nexport interface TokenUsage {\n  inputTokens: number\n  outputTokens: number\n  cacheReadTokens?: number\n  cacheCreationTokens?: number\n}\n\n/**\n * Agent Transcript - Complete record of an agent's execution\n */\nexport interface AgentTranscript {\n  /** Unique identifier for this agent execution */\n  agentId: string\n\n  /** Type of agent (e.g., \"general-purpose\", \"strategic-market-analyzer\") */\n  agentType: string\n\n  /** Parent agent ID if this is a nested agent call */\n  parentAgentId?: string\n\n  /** The tool_use ID that triggered this agent (for UI association) */\n  toolUseId?: string\n\n  /** Short description of the task (3-5 words) */\n  description: string\n\n  /** Full prompt given to the agent */\n  prompt: string\n\n  /** Unix timestamp when execution started */\n  startTime: number\n\n  /** Unix timestamp when execution ended (undefined if still running) */\n  endTime?: number\n\n  /** Current execution status */\n  status: AgentStatus\n\n  /** All messages in the agent's conversation */\n  messages: MessageType[]\n\n  /** Number of tool uses during execution */\n  toolUseCount: number\n\n  /** Token usage statistics */\n  tokenUsage: TokenUsage\n\n  /** Model used for this agent */\n  model: string\n\n  /** Fork number for log correlation */\n  forkNumber?: number\n\n  /** Message log name for log correlation */\n  messageLogName?: string\n\n  /** Additional metadata */\n  metadata?: Record<string, unknown>\n\n  /** API retry events (for display in UI) */\n  retryEvents?: Array<{\n    timestamp: number\n    attempt: number\n    maxRetries: number\n    errorMessage: string\n    delayMs: number\n  }>\n}\n\n/**\n * Summary of an agent transcript (for listing)\n */\nexport interface AgentTranscriptSummary {\n  agentId: string\n  agentType: string\n  description: string\n  status: AgentStatus\n  startTime: number\n  endTime?: number\n  messageCount: number\n  toolUseCount: number\n  model: string\n}\n\n/**\n * Options for listing transcripts\n */\nexport interface ListTranscriptsOptions {\n  /** Filter by status */\n  status?: AgentStatus | AgentStatus[]\n  /** Filter by agent type */\n  agentType?: string\n  /** Limit number of results */\n  limit?: number\n  /** Sort order (newest first by default) */\n  sortOrder?: 'asc' | 'desc'\n  /** Only include transcripts after this timestamp */\n  since?: number\n}\n\n// In-memory cache for active transcripts (faster access during execution)\nconst activeTranscripts = new Map<string, AgentTranscript>()\n\n/**\n * Get the transcripts directory path\n */\nfunction getTranscriptsDirectory(): string {\n  const configDir =\n    process.env.MINTO_CONFIG_DIR ??\n    process.env.CLAUDE_CONFIG_DIR ??\n    join(homedir(), '.minto')\n\n  return join(configDir, 'transcripts')\n}\n\n/**\n * Ensure the transcripts directory exists\n */\nfunction ensureTranscriptsDirectory(): void {\n  const dir = getTranscriptsDirectory()\n  if (!existsSync(dir)) {\n    mkdirSync(dir, { recursive: true })\n  }\n}\n\n/**\n * Get the file path for a transcript\n */\nfunction getTranscriptPath(agentId: string): string {\n  return join(getTranscriptsDirectory(), `${agentId}.json`)\n}\n\n/**\n * Create a new agent transcript\n */\nexport function createAgentTranscript(\n  options: Omit<\n    AgentTranscript,\n    'startTime' | 'status' | 'messages' | 'toolUseCount' | 'tokenUsage'\n  > & {\n    messages?: MessageType[]\n    toolUseCount?: number\n    tokenUsage?: Partial<TokenUsage>\n  },\n): AgentTranscript {\n  const transcript: AgentTranscript = {\n    ...options,\n    startTime: Date.now(),\n    status: 'running',\n    messages: options.messages || [],\n    toolUseCount: options.toolUseCount || 0,\n    tokenUsage: {\n      inputTokens: options.tokenUsage?.inputTokens || 0,\n      outputTokens: options.tokenUsage?.outputTokens || 0,\n      cacheReadTokens: options.tokenUsage?.cacheReadTokens,\n      cacheCreationTokens: options.tokenUsage?.cacheCreationTokens,\n    },\n  }\n\n  // Store in memory cache\n  activeTranscripts.set(options.agentId, transcript)\n\n  // Persist to disk\n  saveAgentTranscript(transcript, false) // Don't emit here, we'll emit 'created' specifically\n\n  debugLogger.info('AGENT_TRANSCRIPT_CREATED', {\n    agentId: options.agentId,\n    agentType: options.agentType,\n    description: options.description,\n  })\n\n  // Emit creation event\n  transcriptEmitter.emitUpdate({\n    type: 'created',\n    agentId: options.agentId,\n    toolUseId: options.toolUseId,\n    transcript,\n  })\n\n  return transcript\n}\n\n/**\n * Save an agent transcript to disk\n * @param transcript The transcript to save\n * @param emitEvent Whether to emit an update event (default: true)\n */\nexport function saveAgentTranscript(\n  transcript: AgentTranscript,\n  emitEvent: boolean = true,\n): void {\n  ensureTranscriptsDirectory()\n\n  const filePath = getTranscriptPath(transcript.agentId)\n\n  try {\n    writeFileSync(filePath, JSON.stringify(transcript, null, 2), 'utf-8')\n\n    // Update memory cache\n    activeTranscripts.set(transcript.agentId, transcript)\n\n    debugLogger.trace('AGENT_TRANSCRIPT_SAVED', {\n      agentId: transcript.agentId,\n      status: transcript.status,\n      messageCount: transcript.messages.length,\n    })\n\n    // Emit update event if requested\n    if (emitEvent) {\n      transcriptEmitter.emitUpdate({\n        type: 'updated',\n        agentId: transcript.agentId,\n        toolUseId: transcript.toolUseId,\n        transcript,\n      })\n    }\n  } catch (error) {\n    debugLogger.error('AGENT_TRANSCRIPT_SAVE_FAILED', {\n      agentId: transcript.agentId,\n      error: error instanceof Error ? error.message : String(error),\n    })\n    throw error\n  }\n}\n\n/**\n * Get an agent transcript by ID\n */\nexport function getAgentTranscript(agentId: string): AgentTranscript | null {\n  // Check memory cache first\n  const cached = activeTranscripts.get(agentId)\n  if (cached) {\n    return cached\n  }\n\n  // Try to load from disk\n  const filePath = getTranscriptPath(agentId)\n\n  if (!existsSync(filePath)) {\n    return null\n  }\n\n  try {\n    const content = readFileSync(filePath, 'utf-8')\n    const transcript = JSON.parse(content) as AgentTranscript\n\n    // Cache for future access\n    activeTranscripts.set(agentId, transcript)\n\n    return transcript\n  } catch (error) {\n    debugLogger.error('AGENT_TRANSCRIPT_READ_FAILED', {\n      agentId,\n      error: error instanceof Error ? error.message : String(error),\n    })\n    return null\n  }\n}\n\n/**\n * Update an existing agent transcript\n * @param agentId The agent ID to update\n * @param updates The fields to update\n * @param emitEvent Whether to emit an update event (default: true)\n */\nexport function updateAgentTranscript(\n  agentId: string,\n  updates: Partial<Omit<AgentTranscript, 'agentId' | 'startTime'>>,\n  emitEvent: boolean = true,\n): AgentTranscript | null {\n  const transcript = getAgentTranscript(agentId)\n  if (!transcript) {\n    debugLogger.warn('AGENT_TRANSCRIPT_UPDATE_NOT_FOUND', { agentId })\n    return null\n  }\n\n  const updated: AgentTranscript = {\n    ...transcript,\n    ...updates,\n    // Merge token usage if provided\n    tokenUsage: updates.tokenUsage\n      ? { ...transcript.tokenUsage, ...updates.tokenUsage }\n      : transcript.tokenUsage,\n  }\n\n  saveAgentTranscript(updated, emitEvent)\n  return updated\n}\n\n/**\n * Append a message to an agent transcript\n */\nexport function appendMessageToTranscript(\n  agentId: string,\n  message: MessageType,\n): AgentTranscript | null {\n  const transcript = getAgentTranscript(agentId)\n  if (!transcript) {\n    debugLogger.warn('AGENT_TRANSCRIPT_APPEND_NOT_FOUND', { agentId })\n    return null\n  }\n\n  // \u2705 CRITICAL FIX: Create new array reference to trigger React re-renders\n  // Instead of mutating transcript.messages.push(message), we create a new array\n  const updatedMessages = [...transcript.messages, message]\n\n  // Count tool uses\n  let newToolUseCount = transcript.toolUseCount\n  if (message.type === 'assistant') {\n    const content = message.message.content\n    if (Array.isArray(content)) {\n      const toolUses = content.filter(block => block.type === 'tool_use')\n      newToolUseCount += toolUses.length\n    }\n  }\n\n  // Create updated transcript with new references\n  const updated: AgentTranscript = {\n    ...transcript,\n    messages: updatedMessages,\n    toolUseCount: newToolUseCount,\n  }\n\n  // Update memory cache with new reference\n  activeTranscripts.set(agentId, updated)\n\n  saveAgentTranscript(updated, false) // Don't emit generic update\n\n  // Emit specific message_appended event\n  transcriptEmitter.emitUpdate({\n    type: 'message_appended',\n    agentId,\n    toolUseId: transcript.toolUseId,\n    transcript: updated,\n  })\n\n  return updated\n}\n\n/**\n * Mark an agent transcript as completed\n */\nexport function completeAgentTranscript(\n  agentId: string,\n  tokenUsage?: Partial<TokenUsage>,\n): AgentTranscript | null {\n  const transcript = getAgentTranscript(agentId)\n  if (!transcript) {\n    return null\n  }\n\n  const previousStatus = transcript.status\n\n  // Merge partial token usage with existing\n  const mergedTokenUsage: TokenUsage = tokenUsage\n    ? { ...transcript.tokenUsage, ...tokenUsage }\n    : transcript.tokenUsage\n\n  const updated = updateAgentTranscript(\n    agentId,\n    {\n      status: 'completed',\n      endTime: Date.now(),\n      tokenUsage: mergedTokenUsage,\n    },\n    false,\n  ) // Don't emit generic update\n\n  if (updated) {\n    // Emit specific completed event\n    transcriptEmitter.emitUpdate({\n      type: 'completed',\n      agentId,\n      toolUseId: updated.toolUseId,\n      transcript: updated,\n      previousStatus,\n    })\n\n    // Also emit status_changed for subscribers\n    transcriptEmitter.emitUpdate({\n      type: 'status_changed',\n      agentId,\n      toolUseId: updated.toolUseId,\n      transcript: updated,\n      previousStatus,\n    })\n  }\n\n  return updated\n}\n\n/**\n * Mark an agent transcript as failed\n */\nexport function failAgentTranscript(\n  agentId: string,\n  error?: string,\n): AgentTranscript | null {\n  const transcript = getAgentTranscript(agentId)\n  if (!transcript) {\n    return null\n  }\n\n  const previousStatus = transcript.status\n\n  const updated = updateAgentTranscript(\n    agentId,\n    {\n      status: 'failed',\n      endTime: Date.now(),\n      metadata: error ? { error } : undefined,\n    },\n    false,\n  ) // Don't emit generic update\n\n  if (updated) {\n    // Emit specific failed event\n    transcriptEmitter.emitUpdate({\n      type: 'failed',\n      agentId,\n      toolUseId: updated.toolUseId,\n      transcript: updated,\n      previousStatus,\n    })\n\n    // Also emit status_changed for subscribers\n    transcriptEmitter.emitUpdate({\n      type: 'status_changed',\n      agentId,\n      toolUseId: updated.toolUseId,\n      transcript: updated,\n      previousStatus,\n    })\n  }\n\n  return updated\n}\n\n/**\n * Mark an agent transcript as interrupted\n */\nexport function interruptAgentTranscript(\n  agentId: string,\n): AgentTranscript | null {\n  const transcript = getAgentTranscript(agentId)\n  if (!transcript) {\n    return null\n  }\n\n  const previousStatus = transcript.status\n\n  const updated = updateAgentTranscript(\n    agentId,\n    {\n      status: 'interrupted',\n      endTime: Date.now(),\n    },\n    false,\n  ) // Don't emit generic update\n\n  if (updated) {\n    // Emit specific interrupted event\n    transcriptEmitter.emitUpdate({\n      type: 'interrupted',\n      agentId,\n      toolUseId: updated.toolUseId,\n      transcript: updated,\n      previousStatus,\n    })\n\n    // Also emit status_changed for subscribers\n    transcriptEmitter.emitUpdate({\n      type: 'status_changed',\n      agentId,\n      toolUseId: updated.toolUseId,\n      transcript: updated,\n      previousStatus,\n    })\n  }\n\n  return updated\n}\n\n/**\n * Add a retry event to an agent transcript\n */\nexport function addRetryEventToTranscript(\n  agentId: string,\n  event: {\n    attempt: number\n    maxRetries: number\n    errorMessage: string\n    delayMs: number\n  },\n): AgentTranscript | null {\n  const transcript = getAgentTranscript(agentId)\n  if (!transcript) {\n    return null\n  }\n\n  const retryEvents = transcript.retryEvents || []\n  retryEvents.push({\n    ...event,\n    timestamp: Date.now(),\n  })\n\n  return updateAgentTranscript(agentId, {\n    retryEvents,\n  })\n}\n\n/**\n * List agent transcripts with optional filtering\n */\nexport function listAgentTranscripts(\n  options: ListTranscriptsOptions = {},\n): AgentTranscriptSummary[] {\n  ensureTranscriptsDirectory()\n\n  const dir = getTranscriptsDirectory()\n  const files = readdirSync(dir).filter(f => f.endsWith('.json'))\n\n  const summaries: AgentTranscriptSummary[] = []\n\n  for (const file of files) {\n    try {\n      const content = readFileSync(join(dir, file), 'utf-8')\n      const transcript = JSON.parse(content) as AgentTranscript\n\n      // Apply filters\n      if (options.status) {\n        const statuses = Array.isArray(options.status)\n          ? options.status\n          : [options.status]\n        if (!statuses.includes(transcript.status)) {\n          continue\n        }\n      }\n\n      if (options.agentType && transcript.agentType !== options.agentType) {\n        continue\n      }\n\n      if (options.since && transcript.startTime < options.since) {\n        continue\n      }\n\n      summaries.push({\n        agentId: transcript.agentId,\n        agentType: transcript.agentType,\n        description: transcript.description,\n        status: transcript.status,\n        startTime: transcript.startTime,\n        endTime: transcript.endTime,\n        messageCount: transcript.messages.length,\n        toolUseCount: transcript.toolUseCount,\n        model: transcript.model,\n      })\n    } catch {\n      // Skip invalid files\n      continue\n    }\n  }\n\n  // Sort by start time\n  summaries.sort((a, b) => {\n    const order = options.sortOrder === 'asc' ? 1 : -1\n    return order * (b.startTime - a.startTime)\n  })\n\n  // Apply limit\n  if (options.limit && options.limit > 0) {\n    return summaries.slice(0, options.limit)\n  }\n\n  return summaries\n}\n\n/**\n * Delete an agent transcript\n */\nexport function deleteAgentTranscript(agentId: string): boolean {\n  const filePath = getTranscriptPath(agentId)\n\n  // Remove from cache\n  activeTranscripts.delete(agentId)\n\n  if (!existsSync(filePath)) {\n    return false\n  }\n\n  try {\n    unlinkSync(filePath)\n    debugLogger.info('AGENT_TRANSCRIPT_DELETED', { agentId })\n    return true\n  } catch (error) {\n    debugLogger.error('AGENT_TRANSCRIPT_DELETE_FAILED', {\n      agentId,\n      error: error instanceof Error ? error.message : String(error),\n    })\n    return false\n  }\n}\n\n/**\n * Clean up old transcripts\n * @param maxAge Maximum age in milliseconds (default: 7 days)\n */\nexport function cleanupOldTranscripts(\n  maxAge: number = 7 * 24 * 60 * 60 * 1000,\n): number {\n  const cutoff = Date.now() - maxAge\n  const transcripts = listAgentTranscripts()\n  let deleted = 0\n\n  for (const summary of transcripts) {\n    // Only delete completed or failed transcripts that are old\n    if (\n      (summary.status === 'completed' || summary.status === 'failed') &&\n      summary.startTime < cutoff\n    ) {\n      if (deleteAgentTranscript(summary.agentId)) {\n        deleted++\n      }\n    }\n  }\n\n  debugLogger.info('AGENT_TRANSCRIPTS_CLEANUP', { deleted, maxAge })\n  return deleted\n}\n\n/**\n * Get a transcript that can be resumed (running or interrupted)\n */\nexport function getResumableTranscript(\n  agentId: string,\n): AgentTranscript | null {\n  const transcript = getAgentTranscript(agentId)\n  if (!transcript) {\n    return null\n  }\n\n  // Only running or interrupted transcripts can be resumed\n  if (transcript.status !== 'running' && transcript.status !== 'interrupted') {\n    debugLogger.warn('AGENT_TRANSCRIPT_NOT_RESUMABLE', {\n      agentId,\n      status: transcript.status,\n    })\n    return null\n  }\n\n  return transcript\n}\n\n/**\n * Check if a transcript exists and is resumable\n */\nexport function canResumeTranscript(agentId: string): boolean {\n  return getResumableTranscript(agentId) !== null\n}\n\n/**\n * Get all running agent transcripts\n */\nexport function getRunningTranscripts(): AgentTranscriptSummary[] {\n  return listAgentTranscripts({ status: 'running' })\n}\n\n/**\n * Clear the in-memory transcript cache\n */\nexport function clearTranscriptCache(): void {\n  activeTranscripts.clear()\n}\n\n// In-memory map from toolUseId to agentId for fast lookup\nconst toolUseToAgentMap = new Map<string, string>()\n\n// Reverse map from agentId to toolUseId for TaskOutput association\nconst agentToToolUseMap = new Map<string, string>()\n\n/**\n * Register a toolUseId -> agentId mapping (bidirectional)\n */\nexport function registerToolUseAgent(toolUseId: string, agentId: string): void {\n  toolUseToAgentMap.set(toolUseId, agentId)\n  agentToToolUseMap.set(agentId, toolUseId)\n}\n\n/**\n * Get agent ID from a tool use ID\n */\nexport function getAgentIdByToolUseId(toolUseId: string): string | null {\n  return toolUseToAgentMap.get(toolUseId) || null\n}\n\n/**\n * Get tool use ID from an agent ID (reverse lookup for TaskOutput association)\n * Enhanced: Falls back to disk lookup when memory mapping is empty (for history restore)\n */\nexport function getToolUseIdByAgentId(agentId: string): string | null {\n  // 1. Try memory mapping first (fast path)\n  const cached = agentToToolUseMap.get(agentId)\n  if (cached) {\n    return cached\n  }\n\n  // 2. Try lazy bulk restore (first miss triggers full scan)\n  if (!diskMappingsRestored) {\n    restoreToolUseAgentMappings()\n\n    // Check again after restore\n    const afterRestore = agentToToolUseMap.get(agentId)\n    if (afterRestore) {\n      return afterRestore\n    }\n  }\n\n  // 3. Last resort: load specific transcript by agentId and extract toolUseId\n  const transcript = getAgentTranscript(agentId)\n  if (transcript?.toolUseId) {\n    // Cache for future lookups\n    registerToolUseAgent(transcript.toolUseId, agentId)\n    return transcript.toolUseId\n  }\n\n  return null\n}\n\n// Flag to track if we've already scanned disk for history restore\nlet diskMappingsRestored = false\n\n/**\n * Scan transcript files to find one matching the toolUseId\n * Used for history restore when memory mappings are empty\n */\nfunction findTranscriptByToolUseIdOnDisk(\n  toolUseId: string,\n): AgentTranscript | null {\n  const dir = getTranscriptsDirectory()\n  if (!existsSync(dir)) return null\n\n  try {\n    const files = readdirSync(dir).filter(f => f.endsWith('.json'))\n\n    for (const file of files) {\n      try {\n        const content = readFileSync(join(dir, file), 'utf-8')\n        const transcript = JSON.parse(content) as AgentTranscript\n\n        if (transcript.toolUseId === toolUseId) {\n          // Cache to memory for subsequent access\n          activeTranscripts.set(transcript.agentId, transcript)\n          registerToolUseAgent(toolUseId, transcript.agentId)\n\n          debugLogger.trace('TRANSCRIPT_FOUND_ON_DISK', {\n            toolUseId,\n            agentId: transcript.agentId,\n          })\n\n          return transcript\n        }\n      } catch {\n        // Skip invalid files\n        continue\n      }\n    }\n  } catch (error) {\n    debugLogger.error('TRANSCRIPT_DISK_SCAN_FAILED', {\n      error: error instanceof Error ? error.message : String(error),\n    })\n  }\n\n  return null\n}\n\n/**\n * Restore all toolUseId -> agentId mappings from disk\n * Called lazily on first lookup miss to support history restore\n */\nexport function restoreToolUseAgentMappings(): void {\n  if (diskMappingsRestored) return\n\n  const dir = getTranscriptsDirectory()\n  if (!existsSync(dir)) {\n    diskMappingsRestored = true\n    return\n  }\n\n  try {\n    const files = readdirSync(dir).filter(f => f.endsWith('.json'))\n    let restoredCount = 0\n\n    for (const file of files) {\n      try {\n        const content = readFileSync(join(dir, file), 'utf-8')\n        const transcript = JSON.parse(content) as AgentTranscript\n\n        if (transcript.toolUseId && transcript.agentId) {\n          registerToolUseAgent(transcript.toolUseId, transcript.agentId)\n          activeTranscripts.set(transcript.agentId, transcript)\n          restoredCount++\n        }\n      } catch {\n        // Skip invalid files\n        continue\n      }\n    }\n\n    debugLogger.info('TRANSCRIPT_MAPPINGS_RESTORED', {\n      count: restoredCount,\n      totalFiles: files.length,\n    })\n  } catch (error) {\n    debugLogger.error('TRANSCRIPT_RESTORE_FAILED', {\n      error: error instanceof Error ? error.message : String(error),\n    })\n  }\n\n  diskMappingsRestored = true\n}\n\n/**\n * Get agent transcript by tool use ID\n * Enhanced: Falls back to disk scan when memory mapping is empty (for history restore)\n */\nexport function getAgentTranscriptByToolUseId(\n  toolUseId: string,\n): AgentTranscript | null {\n  // 1. Try memory mapping first (fast path for live sessions)\n  const agentId = getAgentIdByToolUseId(toolUseId)\n  if (agentId) {\n    return getAgentTranscript(agentId)\n  }\n\n  // 2. Try lazy bulk restore (first miss triggers full scan)\n  if (!diskMappingsRestored) {\n    restoreToolUseAgentMappings()\n\n    // Check again after restore\n    const agentIdAfterRestore = getAgentIdByToolUseId(toolUseId)\n    if (agentIdAfterRestore) {\n      return getAgentTranscript(agentIdAfterRestore)\n    }\n  }\n\n  // 3. Last resort: direct disk lookup (handles late-written transcripts)\n  return findTranscriptByToolUseIdOnDisk(toolUseId)\n}\n\n/**\n * Clear the toolUseId -> agentId mapping cache\n */\nexport function clearToolUseAgentMap(): void {\n  toolUseToAgentMap.clear()\n  agentToToolUseMap.clear()\n}\n"],
+  "mappings": "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",
+  "names": ["state"]
+}

package/dist/utils/animationManager.js

@@ -0,0 +1,213 @@
+class AnimationManager {
+  static instance;
+  subscriptions = /* @__PURE__ */ new Map();
+  rafId = null;
+  lastFrameTime = 0;
+  isRunning = false;
+  // Use 30fps as base rate to reduce terminal render load
+  // Terminal rendering is expensive, unlike browser canvas rendering
+  FRAME_INTERVAL = 33;
+  // ~30fps (was 16ms/60fps)
+  constructor() {
+  }
+  static getInstance() {
+    if (!AnimationManager.instance) {
+      AnimationManager.instance = new AnimationManager();
+    }
+    return AnimationManager.instance;
+  }
+  /**
+   * Subscribe to animation updates
+   * @param id Unique identifier for this subscription
+   * @param callback Function to call on each animation frame
+   * @param interval Minimum interval between callback invocations (ms)
+   * @returns Unsubscribe function
+   */
+  subscribe(id, callback, interval) {
+    this.subscriptions.set(id, {
+      id,
+      callback,
+      interval,
+      lastUpdate: 0
+    });
+    if (!this.isRunning) {
+      this.start();
+    }
+    return () => this.unsubscribe(id);
+  }
+  /**
+   * Unsubscribe from animation updates
+   */
+  unsubscribe(id) {
+    this.subscriptions.delete(id);
+    if (this.subscriptions.size === 0) {
+      this.stop();
+    }
+  }
+  /**
+   * Start the animation loop
+   */
+  start() {
+    if (this.isRunning) return;
+    this.isRunning = true;
+    this.lastFrameTime = Date.now();
+    this.tick();
+  }
+  /**
+   * Stop the animation loop
+   */
+  stop() {
+    if (!this.isRunning) return;
+    this.isRunning = false;
+    if (this.rafId !== null) {
+      clearTimeout(this.rafId);
+      this.rafId = null;
+    }
+  }
+  /**
+   * Main animation tick
+   */
+  tick = () => {
+    if (!this.isRunning) return;
+    const now = Date.now();
+    const deltaTime = now - this.lastFrameTime;
+    this.lastFrameTime = now;
+    const callbacksToRun = [];
+    for (const sub of this.subscriptions.values()) {
+      const timeSinceLastUpdate = now - sub.lastUpdate;
+      if (timeSinceLastUpdate >= sub.interval) {
+        sub.lastUpdate = now;
+        callbacksToRun.push(sub.callback);
+      }
+    }
+    if (callbacksToRun.length > 0) {
+      for (const callback of callbacksToRun) {
+        try {
+          callback(deltaTime);
+        } catch (error) {
+        }
+      }
+    }
+    this.rafId = setTimeout(this.tick, this.FRAME_INTERVAL);
+  };
+  /**
+   * Get the number of active subscriptions
+   */
+  getSubscriptionCount() {
+    return this.subscriptions.size;
+  }
+  /**
+   * Check if animation loop is running
+   */
+  isAnimating() {
+    return this.isRunning;
+  }
+}
+const animationManager = AnimationManager.getInstance();
+import { useState, useEffect, useRef } from "react";
+function useUnifiedAnimation({
+  enabled,
+  startTime,
+  spinnerFrameCount,
+  componentId
+}) {
+  const [animState, setAnimState] = useState(() => ({
+    spinnerFrame: 0,
+    dotVisible: true,
+    elapsedTime: Math.floor((Date.now() - startTime) / 1e3)
+  }));
+  const startTimeRef = useRef(startTime);
+  startTimeRef.current = startTime;
+  const timingRef = useRef({
+    lastSpinnerUpdate: 0,
+    lastDotUpdate: 0,
+    lastElapsedUpdate: 0
+  });
+  const SPINNER_INTERVAL = 200;
+  const DOT_INTERVAL = 800;
+  const ELAPSED_INTERVAL = 1e3;
+  useEffect(() => {
+    if (!enabled) {
+      return;
+    }
+    const uniqueId = `${componentId}-unified-animation`;
+    const unsubscribe = animationManager.subscribe(
+      uniqueId,
+      () => {
+        const now = Date.now();
+        const timing = timingRef.current;
+        setAnimState((prevState) => {
+          let needsUpdate = false;
+          let newSpinnerFrame = prevState.spinnerFrame;
+          let newDotVisible = prevState.dotVisible;
+          let newElapsedTime = prevState.elapsedTime;
+          if (now - timing.lastSpinnerUpdate >= SPINNER_INTERVAL) {
+            timing.lastSpinnerUpdate = now;
+            newSpinnerFrame = (newSpinnerFrame + 1) % spinnerFrameCount;
+            needsUpdate = true;
+          }
+          if (now - timing.lastDotUpdate >= DOT_INTERVAL) {
+            timing.lastDotUpdate = now;
+            newDotVisible = !newDotVisible;
+            needsUpdate = true;
+          }
+          if (now - timing.lastElapsedUpdate >= ELAPSED_INTERVAL) {
+            timing.lastElapsedUpdate = now;
+            newElapsedTime = Math.floor((now - startTimeRef.current) / 1e3);
+            needsUpdate = true;
+          }
+          if (!needsUpdate) {
+            return prevState;
+          }
+          return {
+            spinnerFrame: newSpinnerFrame,
+            dotVisible: newDotVisible,
+            elapsedTime: newElapsedTime
+          };
+        });
+      },
+      // Use fastest needed interval for checking
+      Math.min(SPINNER_INTERVAL, DOT_INTERVAL, ELAPSED_INTERVAL)
+    );
+    return unsubscribe;
+  }, [enabled, spinnerFrameCount, componentId]);
+  return animState;
+}
+function throttle(func, limit) {
+  let inThrottle = false;
+  let lastArgs = null;
+  return function(...args) {
+    if (!inThrottle) {
+      func.apply(this, args);
+      inThrottle = true;
+      setTimeout(() => {
+        inThrottle = false;
+        if (lastArgs) {
+          func.apply(this, lastArgs);
+          lastArgs = null;
+        }
+      }, limit);
+    } else {
+      lastArgs = args;
+    }
+  };
+}
+function debounce(func, wait) {
+  let timeoutId = null;
+  return function(...args) {
+    if (timeoutId !== null) {
+      clearTimeout(timeoutId);
+    }
+    timeoutId = setTimeout(() => {
+      func.apply(this, args);
+      timeoutId = null;
+    }, wait);
+  };
+}
+export {
+  animationManager,
+  debounce,
+  throttle,
+  useUnifiedAnimation
+};
+//# sourceMappingURL=animationManager.js.map

package/dist/utils/animationManager.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/utils/animationManager.ts"],
+  "sourcesContent": ["/**\n * Unified Animation Manager\n *\n * Consolidates multiple animation timers into a single requestAnimationFrame loop\n * to prevent render thrashing and screen flickering.\n *\n * Benefits:\n * - Single animation frame callback instead of multiple setInterval timers\n * - Batched state updates reduce React re-renders\n * - Configurable frame rates for different animation types\n * - Automatic cleanup on unmount\n */\n\ntype AnimationCallback = (deltaTime: number) => void\n\ninterface AnimationSubscription {\n  id: string\n  callback: AnimationCallback\n  interval: number // Minimum interval between updates in ms\n  lastUpdate: number\n}\n\nclass AnimationManager {\n  private static instance: AnimationManager\n  private subscriptions: Map<string, AnimationSubscription> = new Map()\n  private rafId: ReturnType<typeof setTimeout> | null = null\n  private lastFrameTime: number = 0\n  private isRunning: boolean = false\n\n  // Use 30fps as base rate to reduce terminal render load\n  // Terminal rendering is expensive, unlike browser canvas rendering\n  private readonly FRAME_INTERVAL = 33 // ~30fps (was 16ms/60fps)\n\n  private constructor() {}\n\n  static getInstance(): AnimationManager {\n    if (!AnimationManager.instance) {\n      AnimationManager.instance = new AnimationManager()\n    }\n    return AnimationManager.instance\n  }\n\n  /**\n   * Subscribe to animation updates\n   * @param id Unique identifier for this subscription\n   * @param callback Function to call on each animation frame\n   * @param interval Minimum interval between callback invocations (ms)\n   * @returns Unsubscribe function\n   */\n  subscribe(\n    id: string,\n    callback: AnimationCallback,\n    interval: number,\n  ): () => void {\n    this.subscriptions.set(id, {\n      id,\n      callback,\n      interval,\n      lastUpdate: 0,\n    })\n\n    if (!this.isRunning) {\n      this.start()\n    }\n\n    return () => this.unsubscribe(id)\n  }\n\n  /**\n   * Unsubscribe from animation updates\n   */\n  unsubscribe(id: string): void {\n    this.subscriptions.delete(id)\n\n    if (this.subscriptions.size === 0) {\n      this.stop()\n    }\n  }\n\n  /**\n   * Start the animation loop\n   */\n  private start(): void {\n    if (this.isRunning) return\n\n    this.isRunning = true\n    this.lastFrameTime = Date.now()\n    this.tick()\n  }\n\n  /**\n   * Stop the animation loop\n   */\n  private stop(): void {\n    if (!this.isRunning) return\n\n    this.isRunning = false\n    if (this.rafId !== null) {\n      clearTimeout(this.rafId)\n      this.rafId = null\n    }\n  }\n\n  /**\n   * Main animation tick\n   */\n  private tick = (): void => {\n    if (!this.isRunning) return\n\n    const now = Date.now()\n    const deltaTime = now - this.lastFrameTime\n    this.lastFrameTime = now\n\n    // Batch all callbacks that need to run this frame\n    const callbacksToRun: AnimationCallback[] = []\n\n    for (const sub of this.subscriptions.values()) {\n      const timeSinceLastUpdate = now - sub.lastUpdate\n\n      if (timeSinceLastUpdate >= sub.interval) {\n        sub.lastUpdate = now\n        callbacksToRun.push(sub.callback)\n      }\n    }\n\n    // Execute all callbacks in a single batch\n    // This allows React to batch the state updates\n    if (callbacksToRun.length > 0) {\n      for (const callback of callbacksToRun) {\n        try {\n          callback(deltaTime)\n        } catch (error) {\n          // Silently ignore callback errors to prevent animation loop from breaking\n        }\n      }\n    }\n\n    // Schedule next frame using setTimeout (works in Node.js/Bun)\n    this.rafId = setTimeout(this.tick, this.FRAME_INTERVAL)\n  }\n\n  /**\n   * Get the number of active subscriptions\n   */\n  getSubscriptionCount(): number {\n    return this.subscriptions.size\n  }\n\n  /**\n   * Check if animation loop is running\n   */\n  isAnimating(): boolean {\n    return this.isRunning\n  }\n}\n\n// Export singleton instance\nexport const animationManager = AnimationManager.getInstance()\n\n/**\n * React hook for unified animation updates\n *\n * Usage:\n * ```typescript\n * const { spinnerFrame, dotVisible, elapsedTime } = useUnifiedAnimation({\n *   enabled: hasRunningTasks,\n *   startTime: Date.now(),\n *   spinnerFrameCount: 12,\n * })\n * ```\n */\nexport interface UnifiedAnimationState {\n  spinnerFrame: number\n  dotVisible: boolean\n  elapsedTime: number\n}\n\nexport interface UseUnifiedAnimationOptions {\n  enabled: boolean\n  startTime: number\n  spinnerFrameCount: number\n  componentId: string\n}\n\nimport { useState, useEffect, useRef, useCallback } from 'react'\n\nexport function useUnifiedAnimation({\n  enabled,\n  startTime,\n  spinnerFrameCount,\n  componentId,\n}: UseUnifiedAnimationOptions): UnifiedAnimationState {\n  // Use a single state object to batch updates\n  const [animState, setAnimState] = useState<UnifiedAnimationState>(() => ({\n    spinnerFrame: 0,\n    dotVisible: true,\n    elapsedTime: Math.floor((Date.now() - startTime) / 1000),\n  }))\n\n  // Store startTime in ref to avoid closure issues\n  const startTimeRef = useRef(startTime)\n  startTimeRef.current = startTime\n\n  // Track timing internally to reduce state updates\n  const timingRef = useRef({\n    lastSpinnerUpdate: 0,\n    lastDotUpdate: 0,\n    lastElapsedUpdate: 0,\n  })\n\n  // Animation intervals - optimized for less flicker\n  // Slower spinner reduces terminal re-render frequency\n  const SPINNER_INTERVAL = 200 // 200ms (was 120ms) - reduces flicker by ~40%\n  const DOT_INTERVAL = 800 // 800ms (was 600ms) - less visual noise\n  const ELAPSED_INTERVAL = 1000 // 1s - unchanged\n\n  useEffect(() => {\n    if (!enabled) {\n      return\n    }\n\n    const uniqueId = `${componentId}-unified-animation`\n\n    const unsubscribe = animationManager.subscribe(\n      uniqueId,\n      () => {\n        const now = Date.now()\n        const timing = timingRef.current\n\n        // Use functional state update to avoid closure issues\n        setAnimState(prevState => {\n          let needsUpdate = false\n          let newSpinnerFrame = prevState.spinnerFrame\n          let newDotVisible = prevState.dotVisible\n          let newElapsedTime = prevState.elapsedTime\n\n          // Check spinner update\n          if (now - timing.lastSpinnerUpdate >= SPINNER_INTERVAL) {\n            timing.lastSpinnerUpdate = now\n            newSpinnerFrame = (newSpinnerFrame + 1) % spinnerFrameCount\n            needsUpdate = true\n          }\n\n          // Check dot update\n          if (now - timing.lastDotUpdate >= DOT_INTERVAL) {\n            timing.lastDotUpdate = now\n            newDotVisible = !newDotVisible\n            needsUpdate = true\n          }\n\n          // Check elapsed time update\n          if (now - timing.lastElapsedUpdate >= ELAPSED_INTERVAL) {\n            timing.lastElapsedUpdate = now\n            newElapsedTime = Math.floor((now - startTimeRef.current) / 1000)\n            needsUpdate = true\n          }\n\n          // Return same object if no update needed (prevents unnecessary re-render)\n          if (!needsUpdate) {\n            return prevState\n          }\n\n          return {\n            spinnerFrame: newSpinnerFrame,\n            dotVisible: newDotVisible,\n            elapsedTime: newElapsedTime,\n          }\n        })\n      },\n      // Use fastest needed interval for checking\n      Math.min(SPINNER_INTERVAL, DOT_INTERVAL, ELAPSED_INTERVAL),\n    )\n\n    return unsubscribe\n  }, [enabled, spinnerFrameCount, componentId])\n\n  return animState\n}\n\n/**\n * Throttle utility for event handlers\n */\nexport function throttle<T extends (...args: any[]) => any>(\n  func: T,\n  limit: number,\n): (...args: Parameters<T>) => void {\n  let inThrottle = false\n  let lastArgs: Parameters<T> | null = null\n\n  return function (this: any, ...args: Parameters<T>) {\n    if (!inThrottle) {\n      func.apply(this, args)\n      inThrottle = true\n      setTimeout(() => {\n        inThrottle = false\n        if (lastArgs) {\n          func.apply(this, lastArgs)\n          lastArgs = null\n        }\n      }, limit)\n    } else {\n      lastArgs = args\n    }\n  }\n}\n\n/**\n * Debounce utility for event handlers\n */\nexport function debounce<T extends (...args: any[]) => any>(\n  func: T,\n  wait: number,\n): (...args: Parameters<T>) => void {\n  let timeoutId: ReturnType<typeof setTimeout> | null = null\n\n  return function (this: any, ...args: Parameters<T>) {\n    if (timeoutId !== null) {\n      clearTimeout(timeoutId)\n    }\n    timeoutId = setTimeout(() => {\n      func.apply(this, args)\n      timeoutId = null\n    }, wait)\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/utils/animationSync.js

@@ -0,0 +1,110 @@
+import { EventEmitter } from "events";
+const ANIMATION_INTERVALS = {
+  SPINNER: 120,
+  // Spinner frame rotation
+  BLINK: 600,
+  // Blinking dot visibility toggle
+  ELAPSED_TIME: 1e3
+  // Elapsed time counter
+};
+class AnimationSyncManager extends EventEmitter {
+  static instance = null;
+  timers = /* @__PURE__ */ new Map();
+  frame = {
+    spinnerFrame: 0,
+    blinkVisible: true,
+    elapsedSeconds: 0
+  };
+  subscriberCount = 0;
+  startTime = 0;
+  constructor() {
+    super();
+    this.setMaxListeners(100);
+  }
+  static getInstance() {
+    if (!AnimationSyncManager.instance) {
+      AnimationSyncManager.instance = new AnimationSyncManager();
+    }
+    return AnimationSyncManager.instance;
+  }
+  /**
+   * Subscribe to animation frame updates
+   * @param callback Called on every animation frame update
+   * @returns Unsubscribe function
+   */
+  subscribe(callback) {
+    this.subscriberCount++;
+    if (this.subscriberCount === 1) {
+      this.startTimers();
+    }
+    callback({ ...this.frame });
+    this.on("frame", callback);
+    return () => {
+      this.off("frame", callback);
+      this.subscriberCount--;
+      if (this.subscriberCount === 0) {
+        this.stopTimers();
+      }
+    };
+  }
+  /**
+   * Get current animation frame state
+   */
+  getFrame() {
+    return { ...this.frame };
+  }
+  /**
+   * Reset elapsed time counter (e.g., when starting a new operation)
+   */
+  resetElapsedTime() {
+    this.frame.elapsedSeconds = 0;
+    this.startTime = Date.now();
+  }
+  startTimers() {
+    this.startTime = Date.now();
+    const spinnerTimer = setInterval(() => {
+      this.frame.spinnerFrame = (this.frame.spinnerFrame + 1) % 12;
+      this.emit("frame", { ...this.frame });
+    }, ANIMATION_INTERVALS.SPINNER);
+    this.timers.set("SPINNER", spinnerTimer);
+    const blinkTimer = setInterval(() => {
+      this.frame.blinkVisible = !this.frame.blinkVisible;
+    }, ANIMATION_INTERVALS.BLINK);
+    this.timers.set("BLINK", blinkTimer);
+    const elapsedTimer = setInterval(() => {
+      this.frame.elapsedSeconds = Math.floor(
+        (Date.now() - this.startTime) / 1e3
+      );
+    }, ANIMATION_INTERVALS.ELAPSED_TIME);
+    this.timers.set("ELAPSED_TIME", elapsedTimer);
+  }
+  stopTimers() {
+    for (const timer of this.timers.values()) {
+      clearInterval(timer);
+    }
+    this.timers.clear();
+    this.frame = {
+      spinnerFrame: 0,
+      blinkVisible: true,
+      elapsedSeconds: 0
+    };
+  }
+  /**
+   * Cleanup - should be called on application shutdown
+   */
+  destroy() {
+    this.stopTimers();
+    this.removeAllListeners();
+    AnimationSyncManager.instance = null;
+  }
+}
+const animationSync = AnimationSyncManager.getInstance();
+function useAnimationSync() {
+  return animationSync.getFrame();
+}
+export {
+  ANIMATION_INTERVALS,
+  animationSync,
+  useAnimationSync
+};
+//# sourceMappingURL=animationSync.js.map

package/dist/utils/animationSync.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/utils/animationSync.ts"],
+  "sourcesContent": ["/**\n * Animation Synchronization Manager\n *\n * Provides synchronized animation timing across all UI components.\n * This ensures consistent visual experience by keeping all animations in sync.\n *\n * Animation intervals (Claude Code spec compliant):\n * - Spinner: 120ms\n * - Blinking Dot: 600ms\n * - Elapsed Time: 1000ms\n */\n\nimport { EventEmitter } from 'events'\n\n// Animation intervals per Claude Code specification\nexport const ANIMATION_INTERVALS = {\n  SPINNER: 120, // Spinner frame rotation\n  BLINK: 600, // Blinking dot visibility toggle\n  ELAPSED_TIME: 1000, // Elapsed time counter\n} as const\n\ntype AnimationType = keyof typeof ANIMATION_INTERVALS\n\ninterface AnimationFrame {\n  spinnerFrame: number\n  blinkVisible: boolean\n  elapsedSeconds: number\n}\n\nclass AnimationSyncManager extends EventEmitter {\n  private static instance: AnimationSyncManager | null = null\n  private timers: Map<AnimationType, NodeJS.Timeout> = new Map()\n  private frame: AnimationFrame = {\n    spinnerFrame: 0,\n    blinkVisible: true,\n    elapsedSeconds: 0,\n  }\n  private subscriberCount: number = 0\n  private startTime: number = 0\n\n  private constructor() {\n    super()\n    this.setMaxListeners(100) // Allow many components to subscribe\n  }\n\n  static getInstance(): AnimationSyncManager {\n    if (!AnimationSyncManager.instance) {\n      AnimationSyncManager.instance = new AnimationSyncManager()\n    }\n    return AnimationSyncManager.instance\n  }\n\n  /**\n   * Subscribe to animation frame updates\n   * @param callback Called on every animation frame update\n   * @returns Unsubscribe function\n   */\n  subscribe(callback: (frame: AnimationFrame) => void): () => void {\n    this.subscriberCount++\n\n    // Start timers if this is the first subscriber\n    if (this.subscriberCount === 1) {\n      this.startTimers()\n    }\n\n    // Immediately call with current frame\n    callback({ ...this.frame })\n\n    // Subscribe to updates\n    this.on('frame', callback)\n\n    return () => {\n      this.off('frame', callback)\n      this.subscriberCount--\n\n      // Stop timers if no more subscribers\n      if (this.subscriberCount === 0) {\n        this.stopTimers()\n      }\n    }\n  }\n\n  /**\n   * Get current animation frame state\n   */\n  getFrame(): AnimationFrame {\n    return { ...this.frame }\n  }\n\n  /**\n   * Reset elapsed time counter (e.g., when starting a new operation)\n   */\n  resetElapsedTime(): void {\n    this.frame.elapsedSeconds = 0\n    this.startTime = Date.now()\n  }\n\n  private startTimers(): void {\n    this.startTime = Date.now()\n\n    // Spinner timer (120ms)\n    const spinnerTimer = setInterval(() => {\n      this.frame.spinnerFrame = (this.frame.spinnerFrame + 1) % 12 // 12 frames for smooth animation\n      this.emit('frame', { ...this.frame })\n    }, ANIMATION_INTERVALS.SPINNER)\n    this.timers.set('SPINNER', spinnerTimer)\n\n    // Blink timer (600ms)\n    const blinkTimer = setInterval(() => {\n      this.frame.blinkVisible = !this.frame.blinkVisible\n      // Note: We don't emit here to avoid double emissions\n      // The blink state is included in the spinner frame update\n    }, ANIMATION_INTERVALS.BLINK)\n    this.timers.set('BLINK', blinkTimer)\n\n    // Elapsed time timer (1000ms)\n    const elapsedTimer = setInterval(() => {\n      this.frame.elapsedSeconds = Math.floor(\n        (Date.now() - this.startTime) / 1000,\n      )\n      // Note: We don't emit here to avoid double emissions\n    }, ANIMATION_INTERVALS.ELAPSED_TIME)\n    this.timers.set('ELAPSED_TIME', elapsedTimer)\n  }\n\n  private stopTimers(): void {\n    for (const timer of this.timers.values()) {\n      clearInterval(timer)\n    }\n    this.timers.clear()\n\n    // Reset frame state\n    this.frame = {\n      spinnerFrame: 0,\n      blinkVisible: true,\n      elapsedSeconds: 0,\n    }\n  }\n\n  /**\n   * Cleanup - should be called on application shutdown\n   */\n  destroy(): void {\n    this.stopTimers()\n    this.removeAllListeners()\n    AnimationSyncManager.instance = null\n  }\n}\n\n/**\n * Global animation sync manager instance\n */\nexport const animationSync = AnimationSyncManager.getInstance()\n\n/**\n * React hook for synchronized animations\n * Usage:\n * ```tsx\n * function MyComponent() {\n *   const frame = useAnimationSync()\n *   return <Text>{spinnerChars[frame.spinnerFrame % spinnerChars.length]}</Text>\n * }\n * ```\n */\nexport function useAnimationSync(): AnimationFrame {\n  // This is a placeholder - actual React hook implementation\n  // should be in a separate file to avoid importing React here\n  return animationSync.getFrame()\n}\n"],
+  "mappings": "AAYA,SAAS,oBAAoB;AAGtB,MAAM,sBAAsB;AAAA,EACjC,SAAS;AAAA;AAAA,EACT,OAAO;AAAA;AAAA,EACP,cAAc;AAAA;AAChB;AAUA,MAAM,6BAA6B,aAAa;AAAA,EAC9C,OAAe,WAAwC;AAAA,EAC/C,SAA6C,oBAAI,IAAI;AAAA,EACrD,QAAwB;AAAA,IAC9B,cAAc;AAAA,IACd,cAAc;AAAA,IACd,gBAAgB;AAAA,EAClB;AAAA,EACQ,kBAA0B;AAAA,EAC1B,YAAoB;AAAA,EAEpB,cAAc;AACpB,UAAM;AACN,SAAK,gBAAgB,GAAG;AAAA,EAC1B;AAAA,EAEA,OAAO,cAAoC;AACzC,QAAI,CAAC,qBAAqB,UAAU;AAClC,2BAAqB,WAAW,IAAI,qBAAqB;AAAA,IAC3D;AACA,WAAO,qBAAqB;AAAA,EAC9B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,UAAU,UAAuD;AAC/D,SAAK;AAGL,QAAI,KAAK,oBAAoB,GAAG;AAC9B,WAAK,YAAY;AAAA,IACnB;AAGA,aAAS,EAAE,GAAG,KAAK,MAAM,CAAC;AAG1B,SAAK,GAAG,SAAS,QAAQ;AAEzB,WAAO,MAAM;AACX,WAAK,IAAI,SAAS,QAAQ;AAC1B,WAAK;AAGL,UAAI,KAAK,oBAAoB,GAAG;AAC9B,aAAK,WAAW;AAAA,MAClB;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,WAA2B;AACzB,WAAO,EAAE,GAAG,KAAK,MAAM;AAAA,EACzB;AAAA;AAAA;AAAA;AAAA,EAKA,mBAAyB;AACvB,SAAK,MAAM,iBAAiB;AAC5B,SAAK,YAAY,KAAK,IAAI;AAAA,EAC5B;AAAA,EAEQ,cAAoB;AAC1B,SAAK,YAAY,KAAK,IAAI;AAG1B,UAAM,eAAe,YAAY,MAAM;AACrC,WAAK,MAAM,gBAAgB,KAAK,MAAM,eAAe,KAAK;AAC1D,WAAK,KAAK,SAAS,EAAE,GAAG,KAAK,MAAM,CAAC;AAAA,IACtC,GAAG,oBAAoB,OAAO;AAC9B,SAAK,OAAO,IAAI,WAAW,YAAY;AAGvC,UAAM,aAAa,YAAY,MAAM;AACnC,WAAK,MAAM,eAAe,CAAC,KAAK,MAAM;AAAA,IAGxC,GAAG,oBAAoB,KAAK;AAC5B,SAAK,OAAO,IAAI,SAAS,UAAU;AAGnC,UAAM,eAAe,YAAY,MAAM;AACrC,WAAK,MAAM,iBAAiB,KAAK;AAAA,SAC9B,KAAK,IAAI,IAAI,KAAK,aAAa;AAAA,MAClC;AAAA,IAEF,GAAG,oBAAoB,YAAY;AACnC,SAAK,OAAO,IAAI,gBAAgB,YAAY;AAAA,EAC9C;AAAA,EAEQ,aAAmB;AACzB,eAAW,SAAS,KAAK,OAAO,OAAO,GAAG;AACxC,oBAAc,KAAK;AAAA,IACrB;AACA,SAAK,OAAO,MAAM;AAGlB,SAAK,QAAQ;AAAA,MACX,cAAc;AAAA,MACd,cAAc;AAAA,MACd,gBAAgB;AAAA,IAClB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,UAAgB;AACd,SAAK,WAAW;AAChB,SAAK,mBAAmB;AACxB,yBAAqB,WAAW;AAAA,EAClC;AACF;AAKO,MAAM,gBAAgB,qBAAqB,YAAY;AAYvD,SAAS,mBAAmC;AAGjD,SAAO,cAAc,SAAS;AAChC;",
+  "names": []
+}