[DOCS] [Hooks] PostToolUse `continueOnBlock` option is not documented

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/hooks

Section/Topic

PostToolUse decision control (near line 1358)

Current Documentation

The PostToolUse decision control section documents decision, updatedToolOutput, and updatedMCPToolOutput as the available output fields:

| decision | "block" adds the reason next to the tool result. Claude still sees the original output; to replace it, use updatedToolOutput | | updatedToolOutput | Replaces the tool's output with the provided value before it is sent to Claude. The value must match the tool's output shape | | updatedMCPToolOutput | Replaces the output for [MCP tools](#match-mcp-tools) only. Prefer updatedToolOutput, which works for all tools |

The section describes that decision: "block" adds the reason next to the tool result and states "Claude still sees the original output" — but it does not document any option to feed the rejection reason back to Claude and continue the turn.

What's Wrong or Missing?

The continueOnBlock config option for PostToolUse hooks is not documented. According to the v2.1.139 changelog, this option was added with the following behavior:

Added hook continueOnBlock config option for PostToolUse — set to true to feed the hook's rejection reason back to Claude and continue the turn

When a PostToolUse hook returns decision: "block" with a reason, the current documentation indicates the reason is shown next to the tool result but Claude still sees the original output. The new continueOnBlock option allows the hook's rejection reason to be fed back to Claude and the turn to continue, which is a distinct behavior not covered in the current docs.

Suggested Improvement

Add continueOnBlock to the PostToolUse decision control output fields table:

| `continueOnBlock`       | When `true` and `decision` is `"block"`, feeds the hook's rejection reason back to Claude and continues the turn instead of showing the reason next to the tool result |

Also add a note explaining the distinction:

• Without continueOnBlock: decision: "block" adds the reason next to the tool result. Claude still sees the original output.
• With continueOnBlock: true: decision: "block" feeds the rejection reason back to Claude and continues the turn.

Impact

Low - Minor confusion or inconvenience

Additional Context

Changelog reference: v2.1.139 — "Added hook continueOnBlock config option for PostToolUse — set to true to feed the hook's rejection reason back to Claude and continue the turn"

Affected Pages:
| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/hooks | PostToolUse decision control section |
| https://code.claude.com/docs/en/agent-sdk/hooks | Agent SDK hooks reference (may also need updating) |