harness-sdk-python 0.28.0__tar.gz → 0.29.1__tar.gz

{harness_sdk_python-0.28.0 → harness_sdk_python-0.29.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: harness-sdk-python
-Version: 0.28.0
+Version: 0.29.1
 Summary: RunManager: the harness-sdk runs subsystem for Python Statewire hosts
 Project-URL: Repository, https://github.com/assistant-ui/harness-sdk
 License-Expression: MIT

{harness_sdk_python-0.28.0 → harness_sdk_python-0.29.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "harness-sdk-python"
-version = "0.28.0"
+version = "0.29.1"
 description = "RunManager: the harness-sdk runs subsystem for Python Statewire hosts"
 readme = "README.md"
 license = "MIT"

{harness_sdk_python-0.28.0 → harness_sdk_python-0.29.1}/src/harness_sdk/deepagents.py

@@ -1,7 +1,8 @@
 """DeepagentsMessages: the ``messages`` slice of a Statewire host, projected
 from a langgraph checkpointer in the deepagents dialect. The checkpointer is
 the source of truth and the wire state is its projection, restamped with
-``branch: {id, siblings}`` metadata after every ingest. A rewind restores the
+``branch: {id, siblings}`` metadata after every ingest; ephemeral overlay
+entries carry ``ephemeral: true`` instead. A rewind restores the
 projection from the target message's anchor checkpoint; a branch switch clones
 the target branch's tip as the checkpointer's latest checkpoint, so resumption
 and reboot both land on the switched world.
@@ -243,7 +244,7 @@ class DeepagentsMessages:
         return snapshot
 
     def upsert_ephemeral_message(self, message: dict[str, Any]) -> None:
-        """Render an in-flight ``{id, role, text}`` entry in ``state["messages"]``; an ``append_messages`` of the same id replaces it durably."""
+        """Render an in-flight ``{id, role, text}`` entry in ``state["messages"]`` tagged ``ephemeral: true``; an ``append_messages`` of the same id replaces it durably."""
         if message["role"] not in ("user", "assistant"):
             raise ValueError(f"unsupported message role: {message['role']!r}")
         if message["id"] not in self._ephemeral and any(
@@ -280,6 +281,8 @@ class DeepagentsMessages:
             stamped.append({**message, "branch": {"id": branch, "siblings": siblings}})
         durable = {message["id"] for message in stamped}
         stamped.extend(
-            entry for id_, entry in self._ephemeral.items() if id_ not in durable
+            {**entry, "ephemeral": True}
+            for id_, entry in self._ephemeral.items()
+            if id_ not in durable
         )
         self._replace(stamped)

{harness_sdk_python-0.28.0 → harness_sdk_python-0.29.1}/src/harness_sdk/voice.py

@@ -9,11 +9,12 @@ and the turn commit both stay host-owned.
 
 ``voice/start {offer}`` seeds the provider from the thread transcript (at
 most 128 messages, tail taken) and projects ``state["voice"] = {clientId,
-status, answer}`` — the SDP answer rides the applied state. The session is
-bound to the issuing client's connection: ``voice/end`` from the owner, a
+status}`` — the SDP answer rides only the command's result payload
+``{answer}``. The session is bound to the issuing client's connection: ``voice/end`` from the owner, a
 provider ``closed`` event, or a connection drop ends it. Provider turn
 events render live in ``state["messages"]`` through
-``Host.upsert_ephemeral_message`` (message id = turn id); each completed
+``Host.upsert_ephemeral_message`` (message id = turn id), tagged
+``ephemeral: true`` on the wire; each completed
 turn commits through ``Host.commit_voice_turns`` (serialized, in
 done-order) and the durable entry replaces the ephemeral one under the
 same id, a failed commit keeps its turns for the next flush; session end
@@ -69,13 +70,11 @@ class VoiceManager(Tray):
 
     clientId = observable(None)
     status = observable("connecting")
-    answer = observable(None)
 
     state = observable(
         {
             "clientId": clientId,
             "status": status,
-            "answer": answer,
         }
     )
 
@@ -161,7 +160,6 @@ class VoiceManager(Tray):
             self.delete()
             raise _reject("voice-unavailable", f"voice session failed to start: {exc}")
         self._provider = provider
-        self.answer.value = answer
         self.status.value = "live"
         applied()
         self._watcher = self._spawn(self._watch(caller))

{harness_sdk_python-0.28.0 → harness_sdk_python-0.29.1}/tests/test_deepagents_messages.py

@@ -170,10 +170,16 @@ async def test_ingest_turn_refetch_discards_the_capture():
 async def test_ephemeral_message_renders_and_updates_in_place():
     _, _, _, messages, state = await seeded()
     messages.upsert_ephemeral_message({"id": "v1", "role": "user", "text": "hel"})
-    assert state["messages"][-1] == {"id": "v1", "type": "human", "content": "hel"}
+    assert state["messages"][-1] == {
+        "id": "v1",
+        "type": "human",
+        "content": "hel",
+        "ephemeral": True,
+    }
     messages.upsert_ephemeral_message({"id": "v1", "role": "user", "text": "hello"})
     assert ids(state) == ["u1", "a0", "u2", "a1", "v1"]
     assert state["messages"][-1]["content"] == "hello"
+    assert all("ephemeral" not in m for m in state["messages"][:-1])
 
 
 async def test_ephemeral_message_survives_a_turn_ingest():
@@ -181,7 +187,12 @@ async def test_ephemeral_message_survives_a_turn_ingest():
     messages.upsert_ephemeral_message({"id": "v1", "role": "assistant", "text": "hi"})
     await turn(graph, messages, Ctx("message-send", (user("u3", "three"),)))
     assert ids(state) == ["u1", "a0", "u2", "a1", "u3", "a2", "v1"]
-    assert state["messages"][-1] == {"id": "v1", "type": "ai", "content": "hi"}
+    assert state["messages"][-1] == {
+        "id": "v1",
+        "type": "ai",
+        "content": "hi",
+        "ephemeral": True,
+    }
 
 
 async def test_append_messages_replaces_the_ephemeral_entry_durably():
@@ -190,6 +201,7 @@ async def test_append_messages_replaces_the_ephemeral_entry_durably():
     await messages.append_messages([{"id": "v1", "role": "user", "text": "spoken"}])
     assert ids(state) == ["u1", "a0", "u2", "a1", "v1"]
     assert "branch" in state["messages"][-1]
+    assert "ephemeral" not in state["messages"][-1]
     messages.drop_ephemeral_message("v1")
     assert ids(state) == ["u1", "a0", "u2", "a1", "v1"]
 

{harness_sdk_python-0.28.0 → harness_sdk_python-0.29.1}/tests/test_voice.py

@@ -39,11 +39,7 @@ async def test_start_seeds_provider_and_projects_session():
         assert bench.provider.calls == [("start", OFFER, bench.transcript)]
         await drv.wait(lambda s: (voice_of(s) or {}).get("status") == "live")
         voice = voice_of(drv.replica)
-        assert voice == {
-            "clientId": drv.client_id,
-            "status": "live",
-            "answer": ANSWER,
-        }
+        assert voice == {"clientId": drv.client_id, "status": "live"}
         assert bench.contexts[0].client_id == drv.client_id
 
 
@@ -92,7 +88,14 @@ async def test_turn_streams_into_messages_ephemerally():
         events.turn_delta("t1", "there")
         await drv.wait(
             lambda s: messages_of(s)
-            == [{"id": "t1", "type": "human", "content": "hello there"}]
+            == [
+                {
+                    "id": "t1",
+                    "type": "human",
+                    "content": "hello there",
+                    "ephemeral": True,
+                }
+            ]
         )
         assert bench.commits == []
 
@@ -145,7 +148,14 @@ async def test_commit_failure_keeps_the_turn_until_the_next_flush():
         assert bench.commits == []
         await drv.wait(
             lambda s: messages_of(s)
-            == [{"id": "t1", "type": "human", "content": "question"}]
+            == [
+                {
+                    "id": "t1",
+                    "type": "human",
+                    "content": "question",
+                    "ephemeral": True,
+                }
+            ]
         )
         # session end retries the kept turn
         await drv.command("voice/end")

{harness_sdk_python-0.28.0 → harness_sdk_python-0.29.1}/tests/voice_helpers.py

@@ -83,7 +83,11 @@ def make_voice_host(bench: Bench, *, declare: bool = True):
             durable_ids = {m["id"] for m in self._durable}
             self.state["messages"] = [
                 *self._durable,
-                *(e for i, e in self._ephemeral.items() if i not in durable_ids),
+                *(
+                    {**e, "ephemeral": True}
+                    for i, e in self._ephemeral.items()
+                    if i not in durable_ids
+                ),
             ]
 
         async def get_voice_seed(self):