📄 File detail

tasks/LocalShellTask/guards.ts

🧩 .ts📏 42 lines💾 1,552 bytes📝 text

🎯 Use case

This module is a “LocalShellTask” task implementation — concrete work units the task runner schedules and monitors. On the API surface it exposes BashTaskKind, LocalShellTaskState, and isLocalShellTask — mainly types, interfaces, or factory objects. It composes internal code from Task, types, and utils (relative imports). What the file header says: Pure type + type guard for LocalShellTask state. Extracted from LocalShellTask.tsx so non-React consumers (stopTask.ts via print.ts) don't pull React/ink into the module graph.

Generated from folder role, exports, dependency roots, and inline comments — not hand-reviewed for every path.

🧠 Inline summary

Pure type + type guard for LocalShellTask state. Extracted from LocalShellTask.tsx so non-React consumers (stopTask.ts via print.ts) don't pull React/ink into the module graph.

📤 Exports (heuristic)

BashTaskKind
LocalShellTaskState
isLocalShellTask

🖥️ Source preview

// Pure type + type guard for LocalShellTask state.
// Extracted from LocalShellTask.tsx so non-React consumers (stopTask.ts via
// print.ts) don't pull React/ink into the module graph.

import type { TaskStateBase } from '../../Task.js'
import type { AgentId } from '../../types/ids.js'
import type { ShellCommand } from '../../utils/ShellCommand.js'

export type BashTaskKind = 'bash' | 'monitor'

export type LocalShellTaskState = TaskStateBase & {
  type: 'local_bash' // Keep as 'local_bash' for backward compatibility with persisted session state
  command: string
  result?: {
    code: number
    interrupted: boolean
  }
  completionStatusSentInAttachment: boolean
  shellCommand: ShellCommand | null
  unregisterCleanup?: () => void
  cleanupTimeoutId?: NodeJS.Timeout
  // Track what we last reported for computing deltas (total lines from TaskOutput)
  lastReportedTotalLines: number
  // Whether the task has been backgrounded (false = foreground running, true = backgrounded)
  isBackgrounded: boolean
  // Agent that spawned this task. Used to kill orphaned bash tasks when the
  // agent exits (see killShellTasksForAgent). Undefined = main thread.
  agentId?: AgentId
  // UI display variant. 'monitor' → shows description instead of command,
  // 'Monitor details' dialog title, distinct status bar pill.
  kind?: BashTaskKind
}

export function isLocalShellTask(task: unknown): task is LocalShellTaskState {
  return (
    typeof task === 'object' &&
    task !== null &&
    'type' in task &&
    task.type === 'local_bash'
  )
}