AGENTS.md

1# HTTP Filters
2 
3This directory contains various HTTP-related channel filters and functionality.
4 
5 
6 
7## Overarching Purpose
8 
9This directory contains a collection of filters that are responsible for handling HTTP/2-specific functionality in gRPC. This includes things like header manipulation, message compression, and authority checking.
10 
11## Subdirectories
12 
13*   **[`client`](./client/AGENTS.md)**: Contains client-side HTTP filters.
14*   **[`server`](./server/AGENTS.md)**: Contains server-side HTTP filters.
15 
16## Files
17 
18*   **`client_authority_filter.h`, `client_authority_filter.cc`**: These files contain the implementation of the `ClientAuthorityFilter`, a client-side filter that sets the `:authority` pseudo-header in HTTP/2 requests.
19*   **`http_filters_plugin.cc`**: This file registers the HTTP filters with the `CoreConfiguration`.
20 
21## Notes
22 
23*   The filters in this directory are essential for ensuring that gRPC is compliant with the HTTP/2 specification.
24*   The `ClientAuthorityFilter` is a good example of a simple, single-purpose filter. It has one job (to set the `:authority` header), and it does it well.
25*   The `message_compress` filter is a good example of a more complex filter that is used on both the client and the server. It is responsible for compressing and decompressing messages, and it supports a variety of different compression algorithms.
26