svrnty-hermes-webui-plugin/CONNECTION-MAP.md
Svrnty 37123f570b
All checks were successful
plugin-tests / test (push) Successful in 8s
feat(plugin): STT migration via audio_attachment_processor hook (L1-L6)
Closes Phase 2.A. STT now lives entirely in the plugin via the new public-API
method `api.register_audio_attachment_processor` added to the loader hook
(Rule 1 — extended API, no forced-internal). The fork patch stays minimal
(streaming.py gains a small loop that calls registered processors; loader
adds the 1 new method).

Plugin additions:
  routes/transcribe.py            POST /api/transcribe + audio_attachment_processor
                                  - _external_stt_transcribe: multipart POST to STT endpoint
                                  - _handle_transcribe: one-shot transcription route
                                  - _transcribe_audio_attachments: voice-message processor
                                  - _parse_multipart_file: stdlib email-based multipart
                                    (Python 3.13 dropped cgi per PEP 594)
  tests/unit/test_transcribe.py   8 tests (register, processor, route, multipart parser)
  tests/evals/test_features.py    + 1 eval (audio processor signature contract)

Config (read at call time, never persisted):
  HERMES_WEBUI_STT_URL  external STT endpoint (OpenAI or WhisperX shape)
  HERMES_WEBUI_STT_KEY  optional bearer token

CONNECTION-MAP regenerated: 9 public-API · 0 forced-internal · 1 frontend.
20/20 tests PASS.

Loader API extended in hermes-webui (next commit there) — 7th method:
register_audio_attachment_processor. Streaming.py gets a small loop that
calls registered processors before _build_native_multimodal_message.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-23 10:14:29 -04:00

1.8 KiB

CONNECTION MAP — svrnty-hermes-webui-plugin → nesquena/hermes-webui

Upstream version: v0.51.117
Plugin version: 0.1.0
Total dependencies: 10 (9 public API · 0 forced internal · 1 frontend)

Auto-generated by scripts/ast-connection-map.py. Do not hand-edit. To change a justification, edit the # CONNECTION: comment above the relevant import and re-run the script.


Public API dependencies (via loader-provided api)

Plugin location Upstream symbol Snippet
plugin.py:29 api.logger log = api.logger("svrnty.plugin")
plugin.py:34 api.register_static api.register_static(STATIC_PREFIX, str(STATIC_DIR))
plugin.py:35 api.inject_stylesheet api.inject_stylesheet(f"/plugins/{STATIC_PREFIX}/app.css")
plugin.py:36 api.inject_script api.inject_script(f"/plugins/{STATIC_PREFIX}/app.js")
routes/transcribe.py:37 api.logger log = api.logger("svrnty.routes.transcribe")
routes/transcribe.py:38 api.register_route api.register_route("/api/transcribe", "POST", _handle_transcribe)
routes/transcribe.py:39 api.register_audio_attachment_processor api.register_audio_attachment_processor(_transcribe_audio_attachments)
routes/vault_status.py:19 api.logger log = api.logger("svrnty.routes.vault_status")
routes/vault_status.py:20 api.register_route api.register_route("/api/vault/status", "GET", _handle_vault_status)

Forced internal dependencies (Rule 2 escape hatch)

Each row requires a # CONNECTION: <reason> comment in source.

None. Plugin uses only the public API.


Frontend dependencies (static/.js → /api/ URLs)

File Line URL
static/app.js 46 /api/vault/status