awp-python 0.1.0a1__py3-none-any.whl

awp/__init__.py

@@ -0,0 +1,64 @@
+"""Agent World Protocol client protocol layer.
+
+`ClientConnection` is the agent side of AWP as a sans-IO state machine; `awp.aio.AsyncClient`
+drives it over a WebSocket. This package targets the specification revision in `SPEC_REVISION`.
+"""
+
+from importlib.metadata import PackageNotFoundError, version
+
+from .client import (
+    ActionRecord,
+    ActionUpdated,
+    ApprovalRequested,
+    ClientConnection,
+    ErrorResponse,
+    Event,
+    FrameReceived,
+    Initialized,
+    ProtocolViolation,
+    ReplayCompleted,
+    Response,
+    SessionOpened,
+    SessionStateChanged,
+    Telemetry,
+    TickCompleted,
+    WorldEvent,
+)
+from .errors import AwpError, ErrorCode, ProtocolError
+from .frames import Frame
+from .lifecycle import ActionState
+
+SPEC_REVISION = "0.1-draft.7"
+PROTOCOL_VERSION = "0.1"
+
+try:
+    __version__ = version("awp-python")
+except PackageNotFoundError:  # pragma: no cover - running from a source tree without install
+    __version__ = "0.0.0"
+
+__all__ = [
+    "PROTOCOL_VERSION",
+    "SPEC_REVISION",
+    "ActionRecord",
+    "ActionState",
+    "ActionUpdated",
+    "ApprovalRequested",
+    "AwpError",
+    "ClientConnection",
+    "ErrorCode",
+    "ErrorResponse",
+    "Event",
+    "Frame",
+    "FrameReceived",
+    "Initialized",
+    "ProtocolError",
+    "ProtocolViolation",
+    "ReplayCompleted",
+    "Response",
+    "SessionOpened",
+    "SessionStateChanged",
+    "Telemetry",
+    "TickCompleted",
+    "WorldEvent",
+    "__version__",
+]

awp/_spec/lifecycle.json

@@ -0,0 +1,190 @@
+{
+  "states": {
+    "submitted": "transient",
+    "pending_approval": "pre-execution",
+    "queued": "pre-execution",
+    "accepted": "pre-execution",
+    "executing": "execution",
+    "cancelling": "execution",
+    "rejected": "terminal",
+    "completed": "terminal",
+    "failed": "terminal",
+    "preempted": "terminal",
+    "cancelled": "terminal"
+  },
+  "transitions": [
+    {
+      "from": "submitted",
+      "to": "rejected",
+      "label": "validation, grant, envelope, or intent check fails",
+      "wire": "error"
+    },
+    {
+      "from": "submitted",
+      "to": "pending_approval",
+      "label": "type requires approval"
+    },
+    {
+      "from": "submitted",
+      "to": "queued",
+      "label": "group busy and preempt is queue"
+    },
+    {
+      "from": "submitted",
+      "to": "accepted",
+      "label": "admitted"
+    },
+    {
+      "from": "pending_approval",
+      "to": "queued",
+      "label": "approved and group busy"
+    },
+    {
+      "from": "pending_approval",
+      "to": "accepted",
+      "label": "approved"
+    },
+    {
+      "from": "pending_approval",
+      "to": "rejected",
+      "label": "denied, timeout, deadline, re-check fails",
+      "reasons": [
+        "approval_denied",
+        "approval_timeout",
+        "deadline_exceeded",
+        "stale_intent",
+        "forbidden",
+        "envelope"
+      ]
+    },
+    {
+      "from": "pending_approval",
+      "to": "cancelled",
+      "label": "cancel, e-stop, safe state, close, reset, transfer, superseded",
+      "reasons": [
+        "cancelled_by_agent",
+        "e_stop",
+        "safe_state",
+        "session_closed",
+        "world_reset",
+        "transferred",
+        "superseded"
+      ]
+    },
+    {
+      "from": "queued",
+      "to": "accepted",
+      "label": "group free"
+    },
+    {
+      "from": "queued",
+      "to": "rejected",
+      "label": "deadline or re-check fails",
+      "reasons": [
+        "deadline_exceeded",
+        "stale_intent",
+        "forbidden",
+        "envelope"
+      ]
+    },
+    {
+      "from": "queued",
+      "to": "cancelled",
+      "label": "cancel, e-stop, safe state, close, reset, transfer, superseded",
+      "reasons": [
+        "cancelled_by_agent",
+        "e_stop",
+        "safe_state",
+        "session_closed",
+        "world_reset",
+        "transferred",
+        "superseded"
+      ]
+    },
+    {
+      "from": "accepted",
+      "to": "executing",
+      "label": "execution begins"
+    },
+    {
+      "from": "accepted",
+      "to": "rejected",
+      "label": "deadline or validity passes before execution",
+      "reasons": [
+        "deadline_exceeded",
+        "stale_intent"
+      ]
+    },
+    {
+      "from": "accepted",
+      "to": "cancelled",
+      "label": "cancel, e-stop, safe state, close, reset, transfer, superseded",
+      "reasons": [
+        "cancelled_by_agent",
+        "e_stop",
+        "safe_state",
+        "session_closed",
+        "world_reset",
+        "transferred",
+        "superseded"
+      ]
+    },
+    {
+      "from": "executing",
+      "to": "completed",
+      "label": "goal reached"
+    },
+    {
+      "from": "executing",
+      "to": "failed",
+      "label": "deadline, e-stop, safe state, envelope, watchdog, error",
+      "reasons": [
+        "deadline_exceeded",
+        "e_stop",
+        "connection_lost",
+        "envelope",
+        "watchdog",
+        "world_error"
+      ]
+    },
+    {
+      "from": "executing",
+      "to": "preempted",
+      "label": "newer replace or blend, transfer",
+      "reasons": [
+        "transferred"
+      ]
+    },
+    {
+      "from": "executing",
+      "to": "cancelling",
+      "label": "cancel, close, reset",
+      "reasons": [
+        "cancelled_by_agent",
+        "session_closed",
+        "world_reset"
+      ]
+    },
+    {
+      "from": "cancelling",
+      "to": "cancelled",
+      "label": "safe abort complete",
+      "reasons": [
+        "cancelled_by_agent",
+        "session_closed",
+        "world_reset"
+      ]
+    },
+    {
+      "from": "cancelling",
+      "to": "failed",
+      "label": "e-stop, safe state, abort fails",
+      "reasons": [
+        "e_stop",
+        "connection_lost",
+        "abort_failed",
+        "world_error"
+      ]
+    }
+  ]
+}

awp/_spec/schemas/action-cancel-result.schema.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agentworldprotocol.com/schemas/v0.1/action-cancel-result.schema.json",
+  "title": "action.cancel result (AWP-LIF-005)",
+  "type": "object",
+  "properties": {
+    "action_id": { "$ref": "common.schema.json#/$defs/action_id" },
+    "state": { "$ref": "common.schema.json#/$defs/action_state" },
+    "status_seq": { "$ref": "common.schema.json#/$defs/status_seq" }
+  },
+  "required": ["action_id", "state", "status_seq"],
+  "additionalProperties": true
+}

awp/_spec/schemas/action-ref.schema.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agentworldprotocol.com/schemas/v0.1/action-ref.schema.json",
+  "title": "action.cancel and action.status (pull) params",
+  "type": "object",
+  "properties": {
+    "action_id": {"$ref": "common.schema.json#/$defs/action_id"}
+  },
+  "required": ["action_id"],
+  "x-awp-closed": true
+}

awp/_spec/schemas/action-schema.schema.json

@@ -0,0 +1,37 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agentworldprotocol.com/schemas/v0.1/action-schema.schema.json",
+  "title": "Action type declaration",
+  "description": "An entry in world-manifest.action_schemas (spec/loop/actions, spec/loop/preemption, spec/loop/command-channels).",
+  "type": "object",
+  "properties": {
+    "type": { "$ref": "common.schema.json#/$defs/identifier", "description": "Action type name, unique per world." },
+    "params_schema": { "$ref": "common.schema.json#/$defs/json_schema", "description": "JSON Schema 2020-12 for params (AWP-MAN-002). Local $refs resolve against the manifest's $defs." },
+    "duration": { "type": "string", "enum": ["instant", "extended", "streaming"] },
+    "preemption": {
+      "description": "Declared policies the submitter may choose from (AWP-PRE-001).",
+      "oneOf": [
+        { "$ref": "common.schema.json#/$defs/preemption_policy" },
+        { "type": "array", "items": { "$ref": "common.schema.json#/$defs/preemption_policy" }, "minItems": 1, "uniqueItems": true }
+      ]
+    },
+    "concurrency_group": { "$ref": "common.schema.json#/$defs/identifier", "description": "Types sharing a group preempt one another (AWP-PRE-006)." },
+    "max_queue": { "type": "integer", "minimum": 1, "description": "Queue depth when queue is offered (AWP-PRE-002)." },
+    "requires_approval": { "type": "boolean", "default": false },
+    "command_channel": { "$ref": "common.schema.json#/$defs/identifier", "description": "Command channel this streaming type opens (AWP-CMD-002)." },
+    "watchdog_ms": { "type": "integer", "minimum": 1, "description": "Per-stream watchdog for streaming types (AWP-CMD-005)." },
+    "max_abort_ms": { "type": "integer", "minimum": 1, "description": "Upper bound on the cancelling state for this type (AWP-LIF-010)." },
+    "max_duration_ms": { "type": "integer", "minimum": 1, "description": "Extended types: longest execution the world permits; applies as a deadline when the submission's deadline_ms is absent or longer (AWP-ACT-008). Required for extended types in the robotics profile (AWP-ROB-007)." },
+    "description": { "type": "string" }
+  },
+  "required": ["type", "params_schema", "duration", "preemption"],
+  "allOf": [
+    {
+      "if": { "properties": { "duration": { "const": "streaming" } } },
+      "then": { "required": ["command_channel", "watchdog_ms"] },
+      "else": { "not": { "anyOf": [{ "required": ["command_channel"] }, { "required": ["watchdog_ms"] }] } }
+    }
+  ],
+  "patternProperties": { "^x-[a-z0-9]+\\.": {} },
+  "additionalProperties": true
+}

awp/_spec/schemas/action-status.schema.json

@@ -0,0 +1,39 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agentworldprotocol.com/schemas/v0.1/action-status.schema.json",
+  "title": "action.status params (notification and pull result)",
+  "type": "object",
+  "properties": {
+    "action_id": { "$ref": "common.schema.json#/$defs/action_id" },
+    "state": { "$ref": "common.schema.json#/$defs/action_state" },
+    "status_seq": { "$ref": "common.schema.json#/$defs/status_seq" },
+    "ts_mono_ns": { "$ref": "common.schema.json#/$defs/ts_mono_ns" },
+    "tick": { "$ref": "common.schema.json#/$defs/tick", "description": "Lockstep: tick of the transition." },
+    "progress": { "type": "number", "minimum": 0, "maximum": 1 },
+    "reason": { "$ref": "common.schema.json#/$defs/status_reason" },
+    "detail": { "type": "string" },
+    "clamped": { "type": "boolean" },
+    "blended": { "type": "boolean" },
+    "aborted_at_progress": { "type": "number", "minimum": 0, "maximum": 1 },
+    "stream": {
+      "type": "object",
+      "description": "Streaming-duration actions (AWP-CMD-004).",
+      "properties": {
+        "frames_applied": { "$ref": "common.schema.json#/$defs/u53" },
+        "last_seq": { "$ref": "common.schema.json#/$defs/seq" },
+        "clamped_count": { "$ref": "common.schema.json#/$defs/u53" }
+      },
+      "required": ["frames_applied", "last_seq"],
+      "additionalProperties": true
+    }
+  },
+  "required": ["action_id", "state", "status_seq", "ts_mono_ns"],
+  "allOf": [
+    {
+      "if": { "properties": { "state": { "enum": ["rejected", "failed", "cancelled"] } } },
+      "then": { "required": ["reason"] }
+    }
+  ],
+  "patternProperties": { "^x-[a-z0-9]+\\.": {} },
+  "additionalProperties": true
+}

awp/_spec/schemas/action-submit-result.schema.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agentworldprotocol.com/schemas/v0.1/action-submit-result.schema.json",
+  "title": "action.submit result (admission acknowledgement, AWP-LIF-002)",
+  "type": "object",
+  "properties": {
+    "action_id": { "$ref": "common.schema.json#/$defs/action_id" },
+    "state": { "$ref": "common.schema.json#/$defs/action_state", "description": "A first submission reports pending_approval, queued, or accepted. An idempotent resubmission reports the action's current state (AWP-ACT-001)." },
+    "status_seq": { "$ref": "common.schema.json#/$defs/status_seq", "description": "The transition this result reports; for an idempotent resubmission, the action's most recent transition (no new status_seq is consumed)." },
+    "received_ts_mono_ns": { "$ref": "common.schema.json#/$defs/ts_mono_ns", "description": "Session-clock time the world received the submission; origin of deadline_ms and of admission latency." },
+    "ts_mono_ns": { "$ref": "common.schema.json#/$defs/ts_mono_ns", "description": "Time of the reported transition." },
+    "reason": { "$ref": "common.schema.json#/$defs/status_reason", "description": "Present when an idempotent resubmission reports a rejected, failed, or cancelled action." }
+  },
+  "required": ["action_id", "state", "status_seq", "received_ts_mono_ns", "ts_mono_ns"],
+  "additionalProperties": true
+}

awp/_spec/schemas/action-submit.schema.json

@@ -0,0 +1,19 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agentworldprotocol.com/schemas/v0.1/action-submit.schema.json",
+  "title": "action.submit params",
+  "type": "object",
+  "properties": {
+    "action_id": { "$ref": "common.schema.json#/$defs/action_id" },
+    "type": { "$ref": "common.schema.json#/$defs/identifier" },
+    "params": { "type": "object" },
+    "embodiment_id": { "$ref": "common.schema.json#/$defs/identifier", "description": "Required in multi-bind sessions (AWP-EMB-005)." },
+    "preempt": { "$ref": "common.schema.json#/$defs/preemption_policy" },
+    "deadline_ms": { "type": "integer", "minimum": 1, "description": "From world receipt; covers approval and queue wait (AWP-ACT-004)." },
+    "basis_ts_mono_ns": { "$ref": "common.schema.json#/$defs/ts_mono_ns", "description": "Capture time of the newest observation this intent relies on (AWP-ACT-007)." },
+    "valid_until_ns": { "$ref": "common.schema.json#/$defs/ts_mono_ns", "description": "Session-clock instant after which the intent must not begin executing (AWP-ACT-007)." }
+  },
+  "required": ["action_id", "type", "params"],
+  "patternProperties": { "^x-[a-z0-9]+\\.": {} },
+  "additionalProperties": true
+}

awp/_spec/schemas/agent-manifest.schema.json

@@ -0,0 +1,27 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agentworldprotocol.com/schemas/v0.1/agent-manifest.schema.json",
+  "title": "Agent manifest (initialize params)",
+  "description": "What the agent declares in initialize (spec/session/agent-manifest).",
+  "type": "object",
+  "properties": {
+    "protocol_versions": { "type": "array", "items": { "$ref": "common.schema.json#/$defs/protocol_version" }, "minItems": 1, "uniqueItems": true },
+    "agent": {
+      "type": "object",
+      "properties": {
+        "name": { "type": "string", "minLength": 1 },
+        "version": { "type": "string", "minLength": 1 },
+        "vendor": { "type": "string", "minLength": 1 }
+      },
+      "required": ["name", "version", "vendor"],
+      "additionalProperties": true
+    },
+    "consumes_modalities": { "type": "array", "items": { "type": "string", "minLength": 1 }, "minItems": 1, "uniqueItems": true },
+    "time_models": { "type": "array", "items": { "$ref": "common.schema.json#/$defs/time_model" }, "minItems": 1, "uniqueItems": true, "default": ["lockstep", "streaming"] },
+    "max_obs_rate_hz": { "type": "number", "exclusiveMinimum": 0 },
+    "extensions": { "$ref": "common.schema.json#/$defs/extensions" }
+  },
+  "required": ["protocol_versions", "agent", "consumes_modalities"],
+  "patternProperties": { "^x-[a-z0-9]+\\.": {} },
+  "additionalProperties": true
+}

awp/_spec/schemas/approval-requested.schema.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agentworldprotocol.com/schemas/v0.1/approval-requested.schema.json",
+  "title": "safety.approval_requested params (AWP-APR-001)",
+  "type": "object",
+  "properties": {
+    "approval_id": { "type": "string", "minLength": 1 },
+    "action_id": { "$ref": "common.schema.json#/$defs/action_id" },
+    "type": { "$ref": "common.schema.json#/$defs/identifier" },
+    "params": { "type": "object" },
+    "requester": {
+      "type": "object",
+      "properties": {
+        "session": { "type": "string" },
+        "embodiment": { "$ref": "common.schema.json#/$defs/identifier" }
+      },
+      "required": ["session"],
+      "additionalProperties": true
+    },
+    "task": { "$ref": "common.schema.json#/$defs/task" },
+    "expires_at_ns": { "$ref": "common.schema.json#/$defs/ts_mono_ns" }
+  },
+  "required": ["approval_id", "action_id", "type", "params", "requester", "expires_at_ns"],
+  "additionalProperties": true
+}

awp/_spec/schemas/approval-respond.schema.json

@@ -0,0 +1,31 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agentworldprotocol.com/schemas/v0.1/approval-respond.schema.json",
+  "title": "safety.approval.respond params (AWP-APR-002)",
+  "type": "object",
+  "properties": {
+    "approval_id": { "type": "string", "minLength": 1 },
+    "decision": { "type": "string", "enum": ["approve", "deny"] },
+    "note": { "type": "string" },
+    "standing": {
+      "type": "object",
+      "description": "Scoped standing approval (AWP-APR-004).",
+      "properties": {
+        "scope": {
+          "type": "object",
+          "properties": {
+            "type": { "$ref": "common.schema.json#/$defs/identifier" },
+            "predicate": { "type": "object", "description": "JSON Schema the params must satisfy." }
+          },
+          "required": ["type"],
+          "x-awp-closed": true
+        },
+        "expires_at": { "$ref": "common.schema.json#/$defs/ts_mono_ns" }
+      },
+      "required": ["scope", "expires_at"],
+      "x-awp-closed": true
+    }
+  },
+  "required": ["approval_id", "decision"],
+  "x-awp-closed": true
+}

awp/_spec/schemas/common.schema.json

@@ -0,0 +1,150 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agentworldprotocol.com/schemas/v0.1/common.schema.json",
+  "title": "AWP common definitions",
+  "description": "Shared primitives referenced by every other AWP schema. Apache-2.0.",
+  "$defs": {
+    "u53": {
+      "description": "Unsigned 64-bit value carried as a JSON integer; bounded by 2^53-1 (AWP-CTL-009).",
+      "type": "integer",
+      "minimum": 0,
+      "maximum": 9007199254740991
+    },
+    "i53": {
+      "description": "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": { "$ref": "#/$defs/u53", "description": "Nanoseconds on the session monotonic clock (AWP-CLK-001)." },
+    "ts_sim_ns": { "$ref": "#/$defs/i53", "description": "Simulated time in nanoseconds (AWP-CLK-003)." },
+    "ts_send_ns": { "$ref": "#/$defs/u53", "description": "Session-clock time at which a frame was handed to the transport (AWP-OBS-006)." },
+    "agent_ns": { "$ref": "#/$defs/u53", "description": "Nanoseconds on the agent's monotonic clock (AWP-CLK-006)." },
+    "tick": { "$ref": "#/$defs/u53", "description": "Lockstep tick number." },
+    "seq": { "$ref": "#/$defs/u53", "description": "Per-channel frame sequence number (AWP-DAT-001)." },
+    "status_seq": { "$ref": "#/$defs/u53", "description": "Per-session notification sequence shared by action.status, world.event, and session.state (AWP-CTL-008)." },
+    "session_id": { "type": "string", "minLength": 1, "maxLength": 128, "description": "World-assigned session identifier; not a credential (AWP-SES-009)." },
+    "session_state": { "type": "string", "enum": ["negotiating", "ready", "active", "suspended", "closed"] },
+    "channel_id": { "type": "integer", "minimum": 0, "maximum": 65535 },
+    "channel_grant": {
+      "description": "A granted channel subscription as enumerated in session.ready and obs.subscribe results (AWP-NEG-001).",
+      "type": "object",
+      "properties": {
+        "channel": { "$ref": "#/$defs/identifier" },
+        "rate_hz": { "oneOf": [{ "type": "number", "exclusiveMinimum": 0 }, { "type": "null" }] },
+        "channel_id": { "$ref": "#/$defs/channel_id" }
+      },
+      "required": ["channel", "rate_hz", "channel_id"],
+      "x-awp-closed": true
+    },
+    "latency_stats": {
+      "description": "Distribution of a latency or staleness quantity over a measurement window, in nanoseconds. Present only when count > 0.",
+      "type": "object",
+      "properties": {
+        "count": { "$ref": "#/$defs/u53", "description": "Samples in the window." },
+        "p50": { "$ref": "#/$defs/u53" },
+        "p95": { "$ref": "#/$defs/u53" },
+        "max": { "$ref": "#/$defs/u53" }
+      },
+      "required": ["count", "p50", "p95"],
+      "x-awp-closed": true
+    },
+    "per_channel": {
+      "description": "Object keyed by the decimal channel_id assigned in session.ready.",
+      "type": "object",
+      "propertyNames": { "pattern": "^(0|[1-9][0-9]{0,4})$" }
+    },
+    "identifier": {
+      "description": "Names for channels, action types, embodiments, frames, entities.",
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128,
+      "pattern": "^[A-Za-z_][A-Za-z0-9_.:-]*$"
+    },
+    "action_id": { "type": "string", "minLength": 1, "maxLength": 128 },
+    "protocol_version": { "type": "string", "pattern": "^[0-9]+\\.[0-9]+$" },
+    "vendor_key": {
+      "description": "Extension key naming per AWP-VER-004.",
+      "type": "string",
+      "pattern": "^x-[a-z0-9]+\\.[A-Za-z0-9_.-]+$"
+    },
+    "extensions": {
+      "description": "Vendor extension map; keys use the x-<vendor>. prefix (AWP-VER-004).",
+      "type": "object",
+      "propertyNames": { "$ref": "#/$defs/vendor_key" }
+    },
+    "quaternion": {
+      "description": "Unit quaternion [x, y, z, w] (AWP-UNI-002).",
+      "type": "array",
+      "items": { "type": "number" },
+      "minItems": 4,
+      "maxItems": 4
+    },
+    "vec3_m": {
+      "type": "array",
+      "items": { "type": "number" },
+      "minItems": 3,
+      "maxItems": 3
+    },
+    "transform": {
+      "type": "object",
+      "properties": { "p_m": { "$ref": "#/$defs/vec3_m" }, "q": { "$ref": "#/$defs/quaternion" } },
+      "required": ["p_m", "q"],
+      "x-awp-closed": true
+    },
+    "pose": {
+      "description": "A pose in a named frame (AWP-UNI-003).",
+      "type": "object",
+      "properties": {
+        "frame": { "$ref": "#/$defs/identifier" },
+        "p_m": { "$ref": "#/$defs/vec3_m" },
+        "q": { "$ref": "#/$defs/quaternion" }
+      },
+      "required": ["frame", "p_m", "q"],
+      "x-awp-closed": true
+    },
+    "time_model": { "type": "string", "enum": ["lockstep", "streaming"] },
+    "loss_class": { "type": "string", "enum": ["reliable", "latest-wins"] },
+    "action_state": {
+      "type": "string",
+      "enum": ["pending_approval", "queued", "accepted", "executing", "cancelling", "rejected", "completed", "failed", "preempted", "cancelled"]
+    },
+    "terminal_state": { "type": "string", "enum": ["rejected", "completed", "failed", "preempted", "cancelled"] },
+    "status_reason": {
+      "description": "Status reason registry (spec/loop/events-and-errors#status-reasons) or a vendor reason.",
+      "anyOf": [
+        {
+          "type": "string",
+          "enum": [
+            "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", "transferred", "abort_failed", "watchdog", "world_error"
+          ]
+        },
+        { "$ref": "#/$defs/vendor_key" }
+      ]
+    },
+    "preemption_policy": { "type": "string", "enum": ["queue", "replace", "blend", "reject"] },
+    "admin_operation": { "type": "string", "enum": ["snapshot", "restore", "reset", "tick"] },
+    "content_block": {
+      "description": "Task content block (AWP-TSK-002). text is Markdown; other types are world-defined.",
+      "type": "object",
+      "properties": { "type": { "type": "string", "minLength": 1 } },
+      "required": ["type"],
+      "if": { "properties": { "type": { "const": "text" } } },
+      "then": { "properties": { "text": { "type": "string" } }, "required": ["text"] }
+    },
+    "task": {
+      "type": "object",
+      "properties": {
+        "content": { "type": "array", "items": { "$ref": "#/$defs/content_block" }, "minItems": 1 }
+      },
+      "required": ["content"],
+      "x-awp-closed": true
+    },
+    "json_schema": {
+      "description": "An embedded JSON Schema 2020-12 document (AWP-MAN-002).",
+      "$ref": "https://json-schema.org/draft/2020-12/schema"
+    }
+  }
+}