public final class IntentResult

What an intent handler hands back.

A result carries up to four independent things, and every consumer takes the parts it understands and ignores the rest:

• a value, which the Shortcuts app pipes into the next action
• a spoken line, which an assistant reads aloud
• a snippet, a small layout shown alongside the answer
• an open route, which continues the interaction inside the app

Nothing is mandatory. IntentResult.ok() is a complete, valid answer meaning “done, nothing to report”.

return IntentResult.value(orderId)
        .withDialog("Your coffee is on the way")
        .withSnippet(orderCard);

The snippet is a surface, not a Form

A snippet is rendered by the platform while your app may not be on screen, so it uses the com.codename1.surfaces node catalog and obeys the same dead-process rule: it serializes to data at the moment you return it. That is also why there is no way to hand back a Form – a live component tree has nowhere to live once the handler returns.