receipt · command

Command receipt

Reports validation and owner completion for a typed command.

command.receipt

Stable ID: command.receipt
Owner: app.script-command-service
Authority: read_only
Timing: post_commit
Availability: active-session
Side effects: none
Determinism: ordered by engine-assigned receipt sequence
Introduced: 1.0.0

Usage

Keep the receipt sequence and status as request evidence. Use post-commit events for completion; an accepted receipt is not authoritative completion.

Parameters

None

Returns

An immutable receipt record describing a submitted command and its current status.

Cost

Bounded by per-package command and queue limits; authoritative work occurs once through the fixed-tick owner.

Fields

ID	Type	Units	Required	Description
`recorded_at_tick`	`tick`	simulation-ticks	yes	Committed simulation tick when the receipt was recorded.
`request_sequence`	`unsigned-integer`	none	yes	Engine-assigned command request sequence.
`sequence`	`unsigned-integer`	none	yes	Engine-assigned receipt sequence.
`status`	`string`	none	yes	Submitted, accepted, rejected, completed, or failed.

Errors

None

Examples

local receipt = command.submit("command.actor.take-control", arguments, 1)
if receipt.status == "accepted" then
    -- Wait for the corresponding completion event.
end

API history

1.0.0: Runtime contract published from the complete Phase 14 registry.