The docs should start with that with a very clean explanation how it works. Basically first paragraph. :)

Otherwise you should expect churn.

But also it should really go into some detail how is this different from tool calls with type enforcement on expected parameters.

That's good feedback, thank you! I have an update landing shortly so I'll make sure to clarify in the docs! I appreciate it!