fix: allow enumerating deferred tools

[masamorishita]

Summary

• allow the tool-search bridge to enumerate the full deferred tool catalog with query='*'
• add offset pagination and next_offset so catalogs larger than the per-call limit can be walked completely
• update bridge schema descriptions and regression tests for the "list every connected tool" use-case

Tests

• uv run --with pytest --with pytest-timeout python -m pytest tests/tools/test_tool_search.py -q

[teknium1]

Thanks for addressing deferred-tool catalog enumeration. The underlying gap is still present on current main: tools/tool_search.py:612-614 rejects an empty query, and the bridge schema at tools/tool_search.py:459-469 has no pagination field.

Problems

• tools/tool_search.py:650-652 cannot signal another keyword-search page. search_catalog(..., limit=limit + offset) returns at most that many rows, so a full page makes offset + len(page) == len(hits) and sets next_offset to null even if more catalog entries match.
• website/docs/user-guide/features/tool-search.md:29-35 still documents tool_search(query, limit?); it needs the wildcard, offset, and next_offset contract.

Suggested changes

• Retrieve a sentinel result beyond the requested page (or rank all matches), then test a multi-page keyword query through completion.
• Update the Tool Search feature documentation alongside the schema change.

Automated hermes-sweeper review.

[teknium1]

hits is capped at limit + offset on the preceding line, so a full keyword-search page makes this condition false and returns next_offset: null even when later matches exist. Fetch a sentinel result (or rank all matches) before deriving the continuation.