Skip to content

agentic.deliver

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

deliver 

deliver(
    result_type: type[T],
    *,
    goal: str,
    evidence: Sequence[object] = (),
    constraints: Sequence[str] = (),
    limits: DeliveryLimits | None = None,
) -> T | Awaitable[T]

Deliver a typed result from inside an active function-form task.

In a sync task body this runs the model-call coroutine to completion and returns T. In an async task body it returns an awaitable for T; call sites should use await deliver(...).

See also