refactor: share media normalization across runtimes

docs/tools/image-generation.md

@@ -70,6 +70,8 @@ Use `action: "list"` to inspect available providers and models at runtime:
 
 Not all providers support all parameters. When a fallback provider supports a nearby geometry option instead of the exact requested one, OpenClaw remaps to the closest supported size, aspect ratio, or resolution before submission. Truly unsupported overrides are still reported in the tool result.
 
+Tool results report the applied settings. When OpenClaw remaps geometry during provider fallback, the returned `size`, `aspectRatio`, and `resolution` values reflect what was actually sent, and `details.normalization` captures the requested-to-applied translation.
+
 ## Configuration
 
 ### Model selection

docs/tools/music-generation.md

@@ -136,6 +136,8 @@ uses a shorter maximum than the requested value, OpenClaw automatically clamps
 to the closest supported duration. Truly unsupported optional hints are ignored
 with a warning when the selected provider or model cannot honor them.
 
+Tool results report the applied settings. When OpenClaw clamps duration during provider fallback, the returned `durationSeconds` reflects the submitted value and `details.normalization.durationSeconds` shows the requested-to-applied mapping.
+
 ## Async behavior for the shared provider-backed path
 
 - Session-backed agent runs: `music_generate` creates a background task, returns a started/task response immediately, and posts the finished track later in a follow-up agent message.

docs/tools/video-generation.md

@@ -156,6 +156,8 @@ and the shared live sweep.
 
 Not all providers support all parameters. OpenClaw already normalizes duration to the closest provider-supported value, and it also remaps translated geometry hints such as size-to-aspect-ratio when a fallback provider exposes a different control surface. Truly unsupported overrides are ignored on a best-effort basis and reported as warnings in the tool result. Hard capability limits (such as too many reference inputs) fail before submission.
 
+Tool results report the applied settings. When OpenClaw remaps duration or geometry during provider fallback, the returned `durationSeconds`, `size`, `aspectRatio`, and `resolution` values reflect what was submitted, and `details.normalization` captures the requested-to-applied translation.
+
 Reference inputs also select the runtime mode:
 
 - No reference media: `generate`