feat: add end-to-end agent diagnostics command#509
Open
GautamKumarOffical wants to merge 1 commit into
Open
Conversation
Add 'agn diagnose <agent-name>' command that runs a structured set of health checks to determine if an agent is truly usable end-to-end. Checks performed: - Daemon liveness (is the daemon process running?) - Adapter state (is the adapter marked as running?) - Workspace health (is the workspace backend reachable?) - Workspace presence (is the agent online with fresh heartbeats?) - Session validity (can the agent heartbeat successfully?) - LLM connectivity (can the configured LLM provider respond?) Output is a structured verdict with ok/warn/error status per check, making it easy to identify exactly where an agent's problems lie. Usage: agn diagnose my-agent Output: Diagnosing agent: my-agent (claude) ✓ daemon PID 12345 ✓ adapter_state running ✓ workspace_health reachable ✓ workspace_presence online (12s ago) ✓ session valid ✓ llm claude-3-5-sonnet-20241022 Result: ALL CHECKS PASSED — agent is ready Fixes openagents-org#485 Signed-off-by: Gautam Kumar <gautamkumarofficial@users.noreply.github.com>
|
Someone is attempting to deploy a commit to the Raphael's projects Team on Vercel. A member of the Team first needs to authorize it. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds
agn diagnose <agent-name>command that runs structured health checks to determine if an agent is truly usable end-to-end.Problem
Users currently need to manually combine multiple status surfaces (agn status, /v1/health, /v1/discover, heartbeat logs) to answer the question: "Can this agent actually receive and complete work right now?" This makes debugging "agent is running but not responding" problems difficult.
Solution
New
agn diagnosecommand that runs a comprehensive set of checks:Output Format
Each check shows ok/warn/error status, making it easy to identify exactly where an agent's problems lie.
Changes
packages/agent-connector/src/cli.js:cmdDiagnose()function with structured health checksUsage
Fixes #485