Skip to content

Glossary

TermMeaning
PathThe filesystem address a tool opens, lists, stats, or reads.
MountA configured provider instance under a mount prefix, such as /github or /db.
ProviderA wasm32-wasip2 component that defines routes, object identity, and rendered files for one system.
HostThe runtime that owns FUSE, credentials, cache, callouts, provider lifecycle, and runtime grants.
WITThe omnifs:provider interface between host and provider.
LookupThe authoritative question: does this child name exist under this parent path?
List responseA provider response for directory listing. It may be exhaustive or non-exhaustive.
CursorPagination state for listing responses.
CalloutHost work requested by a suspended provider operation, such as HTTP fetch, git handoff, blob fetch, or archive access.
EffectTerminal provider output that asks the host to store canonical bytes, materialize view records, or invalidate cached state.
ObjectA logical upstream resource represented by one or more rendered files.
Logical idThe stable provider-defined identity for an object inside a mount.
Canonical bytesProvider-supplied upstream bytes stored in the object cache.
Cached canonicalCanonical bytes pushed by the host back into read-file so the provider can render without refetching.
Field leafA small file derived from an object, such as title, state, or assignee.
View leavesRendered filesystem records associated with an object and stored in the view cache.
Rendered viewFiles and directories shell tools read after provider rendering.
Object cacheDurable cache for canonical object bytes.
View cacheRecreated-on-startup cache for derived filesystem records.
Blob cacheHost-managed byte storage for large fetched blobs, archives, and streamed content.
Tree-refProvider handoff to a real backing tree, such as a cloned repository.
CapabilityA manifest-declared permission for host-mediated effects such as domains, Git remotes, Unix sockets, or preopened paths.
WASI preopenExplicit filesystem path granted to the provider sandbox.
No ambient authorityProviders have no direct network, arbitrary disk, Docker, Git, or credential access outside host-mediated capabilities.

For a narrative explanation, see Architecture: Glossary.