deepseek-ai/deepseek-harness · error

subagent-codex "${this.name}": child run failed (${stopReaso

Error message

subagent-codex "${this.name}": child run failed (${stopReason}): ${error.message}

What it means

Error "subagent-codex "${this.name}": child run failed (${stopReason}): ${error.message}" thrown in deepseek-ai/deepseek-harness.

Source

Thrown at packages/subagent/subagent-codex/src/index.ts:99

        undefined,
        parentCwd,
      )
    } catch (error: unknown) {
      if (request.signal.aborted) {
        throw new Error(
          'subagent-codex: request was aborted before app-server startup',
        )
      }
      throw codexStartupFailure(error)
    }
    const spec: CodexRunSpec = {
      cwd,
      permissionMode: this.config.permissionMode,
      env: this.config.env,
      disposeGraceMs: this.config.disposeGraceMs,
      spawn: spawnSpec => this.ctx.subprocess.spawn(spawnSpec),
      onError: (error, stopReason) => {
        this.ctx.logger.warn(
          `subagent-codex "${this.name}": child run failed (${stopReason}): ${error.message}`,
        )
      },
    }
    return startCodexRun(request, spec)
  }
}

/**
 * Register one Profile-named Codex provider.
 * @param ctx - context carrying shared subagent and subprocess services.
 * @param config - registry name, permission mode, child environment, and disposal grace.
 */
export function apply(ctx: Context, config: Config): void {
  const resolved: ResolvedConfig = {
    providerName: config.providerName ?? DEFAULT_PROVIDER_NAME,
    env: config.env as Record<string, string>,
    permissionMode: config.permissionMode ?? DEFAULT_CODEX_PERMISSION_MODE,

View on GitHub (pinned to b150a551b8)

Solutions

1. Inspect the Codex child logs for the stopReason and error message; fix the child configuration and retry.

When it happens

Trigger: Thrown at packages/subagent/subagent-codex/src/index.ts:99 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/2206851ee7abe55c. Report an issue: GitHub.