# LLM Layer Guidelines

## Scope
- Applies to `src/llm/`.
- Inherits root `AGENTS.md` and `src/AGENTS.md`.

## Adapter Contracts
- Provider clients must implement `HyperAgentLLM`.
- Wire provider selection through `createLLMClient` in `src/llm/providers/index.ts`.
- Keep each provider aligned with shared model capabilities and structured output expectations.

## Message and Schema Translation
- Update `src/llm/utils/message-converter.ts` and `src/llm/utils/schema-converter.ts` when provider message/schema requirements change.
- Preserve zod-first structured output flow for tool/action decisions.
- Avoid provider-specific assumptions leaking into agent/runtime modules.