* feat: add support for custom HTTP headers in client requests

This update introduces the ability to include custom HTTP headers in requests sent from the client. This enhancement facilitates more flexible and secure communication with servers by allowing clients to pass additional information in the header of each request, such as authentication tokens or custom metadata. This feature is crucial for integrating with APIs that require specific headers for access control, content negotiation, or tracking purposes.

Signed-off-by: Matthis Holleville <[email protected]>

* feat(client/transport): enhance HTTP request flexibility

Enhanced the flexibility of HTTP requests in the streamable HTTP client by allowing additional headers to be specified. This change aims to support more diverse server requirements and improve the adaptability of our client transport layer.

Signed-off-by: Matthis Holleville <[email protected]>

* fix: Improve OAuth error handling and test readability in HTTP transport

- Enhanced OAuth error detection by using `errors.Is` for more reliable error handling.
- Corrected a typo in a comment and improved code readability in tests by using a variable for headers.

Signed-off-by: Matthis Holleville <[email protected]>

* fix: improve variable naming for clarity in streamable_http_test

Signed-off-by: Matthis Holleville <[email protected]>

* feat: Ensure system headers are preserved in streamable HTTP tests

To maintain consistency and ensure the integrity of HTTP headers during tests, system headers like Content-Type are now verified to be preserved. This change enhances the reliability of our testing framework by ensuring essential headers are not inadvertently removed or altered during the testing process.

Signed-off-by: Matthis Holleville <[email protected]>

---------

Signed-off-by: Matthis Holleville <[email protected]>

…templates (#624)

* feat: add SessionWithResourceTemplates for session-specific resource templates

Implements session-specific resource templates to achieve parity with
SessionWithTools and SessionWithResources. This allows sessions to have
their own resource templates that override global templates with the
same URI pattern.

Key changes:
- Add SessionWithResourceTemplates interface to ClientSession hierarchy
- Implement interface in both SSE and StreamableHTTP transports
- Add AddSessionResourceTemplate(s) and DeleteSessionResourceTemplates methods
- Update handleListResourceTemplates to merge session and global templates
- Update handleReadResource to check session templates before global ones
- Session templates trigger notifications/resources/list_changed when modified

Closes #622

* test: add comprehensive tests for session resource templates

- Add sessionTestClientWithResourceTemplates mock
- Test AddSessionResourceTemplate and AddSessionResourceTemplates
- Test DeleteSessionResourceTemplates
- Test session template override behavior
- Test notification behavior (enabled/disabled)
- Test uninitialized session handling
- Test error cases for unsupported sessions
- Verify thread-safety through existing patterns

Coverage increased from 70.17% to 72.8% (+2.63%)

* refactor: address CodeRabbit review comments

- Use atomic.Bool for initialized field in test mock to prevent data races
- Add nil checks for URITemplate in handleReadResource for both session and global templates
- Add validation in AddSessionResourceTemplates to prevent nil URITemplate, empty URI, or empty Name
- Simplify Get/SetSessionResourceTemplates using maps.Clone
- Fix test initialization states to match expected behavior

All tests pass with race detector.

…ession management (#626)

* Add SessionIdManagerResolver

* Rabbit AI Cr Comments

* Nitpicks

* Nitpicks

* more tests

* feat: client roots feature

* feat: finish client roots, pass unit and integration test

* client roots http sample code

* client roots for stdio and pass integration test

* update roots stio client example

* add godoc and const of rootlist

* update godoc and data format

* update examples for client roots

* add fallback for demonstration

* adjust roots path and signals of examples

* update roots http client example

* samples: fix unit test and refactor with lint

* examples: refactor to adapt windows os and nitpick comments

* update for nitpick comments

* refactor for nitpick comments