provider_handoff
Generate a redacted handoff receipt for review without calling a live provider, returning a handoff ID and local file guidance.
Instructions
Create a dry-run provider handoff receipt.
Renders the configured provider handoff template, redacts secret-shaped text, stores the
hosted receipt, and returns the handoff id plus localWrites guidance for the caller-owned
`.nogra/` receipt copy.
This public V1 tool does not call a live provider.
When to use:
- Prepare a redacted provider handoff before handing work to another model or reviewer.
- Validate how a prompt, context, and mode will render without making an external model call.
When NOT to use:
- Do not use this when you need an actual provider response; providerCall.attempted is always false.
- Do not use this for run tracking or pinboard activity; use event/run tools for that.
Examples:
>>> provider_handoff(provider="codex", prompt="Review this brief", context="Scope: docs only", intent="review")
{"status": "dry_run", "handoffId": "provider-handoff-...", "provider": "codex", "intent": "review", ...}
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | Deprecated alias for intent. Kept only so older beta prompts fail softly during migration. | |
| model | No | Deprecated alias for provider. Kept only so older beta prompts fail softly during migration. | |
| intent | No | Provider intent label such as consult, review, delegate or gate. | consult |
| prompt | No | Question or task text to render into the provider handoff prompt. | |
| context | No | Optional surrounding context rendered into the provider handoff prompt. | |
| surface | No | Suggested surface mode: pass-through, manager-summary or conditional-loud. | pass-through |
| provider | No | Provider label to place in the handoff receipt, such as codex or gemini. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||