# Documentation

This directory contains detailed documentation for ya-agent-sdk.

## Contents

| Document                                         | Description                                                                |
| ------------------------------------------------ | -------------------------------------------------------------------------- |
| [context.md](context.md)                         | AgentContext and session management, resumable sessions, extending context |
| [streaming.md](streaming.md)                     | Streaming agent execution, lifecycle hooks, event handling                 |
| [events.md](events.md)                           | Lifecycle events, sideband events, event correlation, custom events        |
| [toolset.md](toolset.md)                         | Toolset architecture, creating tools, hooks, error handling                |
| [tool-search.md](tool-search.md)                 | Dynamic tool discovery with keyword and embedding search strategies        |
| [subagent.md](subagent.md)                       | Subagent system, configuration, builtin presets, hierarchical agents       |
| [skills.md](skills.md)                           | Markdown-based skills, hot reload, progressive loading, pre-scan hooks     |
| [message-bus.md](message-bus.md)                 | Inter-agent communication, multimodal messages, user steering              |
| [media.md](media.md)                             | S3 media upload, custom backends, history filter integration               |
| [environment.md](environment.md)                 | Custom environments, async context manager patterns, resource management   |
| [resumable-resources.md](resumable-resources.md) | Resumable resources, BaseResource, factory pattern, state persistence      |
| [model.md](model.md)                             | Model configuration and usage                                              |
| [logging.md](logging.md)                         | Logging configuration and usage                                            |

> **Note**: Base environment abstractions are defined in [y-agent-environment](https://github.com/wh1isper/y-agent-environment).

## Quick Links

- [Main README](../README.md)
- [Contributing Guide](../CONTRIBUTING.md)
- [API Reference](../ya_agent_sdk/)
