Something went wrong. Try again.
source dump of claude code
Something went wrong. Try again.
9.9 kB · 308 lines
TypeScript
at main
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309import { OUTPUT_FILE_TAG, STATUS_TAG, SUMMARY_TAG, TASK_ID_TAG, TASK_NOTIFICATION_TAG, TASK_TYPE_TAG, TOOL_USE_ID_TAG,} from '../../constants/xml.js'import type { AppState } from '../../state/AppState.js'import { isTerminalTaskStatus, type TaskStatus, type TaskType,} from '../../Task.js'import type { TaskState } from '../../tasks/types.js'import { enqueuePendingNotification } from '../messageQueueManager.js'import { enqueueSdkEvent } from '../sdkEventQueue.js'import { getTaskOutputDelta, getTaskOutputPath } from './diskOutput.js'
// Standard polling interval for all tasksexport const POLL_INTERVAL_MS = 1000
// Duration to display killed tasks before evictionexport const STOPPED_DISPLAY_MS = 3_000
// Grace period for terminal local_agent tasks in the coordinator panelexport const PANEL_GRACE_MS = 30_000
// Attachment type for task status updatesexport type TaskAttachment = { type: 'task_status' taskId: string toolUseId?: string taskType: TaskType status: TaskStatus description: string deltaSummary: string | null // New output since last attachment}
type SetAppState = (updater: (prev: AppState) => AppState) => void
/** * Update a task's state in AppState. * Helper function for task implementations. * Generic to allow type-safe updates for specific task types. */export function updateTaskState<T extends TaskState>( taskId: string, setAppState: SetAppState, updater: (task: T) => T,): void { setAppState(prev => { const task = prev.tasks?.[taskId] as T | undefined if (!task) { return prev } const updated = updater(task) if (updated === task) { // Updater returned the same reference (early-return no-op). Skip the // spread so s.tasks subscribers don't re-render on unchanged state. return prev } return { ...prev, tasks: { ...prev.tasks, [taskId]: updated, }, } })}
/** * Register a new task in AppState. */export function registerTask(task: TaskState, setAppState: SetAppState): void { let isReplacement = false setAppState(prev => { const existing = prev.tasks[task.id] isReplacement = existing !== undefined // Carry forward UI-held state on re-register (resumeAgentBackground // replaces the task; user's retain shouldn't reset). startTime keeps // the panel sort stable; messages + diskLoaded preserve the viewed // transcript across the replace (the user's just-appended prompt lives // in messages and isn't on disk yet). const merged = existing && 'retain' in existing ? { ...task, retain: existing.retain, startTime: existing.startTime, messages: existing.messages, diskLoaded: existing.diskLoaded, pendingMessages: existing.pendingMessages, } : task return { ...prev, tasks: { ...prev.tasks, [task.id]: merged } } })
// Replacement (resume) — not a new start. Skip to avoid double-emit. if (isReplacement) return
enqueueSdkEvent({ type: 'system', subtype: 'task_started', task_id: task.id, tool_use_id: task.toolUseId, description: task.description, task_type: task.type, workflow_name: 'workflowName' in task ? (task.workflowName as string | undefined) : undefined, prompt: 'prompt' in task ? (task.prompt as string) : undefined, })}
/** * Eagerly evict a terminal task from AppState. * The task must be in a terminal state (completed/failed/killed) with notified=true. * This allows memory to be freed without waiting for the next query loop iteration. * The lazy GC in generateTaskAttachments() remains as a safety net. */export function evictTerminalTask( taskId: string, setAppState: SetAppState,): void { setAppState(prev => { const task = prev.tasks?.[taskId] if (!task) return prev if (!isTerminalTaskStatus(task.status)) return prev if (!task.notified) return prev // Panel grace period — blocks eviction until deadline passes. // 'retain' in task narrows to LocalAgentTaskState (the only type with // that field); evictAfter is optional so 'evictAfter' in task would // miss tasks that haven't had it set yet. if ('retain' in task && (task.evictAfter ?? Infinity) > Date.now()) { return prev } const { [taskId]: _, ...remainingTasks } = prev.tasks return { ...prev, tasks: remainingTasks } })}
/** * Get all running tasks. */export function getRunningTasks(state: AppState): TaskState[] { const tasks = state.tasks ?? {} return Object.values(tasks).filter(task => task.status === 'running')}
/** * Generate attachments for tasks with new output or status changes. * Called by the framework to create push notifications. */export async function generateTaskAttachments(state: AppState): Promise<{ attachments: TaskAttachment[] // Only the offset patch — NOT the full task. The task may transition to // completed during getTaskOutputDelta's async disk read, and spreading the // full stale snapshot would clobber that transition (zombifying the task). updatedTaskOffsets: Record<string, number> evictedTaskIds: string[]}> { const attachments: TaskAttachment[] = [] const updatedTaskOffsets: Record<string, number> = {} const evictedTaskIds: string[] = [] const tasks = state.tasks ?? {}
for (const taskState of Object.values(tasks)) { if (taskState.notified) { switch (taskState.status) { case 'completed': case 'failed': case 'killed': // Evict terminal tasks — they've been consumed and can be GC'd evictedTaskIds.push(taskState.id) continue case 'pending': // Keep in map — hasn't run yet, but parent already knows about it continue case 'running': // Fall through to running logic below break } }
if (taskState.status === 'running') { const delta = await getTaskOutputDelta( taskState.id, taskState.outputOffset, ) if (delta.content) { updatedTaskOffsets[taskState.id] = delta.newOffset } }
// Completed tasks are NOT notified here — each task type handles its own // completion notification via enqueuePendingNotification(). Generating // attachments here would race with those per-type callbacks, causing // dual delivery (one inline attachment + one separate API turn). }
return { attachments, updatedTaskOffsets, evictedTaskIds }}
/** * Apply the outputOffset patches and evictions from generateTaskAttachments. * Merges patches against FRESH prev.tasks (not the stale pre-await snapshot), * so concurrent status transitions aren't clobbered. */export function applyTaskOffsetsAndEvictions( setAppState: SetAppState, updatedTaskOffsets: Record<string, number>, evictedTaskIds: string[],): void { const offsetIds = Object.keys(updatedTaskOffsets) if (offsetIds.length === 0 && evictedTaskIds.length === 0) { return } setAppState(prev => { let changed = false const newTasks = { ...prev.tasks } for (const id of offsetIds) { const fresh = newTasks[id] // Re-check status on fresh state — task may have completed during the // await. If it's no longer running, the offset update is moot. if (fresh?.status === 'running') { newTasks[id] = { ...fresh, outputOffset: updatedTaskOffsets[id]! } changed = true } } for (const id of evictedTaskIds) { const fresh = newTasks[id] // Re-check terminal+notified on fresh state (TOCTOU: resume may have // replaced the task during the generateTaskAttachments await) if (!fresh || !isTerminalTaskStatus(fresh.status) || !fresh.notified) { continue } if ('retain' in fresh && (fresh.evictAfter ?? Infinity) > Date.now()) { continue } delete newTasks[id] changed = true } return changed ? { ...prev, tasks: newTasks } : prev })}
/** * Poll all running tasks and check for updates. * This is the main polling loop called by the framework. */export async function pollTasks( getAppState: () => AppState, setAppState: SetAppState,): Promise<void> { const state = getAppState() const { attachments, updatedTaskOffsets, evictedTaskIds } = await generateTaskAttachments(state)
applyTaskOffsetsAndEvictions(setAppState, updatedTaskOffsets, evictedTaskIds)
// Send notifications for completed tasks for (const attachment of attachments) { enqueueTaskNotification(attachment) }}
/** * Enqueue a task notification to the message queue. */function enqueueTaskNotification(attachment: TaskAttachment): void { const statusText = getStatusText(attachment.status)
const outputPath = getTaskOutputPath(attachment.taskId) const toolUseIdLine = attachment.toolUseId ? `\n<${TOOL_USE_ID_TAG}>${attachment.toolUseId}</${TOOL_USE_ID_TAG}>` : '' const message = `<${TASK_NOTIFICATION_TAG}><${TASK_ID_TAG}>${attachment.taskId}</${TASK_ID_TAG}>${toolUseIdLine}<${TASK_TYPE_TAG}>${attachment.taskType}</${TASK_TYPE_TAG}><${OUTPUT_FILE_TAG}>${outputPath}</${OUTPUT_FILE_TAG}><${STATUS_TAG}>${attachment.status}</${STATUS_TAG}><${SUMMARY_TAG}>Task "${attachment.description}" ${statusText}</${SUMMARY_TAG}></${TASK_NOTIFICATION_TAG}>`
enqueuePendingNotification({ value: message, mode: 'task-notification' })}
/** * Get human-readable status text. */function getStatusText(status: TaskStatus): string { switch (status) { case 'completed': return 'completed successfully' case 'failed': return 'failed' case 'killed': return 'was stopped' case 'running': return 'is running' case 'pending': return 'is pending' }}