agentic.current_binding

Page status: scaffold Source state: generated Applies to: Shepherd v1.0-dev Owner: @docs-system-owner (TBD) Validation: scripts/gen_shepherd_api_inventory.py --check

This is reference — exact, generated facts. The mental model lives in concepts; recipes live in guides.

Pre-rename surface

Generated from the internal agentic facade; names and paths change at the Shepherd rename.

function

current_binding

current_binding(target_type: type[T]) -> ContextRef[T]

Return a live ContextRef[T] for the innermost matching binding.

Raises NoBindingForType if no binding matches anywhere on the Scope chain. Raises AmbiguousBinding if two or more bindings match at the same innermost depth.

The returned ContextRef re-resolves on every attribute access, so subsequent rebinding in the active Scope is visible without re-calling current_binding.