docs: clarify aggregate context tools

This commit is contained in:
morluto 2026-09-29 18:42:57 +08:00
parent b5c0b5b53e
commit c7e207c290
1 changed files with 4 additions and 3 deletions

View File

@ -69,9 +69,10 @@ current/containing procedure. Its capability inventory exposes a
the caller supplies `document` and the provider lacks `current_document`. A
cursor outside a procedure is represented as
`procedure: null`. `inspect_address_context` requires an explicit address and
returns bounded name, procedure, comment, inline-comment, and bookmark facets;
unsupported facets are local `unavailable` outcomes. The scalar getters remain
available while the aggregate contracts are evaluated.
returns name, procedure, comment, inline-comment, and bookmark facets;
unsupported facets are local `unavailable` outcomes. Use `current_document`,
`current_address`, and `current_procedure` for direct single-field lookups; use
the aggregate tools when you need related context together.
## Permission policy