Files
agent-estate-wiki/systems/conduit.md
T

4.5 KiB
Raw Blame History

title, type, status, created, updated, verified_on, review_after, confidence, tags, sources
title type status created updated verified_on review_after confidence tags sources
Conduit system active 2026-10-24 2026-10-24 2026-10-24 2026-11-07 high
conduit
plugin
phone
iphone
push
voice
memory
live-probe
plugin-tree
live-sqlite-conduit
live-log
session-20261023_182601

Conduit

Purpose

Hermes on Anthony's phone. A dashboard plugin + iOS app pair that pushes cards, prompts, location and health data between the Hermes gateway and the iPhone, and lets a voice call be started from the phone where the agent can speak and listen (conduit-voice sessions).

Related: systems/mnemosyne (memory backend the voice session reads), systems/hermes-ui (the browser desktop), systems/push-notifications (the older hermes-push bridge).

Where it lives

  • Plugin tree: /home/hermes/.hermes/plugins/conduit_push
  • Version: 0.64.0 (manifest_version: 1), git HEAD eaa14be — “Pulse: mark follow-up cards done, by hand or after Do it (0.64.0) (#323)”
  • Upstream: https://github.com/kaishi00/hermes-conduit-notifier.git (origin, fetch+push)
  • ⚠ The working tree carries an uncommitted local patch (M dashboard/plugin_api.py, the memory-timeout fix in incidents/2026-10-22-conduit-memory-start-timeout). A plugin update that resets the tree drops it.
  • Skills shipped with the plugin (4, under plugins/conduit_push/skills/): calling-the-user, reading-health-data, using-calendar, using-location.
  • Data stores (~/.hermes/): conduit-health.sqlite3, conduit-location.sqlite3, conduit-phone.sqlite3, plus JSON state — conduit-push.json (credential / gateway id / installation id / relay url / e2e — no values recorded here), conduit-calls.json, conduit-settings.json, conduit-present.json, conduit-desktop-views.json.

Current state (verified 2026-10-24 00:1x AWST)

  • Dashboard gateway: listening on 0.0.0.0:9119; process started 2026-10-23 18:54:43 (this start picked up the memory-timeout patch).
  • Device: one registered — iPhone, app version 2.0.0, features chat-cards, info-cards, live-cards, maps-navigate, media-cards, show-cards (last seen 2026-10-23 19:02:16). No other device is registered.
  • Call settings: enabled, when_asked, decides, alerts all true; rate limits min_gap_s 120 / per_hour 6 / per_day 20; avoid_unknown_place false.
  • Recent calls: two call sessions closed cleanly on 2026-10-24 00:03:23 and 00:06:57 (both outcome: done, conduit-calls.json written 00:06:57) — the first evidence after the memory-timeout fix.
  • Data volume: conduit-health.sqlite3 is 561.7 MB (WAL 6.1 MB) holding 1,501,165 events rows across 308 buckets / 62 windows for its single device; conduit-location.sqlite3 80 KB; conduit-phone.sqlite3 284 KB. No retention or compaction has been observed — the health store has grown from card/health ingestion alone and is worth watching against the CT460 disk budget.

Memory integration

The voice session (conduit-voice) reaches Mnemosyne through the plugin's own memory layer, not through Mnemosyne's system_prompt_block() — recall is wrapped in a per-request deadline (MEMORY_TIMEOUT_S, default 60 s as of 2026-10-23, overridable with CONDUIT_MEMORY_TIMEOUT_S; it was a hard-coded 10 s before that, which was too short for Mnemosyne's 10–45 s cold start). If the provider fails to start, the plugin logs a warning and proceeds without recall rather than abandoning the call. See incidents/2026-10-22-conduit-memory-start-timeout and systems/mnemosyne.

Maintenance commands

# what version is installed / is the tree patched?
git -C ~/.hermes/plugins/conduit_push log --oneline -1 && \
git -C ~/.hermes/plugins/conduit_push status --short

# is the gateway up, and since when?
ss -tlnp | grep 9119

# did a voice call lose its memory context?
grep -h "Conduit" ~/.hermes/logs/agent.log | grep -i "memory" | tail

# state files (no secrets in the wiki)
ls -la ~/.hermes/conduit-*.json ~/.hermes/conduit-*.sqlite3

Open items

  • Commit or upstream the plugin_api.py timeout patch so a plugin update cannot revert it.
  • No retention policy on conduit-health.sqlite3 (561.7 MB and growing).
  • The Mnemosyne cold start that motivated the patch is still slow (10–45 s); only the budget was raised. → systems/mnemosyne