Interface: AgentProposal
@roomful/core / AgentProposal
Interface: AgentProposal
Section titled “Interface: AgentProposal”Defined in: packages/core/src/types.ts:1954
An action an AI agent proposes but does not apply itself — it waits for a human to approve or reject it, so AI actions are inspectable before they commit. Synced to every peer.
Properties
Section titled “Properties”decidedBy?
Section titled “decidedBy?”
optionaldecidedBy:Peer<PresenceData>
Defined in: packages/core/src/types.ts:1988
The peer that approved or rejected it, once decided.
id:
string
Defined in: packages/core/src/types.ts:1958
Identifies the proposal within the room.
payload?
Section titled “payload?”
optionalpayload:unknown
Defined in: packages/core/src/types.ts:1973
An optional structured payload describing the action, e.g. { field, value }.
proposer
Section titled “proposer”proposer:
Peer
Defined in: packages/core/src/types.ts:1963
The peer that proposed the action (an AI agent), carrying live presence.
status
Section titled “status”status:
AgentProposalStatus
Defined in: packages/core/src/types.ts:1978
The current decision state.
timestamp
Section titled “timestamp”timestamp:
number
Defined in: packages/core/src/types.ts:1983
When the proposal was created (ms epoch).
type:
string
Defined in: packages/core/src/types.ts:1968
The proposed action type — an app-defined label, e.g. 'clear-canvas' or 'set-field'.