unmute-core 0.14.0__tar.gz

unmute_core-0.14.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 slng.ai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

unmute_core-0.14.0/PKG-INFO

@@ -0,0 +1,203 @@
+Metadata-Version: 2.4
+Name: unmute-core
+Version: 0.14.0
+Summary: Typed call state, tasks, tools, handoffs and tracing for voice agents on LiveKit and Pipecat
+Keywords: voice agents,livekit,pipecat,llm,telephony,opentelemetry
+Author: Nicola Croon
+Author-email: Nicola Croon <nicola@slng.ai>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Multimedia :: Sound/Audio :: Speech
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Typing :: Typed
+Requires-Dist: babel>=2.16,<3
+Requires-Dist: email-validator>=2.2,<3
+Requires-Dist: httpx>=0.28,<1
+Requires-Dist: jsonschema>=4.23,<5
+Requires-Dist: opentelemetry-exporter-otlp-proto-http>=1.40,<2
+Requires-Dist: opentelemetry-sdk>=1.40,<2
+Requires-Dist: phonenumbers>=8.13,<10
+Requires-Dist: pydantic>=2.11,<3
+Requires-Dist: pydantic-settings>=2.8,<3
+Requires-Dist: llama-index-core>=0.14,<0.15 ; extra == 'knowledge'
+Requires-Dist: llama-index-readers-file>=0.5,<0.8 ; extra == 'knowledge'
+Requires-Dist: llama-index-retrievers-bm25>=0.6,<0.9 ; extra == 'knowledge'
+Requires-Dist: livekit-agents>=1.8.7,<1.9 ; extra == 'livekit'
+Requires-Dist: pipecat-ai>=1.12.0,<1.13 ; extra == 'pipecat'
+Requires-Dist: openai>=1.109,<4 ; extra == 'slng'
+Requires-Python: >=3.12
+Project-URL: Repository, https://github.com/slng-ai/unmute-core
+Project-URL: Documentation, https://github.com/slng-ai/unmute-core/tree/main/docs
+Project-URL: Issues, https://github.com/slng-ai/unmute-core/issues
+Project-URL: Changelog, https://github.com/slng-ai/unmute-core/blob/main/CHANGELOG.md
+Provides-Extra: knowledge
+Provides-Extra: livekit
+Provides-Extra: pipecat
+Provides-Extra: slng
+Description-Content-Type: text/markdown
+
+# unmute-core
+
+[![PyPI](https://img.shields.io/pypi/v/unmute-core)](https://pypi.org/project/unmute-core/)
+[![Python](https://img.shields.io/pypi/pyversions/unmute-core)](https://pypi.org/project/unmute-core/)
+[![CI](https://github.com/slng-ai/unmute-core/actions/workflows/ci.yml/badge.svg)](https://github.com/slng-ai/unmute-core/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/pypi/l/unmute-core)](https://github.com/slng-ai/unmute-core/blob/main/LICENSE)
+
+unmute-core is a Python library for voice agents on [LiveKit Agents](https://github.com/livekit/agents) and [Pipecat](https://github.com/pipecat-ai/pipecat). You keep your framework, your speech and model plugins, and your pipeline. The library adds what a real phone or web call needs on top: typed call state, task steps, tools, handoffs, idle callers, transfers and tracing.
+
+[Unmute](https://github.com/slng-ai/unmute) compiles an agent spec into a LiveKit or Pipecat project. Those projects import this library. You can also use it in an agent you write by hand, one piece at a time or all of it.
+
+## Example
+
+A plain LiveKit agent with one tool from the library:
+
+```python
+import os
+
+from livekit.agents import Agent, AgentSession
+from livekit.plugins import openai, silero, slng
+from pydantic import BaseModel
+
+from unmute_core.livekit import function_tools
+from unmute_core.tools import ToolRegistry, local_tool
+
+
+class OrderStatus(BaseModel):
+    order_id: str
+    status: str
+
+
+def order_status(order_id: str) -> OrderStatus:
+    """Look up an order by its id. The return annotation is the result's checked shape."""
+    return OrderStatus(order_id=order_id, status="out for delivery")
+
+
+registry = ToolRegistry([local_tool(order_status, announce="One moment, let me check.")])
+
+agent = Agent(instructions="You help with orders.", tools=function_tools(registry))
+slng_host = f"{os.environ['SLNG_WORLD_PART']}.api.slng.ai"
+stt = slng.STT(slng_base_url=slng_host, model="soniox/speech-ai:rt-v5")
+session = AgentSession(
+    stt=stt,
+    llm=openai.LLM(),
+    tts=slng.TTS(
+        slng_base_url=slng_host,
+        model="slng/fish/tts:s2.1-pro",
+        voice="8d8aec63a56c460cb7def795bdf754fa",
+    ),
+    vad=silero.VAD.load(),
+)
+stt.attach_to_session(session)
+```
+
+The agent stays a normal LiveKit `Agent`. The library adds the tool and the line the agent says while the tool runs. Speech runs on SLNG: Soniox hears the caller and Fish Audio speaks, with your `SLNG_API_KEY`. On Pipecat, put `tools_schema(registry)` on the `LLMContext` instead.
+
+## How it fits
+
+```mermaid
+flowchart TD
+    U[Unmute compiles agent.yaml] --> P[Your LiveKit or Pipecat project]
+    H[You write agent.py by hand] --> P
+    P -->|builds the pipeline, calls| A[unmute_core.livekit or unmute_core.pipecat]
+    A --> C[Core: state, tasks, tools, hooks, handoff, telemetry, model call]
+```
+
+1. Your project builds the pipeline. Unmute writes that project for you, or you write it yourself.
+2. The project calls an adapter: `unmute_core.livekit` or `unmute_core.pipecat`.
+3. The adapter turns framework events into calls to the core. The core never imports LiveKit or Pipecat.
+4. The same core runs on both frameworks. Shared test scenarios run on both adapters and must give the same result.
+
+The library never reads `agent.yaml` and never builds the pipeline. Your speech-to-text, text-to-speech and LLM plugins stay yours.
+
+## Three ways to use it
+
+| Way | What you write | Start here |
+|---|---|---|
+| One piece at a time | A plain `Agent` or pipeline, plus the pieces you want: tools, greeting, idle nudges, tracing | [standalone](https://github.com/slng-ai/unmute-core/blob/main/docs/core/frameworks/standalone.mdx), [examples/minimal](https://github.com/slng-ai/unmute-core/tree/main/examples/minimal) |
+| A whole agent | One `AgentSpec` with typed state, tasks and handoffs, run by `UnmuteAgent` on LiveKit or `UnmuteFlows` on Pipecat | [livekit](https://github.com/slng-ai/unmute-core/blob/main/docs/core/frameworks/livekit.mdx), [pipecat](https://github.com/slng-ai/unmute-core/blob/main/docs/core/frameworks/pipecat.mdx), [examples/salon-concierge-unmute](https://github.com/slng-ai/unmute-core/tree/main/examples/salon-concierge-unmute) |
+| Compiled by Unmute | `agent.yaml` and Markdown prompts. Unmute writes the Python. | [Unmute](https://github.com/slng-ai/unmute), [examples/salon-concierge](https://github.com/slng-ai/unmute-core/tree/main/examples/salon-concierge) |
+
+An agent can also be defined as data: state as type text like `Phone | None`, tasks and tools as JSON. See [examples/parcel-desk](https://github.com/slng-ai/unmute-core/tree/main/examples/parcel-desk).
+
+Four whole agents show other shapes of call, each on LiveKit and Pipecat from one package, on SLNG speech and Gemini in the EU: a restaurant finder with tools only ([nosh](https://github.com/slng-ai/unmute-core/tree/main/examples/nosh)), a car claim intake ([kestrel](https://github.com/slng-ai/unmute-core/tree/main/examples/kestrel)), an outbound payment reminder ([wasla](https://github.com/slng-ai/unmute-core/tree/main/examples/wasla)) and a bilingual language tutor ([faro](https://github.com/slng-ai/unmute-core/tree/main/examples/faro)). See [example agents](https://github.com/slng-ai/unmute-core/blob/main/docs/core/examples/overview.mdx) and [type the path](https://github.com/slng-ai/unmute-core/blob/main/docs/core/examples/typed-path.mdx).
+
+## Why use it
+
+LiveKit and Pipecat move audio, run the models and call your tools. They do not decide what a good phone call looks like. Every team learns that from its first real calls. unmute-core holds what we learned, so you start from it.
+
+1. **One agent, two frameworks.** State, tasks, tools, prompts and traces run the same on LiveKit and Pipecat. 90 test scenarios run on both frameworks, with plain and realtime models, and must give the same result.
+2. **The model cannot break your data.** Each value the model saves is checked against its type. A wrong value is refused with a reason the model can act on, like `caller_phone: expected a phone number with its country code`. The model asks the caller again.
+3. **Over 100 call optimizations, built in.** Some examples:
+
+| On a call without it | What unmute-core does |
+|---|---|
+| A weak model says "Noted, thank you" and never finishes the step. | The finish check asks the model one narrow question: finish, or not yet. |
+| The caller pauses, goes on, and the reply plays over them. | `yield_to_caller` drops that reply. The next one answers everything they said. |
+| A slow tool leaves the caller in silence. | The tool says a line as it starts, and the caller's voice never cancels it. |
+| A tool returns the wrong shape, and the model tells the caller it worked. | Every tool names the Pydantic model of its result. A result that does not fit fails the call, and the model reads which field is wrong. |
+| The new agent hands the call straight back after a handoff. | Handoff tools are hidden on the first reply after a handoff. |
+| A bad key is tried on every fallback model while the caller waits. | Errors that every model would give stop the fallback chain at once. |
+| Gemini 3 refuses the next request after a tool call. | Thought signatures are kept on replayed tool calls. |
+| The model or voice fails and the caller hears silence. | A short apology plays, then the call ends with a clear reason. |
+| A webhook tool reaches `localhost` or a cloud metadata address. | Each webhook address must be public, and the connection is pinned to it. |
+| Each framework traces differently, so dashboards break when you switch. | One trace shape on both, sent to Langfuse, Coval, Logfire or any OpenTelemetry collector. |
+
+[Why unmute-core](https://github.com/slng-ai/unmute-core/blob/main/docs/core/start/why-unmute-core.mdx) follows one call from start to end. Each feature page then starts with what it fixes.
+
+## Install
+
+Python 3.12 or newer. Pick the extra for your framework:
+
+```bash
+uv add "unmute-core[livekit]"
+```
+
+```bash
+uv add "unmute-core[pipecat]"
+```
+
+| Extra | What it adds |
+|---|---|
+| `livekit` | The LiveKit adapter. LiveKit Agents 1.8.7 or newer within 1.8. |
+| `pipecat` | The Pipecat adapter. Pipecat 1.12 or newer within 1.12. |
+| `slng` | The `openai` package, for `OpenAIModelCall` and the SLNG Context Router as a model call. See [slng](https://github.com/slng-ai/unmute-core/blob/main/docs/core/models/slng.mdx). |
+| `knowledge` | Search over a folder of documents, with llama-index. See [knowledge](https://github.com/slng-ai/unmute-core/blob/main/docs/core/build/knowledge.mdx). |
+
+Everything works with your framework's own plugins and no SLNG package. [installation](https://github.com/slng-ai/unmute-core/blob/main/docs/core/start/installation.mdx) covers version ranges and the version check at import.
+
+## Docs
+
+The docs tell one story. Start small, then go deeper where you need to.
+
+1. **Get started:** [why unmute-core](https://github.com/slng-ai/unmute-core/blob/main/docs/core/start/why-unmute-core.mdx), [installation](https://github.com/slng-ai/unmute-core/blob/main/docs/core/start/installation.mdx) and the [quickstart](https://github.com/slng-ai/unmute-core/blob/main/docs/core/start/quickstart.mdx).
+2. **Build a salon agent:** a [tutorial](https://github.com/slng-ai/unmute-core/blob/main/docs/core/tutorial/overview.mdx) that grows one agent, one piece per page. It ends at [examples/salon-concierge-unmute](https://github.com/slng-ai/unmute-core/tree/main/examples/salon-concierge-unmute).
+3. **On your framework:** [add one piece to your agent](https://github.com/slng-ai/unmute-core/blob/main/docs/core/frameworks/standalone.mdx), or run a whole agent on [LiveKit](https://github.com/slng-ai/unmute-core/blob/main/docs/core/frameworks/livekit.mdx) or [Pipecat](https://github.com/slng-ai/unmute-core/blob/main/docs/core/frameworks/pipecat.mdx).
+4. **Guides:** [state](https://github.com/slng-ai/unmute-core/blob/main/docs/core/build/state.mdx), [tools](https://github.com/slng-ai/unmute-core/blob/main/docs/core/build/tools.mdx), [knowledge](https://github.com/slng-ai/unmute-core/blob/main/docs/core/build/knowledge.mdx), [tasks](https://github.com/slng-ai/unmute-core/blob/main/docs/core/build/tasks.mdx), [handoffs](https://github.com/slng-ai/unmute-core/blob/main/docs/core/build/handoffs.mdx), [call lifecycle](https://github.com/slng-ai/unmute-core/blob/main/docs/core/build/call-lifecycle.mdx), [prefetch](https://github.com/slng-ai/unmute-core/blob/main/docs/core/build/prefetch.mdx), [turn taking](https://github.com/slng-ai/unmute-core/blob/main/docs/core/build/turn-taking.mdx), [hooks](https://github.com/slng-ai/unmute-core/blob/main/docs/core/build/hooks.mdx), [model call](https://github.com/slng-ai/unmute-core/blob/main/docs/core/models/model-call.mdx), [slng](https://github.com/slng-ai/unmute-core/blob/main/docs/core/models/slng.mdx), [realtime](https://github.com/slng-ai/unmute-core/blob/main/docs/core/models/realtime.mdx), [telephony](https://github.com/slng-ai/unmute-core/blob/main/docs/core/telephony.mdx) and [telemetry](https://github.com/slng-ai/unmute-core/blob/main/docs/core/observe/telemetry.mdx).
+5. **Example agents:** [overview](https://github.com/slng-ai/unmute-core/blob/main/docs/core/examples/overview.mdx), [type the path](https://github.com/slng-ai/unmute-core/blob/main/docs/core/examples/typed-path.mdx), and one page each for [nosh](https://github.com/slng-ai/unmute-core/blob/main/docs/core/examples/nosh.mdx), [kestrel](https://github.com/slng-ai/unmute-core/blob/main/docs/core/examples/kestrel.mdx), [wasla](https://github.com/slng-ai/unmute-core/blob/main/docs/core/examples/wasla.mdx) and [faro](https://github.com/slng-ai/unmute-core/blob/main/docs/core/examples/faro.mdx).
+6. **Reference:** [settings](https://github.com/slng-ai/unmute-core/blob/main/docs/core/reference/settings.mdx) and [tasks](https://github.com/slng-ai/unmute-core/blob/main/docs/core/reference/tasks.mdx).
+
+## Versions
+
+The library is 0.x. Code written for `0.14.x` runs on any later `0.14.x`. A new minor version, like `0.15.0`, may break it. `unmute_core.require()` checks this when your code imports.
+
+[CHANGELOG.md](https://github.com/slng-ai/unmute-core/blob/main/CHANGELOG.md) lists what each release changed, and what can break you first.
+
+## Develop
+
+```bash
+uv sync --all-extras
+uv run pytest
+uv run ruff check . && uv run ruff format --check .
+uvx ty check
+```
+
+[CONTRIBUTING.md](https://github.com/slng-ai/unmute-core/blob/main/CONTRIBUTING.md) explains how to send a change. [SECURITY.md](https://github.com/slng-ai/unmute-core/blob/main/SECURITY.md) explains how to report a security problem.
+
+## License
+
+MIT. See [LICENSE](https://github.com/slng-ai/unmute-core/blob/main/LICENSE).

unmute_core-0.14.0/README.md

@@ -0,0 +1,160 @@
+# unmute-core
+
+[![PyPI](https://img.shields.io/pypi/v/unmute-core)](https://pypi.org/project/unmute-core/)
+[![Python](https://img.shields.io/pypi/pyversions/unmute-core)](https://pypi.org/project/unmute-core/)
+[![CI](https://github.com/slng-ai/unmute-core/actions/workflows/ci.yml/badge.svg)](https://github.com/slng-ai/unmute-core/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/pypi/l/unmute-core)](https://github.com/slng-ai/unmute-core/blob/main/LICENSE)
+
+unmute-core is a Python library for voice agents on [LiveKit Agents](https://github.com/livekit/agents) and [Pipecat](https://github.com/pipecat-ai/pipecat). You keep your framework, your speech and model plugins, and your pipeline. The library adds what a real phone or web call needs on top: typed call state, task steps, tools, handoffs, idle callers, transfers and tracing.
+
+[Unmute](https://github.com/slng-ai/unmute) compiles an agent spec into a LiveKit or Pipecat project. Those projects import this library. You can also use it in an agent you write by hand, one piece at a time or all of it.
+
+## Example
+
+A plain LiveKit agent with one tool from the library:
+
+```python
+import os
+
+from livekit.agents import Agent, AgentSession
+from livekit.plugins import openai, silero, slng
+from pydantic import BaseModel
+
+from unmute_core.livekit import function_tools
+from unmute_core.tools import ToolRegistry, local_tool
+
+
+class OrderStatus(BaseModel):
+    order_id: str
+    status: str
+
+
+def order_status(order_id: str) -> OrderStatus:
+    """Look up an order by its id. The return annotation is the result's checked shape."""
+    return OrderStatus(order_id=order_id, status="out for delivery")
+
+
+registry = ToolRegistry([local_tool(order_status, announce="One moment, let me check.")])
+
+agent = Agent(instructions="You help with orders.", tools=function_tools(registry))
+slng_host = f"{os.environ['SLNG_WORLD_PART']}.api.slng.ai"
+stt = slng.STT(slng_base_url=slng_host, model="soniox/speech-ai:rt-v5")
+session = AgentSession(
+    stt=stt,
+    llm=openai.LLM(),
+    tts=slng.TTS(
+        slng_base_url=slng_host,
+        model="slng/fish/tts:s2.1-pro",
+        voice="8d8aec63a56c460cb7def795bdf754fa",
+    ),
+    vad=silero.VAD.load(),
+)
+stt.attach_to_session(session)
+```
+
+The agent stays a normal LiveKit `Agent`. The library adds the tool and the line the agent says while the tool runs. Speech runs on SLNG: Soniox hears the caller and Fish Audio speaks, with your `SLNG_API_KEY`. On Pipecat, put `tools_schema(registry)` on the `LLMContext` instead.
+
+## How it fits
+
+```mermaid
+flowchart TD
+    U[Unmute compiles agent.yaml] --> P[Your LiveKit or Pipecat project]
+    H[You write agent.py by hand] --> P
+    P -->|builds the pipeline, calls| A[unmute_core.livekit or unmute_core.pipecat]
+    A --> C[Core: state, tasks, tools, hooks, handoff, telemetry, model call]
+```
+
+1. Your project builds the pipeline. Unmute writes that project for you, or you write it yourself.
+2. The project calls an adapter: `unmute_core.livekit` or `unmute_core.pipecat`.
+3. The adapter turns framework events into calls to the core. The core never imports LiveKit or Pipecat.
+4. The same core runs on both frameworks. Shared test scenarios run on both adapters and must give the same result.
+
+The library never reads `agent.yaml` and never builds the pipeline. Your speech-to-text, text-to-speech and LLM plugins stay yours.
+
+## Three ways to use it
+
+| Way | What you write | Start here |
+|---|---|---|
+| One piece at a time | A plain `Agent` or pipeline, plus the pieces you want: tools, greeting, idle nudges, tracing | [standalone](https://github.com/slng-ai/unmute-core/blob/main/docs/core/frameworks/standalone.mdx), [examples/minimal](https://github.com/slng-ai/unmute-core/tree/main/examples/minimal) |
+| A whole agent | One `AgentSpec` with typed state, tasks and handoffs, run by `UnmuteAgent` on LiveKit or `UnmuteFlows` on Pipecat | [livekit](https://github.com/slng-ai/unmute-core/blob/main/docs/core/frameworks/livekit.mdx), [pipecat](https://github.com/slng-ai/unmute-core/blob/main/docs/core/frameworks/pipecat.mdx), [examples/salon-concierge-unmute](https://github.com/slng-ai/unmute-core/tree/main/examples/salon-concierge-unmute) |
+| Compiled by Unmute | `agent.yaml` and Markdown prompts. Unmute writes the Python. | [Unmute](https://github.com/slng-ai/unmute), [examples/salon-concierge](https://github.com/slng-ai/unmute-core/tree/main/examples/salon-concierge) |
+
+An agent can also be defined as data: state as type text like `Phone | None`, tasks and tools as JSON. See [examples/parcel-desk](https://github.com/slng-ai/unmute-core/tree/main/examples/parcel-desk).
+
+Four whole agents show other shapes of call, each on LiveKit and Pipecat from one package, on SLNG speech and Gemini in the EU: a restaurant finder with tools only ([nosh](https://github.com/slng-ai/unmute-core/tree/main/examples/nosh)), a car claim intake ([kestrel](https://github.com/slng-ai/unmute-core/tree/main/examples/kestrel)), an outbound payment reminder ([wasla](https://github.com/slng-ai/unmute-core/tree/main/examples/wasla)) and a bilingual language tutor ([faro](https://github.com/slng-ai/unmute-core/tree/main/examples/faro)). See [example agents](https://github.com/slng-ai/unmute-core/blob/main/docs/core/examples/overview.mdx) and [type the path](https://github.com/slng-ai/unmute-core/blob/main/docs/core/examples/typed-path.mdx).
+
+## Why use it
+
+LiveKit and Pipecat move audio, run the models and call your tools. They do not decide what a good phone call looks like. Every team learns that from its first real calls. unmute-core holds what we learned, so you start from it.
+
+1. **One agent, two frameworks.** State, tasks, tools, prompts and traces run the same on LiveKit and Pipecat. 90 test scenarios run on both frameworks, with plain and realtime models, and must give the same result.
+2. **The model cannot break your data.** Each value the model saves is checked against its type. A wrong value is refused with a reason the model can act on, like `caller_phone: expected a phone number with its country code`. The model asks the caller again.
+3. **Over 100 call optimizations, built in.** Some examples:
+
+| On a call without it | What unmute-core does |
+|---|---|
+| A weak model says "Noted, thank you" and never finishes the step. | The finish check asks the model one narrow question: finish, or not yet. |
+| The caller pauses, goes on, and the reply plays over them. | `yield_to_caller` drops that reply. The next one answers everything they said. |
+| A slow tool leaves the caller in silence. | The tool says a line as it starts, and the caller's voice never cancels it. |
+| A tool returns the wrong shape, and the model tells the caller it worked. | Every tool names the Pydantic model of its result. A result that does not fit fails the call, and the model reads which field is wrong. |
+| The new agent hands the call straight back after a handoff. | Handoff tools are hidden on the first reply after a handoff. |
+| A bad key is tried on every fallback model while the caller waits. | Errors that every model would give stop the fallback chain at once. |
+| Gemini 3 refuses the next request after a tool call. | Thought signatures are kept on replayed tool calls. |
+| The model or voice fails and the caller hears silence. | A short apology plays, then the call ends with a clear reason. |
+| A webhook tool reaches `localhost` or a cloud metadata address. | Each webhook address must be public, and the connection is pinned to it. |
+| Each framework traces differently, so dashboards break when you switch. | One trace shape on both, sent to Langfuse, Coval, Logfire or any OpenTelemetry collector. |
+
+[Why unmute-core](https://github.com/slng-ai/unmute-core/blob/main/docs/core/start/why-unmute-core.mdx) follows one call from start to end. Each feature page then starts with what it fixes.
+
+## Install
+
+Python 3.12 or newer. Pick the extra for your framework:
+
+```bash
+uv add "unmute-core[livekit]"
+```
+
+```bash
+uv add "unmute-core[pipecat]"
+```
+
+| Extra | What it adds |
+|---|---|
+| `livekit` | The LiveKit adapter. LiveKit Agents 1.8.7 or newer within 1.8. |
+| `pipecat` | The Pipecat adapter. Pipecat 1.12 or newer within 1.12. |
+| `slng` | The `openai` package, for `OpenAIModelCall` and the SLNG Context Router as a model call. See [slng](https://github.com/slng-ai/unmute-core/blob/main/docs/core/models/slng.mdx). |
+| `knowledge` | Search over a folder of documents, with llama-index. See [knowledge](https://github.com/slng-ai/unmute-core/blob/main/docs/core/build/knowledge.mdx). |
+
+Everything works with your framework's own plugins and no SLNG package. [installation](https://github.com/slng-ai/unmute-core/blob/main/docs/core/start/installation.mdx) covers version ranges and the version check at import.
+
+## Docs
+
+The docs tell one story. Start small, then go deeper where you need to.
+
+1. **Get started:** [why unmute-core](https://github.com/slng-ai/unmute-core/blob/main/docs/core/start/why-unmute-core.mdx), [installation](https://github.com/slng-ai/unmute-core/blob/main/docs/core/start/installation.mdx) and the [quickstart](https://github.com/slng-ai/unmute-core/blob/main/docs/core/start/quickstart.mdx).
+2. **Build a salon agent:** a [tutorial](https://github.com/slng-ai/unmute-core/blob/main/docs/core/tutorial/overview.mdx) that grows one agent, one piece per page. It ends at [examples/salon-concierge-unmute](https://github.com/slng-ai/unmute-core/tree/main/examples/salon-concierge-unmute).
+3. **On your framework:** [add one piece to your agent](https://github.com/slng-ai/unmute-core/blob/main/docs/core/frameworks/standalone.mdx), or run a whole agent on [LiveKit](https://github.com/slng-ai/unmute-core/blob/main/docs/core/frameworks/livekit.mdx) or [Pipecat](https://github.com/slng-ai/unmute-core/blob/main/docs/core/frameworks/pipecat.mdx).
+4. **Guides:** [state](https://github.com/slng-ai/unmute-core/blob/main/docs/core/build/state.mdx), [tools](https://github.com/slng-ai/unmute-core/blob/main/docs/core/build/tools.mdx), [knowledge](https://github.com/slng-ai/unmute-core/blob/main/docs/core/build/knowledge.mdx), [tasks](https://github.com/slng-ai/unmute-core/blob/main/docs/core/build/tasks.mdx), [handoffs](https://github.com/slng-ai/unmute-core/blob/main/docs/core/build/handoffs.mdx), [call lifecycle](https://github.com/slng-ai/unmute-core/blob/main/docs/core/build/call-lifecycle.mdx), [prefetch](https://github.com/slng-ai/unmute-core/blob/main/docs/core/build/prefetch.mdx), [turn taking](https://github.com/slng-ai/unmute-core/blob/main/docs/core/build/turn-taking.mdx), [hooks](https://github.com/slng-ai/unmute-core/blob/main/docs/core/build/hooks.mdx), [model call](https://github.com/slng-ai/unmute-core/blob/main/docs/core/models/model-call.mdx), [slng](https://github.com/slng-ai/unmute-core/blob/main/docs/core/models/slng.mdx), [realtime](https://github.com/slng-ai/unmute-core/blob/main/docs/core/models/realtime.mdx), [telephony](https://github.com/slng-ai/unmute-core/blob/main/docs/core/telephony.mdx) and [telemetry](https://github.com/slng-ai/unmute-core/blob/main/docs/core/observe/telemetry.mdx).
+5. **Example agents:** [overview](https://github.com/slng-ai/unmute-core/blob/main/docs/core/examples/overview.mdx), [type the path](https://github.com/slng-ai/unmute-core/blob/main/docs/core/examples/typed-path.mdx), and one page each for [nosh](https://github.com/slng-ai/unmute-core/blob/main/docs/core/examples/nosh.mdx), [kestrel](https://github.com/slng-ai/unmute-core/blob/main/docs/core/examples/kestrel.mdx), [wasla](https://github.com/slng-ai/unmute-core/blob/main/docs/core/examples/wasla.mdx) and [faro](https://github.com/slng-ai/unmute-core/blob/main/docs/core/examples/faro.mdx).
+6. **Reference:** [settings](https://github.com/slng-ai/unmute-core/blob/main/docs/core/reference/settings.mdx) and [tasks](https://github.com/slng-ai/unmute-core/blob/main/docs/core/reference/tasks.mdx).
+
+## Versions
+
+The library is 0.x. Code written for `0.14.x` runs on any later `0.14.x`. A new minor version, like `0.15.0`, may break it. `unmute_core.require()` checks this when your code imports.
+
+[CHANGELOG.md](https://github.com/slng-ai/unmute-core/blob/main/CHANGELOG.md) lists what each release changed, and what can break you first.
+
+## Develop
+
+```bash
+uv sync --all-extras
+uv run pytest
+uv run ruff check . && uv run ruff format --check .
+uvx ty check
+```
+
+[CONTRIBUTING.md](https://github.com/slng-ai/unmute-core/blob/main/CONTRIBUTING.md) explains how to send a change. [SECURITY.md](https://github.com/slng-ai/unmute-core/blob/main/SECURITY.md) explains how to report a security problem.
+
+## License
+
+MIT. See [LICENSE](https://github.com/slng-ai/unmute-core/blob/main/LICENSE).

unmute_core-0.14.0/pyproject.toml

@@ -0,0 +1,119 @@
+[project]
+name = "unmute-core"
+version = "0.14.0"
+description = "Typed call state, tasks, tools, handoffs and tracing for voice agents on LiveKit and Pipecat"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+keywords = [
+    "voice agents",
+    "livekit",
+    "pipecat",
+    "llm",
+    "telephony",
+    "opentelemetry",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Multimedia :: Sound/Audio :: Speech",
+    "Topic :: Software Development :: Libraries",
+    "Typing :: Typed",
+]
+requires-python = ">=3.12"
+dependencies = [
+    "babel>=2.16,<3",
+    "email-validator>=2.2,<3",
+    "httpx>=0.28,<1",
+    "jsonschema>=4.23,<5",
+    "opentelemetry-exporter-otlp-proto-http>=1.40,<2",
+    "opentelemetry-sdk>=1.40,<2",
+    "phonenumbers>=8.13,<10",
+    "pydantic>=2.11,<3",
+    "pydantic-settings>=2.8,<3",
+]
+
+[[project.authors]]
+name = "Nicola Croon"
+email = "nicola@slng.ai"
+
+[project.urls]
+Repository = "https://github.com/slng-ai/unmute-core"
+Documentation = "https://github.com/slng-ai/unmute-core/tree/main/docs"
+Issues = "https://github.com/slng-ai/unmute-core/issues"
+Changelog = "https://github.com/slng-ai/unmute-core/blob/main/CHANGELOG.md"
+
+[project.optional-dependencies]
+livekit = ["livekit-agents>=1.8.7,<1.9"]
+pipecat = ["pipecat-ai>=1.12.0,<1.13"]
+slng = ["openai>=1.109,<4"]
+knowledge = [
+    "llama-index-core>=0.14,<0.15",
+    "llama-index-readers-file>=0.5,<0.8",
+    "llama-index-retrievers-bm25>=0.6,<0.9",
+]
+
+[dependency-groups]
+dev = [
+    "pipecat-ai[google]",
+    "pytest>=8",
+    "pytest-asyncio>=1",
+    "ruff>=0.15",
+    "ty",
+]
+
+[build-system]
+requires = ["uv_build>=0.12.18,<0.13.0"]
+build-backend = "uv_build"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "--ignore=examples -m 'not live'"
+markers = ["live: needs real API keys. Runs nightly and before a release: pytest -m live"]
+asyncio_mode = "auto"
+
+[tool.ruff]
+line-length = 100
+target-version = "py312"
+extend-exclude = ["examples"]
+
+[tool.ruff.lint]
+select = [
+    "E",
+    "F",
+    "W",
+    "I",
+    "UP",
+    "B",
+    "SIM",
+    "C4",
+    "PERF",
+    "FURB",
+    "RUF",
+    "BLE",
+    "D",
+    "ANN",
+    "N",
+]
+ignore = [
+    "E501",
+    "ANN401",
+]
+
+[tool.ruff.lint.pydocstyle]
+convention = "google"
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**" = [
+    "D",
+    "ANN",
+]
+
+[tool.ty.environment]
+python-version = "3.12"
+
+[tool.ty.src]
+exclude = ["examples"]

unmute_core-0.14.0/pyproject.toml.orig

@@ -0,0 +1,96 @@
+[project]
+name = "unmute-core"
+version = "0.14.0"
+description = "Typed call state, tasks, tools, handoffs and tracing for voice agents on LiveKit and Pipecat"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [
+    { name = "Nicola Croon", email = "nicola@slng.ai" }
+]
+keywords = ["voice agents", "livekit", "pipecat", "llm", "telephony", "opentelemetry"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Multimedia :: Sound/Audio :: Speech",
+    "Topic :: Software Development :: Libraries",
+    "Typing :: Typed",
+]
+requires-python = ">=3.12"
+dependencies = [
+    "babel>=2.16,<3",
+    "email-validator>=2.2,<3",
+    "httpx>=0.28,<1",
+    "jsonschema>=4.23,<5",
+    "opentelemetry-exporter-otlp-proto-http>=1.40,<2",
+    "opentelemetry-sdk>=1.40,<2",
+    "phonenumbers>=8.13,<10",
+    "pydantic>=2.11,<3",
+    "pydantic-settings>=2.8,<3",
+]
+
+[project.urls]
+Repository = "https://github.com/slng-ai/unmute-core"
+Documentation = "https://github.com/slng-ai/unmute-core/tree/main/docs"
+Issues = "https://github.com/slng-ai/unmute-core/issues"
+Changelog = "https://github.com/slng-ai/unmute-core/blob/main/CHANGELOG.md"
+
+[project.optional-dependencies]
+# Each framework is on its newest release. Unmute's internal/target/driver.go follows.
+# LiveKit 1.8.3 added ToolResult, which the adapter needs.
+livekit = ["livekit-agents>=1.8.7,<1.9"]
+pipecat = ["pipecat-ai>=1.12.0,<1.13"]
+# openai 1.109 added `omit`. livekit-agents 1.8.7 needs openai 3, so LiveKit apps get it
+# anyway; a Pipecat app may stay on openai 1 or 2.
+slng = ["openai>=1.109,<4"]
+# No embedding package: the caller passes its own llama-index embedder.
+knowledge = [
+    "llama-index-core>=0.14,<0.15",
+    "llama-index-readers-file>=0.5,<0.8",
+    "llama-index-retrievers-bm25>=0.6,<0.9",
+]
+
+[dependency-groups]
+dev = [
+    # The Gemini service, for the side requests a Pipecat call sends it.
+    "pipecat-ai[google]",
+    "pytest>=8",
+    "pytest-asyncio>=1",
+    "ruff>=0.15",
+    "ty",
+]
+
+[build-system]
+requires = ["uv_build>=0.12.18,<0.13.0"]
+build-backend = "uv_build"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "--ignore=examples -m 'not live'"
+markers = ["live: needs real API keys. Runs nightly and before a release: pytest -m live"]
+asyncio_mode = "auto"
+
+# Each example project keeps the ruff and ty config Unmute emits for it.
+[tool.ruff]
+line-length = 100
+target-version = "py312"
+extend-exclude = ["examples"]
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "I", "UP", "B", "SIM", "C4", "PERF", "FURB", "RUF", "BLE", "D", "ANN", "N"]
+ignore = ["E501", "ANN401"]
+
+[tool.ruff.lint.pydocstyle]
+convention = "google"
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**" = ["D", "ANN"]
+
+[tool.ty.environment]
+python-version = "3.12"
+
+[tool.ty.src]
+exclude = ["examples"]