feat(phonic): export LiveKit tools for the Responses API

livekit-plugins/livekit-plugins-phonic/README.md

@@ -77,6 +77,20 @@ cd examples
 uv run voice_agents/phonic_realtime_agent.py dev
 ```
 
+### Reusing tools with Phonic Responses
+
+Convert an existing LiveKit `ToolContext` into the schema-only definitions
+accepted by Phonic's Responses API:
+
+```python
+from livekit.plugins.phonic.realtime import to_phonic_tool_definitions
+
+tool_definitions = to_phonic_tool_definitions(tool_context)
+```
+
+The executable functions remain in the `ToolContext`; only their names,
+descriptions, and parameter schemas are returned.
+
 ## Configuration
 
 Set the `PHONIC_API_KEY` environment variable, or pass `api_key` directly to `RealtimeModel`. All other options are optional.

livekit-plugins/livekit-plugins-phonic/livekit/plugins/phonic/realtime/__init__.py

@@ -6,6 +6,7 @@
     PronunciationEntry,
     RealtimeModel,
     RealtimeSession,
+    to_phonic_tool_definitions,
 )
 
 __all__ = [
@@ -16,4 +17,5 @@
     "PronunciationEntry",
     "RealtimeModel",
     "RealtimeSession",
+    "to_phonic_tool_definitions",
 ]

livekit-plugins/livekit-plugins-phonic/livekit/plugins/phonic/realtime/realtime_model.py

@@ -26,6 +26,7 @@
     AsyncConversationsSocketClient,
 )
 from phonic.core import RequestOptions
+from phonic.requests import ResponsesToolDefinitionParams
 from phonic.types import (
     AddSystemMessagePayload,
     AudioChunkPayload,
@@ -99,6 +100,32 @@ class ConfigurationEndpoint(TypedDict, total=False):
     timeout_ms: int
 
 
+def _to_phonic_tool_definition(
+    tool_schema: dict[str, typing.Any],
+) -> ResponsesToolDefinitionParams:
+    function = tool_schema["function"]
+    return {
+        "name": function["name"],
+        "description": function.get("description") or "",
+        "parameters": function["parameters"],
+    }
+
+
+def to_phonic_tool_definitions(
+    tool_context: llm.ToolContext,
+) -> list[ResponsesToolDefinitionParams]:
+    """Convert LiveKit function tools to Phonic Responses API definitions.
+
+    The returned values contain schemas only; the executable callables remain in
+    ``tool_context`` for the caller to invoke when Phonic returns a tool call.
+    """
+
+    return [
+        _to_phonic_tool_definition(tool_schema)
+        for tool_schema in tool_context.parse_function_tools("openai", strict=True)
+    ]
+
+
 @dataclass
 class _RealtimeOptions:
     api_key: str

livekit-plugins/livekit-plugins-phonic/pyproject.toml

@@ -25,7 +25,7 @@ dependencies = [
     "livekit-agents>=1.7.1",
     "websockets>=11.0",
     "aiohttp>=3.8.0",
-    "phonic>=0.32.22"
+    "phonic>=0.32.27"
 ]
 
 [project.urls]

livekit-plugins/livekit-plugins-phonic/tests/test_tool_definitions.py

@@ -0,0 +1,41 @@
+import pytest
+
+from livekit.agents import llm
+from livekit.plugins.phonic.realtime import to_phonic_tool_definitions
+
+pytestmark = pytest.mark.unit
+
+
+def test_to_phonic_tool_definitions() -> None:
+    @llm.function_tool(
+        name="search_pizza_shop_recs",
+        description="Search for pizza shop recommendations in a location.",
+    )
+    async def search_pizza_shop_recs(location: str) -> str:
+        return location
+
+    definitions = to_phonic_tool_definitions(llm.ToolContext([search_pizza_shop_recs]))
+
+    assert definitions == [
+        {
+            "name": "search_pizza_shop_recs",
+            "description": "Search for pizza shop recommendations in a location.",
+            "parameters": {
+                "type": "object",
+                "properties": {"location": {"type": "string"}},
+                "required": ["location"],
+                "additionalProperties": False,
+            },
+        }
+    ]
+
+
+def test_to_phonic_tool_definitions_allows_no_description() -> None:
+    @llm.function_tool(name="search_pizza_shop_recs")
+    async def search_pizza_shop_recs() -> None:
+        pass
+
+    assert (
+        to_phonic_tool_definitions(llm.ToolContext([search_pizza_shop_recs]))[0]["description"]
+        == ""
+    )