event · events.command
Command completed
Reports a typed command only after its owner commits successfully.
events.command.completed(request_sequence, command_id, origin_id, target_tick)- Stable ID
events.command.completed- Owner
- app.script-event-service
- Authority
- read_only
- Timing
- post_commit
- Availability
- active-session
- Side effects
- none
- Determinism
- ordered by event publication sequence and committed tick
- Introduced
- 1.0.0
Usage
Listen for events.command.completed after authoritative mutation commits. Use events.after only for explicit catch-up or diagnostic recovery.
Parameters
- None
Returns
A fresh detached callback-local table containing the immutable post-commit fact. Editing the table cannot change the source event or another callback's copy.
Cost
Counts against the package active-delivery and protected-callback budgets.
Fields
| ID | Type | Units | Required | Description |
|---|---|---|---|---|
command_id | string | none | yes | Stable command symbol ID. |
origin_id | string | none | yes | Engine-created caller origin ID. |
request_sequence | unsigned-integer | none | yes | Completed command request sequence. |
target_tick | tick | simulation-ticks | yes | Requested fixed simulation tick. |
Errors
- None
Examples
events.listen("events.command.completed", function(event)
feedback = event.payload.command_id .. " completed"
end)API history
- 1.0.0: Runtime contract published from the complete Phase 14 registry.