t8y2/dbx · error

agent did not become ready: %s

Error message

agent did not become ready: %s

What it means

Returned by startAgent in the kingbase bench harness when the spawned agent process's first stdout line does not contain "ready":true — the agent either printed nothing (crashed on startup) or emitted an error/trace instead of the readiness handshake within the first line.

Source

Thrown at agents/drivers/kingbase-go/bench/agent_compare.go:206

	process.command = exec.Command(argv[0], argv[1:]...)
	stdin, err := process.command.StdinPipe()
	if err != nil {
		return nil, 0, err
	}
	stdout, err := process.command.StdoutPipe()
	if err != nil {
		return nil, 0, err
	}
	process.command.Stderr = os.Stderr
	process.stdin = stdin
	process.reader = bufio.NewScanner(stdout)
	process.reader.Buffer(make([]byte, 64*1024), 512*1024*1024)
	start := time.Now()
	if err := process.command.Start(); err != nil {
		return nil, 0, err
	}
	if !process.reader.Scan() || !strings.Contains(process.reader.Text(), `"ready":true`) {
		return nil, 0, fmt.Errorf("agent did not become ready: %s", process.reader.Text())
	}
	startup := time.Since(start)
	go process.readResponses()
	return process, startup, nil
}

func (process *agentProcess) readResponses() {
	for process.reader.Scan() {
		var response agentResponse
		if json.Unmarshal(process.reader.Bytes(), &response) != nil {
			continue
		}
		if channel, ok := process.pending.LoadAndDelete(response.ID); ok {
			channel.(chan agentResponse) <- response
		}
	}
}

View on GitHub (pinned to c0390bff16)

Solutions

1. Run the agent binary manually with the same env to see its startup output
2. Check stderr (inherited by the bench) for crash or config errors
3. Rebuild the agent so it emits the ready handshake on stdout
4. Verify environment variables required by the agent are set

When it happens

Trigger: Thrown at agents/drivers/kingbase-go/bench/agent_compare.go:206 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of t8y2/dbx@c0390bff16 (2026-09-05). Data as JSON: /api/errors/7d6d26e0c93a8d47. Report an issue: GitHub.