[aheritier]

Documentation changes

• Hooks reference (docs/configuration/hooks/index.md): documents the new tool_result_meta input field on tool_response_transform and post_tool_use, the updated_tool_result_meta output field (object replaces, null clears, omitted leaves unchanged), and that redact_secrets now scrubs result metadata.
• CLI reference (docs/features/cli/index.md): documents that docker agent new defaults to 20 max iterations when the creator uses a DMR model and --max-iterations is omitted.

Source PRs

• fix: render TUI edit diffs from recorded result metadata #4925
• fix(cli): restore the DMR max-iterations default on agent new #4924

[Copilot]

🟡 Changes recommended

The documentation incorrectly implies that post_tool_use can rewrite metadata and that the interactive CLI stops after 20 iterations rather than pausing for a continuation decision.

2 open issues

• Clarify metadata rewriting is limited to tool_response_transform · New
• Explain the iteration limit pauses for a continuation decision · New

What changed in this PR

Updates the documentation to reflect tool-result metadata support from #4925 and the restored DMR iteration default from #4924.

Changes:

• Documents hook metadata inputs, replacement and clearing behavior, and secret redaction.
• Explains the default iteration limit for docker agent new when using DMR.

File	Description
docs/​features/​cli/​index.md	Documents the DMR creator’s default 20-iteration limit and explicit overrides.
docs/​configuration/​hooks/​index.md	Documents tool-result metadata fields, transformation chaining, and redaction.

_{Review effort: Balanced}

[Copilot]

🟢 Approval recommended

No active review issues are recorded for the documentation updates covering hook metadata and Docker Model Runner iteration defaults.

No open issues 🎉

2 resolved since last review

• Explain the iteration limit pauses for a continuation decision
• Clarify metadata rewriting is limited to tool_response_transform

_{Review effort: Balanced}