Dial timeout error should say how long it waited and name the timeout setting

Open Beginner friendly
#408 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

@jay23606 is already working on this.

Since Nov 16, 2026.

  • #663 by @jay23606 — open

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
78/100
Issue type
Bug
Clarity
Clearly specified
Activity status
Quiet
Tech stack
go
Domain
cli

Research direction

Find the CLI's first-connect timeout handling and its unit tests, then read the setting definitions for --dial-timeout and agent.dial_timeout in probe.yaml. Update the error text to report the wait duration and both setting names, keeping the 30s default and retry logic unchanged. Add the error-text unit test and an additive CHANGELOG entry.

Written by the indexing model from the issue text.

Description

area/cli bug

Summary

On a loaded host (for example a parallel app build), the agent can take longer than the default 30s to start listening after a fresh install. The CLI then fails with a bare error such as unexpected EOF or i/o timeout, which reads like a protocol fault.

Acceptance criteria

  • When the first connect gives up, the error says how long the CLI waited and names --dial-timeout and agent.dial_timeout in probe.yaml.
  • The default stays at 30s and the retry logic is unchanged.
  • Covered by a unit test on the error text.
  • CHANGELOG entry (additive).

Notes

Idle-host reproduction attempts (4 fresh installs) all connected on the first attempt, so this is a message and docs fix, not a retry fix.

Dominant language
Go
Stars
6
Forks
3
Avg merge
6h 28m
Merged PRs (30d)
362

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from AlphaWaveSystems/flutter-probe

All issues in AlphaWaveSystems/flutter-probe

Similar issues

More Go issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.