deepseek-ai/deepseek-harness · error · Error

background terminal sends are disabled by tool-terminal conf

Error message

background terminal sends are disabled by tool-terminal configuration

What it means

Error "background terminal sends are disabled by tool-terminal configuration" thrown in deepseek-ai/deepseek-harness.

Source

Thrown at packages/terminal/tool-terminal/src/index.ts:251

        text: value.kind === 'background'
          ? `started background job ${value.jobId}`
          : renderSend(value, maxResultBytes),
      }],
      presentationMeta: (_args, value) => value.kind === 'foreground'
        ? {
          viewport: value.viewport,
          waitReason: value.waitReason,
          sessionStatus: value.sessionStatus,
          truncated: value.truncated,
        }
        : null,
    },
    async execute(args: SendArgs, exec) {
      const owner = requireAgent(exec.agent)
      const id = sessionId(args)
      const request = { text: args.text, submit: args.submit ?? true }
      if (args.run_in_background === true) {
        if (!enableRunInBackground) throw new Error('background terminal sends are disabled by tool-terminal configuration')
        const jobs = ctx.get('jobs')
        if (jobs === undefined) throw new Error('background terminal sends require @deepseek-ai/dsh-jobs and @deepseek-ai/dsh-tool-jobs')
        let cancelRequested = false
        const jobId = jobs.start({
          kind: 'pty-send',
          label: `${id}: ${args.text || '(input)'}`,
          owner,
          outputLimitBytes: maxResultBytes,
          run: () => {
            const operation = ctx.terminals.startSend(owner, id, request)
            return {
              cancel: () => {
                cancelRequested = true
                operation.cancel()
              },
              done: operation.done.then(
                result => ({ status: cancelRequested ? 'killed' as const : 'completed' as const, detail: sendDetail(result) }),
                (error: unknown) => ({ status: 'failed' as const, detail: String(error) }),

View on GitHub (pinned to b150a551b8)

Solutions

1. Enable background sends in the tool-terminal configuration, or send in the foreground.

When it happens

Trigger: Thrown at packages/terminal/tool-terminal/src/index.ts:251 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/07afb1e738954ff9. Report an issue: GitHub.