deepseek-ai/deepseek-harness · error · Error

terminal-bash: handoffGraceMs must be at least pollIntervalM

Error message

terminal-bash: handoffGraceMs must be at least pollIntervalMs so one readiness poll runs inside the grace window

What it means

Error "terminal-bash: handoffGraceMs must be at least pollIntervalMs so one readiness poll runs inside the grace window" thrown in deepseek-ai/deepseek-harness.

Source

Thrown at packages/terminal/terminal-bash/src/config.ts:120

/**
 * Assert every effective numeric config field is a positive safe integer and bounds compose.
 * @param config - Schemastery-resolved plugin configuration.
 * @returns Narrows the input to the fully resolved configuration.
 */
export function validateConfig(config: Config): asserts config is ResolvedConfig {
  const resolved = config as ResolvedConfig
  if (resolved.backendType.length === 0) throw new Error('terminal-bash: backendType must be non-empty')
  if (resolved.shellPath.length === 0) throw new Error('terminal-bash: shellPath must be non-empty')
  for (const [name, value] of Object.entries(resolved)) {
    if (typeof value === 'number' && (!Number.isSafeInteger(value) || value <= 0)) {
      throw new Error(`terminal-bash: ${name} must be a positive safe integer`)
    }
  }
  if (resolved.maxReadBytes > resolved.scrollbackMaxBytes) {
    throw new Error('terminal-bash: maxReadBytes must not exceed scrollbackMaxBytes')
  }
  if (resolved.handoffGraceMs < resolved.pollIntervalMs) {
    throw new Error('terminal-bash: handoffGraceMs must be at least pollIntervalMs so one readiness poll runs inside the grace window')
  }
}

View on GitHub (pinned to b150a551b8)

Solutions

1. Set handoffGraceMs to at least pollIntervalMs.

When it happens

Trigger: Thrown at packages/terminal/terminal-bash/src/config.ts:120 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of deepseek-ai/deepseek-harness@b150a551b8 (2026-08-24). Data as JSON: /api/errors/fe4283ef8054525a. Report an issue: GitHub.