akb_browse
Access all vault documents, tables, and files by specifying a browse root with adjustable tree depth, content type filters, and pagination. Use a canonical URI or vault/collection pair for navigation.
Instructions
Browse ALL vault content — documents, tables, and files — under a browse root. The browse root can be addressed two ways: pass a canonical uri (akb://V for vault root or akb://V/coll/X for a collection), or the legacy vault + optional collection pair. Use the URI form when drilling down from a previous response — every item carries a uri that can be pasted straight back in.
depth is tree-depth from the browse root, mirroring tree -L N: 0 = direct children only (no descent), N = descend N collection levels, -1 = entire subtree. Collection rows are always emitted as navigation aids regardless of depth.
Response is slim by default (no summary field) so large vaults (70+ collections) fit in the agent's context window. Returns {vault, path, items, total, returned, truncated?, hint?}.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| uri | No | Canonical browse target: `akb://{vault}` (vault root) or `akb://{vault}/coll/{path}` (collection-scoped). Takes precedence over `vault` + `collection` when both are given. | |
| vault | No | Vault name. Required unless `uri` is given. | |
| collection | No | Collection path to use as the browse root (omit for vault root). Ignored when `uri` is given. | |
| depth | No | Tree depth from the browse root. 0 = direct children only (no descent into any collection). N = descend N collection levels. -1 = unbounded (entire subtree). Collections themselves are always emitted regardless of depth. | |
| content_type | No | Filter by content type | all |
| filter | No | Substring filter on item name/path (case-insensitive). | |
| limit | No | Cap returned item count. | |
| offset | No | Skip first N items (default 0). | |
| include_summary | No | Include the per-item summary field (default false, drops to keep payload small). | |
| include_hashes | No | Include AKB-certified content_hash/hash_algorithm and resource version fields for documents/files. | |
| include_archived | No | Include archived documents. Default false — `status: archived` docs are hidden from browse. |