Generated from
schemas/v0.1/common.schema.json ($id: https://agentworldprotocol.com/schemas/v0.1/common.schema.json). Normative text: /spec/semantics/units-and-frames. Every tagged example on this site is validated against this schema in CI.Definitions
u53
Unsigned 64-bit value carried as a JSON integer; bounded by 2^53-1 (AWP-CTL-009).
Type: integer, minimum 0, maximum 9007199254740991
i53
Signed 64-bit value carried as a JSON integer; bounded by ±(2^53-1) (AWP-CTL-009).
Type: integer, minimum -9007199254740991, maximum 9007199254740991
ts_mono_ns
Nanoseconds on the session monotonic clock (AWP-CLK-001).
Type: u53
ts_sim_ns
Simulated time in nanoseconds (AWP-CLK-003).
Type: i53
ts_send_ns
Session-clock time at which a frame was handed to the transport (AWP-OBS-006).
Type: u53
agent_ns
Nanoseconds on the agent’s monotonic clock (AWP-CLK-006).
Type: u53
tick
Lockstep tick number.
Type: u53
seq
Per-channel frame sequence number (AWP-DAT-001).
Type: u53
status_seq
Per-session notification sequence shared by action.status, world.event, and session.state (AWP-CTL-008).
Type: u53
session_id
World-assigned session identifier; not a credential (AWP-SES-009).
Type: string
session_state
Type: negotiating | ready | active | suspended | closed
channel_id
Type: integer, minimum 0, maximum 65535
channel_grant
A granted channel subscription as enumerated in session.ready and obs.subscribe results (AWP-NEG-001).
identifier
required
number | null
required
channel_id
required
latency_stats
Distribution of a latency or staleness quantity over a measurement window, in nanoseconds. Present only when count > 0.
u53
required
Samples in the window.
u53
required
u53
required
u53
per_channel
Object keyed by the decimal channel_id assigned in session.ready.
Type: object
identifier
Names for channels, action types, embodiments, frames, entities.
Type: string, pattern ^[A-Za-z_][A-Za-z0-9_.:-]*$
action_id
Type: string
protocol_version
Type: string, pattern ^[0-9]+\.[0-9]+$
vendor_key
Extension key naming per AWP-VER-004.
Type: string, pattern ^x-[a-z0-9]+\.[A-Za-z0-9_.-]+$
extensions
Vendor extension map; keys use the x-<vendor>. prefix (AWP-VER-004).
Type: object
quaternion
Unit quaternion [x, y, z, w] (AWP-UNI-002).
Type: number[]
vec3_m
Type: number[]
transform
vec3_m
required
quaternion
required
pose
A pose in a named frame (AWP-UNI-003).
identifier
required
vec3_m
required
quaternion
required
time_model
Type: lockstep | streaming
loss_class
Type: reliable | latest-wins
action_state
Type: pending_approval | queued | accepted | executing | cancelling | rejected | completed | failed | preempted | cancelled
terminal_state
Type: rejected | completed | failed | preempted | cancelled
status_reason
Status reason registry (spec/loop/events-and-errors#status-reasons) or a vendor reason.
Type: params_invalid | forbidden | envelope | approval_denied | approval_timeout | deadline_exceeded | stale_intent | cancelled_by_agent | superseded | e_stop | connection_lost | safe_state | session_closed | world_reset | watchdog | world_error | vendor_key
preemption_policy
Type: queue | replace | blend | reject
admin_operation
Type: snapshot | restore | reset | tick
content_block
Task content block (AWP-TSK-002). text is Markdown; other types are world-defined.
string
required
task
content_block[]
required
json_schema
An embedded JSON Schema 2020-12 document (AWP-MAN-002).
Type: JSON Schema