awp-python 0.1.0a1__py3-none-any.whl

awp/_spec/schemas/embodiment.schema.json

@@ -0,0 +1,22 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agentworldprotocol.com/schemas/v0.1/embodiment.schema.json",
+  "title": "Embodiment declaration",
+  "description": "An entry in world-manifest.embodiments (spec/session/embodiments).",
+  "type": "object",
+  "properties": {
+    "id": { "$ref": "common.schema.json#/$defs/identifier" },
+    "kind": { "type": "string", "minLength": 1, "description": "Free-form class: manipulator, mobile_base, avatar, cursor, camera_rig, ..." },
+    "shared_control": { "type": "boolean", "default": false, "description": "May be bound by several sessions at once; arbitration documented in arbitration (AWP-MA-003)." },
+    "arbitration": { "type": "string", "description": "Required when shared_control is true: priority, blend, or a vendor rule." },
+    "multi_bind_group": { "$ref": "common.schema.json#/$defs/identifier", "description": "Embodiments sharing a group may be bound together by one session; submissions then carry embodiment_id (AWP-EMB-005)." },
+    "action_types": { "type": "array", "items": { "$ref": "common.schema.json#/$defs/identifier" }, "uniqueItems": true },
+    "channels": { "type": "array", "items": { "$ref": "common.schema.json#/$defs/identifier" }, "uniqueItems": true },
+    "description": { "type": "string" }
+  },
+  "required": ["id", "kind", "action_types", "channels"],
+  "if": { "required": ["shared_control"], "properties": { "shared_control": { "const": true } } },
+  "then": { "required": ["arbitration"] },
+  "patternProperties": { "^x-[a-z0-9]+\\.": {} },
+  "additionalProperties": true
+}

awp/_spec/schemas/empty-result.schema.json

@@ -0,0 +1,8 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agentworldprotocol.com/schemas/v0.1/empty-result.schema.json",
+  "title": "Empty params or result",
+  "description": "Used by session.close, world.manifest, world.snapshot params, task.update result, and safety.approval.respond result.",
+  "type": "object",
+  "x-awp-closed": true
+}

awp/_spec/schemas/error.schema.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agentworldprotocol.com/schemas/v0.1/error.schema.json",
+  "title": "JSON-RPC error object with AWP data (AWP-ERR-001)",
+  "type": "object",
+  "properties": {
+    "code": { "type": "integer" },
+    "message": { "type": "string", "pattern": "^AWP_[A-Z_]+$|^[A-Z][a-z ]+$" },
+    "data": {
+      "type": "object",
+      "properties": {
+        "retryable": { "type": "boolean" },
+        "retry_after_ms": { "type": "integer", "minimum": 0 },
+        "detail": { "type": "string" }
+      },
+      "required": ["retryable"],
+      "additionalProperties": true
+    }
+  },
+  "required": ["code", "message"],
+  "if": { "properties": { "code": { "minimum": -32768, "maximum": -32000 } } },
+  "else": { "required": ["data"] },
+  "description": "AWP errors (codes 1000-4999) carry data.retryable; JSON-RPC reserved errors (-32768..-32000) MAY omit data (AWP-ERR-001).",
+  "x-awp-closed": true
+}

awp/_spec/schemas/frame-inline.schema.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agentworldprotocol.com/schemas/v0.1/frame-inline.schema.json",
+  "title": "obs.frame / cmd.frame params (inline binding, AWP-DAT-004)",
+  "description": "The frame header and extension fields as JSON, payload base64-encoded.",
+  "type": "object",
+  "properties": {
+    "channel_id": { "$ref": "common.schema.json#/$defs/channel_id" },
+    "seq": { "$ref": "common.schema.json#/$defs/seq" },
+    "ts_mono_ns": { "$ref": "common.schema.json#/$defs/ts_mono_ns" },
+    "flags": { "type": "integer", "minimum": 0, "maximum": 255, "description": "Bit 0 keyframe, bit 1 end-of-burst, bit 3 resync. Senders set bit 2 (extensions are explicit fields in JSON) and bits 4-7 to 0 and never set resync without keyframe (AWP-DAT-004/005/009); receivers ignore bits 4-7.", "x-awp-lint": { "enum": [0, 1, 2, 3, 9, 11] } },
+    "tick": { "$ref": "common.schema.json#/$defs/tick" },
+    "ts_sim_ns": { "$ref": "common.schema.json#/$defs/ts_sim_ns" },
+    "ts_send_ns": { "$ref": "common.schema.json#/$defs/ts_send_ns", "description": "Required on observation frames in streaming sessions (AWP-OBS-006)." },
+    "payload_b64": { "type": "string", "pattern": "^[A-Za-z0-9+/]*={0,2}$" }
+  },
+  "required": ["channel_id", "seq", "ts_mono_ns", "flags", "payload_b64"],
+  "patternProperties": { "^x-[a-z0-9]+\\.": {} },
+  "x-awp-closed": true
+}

awp/_spec/schemas/frame-tree.schema.json

@@ -0,0 +1,26 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agentworldprotocol.com/schemas/v0.1/frame-tree.schema.json",
+  "title": "Frame tree",
+  "description": "Named coordinate frames published in session.ready (AWP-UNI-003).",
+  "type": "object",
+  "properties": {
+    "frames": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "properties": {
+          "id": { "$ref": "common.schema.json#/$defs/identifier" },
+          "parent": { "oneOf": [{ "$ref": "common.schema.json#/$defs/identifier" }, { "type": "null" }] },
+          "dynamic": { "type": "boolean", "default": false, "description": "Transform is published on awp.tf (AWP-UNI-004)." },
+          "transform": { "$ref": "common.schema.json#/$defs/transform" }
+        },
+        "required": ["id", "parent"],
+        "x-awp-closed": true
+      }
+    }
+  },
+  "required": ["frames"],
+  "x-awp-closed": true
+}

awp/_spec/schemas/obs-report.schema.json

@@ -0,0 +1,40 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agentworldprotocol.com/schemas/v0.1/obs-report.schema.json",
+  "title": "obs.report params (receiver report, AWP-OBS-007)",
+  "description": "Agent-side delivery quality, staleness, and decision latency aggregated over the preceding window.",
+  "type": "object",
+  "properties": {
+    "window_ms": { "type": "integer", "minimum": 1, "description": "Measurement window the statistics cover." },
+    "sync": {
+      "type": "object",
+      "description": "Current clock-offset estimate (AWP-CLK-008).",
+      "properties": {
+        "offset_ns": { "$ref": "common.schema.json#/$defs/i53", "description": "session clock = agent clock + offset_ns." },
+        "rtt_ns": { "$ref": "common.schema.json#/$defs/u53", "description": "Round-trip time of the selected sample; the offset error is bounded by rtt_ns / 2." },
+        "samples": { "$ref": "common.schema.json#/$defs/u53", "description": "Exchanges completed so far in the session." }
+      },
+      "required": ["offset_ns", "rtt_ns"],
+      "x-awp-closed": true
+    },
+    "channels": {
+      "$ref": "common.schema.json#/$defs/per_channel",
+      "description": "Per observation channel that delivered frames in the window.",
+      "additionalProperties": {
+        "type": "object",
+        "properties": {
+          "frames": { "$ref": "common.schema.json#/$defs/u53", "description": "Frames received." },
+          "gaps": { "$ref": "common.schema.json#/$defs/u53", "description": "Frames missing, by seq." },
+          "jitter_ns": { "$ref": "common.schema.json#/$defs/u53", "description": "Mean of |(R_j − R_i) − (S_j − S_i)| over consecutive frames; R is the agent clock at receipt, S is ts_send_ns." },
+          "staleness_ns": { "$ref": "common.schema.json#/$defs/latency_stats", "description": "Staleness at receipt: (agent receipt + offset_ns) − ts_mono_ns." }
+        },
+        "required": ["frames", "gaps"],
+        "x-awp-closed": true
+      }
+    },
+    "decision_latency_ns": { "$ref": "common.schema.json#/$defs/latency_stats", "description": "Agent receipt of the basis frame → action.submit transmitted, over submissions in the window." }
+  },
+  "required": ["window_ms", "sync", "channels"],
+  "patternProperties": { "^x-[a-z0-9]+\\.": {} },
+  "x-awp-closed": true
+}

awp/_spec/schemas/observation-channel.schema.json

@@ -0,0 +1,28 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agentworldprotocol.com/schemas/v0.1/observation-channel.schema.json",
+  "title": "Channel declaration",
+  "description": "An entry in world-manifest.observation_channels or world-manifest.command_channels (AWP-DAT-002, AWP-CMD-001).",
+  "type": "object",
+  "properties": {
+    "id": { "$ref": "common.schema.json#/$defs/identifier", "description": "Unique per world. awp.* names are reserved (awp.tf)." },
+    "modality": {
+      "description": "From the modality registry or x-<vendor>.<name> (AWP-MOD-002).",
+      "anyOf": [
+        { "type": "string", "enum": ["image/jpeg", "image/raw", "audio/pcm", "text/event+json", "proprio/json", "servo/json", "pointcloud/xyz32", "tensor/raw"] },
+        { "$ref": "common.schema.json#/$defs/vendor_key" }
+      ]
+    },
+    "rate_hz": {
+      "description": "Nominal push rate; null for per-tick lockstep channels.",
+      "oneOf": [{ "type": "number", "exclusiveMinimum": 0 }, { "type": "null" }]
+    },
+    "loss_class": { "$ref": "common.schema.json#/$defs/loss_class" },
+    "keyframe_interval": { "type": "integer", "minimum": 1, "description": "Frames between keyframes when deltas are used (AWP-OBS-004)." },
+    "stale_after_ms": { "type": "integer", "minimum": 1, "description": "Age after which frames are stale; drives channel_degraded on reliable channels (AWP-SAF-009). Default 2 × period." },
+    "schema": { "type": "object", "description": "Modality-specific parameters (dimensions, sample rates, event schema)." }
+  },
+  "required": ["id", "modality", "rate_hz", "loss_class", "schema"],
+  "patternProperties": { "^x-[a-z0-9]+\\.": {} },
+  "additionalProperties": true
+}

awp/_spec/schemas/ping-result.schema.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agentworldprotocol.com/schemas/v0.1/ping-result.schema.json",
+  "title": "ping result (pong, AWP-CLK-007)",
+  "type": "object",
+  "properties": {
+    "origin_ns": { "$ref": "common.schema.json#/$defs/u53", "description": "Echoed from the ping." },
+    "receive_ns": { "$ref": "common.schema.json#/$defs/u53", "description": "Responder's clock when the ping was received." },
+    "transmit_ns": { "$ref": "common.schema.json#/$defs/u53", "description": "Responder's clock when this result was transmitted." }
+  },
+  "required": ["origin_ns", "receive_ns", "transmit_ns"],
+  "x-awp-closed": true
+}

awp/_spec/schemas/ping.schema.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agentworldprotocol.com/schemas/v0.1/ping.schema.json",
+  "title": "ping params (heartbeat and clock synchronization, AWP-CLK-007)",
+  "type": "object",
+  "properties": {
+    "origin_ns": { "$ref": "common.schema.json#/$defs/u53", "description": "Sender's clock at transmission: the session clock from the world, the agent clock from the agent." },
+    "last_status_seq": { "$ref": "common.schema.json#/$defs/status_seq", "description": "Agent pings in a session: highest status_seq the agent has processed, acknowledging delivery (AWP-CTL-010)." }
+  },
+  "required": ["origin_ns"],
+  "x-awp-closed": true
+}

awp/_spec/schemas/profiles/gui-actions.schema.json

@@ -0,0 +1,57 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agentworldprotocol.com/schemas/v0.1/profiles/gui-actions.schema.json",
+  "title": "GUI profile action params (AWP-GUI-002)",
+  "description": "Normative params_schema for the five required GUI action types. Coordinates are viewport-relative pixels; _px is the documented exception to AWP-UNI-001.",
+  "$defs": {
+    "point_px": {
+      "type": "object",
+      "properties": {
+        "x_px": { "type": "number", "minimum": 0 },
+        "y_px": { "type": "number", "minimum": 0 }
+      },
+      "required": ["x_px", "y_px"],
+      "x-awp-closed": true
+    },
+    "pointer_move": { "$ref": "#/$defs/point_px" },
+    "pointer_click": {
+      "type": "object",
+      "properties": {
+        "x_px": { "type": "number", "minimum": 0 },
+        "y_px": { "type": "number", "minimum": 0 },
+        "button": { "type": "string", "enum": ["left", "middle", "right"], "default": "left" },
+        "clicks": { "type": "integer", "minimum": 1, "maximum": 3, "default": 1 }
+      },
+      "required": ["x_px", "y_px"],
+      "x-awp-closed": true
+    },
+    "key_input": {
+      "type": "object",
+      "properties": {
+        "text": { "type": "string", "description": "Text to type; mutually exclusive with keys." },
+        "keys": { "type": "array", "items": { "type": "string" }, "minItems": 1, "description": "Key chord, e.g. [\"Control\", \"a\"]." }
+      },
+      "oneOf": [{ "required": ["text"] }, { "required": ["keys"] }],
+      "x-awp-closed": true
+    },
+    "scroll": {
+      "type": "object",
+      "properties": {
+        "x_px": { "type": "number", "minimum": 0 },
+        "y_px": { "type": "number", "minimum": 0 },
+        "dx_px": { "type": "number" },
+        "dy_px": { "type": "number" }
+      },
+      "required": ["dx_px", "dy_px"],
+      "x-awp-closed": true
+    },
+    "navigate": {
+      "type": "object",
+      "properties": {
+        "url": { "type": "string", "format": "uri" }
+      },
+      "required": ["url"],
+      "x-awp-closed": true
+    }
+  }
+}

awp/_spec/schemas/reset-result.schema.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agentworldprotocol.com/schemas/v0.1/reset-result.schema.json",
+  "title": "world.restore / world.reset result (AWP-PRM-006)",
+  "type": "object",
+  "properties": {
+    "tick": {"$ref": "common.schema.json#/$defs/tick", "description": "Present in lockstep sessions."}
+  },
+  "required": [],
+  "x-awp-closed": true
+}

awp/_spec/schemas/reset.schema.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agentworldprotocol.com/schemas/v0.1/reset.schema.json",
+  "title": "world.reset params (AWP-SIM-001, AWP-PRM-006)",
+  "type": "object",
+  "properties": {
+    "initial_state": {"$ref": "common.schema.json#/$defs/identifier", "description": "Default: the manifest's first initial_states entry."},
+    "seed": {"$ref": "common.schema.json#/$defs/u53", "description": "Requires capabilities.seed."}
+  },
+  "required": [],
+  "x-awp-closed": true
+}

awp/_spec/schemas/restore.schema.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agentworldprotocol.com/schemas/v0.1/restore.schema.json",
+  "title": "world.restore params (AWP-REP-002, AWP-PRM-006)",
+  "type": "object",
+  "properties": {
+    "snapshot_token": {"type": "string", "minLength": 8}
+  },
+  "required": ["snapshot_token"],
+  "x-awp-closed": true
+}

awp/_spec/schemas/safety-policy.schema.json

@@ -0,0 +1,81 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agentworldprotocol.com/schemas/v0.1/safety-policy.schema.json",
+  "title": "Safety policy",
+  "description": "world-manifest.safety_policy (spec/safety/envelopes, approval, safe-state, audit-log).",
+  "type": "object",
+  "properties": {
+    "envelopes": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/envelope" }
+    },
+    "safe_state": {
+      "type": "object",
+      "description": "Watchdog and safe-state behavior (AWP-SAF-003). Required when the world offers streaming.",
+      "properties": {
+        "behavior": {
+          "anyOf": [
+            { "type": "string", "enum": ["hold", "safe_stop", "park"] },
+            { "$ref": "common.schema.json#/$defs/vendor_key" }
+          ]
+        },
+        "watchdog_ms": { "type": "integer", "minimum": 1, "description": "Time since the last agent control message before safe state is entered. MUST be ≤ reconnect_window_ms." }
+      },
+      "required": ["behavior", "watchdog_ms"],
+      "x-awp-closed": true
+    },
+    "max_basis_age_ms": { "type": "integer", "minimum": 1, "description": "Maximum age of an intent's basis observation when execution begins (AWP-SAF-013). Required by the robotics profile (AWP-ROB-005)." },
+    "approval_timeout_ms": { "type": "integer", "minimum": 1, "default": 60000, "description": "AWP-APR-003." },
+    "approval_channel": { "type": "string", "description": "Where approval requests are routed (deployment-defined)." },
+    "audit": {
+      "type": "object",
+      "properties": {
+        "redact_paths": {
+          "type": "array",
+          "items": { "type": "string", "pattern": "^/" },
+          "description": "JSON pointers (relative to params or result) redacted in the audit log (AWP-AUD-006)."
+        }
+      },
+      "x-awp-closed": true
+    }
+  },
+  "required": ["envelopes"],
+  "patternProperties": { "^x-[a-z0-9]+\\.": {} },
+  "additionalProperties": true,
+  "$defs": {
+    "envelope": {
+      "type": "object",
+      "properties": {
+        "embodiment": { "$ref": "common.schema.json#/$defs/identifier" },
+        "spatial": {
+          "type": "object",
+          "properties": {
+            "frame": { "$ref": "common.schema.json#/$defs/identifier" },
+            "aabb_m": {
+              "type": "array",
+              "items": { "$ref": "common.schema.json#/$defs/vec3_m" },
+              "minItems": 2,
+              "maxItems": 2,
+              "description": "[min, max] corners."
+            }
+          },
+          "required": ["frame", "aabb_m"],
+          "x-awp-closed": true
+        },
+        "max_velocity_mps": { "type": "number", "exclusiveMinimum": 0 },
+        "max_force_n": { "type": "number", "exclusiveMinimum": 0, "description": "Declare only if the world can measure force (AWP-ROB-002)." },
+        "max_action_rate_hz": { "type": "number", "exclusiveMinimum": 0 },
+        "enforcement": {
+          "type": "string",
+          "enum": ["command_check", "measured", "both"],
+          "default": "command_check",
+          "description": "command_check: requested commands are clamped/rejected; measured: executed motion is monitored; both (AWP-ENV-005)."
+        },
+        "on_violation": { "type": "string", "enum": ["clamp", "reject"] }
+      },
+      "required": ["embodiment", "on_violation"],
+      "patternProperties": { "^x-[a-z0-9]+\\.": {} },
+      "additionalProperties": true
+    }
+  }
+}

awp/_spec/schemas/session-open.schema.json

@@ -0,0 +1,41 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agentworldprotocol.com/schemas/v0.1/session-open.schema.json",
+  "title": "session.open params",
+  "type": "object",
+  "properties": {
+    "embodiment": { "$ref": "common.schema.json#/$defs/identifier", "description": "Omit for an observer session (AWP-EMB-004)." },
+    "embodiments": {
+      "type": "array",
+      "items": { "$ref": "common.schema.json#/$defs/identifier" },
+      "minItems": 2,
+      "uniqueItems": true,
+      "description": "Bind several embodiments of one multi_bind_group (AWP-EMB-005). Mutually exclusive with embodiment."
+    },
+    "mode": { "$ref": "common.schema.json#/$defs/time_model" },
+    "subscribe": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "channel": { "$ref": "common.schema.json#/$defs/identifier" },
+          "rate_hz": { "type": "number", "exclusiveMinimum": 0 }
+        },
+        "required": ["channel"],
+        "x-awp-closed": true
+      }
+    },
+    "action_types": { "type": "array", "items": { "$ref": "common.schema.json#/$defs/identifier" }, "uniqueItems": true },
+    "admin": { "type": "array", "items": { "$ref": "common.schema.json#/$defs/admin_operation" }, "uniqueItems": true, "description": "Requested administrative operations (AWP-PRM-005)." },
+    "seed": { "$ref": "common.schema.json#/$defs/u53" },
+    "takeover": { "type": "boolean" },
+    "transfer_token": { "type": "string", "minLength": 1 },
+    "task": { "$ref": "common.schema.json#/$defs/task" },
+    "extensions": { "$ref": "common.schema.json#/$defs/extensions" }
+  },
+  "required": ["mode"],
+  "not": { "required": ["embodiment", "embodiments"] },
+  "dependentRequired": { "takeover": ["transfer_token"] },
+  "patternProperties": { "^x-[a-z0-9]+\\.": {} },
+  "additionalProperties": true
+}

awp/_spec/schemas/session-ready.schema.json

@@ -0,0 +1,50 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agentworldprotocol.com/schemas/v0.1/session-ready.schema.json",
+  "title": "session.ready (result of session.open and session.resume)",
+  "type": "object",
+  "properties": {
+    "session_id": { "$ref": "common.schema.json#/$defs/session_id" },
+    "session_token": { "type": "string", "minLength": 16, "description": "Credential; redacted in the audit log (AWP-SEC-003, AWP-AUD-006)." },
+    "reconnect_window_ms": { "type": "integer", "minimum": 0, "default": 30000 },
+    "replay_to_status_seq": { "$ref": "common.schema.json#/$defs/status_seq", "description": "session.resume result only: the highest status_seq assigned before resumption. Replay ends with this notification; later ones are live (AWP-CTL-008)." },
+    "heartbeat_interval_ms": { "type": "integer", "minimum": 100, "default": 5000, "description": "AWP-SAF-001." },
+    "granted": {
+      "type": "object",
+      "properties": {
+        "channels": { "type": "array", "items": { "$ref": "common.schema.json#/$defs/channel_grant" } },
+        "action_types": { "type": "array", "items": { "$ref": "common.schema.json#/$defs/identifier" }, "uniqueItems": true },
+        "admin": { "type": "array", "items": { "$ref": "common.schema.json#/$defs/admin_operation" }, "uniqueItems": true, "default": [] },
+        "envelopes": { "type": "array", "items": { "$ref": "safety-policy.schema.json#/$defs/envelope" } },
+        "expires_at": { "$ref": "common.schema.json#/$defs/ts_mono_ns", "description": "Grant expiry (AWP-PRM-003)." }
+      },
+      "required": ["channels", "action_types", "envelopes"],
+      "x-awp-closed": true
+    },
+    "stream_endpoints": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "properties": {
+          "binding": { "type": "string", "enum": ["inline", "ws", "grpc", "webrtc", "webtransport", "shm"], "description": "Stream binding (AWP-TRN-003)." },
+          "url": { "type": "string" },
+          "signaling": { "type": "string" },
+          "channels": { "type": "array", "items": { "$ref": "common.schema.json#/$defs/channel_id" }, "description": "Channels this endpoint carries; when omitted, every channel of the session, including channels subscribed later (AWP-TRN-012)." },
+          "max_frame_bytes": { "type": "integer", "minimum": 1024, "default": 16777216, "description": "Largest frame this endpoint carries (AWP-TRN-011)." }
+        },
+        "required": ["binding"],
+        "additionalProperties": true
+      },
+      "contains": { "properties": { "binding": { "const": "inline" } } }
+    },
+    "frame_tree": { "$ref": "frame-tree.schema.json" },
+    "clock_anchor": { "type": "string", "format": "date-time", "description": "Wall time at monotonic 0 (AWP-CLK-002)." },
+    "tick": { "$ref": "common.schema.json#/$defs/tick", "description": "Current tick; present in lockstep sessions (AWP-TIM-009)." },
+    "safe_state": { "type": "boolean", "description": "On session.resume: whether the embodiment is in safe state (AWP-SAF-008)." },
+    "extensions": { "$ref": "common.schema.json#/$defs/extensions" }
+  },
+  "required": ["session_id", "session_token", "reconnect_window_ms", "heartbeat_interval_ms", "granted", "stream_endpoints"],
+  "patternProperties": { "^x-[a-z0-9]+\\.": {} },
+  "additionalProperties": true
+}

awp/_spec/schemas/session-resume.schema.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agentworldprotocol.com/schemas/v0.1/session-resume.schema.json",
+  "title": "session.resume params",
+  "type": "object",
+  "properties": {
+    "session_token": { "type": "string", "minLength": 1 },
+    "last_status_seq": { "$ref": "common.schema.json#/$defs/status_seq", "description": "Highest status_seq processed; 0 if none (AWP-CTL-008)." }
+  },
+  "required": ["session_token", "last_status_seq"],
+  "x-awp-closed": true
+}

awp/_spec/schemas/session-state.schema.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agentworldprotocol.com/schemas/v0.1/session-state.schema.json",
+  "title": "session.state params (AWP-SES-007)",
+  "type": "object",
+  "properties": {
+    "state": {"$ref": "common.schema.json#/$defs/session_state"},
+    "status_seq": {"$ref": "common.schema.json#/$defs/status_seq"},
+    "ts_mono_ns": {"$ref": "common.schema.json#/$defs/ts_mono_ns"},
+    "reason": {"type": "string", "enum": ["opened", "first_activity", "connection_lost", "resumed", "session_closed", "window_expired", "world_shutdown", "transferred", "connection_replaced"], "description": "Cause of the transition."}
+  },
+  "required": ["state", "status_seq", "ts_mono_ns"],
+  "x-awp-closed": true
+}

awp/_spec/schemas/session-telemetry.schema.json

@@ -0,0 +1,22 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agentworldprotocol.com/schemas/v0.1/session-telemetry.schema.json",
+  "title": "session.telemetry params (AWP-TIM-006)",
+  "description": "World-side latency measurements aggregated over the preceding window. Each quantity is present whenever at least one sample fell in the window.",
+  "type": "object",
+  "properties": {
+    "window_ms": { "type": "integer", "minimum": 1, "description": "Measurement window the statistics cover." },
+    "observation_latency_ns": { "$ref": "common.schema.json#/$defs/latency_stats", "description": "Pipeline latency, ts_send_ns − ts_mono_ns, over every observation frame sent in the window." },
+    "admission_latency_ns": { "$ref": "common.schema.json#/$defs/latency_stats", "description": "Admission acknowledgement transmitted − received_ts_mono_ns, over every action.submit in the window." },
+    "observation_to_action_ns": { "$ref": "common.schema.json#/$defs/latency_stats", "description": "received_ts_mono_ns − basis_ts_mono_ns, over every submission in the window that carried a basis." },
+    "command_latency_ns": { "$ref": "common.schema.json#/$defs/latency_stats", "description": "World receipt − ts_mono_ns, over every command frame received in the window." },
+    "channels": {
+      "$ref": "common.schema.json#/$defs/per_channel",
+      "description": "Pipeline latency per observation channel, for every channel that sent frames in the window.",
+      "additionalProperties": { "$ref": "common.schema.json#/$defs/latency_stats" }
+    }
+  },
+  "required": ["window_ms"],
+  "patternProperties": { "^x-[a-z0-9]+\\.": {} },
+  "x-awp-closed": true
+}

awp/_spec/schemas/session-transfer-result.schema.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agentworldprotocol.com/schemas/v0.1/session-transfer-result.schema.json",
+  "title": "session.transfer result",
+  "type": "object",
+  "properties": {
+    "transfer_token": { "type": "string", "minLength": 1, "description": "Single-use credential; redacted in the audit log (AWP-EMB-003, AWP-AUD-006)." },
+    "expires_in_ms": { "type": "integer", "minimum": 1 }
+  },
+  "required": ["transfer_token", "expires_in_ms"],
+  "x-awp-closed": true
+}

awp/_spec/schemas/session-transfer.schema.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agentworldprotocol.com/schemas/v0.1/session-transfer.schema.json",
+  "title": "session.transfer params (AWP-EMB-003)",
+  "type": "object",
+  "properties": {
+    "expires_in_ms": {"type": "integer", "minimum": 1000, "default": 30000}
+  },
+  "required": [],
+  "x-awp-closed": true
+}

awp/_spec/schemas/snapshot-result.schema.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agentworldprotocol.com/schemas/v0.1/snapshot-result.schema.json",
+  "title": "world.snapshot result (AWP-REP-002)",
+  "type": "object",
+  "properties": {
+    "snapshot_token": {"type": "string", "minLength": 8, "description": "Opaque credential; redacted in the audit log (AWP-AUD-006)."}
+  },
+  "required": ["snapshot_token"],
+  "x-awp-closed": true
+}

awp/_spec/schemas/subscribe-result.schema.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agentworldprotocol.com/schemas/v0.1/subscribe-result.schema.json",
+  "title": "obs.subscribe / obs.unsubscribe result (AWP-NEG-004)",
+  "type": "object",
+  "properties": {
+    "granted": {"type": "array", "items": {"$ref": "common.schema.json#/$defs/channel_grant"}, "description": "The session's complete channel grant list after the change."}
+  },
+  "required": ["granted"],
+  "x-awp-closed": true
+}

awp/_spec/schemas/subscribe.schema.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agentworldprotocol.com/schemas/v0.1/subscribe.schema.json",
+  "title": "obs.subscribe params (AWP-NEG-004)",
+  "type": "object",
+  "properties": {
+    "channels": {"type": "array", "minItems": 1, "items": {"type": "object", "properties": {"channel": {"$ref": "common.schema.json#/$defs/identifier"}, "rate_hz": {"type": "number", "exclusiveMinimum": 0}}, "required": ["channel"], "x-awp-closed": true}}
+  },
+  "required": ["channels"],
+  "x-awp-closed": true
+}

awp/_spec/schemas/task-update.schema.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agentworldprotocol.com/schemas/v0.1/task-update.schema.json",
+  "title": "task.update params (AWP-TSK-001..003)",
+  "type": "object",
+  "properties": {
+    "task": { "$ref": "common.schema.json#/$defs/task" }
+  },
+  "required": ["task"],
+  "x-awp-closed": true
+}