Metadata-Version: 2.5
Name: ovos-skill-hangup
Version: 1.0.1
Summary: An OVOS skill that silently absorbs utterances Switchboard declines, logging each decline and speaking nothing
Project-URL: Homepage, https://github.com/OscillateLabsLLC/hangup
Project-URL: Repository, https://github.com/OscillateLabsLLC/hangup
Author-email: Oscillate Labs <mike@oscillatelabs.net>
License-Expression: Apache-2.0
License-File: LICENSE
Keywords: intent,neon,ovos,pipeline,skill,switchboard,voice
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Multimedia :: Sound/Audio :: Speech
Requires-Python: >=3.11
Requires-Dist: ovos-bus-client>=0.1.6
Requires-Dist: ovos-utils>=0.8.1
Requires-Dist: ovos-workshop!=1.*,!=2.*,!=3.*,!=4.*,!=5.*,!=6.*,!=7.*,>=0.1.7
Provides-Extra: dev
Requires-Dist: pylint>=3.0.0; extra == 'dev'
Requires-Dist: ruff; extra == 'dev'
Provides-Extra: test
Requires-Dist: ovos-plugin-manager; extra == 'test'
Requires-Dist: pytest; extra == 'test'
Requires-Dist: pytest-cov; extra == 'test'
Description-Content-Type: text/markdown

# Hangup

[![Status: Active](https://img.shields.io/badge/status-active-brightgreen)](https://github.com/OscillateLabsLLC/.github/blob/main/SUPPORT_STATUS.md)

An OVOS skill that says nothing. [Switchboard](https://github.com/OscillateLabsLLC/switchboard) sends it the speech
that wasn't meant for the assistant.

A voice assistant hears a lot that isn't for it: people talking in the room, the TV, its own voice. In stock OVOS,
anything no skill claims falls through to fallback skills, and those *answer*: "I don't understand", or an LLM's
reply to a sentence nobody asked. That's the false trigger households find most annoying.

When Switchboard decides speech wasn't for the assistant, it sends it to Hangup instead. Hangup:

- **says nothing**,
- adds a line to `declines.jsonl` in its data folder (what was heard, why it was declined, and by which step),
- announces `hangup.declined` on the bus, for anything that wants to watch.

Hangup registers no intents, so nothing can reach it by accident; only Switchboard sends to it. Switchboard needs
Hangup installed.

## Install

```sh
pip install ovos-skill-hangup
```

Python 3.11-3.14. Works with ovos-workshop 0.x (Neon) and current OVOS.

## Settings

| key | default | meaning |
|---|---|---|
| `log_declines` | `true` | write each declined utterance to the log |
| `log_file` | `declines.jsonl` | the log's file name, in the skill's data folder |
| `max_log_bytes` | 5000000 | above this size the log moves to `<log_file>.1` (one backup is kept) |

## License

Apache-2.0
