provider_handoff_read
Read a stored provider handoff receipt by ID and return the redacted rendered prompt with redaction labels.
Instructions
Read the redacted rendered prompt for a stored provider handoff receipt.
Looks up a previously written provider handoff receipt by id, validates the id shape, reads the receipt JSON from the
workspace .nogra receipts directory, and returns the redacted rendered prompt plus any redaction labels.
When to use:
- Inspect the exact redacted prompt that was stored for a previous dry-run provider handoff.
- Recover prompt text by handoff id without re-rendering or creating a new receipt.
When NOT to use:
- Do not use this before creating a provider handoff receipt; missing ids return a missing status.
- Do not use this for unredacted secrets or raw provider prompts; the stored field is redacted.
Examples:
>>> provider_handoff_read("provider-handoff-20260504120000-abc123ef")
{"status": "ok", "handoffId": "provider-handoff-20260504120000-abc123ef", "renderedPromptRedacted": "...", "redactions": []}
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| consult_id | No | Deprecated alias for handoff_id. Kept only so older beta prompts fail softly during migration. | |
| handoff_id | No | Provider handoff id returned by provider_handoff, normally shaped like provider-handoff-YYYYMMDDHHMMSS-xxxxxxxx. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||