Home > intention-kernel > Interaction

Interaction interface

A single user-facing information or confirmation request.

Signature:

export interface Interaction

Properties

Property	Modifiers	Type	Description
capabilityId?	readonly	CapabilityId	(Optional) Capability that owns continuation state, when applicable.
goal	readonly	string	Natural-language goal used by the response composer.
id	readonly	InteractionId	Stable identity required when a host submits a clicked answer.
kind	readonly	"input" | "confirmation" | "choice" | "clarification"	Shape of user input requested by this interaction.
mode?	readonly	"required" | "optional"	(Optional) Optional follow-ups may be replaced by required progression or a different user intention.
options?	readonly	readonly InteractionOption[]	(Optional) Server-owned options that may be rendered as controls.
payload?	readonly	unknown	(Optional) Opaque host or capability metadata not interpreted as authority.
protectedCanonicalMessage?	readonly	string	(Optional) Trusted response text used without a model call and omitted from later model context.
requestedFacts	readonly	readonly FactType[]	Facts the interaction is intended to collect.
responseMode?	readonly	"contextual"	(Optional) Opt into reviewed conversational framing instead of direct canonical delivery. Required interactions retain their exact goal once; options and input authority never change. Protected or model-redacted delivery still takes precedence. Omission preserves the canonical fast path when it applies.