@ours.network/mcp 0.13.0 → 0.14.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md
CHANGED
|
@@ -24,6 +24,31 @@ exposes the messaging tools — each a thin wrapper over one MUFL user transacti
|
|
|
24
24
|
| `OURS_STATE_DIR` | `~/.ours` | Node identity + serialized state. Distinct per node. |
|
|
25
25
|
| `OURS_BROKER_URL` | `wss://broker1.ours.network` | The ADAPT broker to connect through. Set to `ws://localhost:9000` for a local broker. |
|
|
26
26
|
|
|
27
|
+
### Voice-message transcription
|
|
28
|
+
|
|
29
|
+
Voice transcription is off until a provider and key (plus provider-required fields) are
|
|
30
|
+
configured. Check readiness without exposing credentials:
|
|
31
|
+
|
|
32
|
+
```sh
|
|
33
|
+
ours-mcp voice-status --json
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
Run `ours-install` interactively for guided, masked setup. It writes the config atomically
|
|
37
|
+
with mode `0600` and rolls back if the daemon cannot reload it. For environment-only service
|
|
38
|
+
configuration use `OURS_STT_PROVIDER`, `OURS_STT_API_KEY`, `OURS_STT_MODEL`,
|
|
39
|
+
`OURS_STT_BASE_URL`, and `OURS_STT_LANGUAGE`; environment values override file fields.
|
|
40
|
+
|
|
41
|
+
The supported providers are `openai-compatible` (explicit base URL + model),
|
|
42
|
+
`elevenlabs` (model), `deepgram`, and `custom` (`stt.custom.url`). Incoming voice remains
|
|
43
|
+
a file and is transcribed only when its real `audio/*` MIME also carries
|
|
44
|
+
`x-ours-kind=voice-message` (or its legacy filename starts `voice-message-`). The original
|
|
45
|
+
bytes are saved whether transcription succeeds, is unconfigured, exceeds the size cap, or
|
|
46
|
+
the provider fails. Provider error text is scrubbed if it echoes the configured key.
|
|
47
|
+
|
|
48
|
+
Telegram fallback preserves its original OGG/Opus bytes and `.ogg` filename and advertises
|
|
49
|
+
`audio/ogg; x-ours-kind=voice-message`; the connector's v2 message envelope correlates the
|
|
50
|
+
separate file using `attachment.wire_id`.
|
|
51
|
+
|
|
27
52
|
## Daemon lifecycle
|
|
28
53
|
|
|
29
54
|
This package is the **single owner of the daemon lifecycle**. `ours-mcp start`
|