awp-python 0.1.0a5__tar.gz → 0.1.0a6__tar.gz

{awp_python-0.1.0a5 → awp_python-0.1.0a6}/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.1.0a6
+
+Targets specification revision `0.1-draft.10`.
+
+- When one of a multi-bind session's embodiments is transferred away, the client stops counting it as bound (AWP-EMB-003).
+
 ## 0.1.0a5
 
 Targets specification revision `0.1-draft.9`.

{awp_python-0.1.0a5 → awp_python-0.1.0a6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: awp-python
-Version: 0.1.0a5
+Version: 0.1.0a6
 Summary: Agent World Protocol agent SDK for Python.
 Project-URL: Specification, https://www.agentworldprotocol.com
 Project-URL: Source, https://github.com/Hyperduality/awp-python
@@ -23,13 +23,13 @@ Description-Content-Type: text/markdown
 
 The Python agent SDK for the [Agent World Protocol](https://www.agentworldprotocol.com). `ClientConnection` is the agent side of AWP as a sans-IO state machine, and `awp.aio.AsyncClient` drives it over a WebSocket.
 
-It targets specification revision **`0.1-draft.9`**, pinned as the `spec/` submodule. This is an alpha, so the API will change along with the draft. The reference world, [awp-sim](https://github.com/Hyperduality/awp-sim), is a separate package built on this one.
+It targets specification revision **`0.1-draft.10`**, pinned as the `spec/` submodule. This is an alpha, so the API will change along with the draft. The reference world, [awp-sim](https://github.com/Hyperduality/awp-sim), is a separate package built on this one.
 
 ## Status
 
-![AWP: Core Agent, AWP-conformant against 0.1-draft.9](https://img.shields.io/badge/AWP-Core_Agent%2C_conformant_0.1--draft.9-555)
+![AWP: Core Agent, AWP-conformant against 0.1-draft.10](https://img.shields.io/badge/AWP-Core_Agent%2C_conformant_0.1--draft.10-555)
 
-In both time models, the demo agent built on the client is **Core Agent: AWP-conformant against 0.1-draft.9**. [awp-conformance](https://github.com/Hyperduality/awp-conformance) reports no failure and nothing untested, and [`conformance/`](conformance/README.md) holds the reports and the evidence for their manual rows.
+In both time models, the demo agent built on the client is **Core Agent: AWP-conformant against 0.1-draft.10**. [awp-conformance](https://github.com/Hyperduality/awp-conformance) reports no failure and nothing untested, and [`conformance/`](conformance/README.md) holds the reports and the evidence for their manual rows.
 
 Implemented:
 
@@ -108,7 +108,7 @@ src/awp/            client protocol layer (sans-IO), asyncio adapter, frame code
 src/awp/_spec/      schemas and lifecycle table bundled from spec/ (scripts/sync_spec.py)
 tests/              unit tests, and a scripted world that serves over WebSockets
 conformance/        conformance reports, the manifests they were run against, and evidence
-spec/               agent-world-protocol, pinned at spec-v0.1-draft.9
+spec/               agent-world-protocol, pinned at spec-v0.1-draft.10
 ```
 
 ## Development

{awp_python-0.1.0a5 → awp_python-0.1.0a6}/README.md

@@ -2,13 +2,13 @@
 
 The Python agent SDK for the [Agent World Protocol](https://www.agentworldprotocol.com). `ClientConnection` is the agent side of AWP as a sans-IO state machine, and `awp.aio.AsyncClient` drives it over a WebSocket.
 
-It targets specification revision **`0.1-draft.9`**, pinned as the `spec/` submodule. This is an alpha, so the API will change along with the draft. The reference world, [awp-sim](https://github.com/Hyperduality/awp-sim), is a separate package built on this one.
+It targets specification revision **`0.1-draft.10`**, pinned as the `spec/` submodule. This is an alpha, so the API will change along with the draft. The reference world, [awp-sim](https://github.com/Hyperduality/awp-sim), is a separate package built on this one.
 
 ## Status
 
-![AWP: Core Agent, AWP-conformant against 0.1-draft.9](https://img.shields.io/badge/AWP-Core_Agent%2C_conformant_0.1--draft.9-555)
+![AWP: Core Agent, AWP-conformant against 0.1-draft.10](https://img.shields.io/badge/AWP-Core_Agent%2C_conformant_0.1--draft.10-555)
 
-In both time models, the demo agent built on the client is **Core Agent: AWP-conformant against 0.1-draft.9**. [awp-conformance](https://github.com/Hyperduality/awp-conformance) reports no failure and nothing untested, and [`conformance/`](conformance/README.md) holds the reports and the evidence for their manual rows.
+In both time models, the demo agent built on the client is **Core Agent: AWP-conformant against 0.1-draft.10**. [awp-conformance](https://github.com/Hyperduality/awp-conformance) reports no failure and nothing untested, and [`conformance/`](conformance/README.md) holds the reports and the evidence for their manual rows.
 
 Implemented:
 
@@ -87,7 +87,7 @@ src/awp/            client protocol layer (sans-IO), asyncio adapter, frame code
 src/awp/_spec/      schemas and lifecycle table bundled from spec/ (scripts/sync_spec.py)
 tests/              unit tests, and a scripted world that serves over WebSockets
 conformance/        conformance reports, the manifests they were run against, and evidence
-spec/               agent-world-protocol, pinned at spec-v0.1-draft.9
+spec/               agent-world-protocol, pinned at spec-v0.1-draft.10
 ```
 
 ## Development

{awp_python-0.1.0a5 → awp_python-0.1.0a6}/conformance/README.md

@@ -1,13 +1,13 @@
 # Conformance
 
-![AWP: Core Agent, AWP-conformant against 0.1-draft.9](https://img.shields.io/badge/AWP-Core_Agent%2C_conformant_0.1--draft.9-555)
+![AWP: Core Agent, AWP-conformant against 0.1-draft.10](https://img.shields.io/badge/AWP-Core_Agent%2C_conformant_0.1--draft.10-555)
 
 | Class | Configuration | Claim | Report |
 |---|---|---|---|
-| Core Agent | `awp-demo`, [`manifest-lockstep.json`](manifest-lockstep.json) | Core Agent (lockstep): AWP-conformant against 0.1-draft.9 (awp-conformance 0.1.0a6) | [`core-agent-lockstep.json`](core-agent-lockstep.json) |
-| Core Agent | `awp-demo`, [`manifest-streaming.json`](manifest-streaming.json) | Core Agent (streaming): AWP-conformant against 0.1-draft.9 (awp-conformance 0.1.0a6) | [`core-agent-streaming.json`](core-agent-streaming.json) |
+| Core Agent | `awp-demo`, [`manifest-lockstep.json`](manifest-lockstep.json) | Core Agent (lockstep): AWP-conformant against 0.1-draft.10 (awp-conformance 0.1.0a7) | [`core-agent-lockstep.json`](core-agent-lockstep.json) |
+| Core Agent | `awp-demo`, [`manifest-streaming.json`](manifest-streaming.json) | Core Agent (streaming): AWP-conformant against 0.1-draft.10 (awp-conformance 0.1.0a7) | [`core-agent-streaming.json`](core-agent-streaming.json) |
 
-The reports come from awp-conformance 0.1.0a6 run against awp-python 0.1.0a5. Neither has a failure or anything untested. The evidence for their `manual` rows is below (AWP-CNF-005).
+The reports come from awp-conformance 0.1.0a7 run against awp-python 0.1.0a6. Neither has a failure or anything untested. The evidence for their `manual` rows is below (AWP-CNF-005).
 
 ## Reproduce
 
@@ -38,7 +38,7 @@ In streaming, the suite reads the agent's loss accounting from its `obs.report`.
 
 ### AWP-DAT-008: frame test vectors
 
-`test_vectors` (`tests/test_frames.py`) runs `awp.frames` over every vector in `schemas/test-vectors/frames.json` of the `spec/` submodule, which is pinned at `spec-v0.1-draft.9`:
+`test_vectors` (`tests/test_frames.py`) runs `awp.frames` over every vector in `schemas/test-vectors/frames.json` of the `spec/` submodule, which is pinned at `spec-v0.1-draft.10`:
 
 - the 10 valid vectors decode to their listed fields;
 - the 10 marked `expect_error` are rejected with their listed error.
@@ -47,7 +47,7 @@ In streaming, the suite reads the agent's loss accounting from its `obs.report`.
 
 ### AWP-VER-009: the draft revision is named
 
-- The [README](../README.md) and the [Python SDK page](https://www.agentworldprotocol.com/sdks/python) name `0.1-draft.9`.
-- `awp.SPEC_REVISION` is `"0.1-draft.9"`.
-- The `spec/` submodule is pinned at the tag `spec-v0.1-draft.9`.
-- Each report records `"specification": "0.1-draft.9"`, and its claim names the revision.
+- The [README](../README.md) and the [Python SDK page](https://www.agentworldprotocol.com/sdks/python) name `0.1-draft.10`.
+- `awp.SPEC_REVISION` is `"0.1-draft.10"`.
+- The `spec/` submodule is pinned at the tag `spec-v0.1-draft.10`.
+- Each report records `"specification": "0.1-draft.10"`, and its claim names the revision.

{awp_python-0.1.0a5 → awp_python-0.1.0a6}/conformance/core-agent-lockstep.json

@@ -1,15 +1,15 @@
 {
   "suite": {
     "name": "awp-conformance",
-    "version": "0.1.0a6"
+    "version": "0.1.0a7"
   },
-  "specification": "0.1-draft.9",
+  "specification": "0.1-draft.10",
   "target": "awp-demo --url {url} --token {token}",
   "side": "agent",
-  "generated": "2026-09-26T18:45:07Z",
+  "generated": "2026-09-26T22:32:00Z",
   "claim": {
     "status": "conformant",
-    "wording": "Core Agent (lockstep): AWP-conformant against 0.1-draft.9 (awp-conformance 0.1.0a6)",
+    "wording": "Core Agent (lockstep): AWP-conformant against 0.1-draft.10 (awp-conformance 0.1.0a7)",
     "classes": [
       "Core Agent"
     ],
@@ -26,7 +26,7 @@
     ],
     "counts": {
       "manual": 4,
-      "n/a": 193,
+      "n/a": 197,
       "pass": 37,
       "untestable": 3
     }
@@ -108,7 +108,7 @@
       "id": "AWP-AGT-001",
       "level": "MUST",
       "outcome": "pass",
-      "detail": "124 check(s): lockstep/baseline, lockstep/integer-range, lockstep/invalid-manifest, lockstep/malformed-frame, lockstep/no-action-grants, lockstep/reconnect, lockstep/refused-submission, lockstep/restarted-world, lockstep/silent-world"
+      "detail": "123 check(s): lockstep/baseline, lockstep/integer-range, lockstep/invalid-manifest, lockstep/malformed-frame, lockstep/no-action-grants, lockstep/reconnect, lockstep/refused-submission, lockstep/restarted-world, lockstep/silent-world"
     },
     {
       "id": "AWP-AGT-002",
@@ -138,7 +138,7 @@
       "id": "AWP-AGT-006",
       "level": "MUST",
       "outcome": "pass",
-      "detail": "24 check(s): lockstep/baseline, lockstep/integer-range, lockstep/malformed-frame, lockstep/reconnect, lockstep/restarted-world, lockstep/silent-world"
+      "detail": "23 check(s): lockstep/baseline, lockstep/integer-range, lockstep/malformed-frame, lockstep/reconnect, lockstep/restarted-world, lockstep/silent-world"
     },
     {
       "id": "AWP-AGT-007",
@@ -356,6 +356,12 @@
       "outcome": "n/a",
       "detail": "world-side requirement"
     },
+    {
+      "id": "AWP-CMD-009",
+      "level": "SHOULD",
+      "outcome": "n/a",
+      "detail": "world-side requirement"
+    },
     {
       "id": "AWP-CNF-001",
       "level": "MUST",
@@ -396,7 +402,7 @@
       "id": "AWP-CTL-001",
       "level": "MUST",
       "outcome": "pass",
-      "detail": "125 check(s): lockstep/baseline, lockstep/integer-range, lockstep/invalid-manifest, lockstep/malformed-frame, lockstep/no-action-grants, lockstep/reconnect, lockstep/refused-submission, lockstep/restarted-world, lockstep/silent-world"
+      "detail": "124 check(s): lockstep/baseline, lockstep/integer-range, lockstep/invalid-manifest, lockstep/malformed-frame, lockstep/no-action-grants, lockstep/reconnect, lockstep/refused-submission, lockstep/restarted-world, lockstep/silent-world"
     },
     {
       "id": "AWP-CTL-002",
@@ -426,7 +432,7 @@
       "id": "AWP-CTL-006",
       "level": "MUST",
       "outcome": "pass",
-      "detail": "125 check(s): lockstep/baseline, lockstep/integer-range, lockstep/invalid-manifest, lockstep/malformed-frame, lockstep/no-action-grants, lockstep/reconnect, lockstep/refused-submission, lockstep/restarted-world, lockstep/silent-world"
+      "detail": "124 check(s): lockstep/baseline, lockstep/integer-range, lockstep/invalid-manifest, lockstep/malformed-frame, lockstep/no-action-grants, lockstep/reconnect, lockstep/refused-submission, lockstep/restarted-world, lockstep/silent-world"
     },
     {
       "id": "AWP-CTL-007",
@@ -444,7 +450,7 @@
       "id": "AWP-CTL-009",
       "level": "MUST",
       "outcome": "pass",
-      "detail": "127 check(s): lockstep/baseline, lockstep/integer-range, lockstep/invalid-manifest, lockstep/malformed-frame, lockstep/no-action-grants, lockstep/reconnect, lockstep/refused-submission, lockstep/restarted-world, lockstep/silent-world"
+      "detail": "126 check(s): lockstep/baseline, lockstep/integer-range, lockstep/invalid-manifest, lockstep/malformed-frame, lockstep/no-action-grants, lockstep/reconnect, lockstep/refused-submission, lockstep/restarted-world, lockstep/silent-world"
     },
     {
       "id": "AWP-CTL-010",
@@ -596,6 +602,12 @@
       "outcome": "n/a",
       "detail": "world-side requirement"
     },
+    {
+      "id": "AWP-EVT-004",
+      "level": "MUST",
+      "outcome": "n/a",
+      "detail": "world-side requirement"
+    },
     {
       "id": "AWP-GUI-001",
       "level": "MUST",
@@ -980,6 +992,12 @@
       "outcome": "n/a",
       "detail": "world-side requirement"
     },
+    {
+      "id": "AWP-ROB-008",
+      "level": "SHOULD",
+      "outcome": "n/a",
+      "detail": "world-side requirement"
+    },
     {
       "id": "AWP-SAF-001",
       "level": "MUST",
@@ -1206,7 +1224,7 @@
       "id": "AWP-TIM-003",
       "level": "MUST",
       "outcome": "pass",
-      "detail": "6 check(s): lockstep/baseline, lockstep/reconnect, lockstep/restarted-world"
+      "detail": "7 check(s): lockstep/baseline, lockstep/malformed-frame, lockstep/reconnect, lockstep/restarted-world"
     },
     {
       "id": "AWP-TIM-004",
@@ -1268,6 +1286,12 @@
       "outcome": "n/a",
       "detail": "world-side requirement"
     },
+    {
+      "id": "AWP-TIM-014",
+      "level": "MUST",
+      "outcome": "n/a",
+      "detail": "world-side requirement"
+    },
     {
       "id": "AWP-TRN-001",
       "level": "MUST",
@@ -1422,7 +1446,7 @@
       "id": "AWP-VER-004",
       "level": "MUST",
       "outcome": "pass",
-      "detail": "111 check(s): lockstep/baseline, lockstep/integer-range, lockstep/invalid-manifest, lockstep/malformed-frame, lockstep/no-action-grants, lockstep/reconnect, lockstep/refused-submission, lockstep/restarted-world, lockstep/silent-world"
+      "detail": "110 check(s): lockstep/baseline, lockstep/integer-range, lockstep/invalid-manifest, lockstep/malformed-frame, lockstep/no-action-grants, lockstep/reconnect, lockstep/refused-submission, lockstep/restarted-world, lockstep/silent-world"
     },
     {
       "id": "AWP-VER-005",

{awp_python-0.1.0a5 → awp_python-0.1.0a6}/conformance/core-agent-streaming.json

@@ -1,15 +1,15 @@
 {
   "suite": {
     "name": "awp-conformance",
-    "version": "0.1.0a6"
+    "version": "0.1.0a7"
   },
-  "specification": "0.1-draft.9",
+  "specification": "0.1-draft.10",
   "target": "awp-demo --url {url} --token {token}",
   "side": "agent",
-  "generated": "2026-09-26T18:45:09Z",
+  "generated": "2026-09-26T22:32:02Z",
   "claim": {
     "status": "conformant",
-    "wording": "Core Agent (streaming): AWP-conformant against 0.1-draft.9 (awp-conformance 0.1.0a6)",
+    "wording": "Core Agent (streaming): AWP-conformant against 0.1-draft.10 (awp-conformance 0.1.0a7)",
     "classes": [
       "Core Agent"
     ],
@@ -24,7 +24,7 @@
     ],
     "counts": {
       "manual": 2,
-      "n/a": 187,
+      "n/a": 191,
       "pass": 45,
       "untestable": 3
     }
@@ -354,6 +354,12 @@
       "outcome": "n/a",
       "detail": "world-side requirement"
     },
+    {
+      "id": "AWP-CMD-009",
+      "level": "SHOULD",
+      "outcome": "n/a",
+      "detail": "world-side requirement"
+    },
     {
       "id": "AWP-CNF-001",
       "level": "MUST",
@@ -594,6 +600,12 @@
       "outcome": "n/a",
       "detail": "world-side requirement"
     },
+    {
+      "id": "AWP-EVT-004",
+      "level": "MUST",
+      "outcome": "n/a",
+      "detail": "world-side requirement"
+    },
     {
       "id": "AWP-GUI-001",
       "level": "MUST",
@@ -978,6 +990,12 @@
       "outcome": "n/a",
       "detail": "world-side requirement"
     },
+    {
+      "id": "AWP-ROB-008",
+      "level": "SHOULD",
+      "outcome": "n/a",
+      "detail": "world-side requirement"
+    },
     {
       "id": "AWP-SAF-001",
       "level": "MUST",
@@ -1266,6 +1284,12 @@
       "outcome": "n/a",
       "detail": "world-side requirement"
     },
+    {
+      "id": "AWP-TIM-014",
+      "level": "MUST",
+      "outcome": "n/a",
+      "detail": "world-side requirement"
+    },
     {
       "id": "AWP-TRN-001",
       "level": "MUST",

{awp_python-0.1.0a5 → awp_python-0.1.0a6}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "awp-python"
-version = "0.1.0a5"
+version = "0.1.0a6"
 description = "Agent World Protocol agent SDK for Python."
 readme = "README.md"
 license = "Apache-2.0"

{awp_python-0.1.0a5 → awp_python-0.1.0a6}/src/awp/__init__.py

@@ -28,7 +28,7 @@ from .errors import AwpError, ErrorCode, ProtocolError
 from .frames import Frame
 from .lifecycle import ActionState
 
-SPEC_REVISION = "0.1-draft.9"
+SPEC_REVISION = "0.1-draft.10"
 PROTOCOL_VERSION = "0.1"
 
 try:

{awp_python-0.1.0a5 → awp_python-0.1.0a6}/src/awp/client.py

@@ -772,6 +772,9 @@ class ClientConnection:
             self._apply_status(params, events)
         elif method == "world.event":
             if self._sequence(params["status_seq"], events):
+                if params["event"] == "embodiment_transferred":
+                    moved = (params.get("detail") or {}).get("embodiment")
+                    self.embodiments = [e for e in self.embodiments if e != moved]  # AWP-EMB-003
                 events.append(WorldEvent(params["event"], params, self._replaying(params)))
         elif method == "session.state" and self._sequence(params["status_seq"], events):
             self.session_state = params["state"]

{awp_python-0.1.0a5 → awp_python-0.1.0a6}/tests/test_client.py

@@ -85,3 +85,16 @@ def test_the_clock_maps_both_ways_through_the_best_sample():
     clock.add(sample(100, 1_050, 1_050, 150))  # rtt 50: the one to trust
     assert (clock.offset_ns, clock.error_bound_ns) == (925, 25)
     assert clock.to_agent(clock.to_session(7_000)) == 7_000
+
+
+def test_a_transferred_embodiment_is_no_longer_bound():
+    conn = ClientConnection(AGENT, MODALITIES, clock_ns=lambda: 0)
+    conn.receive(jsonrpc.result(conn.initialize(), manifest("streaming")))
+    rid = conn.open_session("streaming", embodiments=["arm_01", "gripper_01"])
+    conn.receive(jsonrpc.result(rid, ready("streaming", conn.outgoing()[-1]["params"])))
+    seq = conn.last_status_seq + 1
+    event = {"event": "embodiment_transferred", "status_seq": seq, "ts_mono_ns": 1}
+    event["detail"] = {"embodiment": "arm_01"}
+    conn.receive(jsonrpc.notification("world.event", event))
+    assert conn.embodiments == ["gripper_01"]  # AWP-EMB-003
+    conn.submit("stop", {})  # one embodiment left: embodiment_id may be left out

{awp_python-0.1.0a5 → awp_python-0.1.0a6}/uv.lock

@@ -81,7 +81,7 @@ wheels = [
 
 [[package]]
 name = "awp-python"
-version = "0.1.0a5"
+version = "0.1.0a6"
 source = { editable = "." }
 dependencies = [
     { name = "jsonschema" },