hermes-plugin-teams-voice 0.1.0__tar.gz

hermes_plugin_teams_voice-0.1.0/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 Nous Research
+Copyright (c) 2026 Alaaeldin Elhenawy
+
+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.

hermes_plugin_teams_voice-0.1.0/PKG-INFO

@@ -0,0 +1,178 @@
+Metadata-Version: 2.4
+Name: hermes-plugin-teams-voice
+Version: 0.1.0
+Summary: Microsoft Teams voice/video (Conversational Video Interface) plugin for Hermes Agent
+Author-email: Alaaeldin Elhenawy <alaamh@outlook.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/alaamh/hermes-plugin-teams-voice
+Project-URL: Repository, https://github.com/alaamh/hermes-plugin-teams-voice
+Project-URL: Issues, https://github.com/alaamh/hermes-plugin-teams-voice/issues
+Keywords: hermes,hermes-agent,microsoft-teams,voice,cvi,plugin
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Communications :: Conferencing
+Classifier: Topic :: Multimedia :: Sound/Audio
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiohttp>=3.8
+Provides-Extra: numpy
+Requires-Dist: numpy>=1.21; extra == "numpy"
+Dynamic: license-file
+
+# hermes-plugin-teams-voice
+
+Microsoft Teams **voice/video (Conversational Video Interface)** for **Hermes Agent**,
+packaged as a standalone, pip-installable plugin — install it *on top of* a normal
+Hermes install, no fork required.
+
+The plugin (name **`teams_voice`**) hosts the HMAC-authenticated WebSocket bridge that
+a media worker dials into, and drives the call: realtime (OpenAI/Azure
+speech-to-speech) **or** streaming (STT→agent→TTS), camera/screen vision, the avatar
+driver cues (expression / visemes / show-to-caller), group-call etiquette, DTMF,
+bilingual EN/AR, meeting recap/minutes, and SharePoint (OneDrive) file send.
+
+## Install on Hermes
+
+Install into the **same Python environment as Hermes** — it discovers the plugin via
+the `hermes_agent.plugins` entry-point and imports it in-process. Target the python
+that runs `hermes` (Linux/macOS `…/venv/bin/python`, Windows `…\venv\Scripts\python.exe`),
+or activate that venv first and drop `--python`.
+
+**A — from PyPI (recommended):**
+
+```bash
+uv pip install --python /path/to/hermes/venv/bin/python hermes-plugin-teams-voice
+# or, with the Hermes venv activated:  pip install hermes-plugin-teams-voice
+```
+
+**B — from GitHub (latest / pre-release):**
+
+```bash
+uv pip install --python /path/to/hermes/venv/bin/python \
+  "git+https://github.com/alaamh/hermes-plugin-teams-voice.git"
+```
+
+**C — from a local checkout (development):**
+
+```bash
+git clone https://github.com/alaamh/hermes-plugin-teams-voice.git
+uv pip install --python /path/to/hermes/venv/bin/python -e ./hermes-plugin-teams-voice
+```
+
+> Installing into the wrong environment means Hermes won't see the plugin.
+> Faster audio (optional): add the `numpy` extra, e.g. `hermes-plugin-teams-voice[numpy]`.
+
+## Enable + run
+
+```bash
+hermes plugins list                            # confirm: teams_voice   (source: entrypoint)
+hermes plugins enable teams_voice              # entry-point plugins are opt-in
+hermes teams-voice serve --handler realtime    # voice bridge; also: streaming | echo | logging
+hermes gateway run                             # (separately) the Teams chat plane + cron
+```
+
+## Configure
+
+Config lives in Hermes's own files (this package ships none). Non-secret settings go
+in **`config.yaml`**; secrets go in **`.env`** and are referenced with `${VAR}`.
+
+**`~/.hermes/config.yaml`** — under `plugins.entries.teams_voice.config`:
+
+```yaml
+plugins:
+  enabled:
+    - teams_voice                          # entry-point plugins are opt-in
+  entries:
+    teams_voice:
+      config:
+        shared_secret: ${TEAMS_VOICE_SHARED_SECRET}   # MUST byte-match the worker's secret
+        host: 127.0.0.1
+        port: 8443                         # voice WS the worker dials: ws://host:port/voice/msteams/stream
+        share_point_site_id: ${TEAMS_SHAREPOINT_SITE_ID}  # optional: attach files/minutes to the chat
+        meeting_recap: true                # optional: post minutes at call end
+        allowlist: []                      # optional: caller AAD object ids (empty = allow all)
+        session_scope: per-call            # per-call | per-thread | per-aad
+        # Realtime (speech-to-speech) brain — Azure OpenAI Realtime:
+        realtime:
+          backend: azure                   # azure | openai
+          azure_endpoint: https://<your-azure-resource>.cognitiveservices.azure.com
+          azure_deployment: gpt-realtime
+          azure_api_version: 2025-04-01-preview
+          voice: cedar
+          api_key: ${AZURE_FOUNDRY_API_KEY}
+          vad_threshold: 0.5
+          prefix_padding_ms: 300
+          silence_duration_ms: 500
+```
+
+> **Public OpenAI** instead of Azure: set `backend: openai`, `model: gpt-realtime`,
+> `api_key: ${OPENAI_API_KEY}`, and drop the `azure_*` keys.
+> **Streaming** (STT→agent→TTS) instead of realtime: omit the `realtime:` block and run
+> `hermes teams-voice serve --handler streaming` (needs `ffmpeg` on PATH).
+
+**`~/.hermes/.env`** — the secrets referenced above (plus Teams chat-plane creds if you
+also run `hermes gateway run`):
+
+```bash
+# Voice bridge
+TEAMS_VOICE_SHARED_SECRET=<same value as the media worker's shared secret>
+AZURE_FOUNDRY_API_KEY=<azure-openai-key>                 # or OPENAI_API_KEY for public OpenAI
+TEAMS_SHAREPOINT_SITE_ID=<host>,<siteGuid>,<webGuid>     # optional (needs Graph Sites.ReadWrite.All)
+
+# Teams chat plane (platforms/teams) — only if you run the gateway:
+TEAMS_CLIENT_ID=<bot-app-id>
+TEAMS_CLIENT_SECRET=<bot-app-secret>
+TEAMS_TENANT_ID=<azure-ad-tenant-id>
+```
+
+`shared_secret` **must byte-match** the media worker's shared secret or the HMAC
+handshake fails. Full key reference (every option, streaming mode, DLP/audit, the
+required Microsoft Graph permissions): [`hermes_teams_voice/README.md`](hermes_teams_voice/README.md).
+
+## Upgrade / uninstall
+
+```bash
+uv pip install --upgrade hermes-plugin-teams-voice
+uv pip uninstall hermes-plugin-teams-voice     # then it disappears from `hermes plugins list`
+```
+
+## How it loads
+
+Hermes discovers pip plugins via the `hermes_agent.plugins` entry-point group. This
+package exposes:
+
+```toml
+[project.entry-points."hermes_agent.plugins"]
+teams_voice = "hermes_teams_voice"
+```
+
+Hermes imports `hermes_teams_voice` and calls its `register(ctx)` — registering the
+`teams-voice` CLI, the status tool, and the session hook. Entry-point plugins are
+opt-in, so `teams_voice` must be in `plugins.enabled` (`hermes plugins enable` does this).
+
+## Requirements
+
+- A working **Hermes Agent** install (the host; not a PyPI package).
+- Python ≥ 3.10 and `aiohttp`; `ffmpeg` on PATH for streaming-mode TTS decode.
+- A media worker that bridges the live Teams call audio/video into this plugin over the HMAC WebSocket (open-source, separate repo).
+
+## Relationship to the bundled plugin
+
+This is the same code as the in-tree `plugins/teams_voice` plugin, repackaged for pip
+distribution so you don't have to fork Hermes. Install it on **vanilla** Hermes; don't
+also keep a bundled `teams_voice` (same name → the entry-point would shadow it).
+
+- **Voice/CVI** works fully on vanilla Hermes.
+- **Chat-plane governance + SharePoint file attach** depend on the enhanced
+  `plugins/platforms/teams` adapter; without it the plugin **degrades gracefully**
+  (e.g. meeting minutes post as text instead of a SharePoint file card).
+
+## License
+
+MIT (matches Hermes Agent). Created by Alaaeldin Elhenawy — Dubai, UAE.

hermes_plugin_teams_voice-0.1.0/README.md

@@ -0,0 +1,151 @@
+# hermes-plugin-teams-voice
+
+Microsoft Teams **voice/video (Conversational Video Interface)** for **Hermes Agent**,
+packaged as a standalone, pip-installable plugin — install it *on top of* a normal
+Hermes install, no fork required.
+
+The plugin (name **`teams_voice`**) hosts the HMAC-authenticated WebSocket bridge that
+a media worker dials into, and drives the call: realtime (OpenAI/Azure
+speech-to-speech) **or** streaming (STT→agent→TTS), camera/screen vision, the avatar
+driver cues (expression / visemes / show-to-caller), group-call etiquette, DTMF,
+bilingual EN/AR, meeting recap/minutes, and SharePoint (OneDrive) file send.
+
+## Install on Hermes
+
+Install into the **same Python environment as Hermes** — it discovers the plugin via
+the `hermes_agent.plugins` entry-point and imports it in-process. Target the python
+that runs `hermes` (Linux/macOS `…/venv/bin/python`, Windows `…\venv\Scripts\python.exe`),
+or activate that venv first and drop `--python`.
+
+**A — from PyPI (recommended):**
+
+```bash
+uv pip install --python /path/to/hermes/venv/bin/python hermes-plugin-teams-voice
+# or, with the Hermes venv activated:  pip install hermes-plugin-teams-voice
+```
+
+**B — from GitHub (latest / pre-release):**
+
+```bash
+uv pip install --python /path/to/hermes/venv/bin/python \
+  "git+https://github.com/alaamh/hermes-plugin-teams-voice.git"
+```
+
+**C — from a local checkout (development):**
+
+```bash
+git clone https://github.com/alaamh/hermes-plugin-teams-voice.git
+uv pip install --python /path/to/hermes/venv/bin/python -e ./hermes-plugin-teams-voice
+```
+
+> Installing into the wrong environment means Hermes won't see the plugin.
+> Faster audio (optional): add the `numpy` extra, e.g. `hermes-plugin-teams-voice[numpy]`.
+
+## Enable + run
+
+```bash
+hermes plugins list                            # confirm: teams_voice   (source: entrypoint)
+hermes plugins enable teams_voice              # entry-point plugins are opt-in
+hermes teams-voice serve --handler realtime    # voice bridge; also: streaming | echo | logging
+hermes gateway run                             # (separately) the Teams chat plane + cron
+```
+
+## Configure
+
+Config lives in Hermes's own files (this package ships none). Non-secret settings go
+in **`config.yaml`**; secrets go in **`.env`** and are referenced with `${VAR}`.
+
+**`~/.hermes/config.yaml`** — under `plugins.entries.teams_voice.config`:
+
+```yaml
+plugins:
+  enabled:
+    - teams_voice                          # entry-point plugins are opt-in
+  entries:
+    teams_voice:
+      config:
+        shared_secret: ${TEAMS_VOICE_SHARED_SECRET}   # MUST byte-match the worker's secret
+        host: 127.0.0.1
+        port: 8443                         # voice WS the worker dials: ws://host:port/voice/msteams/stream
+        share_point_site_id: ${TEAMS_SHAREPOINT_SITE_ID}  # optional: attach files/minutes to the chat
+        meeting_recap: true                # optional: post minutes at call end
+        allowlist: []                      # optional: caller AAD object ids (empty = allow all)
+        session_scope: per-call            # per-call | per-thread | per-aad
+        # Realtime (speech-to-speech) brain — Azure OpenAI Realtime:
+        realtime:
+          backend: azure                   # azure | openai
+          azure_endpoint: https://<your-azure-resource>.cognitiveservices.azure.com
+          azure_deployment: gpt-realtime
+          azure_api_version: 2025-04-01-preview
+          voice: cedar
+          api_key: ${AZURE_FOUNDRY_API_KEY}
+          vad_threshold: 0.5
+          prefix_padding_ms: 300
+          silence_duration_ms: 500
+```
+
+> **Public OpenAI** instead of Azure: set `backend: openai`, `model: gpt-realtime`,
+> `api_key: ${OPENAI_API_KEY}`, and drop the `azure_*` keys.
+> **Streaming** (STT→agent→TTS) instead of realtime: omit the `realtime:` block and run
+> `hermes teams-voice serve --handler streaming` (needs `ffmpeg` on PATH).
+
+**`~/.hermes/.env`** — the secrets referenced above (plus Teams chat-plane creds if you
+also run `hermes gateway run`):
+
+```bash
+# Voice bridge
+TEAMS_VOICE_SHARED_SECRET=<same value as the media worker's shared secret>
+AZURE_FOUNDRY_API_KEY=<azure-openai-key>                 # or OPENAI_API_KEY for public OpenAI
+TEAMS_SHAREPOINT_SITE_ID=<host>,<siteGuid>,<webGuid>     # optional (needs Graph Sites.ReadWrite.All)
+
+# Teams chat plane (platforms/teams) — only if you run the gateway:
+TEAMS_CLIENT_ID=<bot-app-id>
+TEAMS_CLIENT_SECRET=<bot-app-secret>
+TEAMS_TENANT_ID=<azure-ad-tenant-id>
+```
+
+`shared_secret` **must byte-match** the media worker's shared secret or the HMAC
+handshake fails. Full key reference (every option, streaming mode, DLP/audit, the
+required Microsoft Graph permissions): [`hermes_teams_voice/README.md`](hermes_teams_voice/README.md).
+
+## Upgrade / uninstall
+
+```bash
+uv pip install --upgrade hermes-plugin-teams-voice
+uv pip uninstall hermes-plugin-teams-voice     # then it disappears from `hermes plugins list`
+```
+
+## How it loads
+
+Hermes discovers pip plugins via the `hermes_agent.plugins` entry-point group. This
+package exposes:
+
+```toml
+[project.entry-points."hermes_agent.plugins"]
+teams_voice = "hermes_teams_voice"
+```
+
+Hermes imports `hermes_teams_voice` and calls its `register(ctx)` — registering the
+`teams-voice` CLI, the status tool, and the session hook. Entry-point plugins are
+opt-in, so `teams_voice` must be in `plugins.enabled` (`hermes plugins enable` does this).
+
+## Requirements
+
+- A working **Hermes Agent** install (the host; not a PyPI package).
+- Python ≥ 3.10 and `aiohttp`; `ffmpeg` on PATH for streaming-mode TTS decode.
+- A media worker that bridges the live Teams call audio/video into this plugin over the HMAC WebSocket (open-source, separate repo).
+
+## Relationship to the bundled plugin
+
+This is the same code as the in-tree `plugins/teams_voice` plugin, repackaged for pip
+distribution so you don't have to fork Hermes. Install it on **vanilla** Hermes; don't
+also keep a bundled `teams_voice` (same name → the entry-point would shadow it).
+
+- **Voice/CVI** works fully on vanilla Hermes.
+- **Chat-plane governance + SharePoint file attach** depend on the enhanced
+  `plugins/platforms/teams` adapter; without it the plugin **degrades gracefully**
+  (e.g. meeting minutes post as text instead of a SharePoint file card).
+
+## License
+
+MIT (matches Hermes Agent). Created by Alaaeldin Elhenawy — Dubai, UAE.

hermes_plugin_teams_voice-0.1.0/hermes_plugin_teams_voice.egg-info/PKG-INFO

@@ -0,0 +1,178 @@
+Metadata-Version: 2.4
+Name: hermes-plugin-teams-voice
+Version: 0.1.0
+Summary: Microsoft Teams voice/video (Conversational Video Interface) plugin for Hermes Agent
+Author-email: Alaaeldin Elhenawy <alaamh@outlook.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/alaamh/hermes-plugin-teams-voice
+Project-URL: Repository, https://github.com/alaamh/hermes-plugin-teams-voice
+Project-URL: Issues, https://github.com/alaamh/hermes-plugin-teams-voice/issues
+Keywords: hermes,hermes-agent,microsoft-teams,voice,cvi,plugin
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Communications :: Conferencing
+Classifier: Topic :: Multimedia :: Sound/Audio
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiohttp>=3.8
+Provides-Extra: numpy
+Requires-Dist: numpy>=1.21; extra == "numpy"
+Dynamic: license-file
+
+# hermes-plugin-teams-voice
+
+Microsoft Teams **voice/video (Conversational Video Interface)** for **Hermes Agent**,
+packaged as a standalone, pip-installable plugin — install it *on top of* a normal
+Hermes install, no fork required.
+
+The plugin (name **`teams_voice`**) hosts the HMAC-authenticated WebSocket bridge that
+a media worker dials into, and drives the call: realtime (OpenAI/Azure
+speech-to-speech) **or** streaming (STT→agent→TTS), camera/screen vision, the avatar
+driver cues (expression / visemes / show-to-caller), group-call etiquette, DTMF,
+bilingual EN/AR, meeting recap/minutes, and SharePoint (OneDrive) file send.
+
+## Install on Hermes
+
+Install into the **same Python environment as Hermes** — it discovers the plugin via
+the `hermes_agent.plugins` entry-point and imports it in-process. Target the python
+that runs `hermes` (Linux/macOS `…/venv/bin/python`, Windows `…\venv\Scripts\python.exe`),
+or activate that venv first and drop `--python`.
+
+**A — from PyPI (recommended):**
+
+```bash
+uv pip install --python /path/to/hermes/venv/bin/python hermes-plugin-teams-voice
+# or, with the Hermes venv activated:  pip install hermes-plugin-teams-voice
+```
+
+**B — from GitHub (latest / pre-release):**
+
+```bash
+uv pip install --python /path/to/hermes/venv/bin/python \
+  "git+https://github.com/alaamh/hermes-plugin-teams-voice.git"
+```
+
+**C — from a local checkout (development):**
+
+```bash
+git clone https://github.com/alaamh/hermes-plugin-teams-voice.git
+uv pip install --python /path/to/hermes/venv/bin/python -e ./hermes-plugin-teams-voice
+```
+
+> Installing into the wrong environment means Hermes won't see the plugin.
+> Faster audio (optional): add the `numpy` extra, e.g. `hermes-plugin-teams-voice[numpy]`.
+
+## Enable + run
+
+```bash
+hermes plugins list                            # confirm: teams_voice   (source: entrypoint)
+hermes plugins enable teams_voice              # entry-point plugins are opt-in
+hermes teams-voice serve --handler realtime    # voice bridge; also: streaming | echo | logging
+hermes gateway run                             # (separately) the Teams chat plane + cron
+```
+
+## Configure
+
+Config lives in Hermes's own files (this package ships none). Non-secret settings go
+in **`config.yaml`**; secrets go in **`.env`** and are referenced with `${VAR}`.
+
+**`~/.hermes/config.yaml`** — under `plugins.entries.teams_voice.config`:
+
+```yaml
+plugins:
+  enabled:
+    - teams_voice                          # entry-point plugins are opt-in
+  entries:
+    teams_voice:
+      config:
+        shared_secret: ${TEAMS_VOICE_SHARED_SECRET}   # MUST byte-match the worker's secret
+        host: 127.0.0.1
+        port: 8443                         # voice WS the worker dials: ws://host:port/voice/msteams/stream
+        share_point_site_id: ${TEAMS_SHAREPOINT_SITE_ID}  # optional: attach files/minutes to the chat
+        meeting_recap: true                # optional: post minutes at call end
+        allowlist: []                      # optional: caller AAD object ids (empty = allow all)
+        session_scope: per-call            # per-call | per-thread | per-aad
+        # Realtime (speech-to-speech) brain — Azure OpenAI Realtime:
+        realtime:
+          backend: azure                   # azure | openai
+          azure_endpoint: https://<your-azure-resource>.cognitiveservices.azure.com
+          azure_deployment: gpt-realtime
+          azure_api_version: 2025-04-01-preview
+          voice: cedar
+          api_key: ${AZURE_FOUNDRY_API_KEY}
+          vad_threshold: 0.5
+          prefix_padding_ms: 300
+          silence_duration_ms: 500
+```
+
+> **Public OpenAI** instead of Azure: set `backend: openai`, `model: gpt-realtime`,
+> `api_key: ${OPENAI_API_KEY}`, and drop the `azure_*` keys.
+> **Streaming** (STT→agent→TTS) instead of realtime: omit the `realtime:` block and run
+> `hermes teams-voice serve --handler streaming` (needs `ffmpeg` on PATH).
+
+**`~/.hermes/.env`** — the secrets referenced above (plus Teams chat-plane creds if you
+also run `hermes gateway run`):
+
+```bash
+# Voice bridge
+TEAMS_VOICE_SHARED_SECRET=<same value as the media worker's shared secret>
+AZURE_FOUNDRY_API_KEY=<azure-openai-key>                 # or OPENAI_API_KEY for public OpenAI
+TEAMS_SHAREPOINT_SITE_ID=<host>,<siteGuid>,<webGuid>     # optional (needs Graph Sites.ReadWrite.All)
+
+# Teams chat plane (platforms/teams) — only if you run the gateway:
+TEAMS_CLIENT_ID=<bot-app-id>
+TEAMS_CLIENT_SECRET=<bot-app-secret>
+TEAMS_TENANT_ID=<azure-ad-tenant-id>
+```
+
+`shared_secret` **must byte-match** the media worker's shared secret or the HMAC
+handshake fails. Full key reference (every option, streaming mode, DLP/audit, the
+required Microsoft Graph permissions): [`hermes_teams_voice/README.md`](hermes_teams_voice/README.md).
+
+## Upgrade / uninstall
+
+```bash
+uv pip install --upgrade hermes-plugin-teams-voice
+uv pip uninstall hermes-plugin-teams-voice     # then it disappears from `hermes plugins list`
+```
+
+## How it loads
+
+Hermes discovers pip plugins via the `hermes_agent.plugins` entry-point group. This
+package exposes:
+
+```toml
+[project.entry-points."hermes_agent.plugins"]
+teams_voice = "hermes_teams_voice"
+```
+
+Hermes imports `hermes_teams_voice` and calls its `register(ctx)` — registering the
+`teams-voice` CLI, the status tool, and the session hook. Entry-point plugins are
+opt-in, so `teams_voice` must be in `plugins.enabled` (`hermes plugins enable` does this).
+
+## Requirements
+
+- A working **Hermes Agent** install (the host; not a PyPI package).
+- Python ≥ 3.10 and `aiohttp`; `ffmpeg` on PATH for streaming-mode TTS decode.
+- A media worker that bridges the live Teams call audio/video into this plugin over the HMAC WebSocket (open-source, separate repo).
+
+## Relationship to the bundled plugin
+
+This is the same code as the in-tree `plugins/teams_voice` plugin, repackaged for pip
+distribution so you don't have to fork Hermes. Install it on **vanilla** Hermes; don't
+also keep a bundled `teams_voice` (same name → the entry-point would shadow it).
+
+- **Voice/CVI** works fully on vanilla Hermes.
+- **Chat-plane governance + SharePoint file attach** depend on the enhanced
+  `plugins/platforms/teams` adapter; without it the plugin **degrades gracefully**
+  (e.g. meeting minutes post as text instead of a SharePoint file card).
+
+## License
+
+MIT (matches Hermes Agent). Created by Alaaeldin Elhenawy — Dubai, UAE.

hermes_plugin_teams_voice-0.1.0/hermes_plugin_teams_voice.egg-info/SOURCES.txt

@@ -0,0 +1,54 @@
+LICENSE
+README.md
+pyproject.toml
+hermes_plugin_teams_voice.egg-info/PKG-INFO
+hermes_plugin_teams_voice.egg-info/SOURCES.txt
+hermes_plugin_teams_voice.egg-info/dependency_links.txt
+hermes_plugin_teams_voice.egg-info/entry_points.txt
+hermes_plugin_teams_voice.egg-info/requires.txt
+hermes_plugin_teams_voice.egg-info/top_level.txt
+hermes_teams_voice/__init__.py
+hermes_teams_voice/agent_consult.py
+hermes_teams_voice/audio.py
+hermes_teams_voice/bridge_server.py
+hermes_teams_voice/call_session_base.py
+hermes_teams_voice/call_tools.py
+hermes_teams_voice/cli.py
+hermes_teams_voice/config.py
+hermes_teams_voice/echo_guard.py
+hermes_teams_voice/elevenlabs_tts.py
+hermes_teams_voice/expression.py
+hermes_teams_voice/group_call_gate.py
+hermes_teams_voice/handlers.py
+hermes_teams_voice/hmac_auth.py
+hermes_teams_voice/meeting.py
+hermes_teams_voice/meeting_docx.py
+hermes_teams_voice/outbound.py
+hermes_teams_voice/plugin.yaml
+hermes_teams_voice/protocol.py
+hermes_teams_voice/realtime_tools.py
+hermes_teams_voice/streaming_audio.py
+hermes_teams_voice/tools.py
+hermes_teams_voice/verbal_interrupts.py
+hermes_teams_voice/viseme_estimate.py
+hermes_teams_voice/vision_budget.py
+hermes_teams_voice/vision_store.py
+hermes_teams_voice/realtime/__init__.py
+hermes_teams_voice/realtime/openai_client.py
+hermes_teams_voice/tests/__init__.py
+hermes_teams_voice/tests/test_audio.py
+hermes_teams_voice/tests/test_call_tools.py
+hermes_teams_voice/tests/test_caps_allowlist.py
+hermes_teams_voice/tests/test_config_sources.py
+hermes_teams_voice/tests/test_contract.py
+hermes_teams_voice/tests/test_cvi_extras.py
+hermes_teams_voice/tests/test_dialogue_depth.py
+hermes_teams_voice/tests/test_expression_viseme.py
+hermes_teams_voice/tests/test_group_call_gate.py
+hermes_teams_voice/tests/test_integration.py
+hermes_teams_voice/tests/test_meeting.py
+hermes_teams_voice/tests/test_protocol_hmac.py
+hermes_teams_voice/tests/test_realtime_config.py
+hermes_teams_voice/tests/test_review_fixes.py
+hermes_teams_voice/tests/test_streaming_audio.py
+hermes_teams_voice/tests/test_voice_ux.py

hermes_plugin_teams_voice-0.1.0/hermes_plugin_teams_voice.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

hermes_plugin_teams_voice-0.1.0/hermes_plugin_teams_voice.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[hermes_agent.plugins]
+teams_voice = hermes_teams_voice

hermes_plugin_teams_voice-0.1.0/hermes_plugin_teams_voice.egg-info/requires.txt

@@ -0,0 +1,4 @@
+aiohttp>=3.8
+
+[numpy]
+numpy>=1.21

hermes_plugin_teams_voice-0.1.0/hermes_plugin_teams_voice.egg-info/top_level.txt

@@ -0,0 +1 @@
+hermes_teams_voice

hermes_plugin_teams_voice-0.1.0/hermes_teams_voice/__init__.py

@@ -0,0 +1,70 @@
+"""teams_voice plugin — Microsoft Teams real-time voice/video (CVI) bridge driver.
+
+Hosts an HMAC-authenticated WebSocket the companion Windows .NET media worker
+dials into, and drives the call: dialogue (realtime
+or streaming), perception (camera/screen vision), and the avatar rendering cues
+(expression / visemes / show-to-caller). The worker renders the NV12 avatar tile;
+this plugin sends the drivers.
+
+Chat-plane integration (Teams messages, message actions, meeting-recap posting)
+is handled by the existing ``plugins/platforms/teams`` adapter — this plugin is
+the *media/voice* half and deliberately does not duplicate it.
+
+Status: implemented. Realtime (OpenAI/Azure speech-to-speech) and streaming
+(STT->agent->TTS) call modes; vision, tools (consult/agent_task/look_at_screen/
+show_to_caller/call_me_back/post_meeting_minutes), group gate, verbal interrupts,
+DTMF, bilingual, meeting recap. The Windows .NET media worker renders the avatar.
+"""
+
+from __future__ import annotations
+
+import logging
+
+from .cli import register_cli as _register_cli
+from .cli import teams_voice_command as _teams_voice_command
+from .tools import (
+    TEAMS_VOICE_STATUS_SCHEMA,
+    check_requirements,
+    handle_teams_voice_status,
+)
+
+logger = logging.getLogger(__name__)
+
+
+def _on_session_end(**_kwargs) -> None:
+    """Best-effort hook placeholder.
+
+    The bridge runs as its own server process, so there is nothing call-scoped to
+    tear down on agent-session end today. Kept registered so the lifecycle wiring
+    is stable as the realtime brain lands.
+    """
+    return None
+
+
+def register(ctx) -> None:
+    """Plugin entry point — register the status tool, CLI, and lifecycle hook.
+
+    Called once by the plugin loader when ``teams_voice`` is enabled via
+    ``plugins.enabled`` in config.yaml.
+    """
+    ctx.register_tool(
+        name="teams_voice_status",
+        toolset="teams_voice",
+        schema=TEAMS_VOICE_STATUS_SCHEMA,
+        handler=handle_teams_voice_status,
+        check_fn=check_requirements,
+        emoji="📞",
+    )
+
+    ctx.register_cli_command(
+        name="teams-voice",
+        help="Microsoft Teams voice/video (CVI) bridge (serve, status)",
+        setup_fn=_register_cli,
+        handler_fn=_teams_voice_command,
+        description=(
+            "Run the HMAC-authenticated bridge the Teams .NET media worker "
+            "connects to. See: hermes teams-voice status"
+        ),
+    )
+
+    ctx.register_hook("on_session_end", _on_session_end)