Add comprehensive documentation for Agent Run Logs API

[codegen-sh]

Overview

This PR adds comprehensive documentation for the Agent Run Logs API endpoint (/agent/run/{agent_run_id}/logs) that returns AgentRunLog data. The endpoint is currently in ALPHA status and wasn't fully documented.

What's Added

📚 New Documentation Page: docs/api-reference/agent-run-logs.mdx

Complete field reference for AgentRunLogResponse:

• agent_run_id, created_at, tool_name, message_type
• thought, observation, tool_input, tool_output
• Data types, descriptions, and when each field is populated

All AgentLogType enum values explained:

• Plan Agent types: ACTION, PLAN_EVALUATION, FINAL_ANSWER, ERROR, USER_MESSAGE
• PR Agent types: INITIAL_PR_GENERATION, DETECT_PR_ERRORS, FIX_PR_ERRORS
• Commit Agent types: COMMIT_EVALUATION
• Link types: AGENT_RUN_LINK

Practical usage examples:

• Basic log retrieval and pagination
• Filtering by log type
• Debugging failed runs
• Building monitoring dashboards

ALPHA status disclaimers and feedback channels

🧭 Updated Navigation: docs/docs.json

• Added new "Guides" section under API Reference tab
• Makes the documentation discoverable through main site navigation

Key Features

✅ Field-by-field reference - Developers know exactly what each field contains
✅ Log type explanations - Clear understanding of different message types
✅ Real-world examples - Practical code snippets for common use cases
✅ ALPHA disclaimers - Appropriate warnings about endpoint stability
✅ Feedback channels - Clear paths for users to provide input

Files Changed

• docs/api-reference/agent-run-logs.mdx - New comprehensive API guide
• docs/docs.json - Updated navigation structure

This addresses the need for detailed field explanations that developers require when working with agent run logs, going beyond the basic auto-generated OpenAPI documentation.

---

💻 View my work • About Codegen

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

✅ All tests successful. No failed tests found.

🚀 New features to boost your workflow:

• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[codegen-sh]

Review request noted—I'll take a look! 🔍

💻 View my work