> ## Documentation Index
> Fetch the complete documentation index at: https://www.agentworldprotocol.com/llms.txt
> Use this file to discover all available pages before exploring further.

# common.schema.json

> Shared primitives: bounded integers, timestamps, pose, task, status reasons.

<Note>Generated from [`schemas/v0.1/common.schema.json`](https://github.com/Hyperduality/agent-world-protocol/blob/main/schemas/v0.1/common.schema.json) (`$id`: `https://agentworldprotocol.com/schemas/v0.1/common.schema.json`). Normative text: [/spec/semantics/units-and-frames](/spec/semantics/units-and-frames). Every tagged example on this site is validated against this schema in CI.</Note>

Shared primitives referenced by every other AWP schema. Apache-2.0.

## 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).

<ResponseField name="channel" type="identifier" required />

<ResponseField name="rate_hz" type="number | null" required />

<ResponseField name="channel_id" type="channel_id" required />

### `latency_stats`

Distribution of a latency or staleness quantity over a measurement window, in nanoseconds. Present only when count > 0.

<ResponseField name="count" type="u53" required>Samples in the window.</ResponseField>

<ResponseField name="p50" type="u53" required />

<ResponseField name="p95" type="u53" required />

<ResponseField name="max" type="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`

<ResponseField name="p_m" type="vec3_m" required />

<ResponseField name="q" type="quaternion" required />

### `pose`

A pose in a named frame (AWP-UNI-003).

<ResponseField name="frame" type="identifier" required />

<ResponseField name="p_m" type="vec3_m" required />

<ResponseField name="q" type="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.

<ResponseField name="type" type="string" required />

### `task`

<ResponseField name="content" type="content_block[]" required />

### `json_schema`

An embedded JSON Schema 2020-12 document (AWP-MAN-002).

Type: `JSON Schema`