harness-sdk-python 0.30.0__tar.gz → 0.30.1__tar.gz

{harness_sdk_python-0.30.0 → harness_sdk_python-0.30.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: harness-sdk-python
-Version: 0.30.0
+Version: 0.30.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.30.0 → harness_sdk_python-0.30.1}/pyproject.toml

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

{harness_sdk_python-0.30.0 → harness_sdk_python-0.30.1}/src/harness_sdk/voice.py

@@ -10,7 +10,7 @@ and the turn commit both stay host-owned.
 ``voice/start {offer, tools?}`` seeds the provider from the thread
 transcript (at most 128 messages, tail taken), hands the client's frontend
 function tool definitions to the provider, and projects ``state["voice"] =
-{clientId, status, toolCalls}`` — the SDP answer rides only the command's
+{clientId, status, toolCalls, activeTask}`` — the SDP answer rides only the command's
 result payload ``{answer}``. A named call matching a client-declared tool
 projects into ``toolCalls`` as ``{callId, name, arguments}``; the owning
 client answers it with ``voice/temp-frontend-tool-result {call_id,
@@ -33,7 +33,8 @@ transcript handoff — the first task the conversation so far, follow-ups the
 turns since the previous task. Interim ``speak`` text and the returned
 result flow back as speakable context appends; a named call's result
 returns via ``provider.return_tool_result``; a failed handler surfaces to
-the model as commentary (task) or an error output (call).
+the model as commentary (task) or an error output (call). The running unit
+projects as ``activeTask`` = ``{taskId, text}``, ``None`` at rest.
 
 Rejections: ``voice-active`` (a session is already live), ``no-voice``
 (no voice manager declared, or ``voice/end`` with no session),
@@ -111,12 +112,14 @@ class VoiceManager(Tray):
     clientId = observable(None)
     status = observable("connecting")
     toolCalls = observable([])
+    activeTask = observable(None)
 
     state = observable(
         {
             "clientId": clientId,
             "status": status,
             "toolCalls": toolCalls,
+            "activeTask": activeTask,
         }
     )
 
@@ -382,6 +385,7 @@ class VoiceManager(Tray):
                 follow_up=self._tasks_run > 0,
             )
             self._tasks_run += 1
+            self.activeTask.value = {"taskId": task_id, "text": text}
             try:
                 answer = await self._host.handle_voice_task(task, speak=self._speak)
                 if not isinstance(answer, str) or answer == "":
@@ -395,6 +399,8 @@ class VoiceManager(Tray):
                     channel="commentary",
                 )
                 return
+            finally:
+                self.activeTask.value = None
             await self._append(answer, channel="speakable")
 
     def tool_requested(self, request: "VoiceManager.ToolRequest") -> None:
@@ -427,6 +433,7 @@ class VoiceManager(Tray):
         ]
 
     async def _run_tool_call(self, request: "VoiceManager.ToolRequest") -> None:
+        self.activeTask.value = {"taskId": request.call_id, "text": request.name}
         try:
             output = await self._host.handle_voice_task(request, speak=self._speak)
             if not isinstance(output, str):
@@ -438,6 +445,8 @@ class VoiceManager(Tray):
                 "voice session %r tool call %r failed", self.id, request.call_id
             )
             output = json.dumps({"error": f"{type(exc).__name__}: {exc}"})
+        finally:
+            self.activeTask.value = None
         provider = self._provider
         if provider is not None:
             await provider.return_tool_result(request.call_id, output)

{harness_sdk_python-0.30.0 → harness_sdk_python-0.30.1}/tests/test_voice.py

@@ -39,7 +39,12 @@ 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", "toolCalls": []}
+        assert voice == {
+            "clientId": drv.client_id,
+            "status": "live",
+            "toolCalls": [],
+            "activeTask": None,
+        }
         assert bench.contexts[0].client_id == drv.client_id
 
 

{harness_sdk_python-0.30.0 → harness_sdk_python-0.30.1}/tests/test_voice_delegation.py

@@ -1,12 +1,12 @@
 """Voice delegation contract: work units route to ``Host.handle_voice_task``,
 handoffs drain the transcript incrementally, results flow back as speakable
-context appends, named calls answer via ``return_tool_result``, and repeated
-request ids run once."""
+context appends, named calls answer via ``return_tool_result``, repeated
+request ids run once, and the running unit projects as ``activeTask``."""
 
 import asyncio
 import json
 
-from voice_helpers import OFFER, Bench, voice_host
+from voice_helpers import OFFER, Bench, voice_host, voice_of
 
 from harness_sdk import VoiceManager
 
@@ -142,6 +142,66 @@ async def test_task_failure_surfaces_as_commentary():
         ]
 
 
+async def test_active_task_projects_while_a_task_runs_and_clears_after():
+    bench = Bench()
+    gate = asyncio.Event()
+
+    async def handler(task, speak):
+        await gate.wait()
+        return "all done"
+
+    bench.task_handler = handler
+    async with voice_host(bench) as (drv, _app):
+        await drv.command("voice/start", {"offer": OFFER})
+        bench.events().task_requested("d1", "check the weather")
+        await drv.wait(
+            lambda s: (voice_of(s) or {}).get("activeTask")
+            == {"taskId": "d1", "text": "check the weather"}
+        )
+        gate.set()
+        await drv.wait(lambda s: (voice_of(s) or {}).get("activeTask") is None)
+
+
+async def test_active_task_projects_a_named_call_and_clears_after():
+    bench = Bench()
+    gate = asyncio.Event()
+
+    async def handler(task, speak):
+        await gate.wait()
+        return "{}"
+
+    bench.task_handler = handler
+    async with voice_host(bench) as (drv, _app):
+        await drv.command("voice/start", {"offer": OFFER})
+        bench.events().tool_requested(
+            VoiceManager.ToolRequest(call_id="c1", name="get_time", arguments="{}")
+        )
+        await drv.wait(
+            lambda s: (voice_of(s) or {}).get("activeTask")
+            == {"taskId": "c1", "text": "get_time"}
+        )
+        gate.set()
+        await drv.wait(lambda s: (voice_of(s) or {}).get("activeTask") is None)
+
+
+async def test_active_task_clears_when_the_handler_fails():
+    bench = Bench()
+    gate = asyncio.Event()
+
+    async def handler(task, speak):
+        await gate.wait()
+        raise RuntimeError("boom")
+
+    bench.task_handler = handler
+    async with voice_host(bench) as (drv, _app):
+        await drv.command("voice/start", {"offer": OFFER})
+        bench.events().task_requested("d1", "dig in")
+        await drv.wait(lambda s: (voice_of(s) or {}).get("activeTask") is not None)
+        gate.set()
+        await drv.wait(lambda s: (voice_of(s) or {}).get("activeTask") is None)
+        assert (voice_of(drv.replica) or {}).get("status") == "live"
+
+
 async def test_tool_failure_returns_an_error_output():
     bench = Bench()