dcdpr / jp / 24393863802

67%

Build Type

push

github

Committed by web-flow

Commit Message

chore(tools): Add section discovery and targeted fetch to `web_fetch` (#552)

Two new optional parameters extend the `web_fetch` tool to support
navigating large documentation pages without fetching everything at
once.

`list_sections` returns a compact XML listing of every headed section on
the page. Each entry includes the section's anchor ID, heading level,
title, and a short content preview. Five heading-ID resolution patterns
are supported: `id` on the heading itself, `id` on a parent element, a
permalink child anchor, a child element with `id`, and a preceding
sibling anchor.

`sections` accepts a list of anchor IDs returned by `list_sections` and
returns only the HTML content under those headings, converted to
Markdown. This significantly reduces output size when only specific
parts of a page are needed.

Typical workflow:

```json
{"url": "https://docs.rs/tokio/latest/tokio/", "list_sections": true}
{"url": "https://docs.rs/tokio/latest/tokio/", "sections": ["modules", "macros"]}
```

The tool definition in `.jp/mcp/tools/web/fetch.toml` is updated to
expose both parameters with descriptions and examples.

Signed-off-by: Jean Mertz <git@jeanmertz.com>

Coverage Stats

142 of 180 new or added lines in 2 files covered. (78.89%)

2 existing lines in 2 files now uncovered.

21854 of 33358 relevant lines covered (65.51%)

172.72 hits per line