docs: add custom agents & sub-agent orchestration guide (#675)

* docs: add custom agents & sub-agent orchestration guide

Add comprehensive documentation for custom agents covering:
- Defining custom agents with scoped tools and prompts
- Configuration reference for all CustomAgentConfig properties
- How sub-agent delegation and inference work
- Listening to sub-agent lifecycle events (started/completed/failed/selected)
- Building agent tree UIs from event data
- Attaching MCP servers to agents
- Best practices and common patterns

Code examples provided for all four SDK languages (TypeScript, Python, Go, .NET).

Addresses #619 and #301.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Fix C# docs validation: add hidden block for sub-agent events snippet

The C# code block for sub-agent event handling referenced 'session'
without declaring it, causing CS0103 compilation errors during docs
validation. Added a hidden validation block with a full compilable
wrapper class, matching the pattern used elsewhere in the docs.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

---------

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: patniko