deepseek-ai/deepseek-harness · error · Error

${path}.mode must be "normal" or "always"

Error message

${path}.mode must be "normal" or "always"

What it means

Error "${path}.mode must be "normal" or "always"" thrown in deepseek-ai/deepseek-harness.

Source

Thrown at packages/llm/llm/src/retry-policy.ts:193

      }
      if (new Set(retryableCodes).size !== retryableCodes.length) {
        throw new Error(`${path}.retryableCodes must not contain duplicates`)
      }
      return Object.freeze({
        mode: 'normal',
        maxRetries,
        retryableCodes: Object.freeze([...retryableCodes]),
        ...resolveBackoff(config.backoff, `${path}.backoff`),
      })
    }
    case 'always':
      validateKeys(config, ALWAYS_POLICY_KEYS, path)
      return Object.freeze({
        mode: 'always',
        ...resolveBackoff(config.backoff, `${path}.backoff`),
      })
    default:
      throw new Error(`${path}.mode must be "normal" or "always"`)
  }
}

View on GitHub (pinned to b150a551b8)

Solutions

1. Set mode to "normal" or "always".

When it happens

Trigger: Thrown at packages/llm/llm/src/retry-policy.ts:193 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/2061859e03db6a4f. Report an issue: GitHub.