fix: suppress N/A source_tag in session list sidebar (fixes #429)

fix: suppress N/A source_tag in session list sidebar (fixes #429)

CHANGELOG.md

@@ -1,5 +1,34 @@
 # Hermes Web UI -- Changelog
 
+## [v0.50.45] fix: suppress N/A source_tag in session list (#429)
+
+Feishu and WeChat sessions (and any session with an unrecognised or legacy
+`source` value in hermes-agent's state.db) were showing "N/A" or raw tag
+strings in the session list sidebar.
+
+Three fixes in `static/sessions.js`:
+
+1. `_formatSourceTag()` now returns `null` for unrecognised tags instead of
+   the raw string. Known platforms (telegram, discord, slack, feishu, weixin,
+   cli) still display their human-readable label. Unknown/legacy values are
+   silently suppressed.
+
+2. The `metaBits` push is guarded: stores the result in `_stLabel` and only
+   pushes if it is non-null. Prevents `null` or unrecognised platform names
+   from appearing in the session metadata line.
+
+3. The `[SYSTEM:]` title fallback now uses `_SOURCE_DISPLAY[s.source_tag] ||
+   'Gateway'` — the raw `s.source_tag` middle term is removed so a session
+   whose source is "N/A" does not use that as its visible title.
+
+No backend changes. The upstream issue (hermes-agent not reliably setting
+`source` for older Feishu/WeChat sessions) is tracked separately.
+
+7 new tests in `tests/test_issue429.py`. Updated 1 existing test in
+`tests/test_sprint40_ui_polish.py` to match the new guarded push pattern.
+
+- Total tests: 1202 (was 1195)
+
 ## [v0.50.44] fix: code-in-table CSS sizing + markdown image rendering (#486, #487)
 
 **CSS: inline code inside table cells** (fixes #486)

static/index.html

@@ -536,7 +536,7 @@
                 <div class="settings-section-title">System</div>
                 <div class="settings-section-meta">Instance version and access controls.</div>
               </div>
-              <span class="settings-version-badge">v0.50.44</span>
+              <span class="settings-version-badge">v0.50.45</span>
             </div>
             <div class="settings-field" style="border-top:1px solid var(--border);padding-top:12px;margin-top:8px">
               <label for="settingsPassword" data-i18n="settings_label_password">Access Password</label>

static/sessions.js

@@ -587,8 +587,11 @@ function renderSessionListFromCache(){
   // ── Render session items (extracted for group body use) ──
   // Note: declared after the groups loop but available via function hoisting.
   function _formatSourceTag(tag){
+    // #429: return null for unknown/unrecognised tags so callers can suppress display.
+    // Previously returned the raw tag string, causing 'N/A' or other junk values
+    // from older hermes-agent state.db records to surface in the session list.
     const names={telegram:'via Telegram',discord:'via Discord',slack:'via Slack',cli:'CLI',feishu:'via Feishu',weixin:'via WeChat'};
-    return names[tag]||tag;
+    return names[tag]||null;
   }
   function _renderOneSession(s){
     const el=document.createElement('div');
@@ -602,7 +605,7 @@ function renderSessionListFromCache(){
     // Guard: system prompt content must never surface as a visible session title
     const _SOURCE_DISPLAY={telegram:'Telegram',discord:'Discord',slack:'Slack',cli:'CLI',feishu:'Feishu',weixin:'WeChat'};
     if(cleanTitle.startsWith('[SYSTEM:')){
-      cleanTitle=(_SOURCE_DISPLAY[s.source_tag]||s.source_tag||'Gateway')+' session';
+      cleanTitle=(_SOURCE_DISPLAY[s.source_tag]||'Gateway')+' session';
     }
     const sessionText=document.createElement('div');
     sessionText.className='session-text';
@@ -615,7 +618,7 @@ function renderSessionListFromCache(){
     const tsMs=_sessionTimestampMs(s);
     titleRow.appendChild(title);
     const metaBits=[];
-    if(s.is_cli_session && s.source_tag) metaBits.push(_formatSourceTag(s.source_tag));
+    if(s.is_cli_session && s.source_tag){const _stLabel=_formatSourceTag(s.source_tag);if(_stLabel)metaBits.push(_stLabel);}
     if(s.message_count) metaBits.push(t('n_messages', s.message_count));
     if(s.model) metaBits.push(String(s.model).split('/').pop());
     sessionText.appendChild(titleRow);

tests/test_issue429.py

@@ -0,0 +1,127 @@
+"""
+Tests for issue #429 — Feishu/WeChat sessions show 'N/A' source_tag
+instead of a platform name or nothing.
+
+Root cause: sessions in hermes-agent's state.db may have source field
+set to NULL, empty string, or a legacy/unknown value (e.g. 'N/A').
+The WebUI was displaying whatever raw value it received.
+
+Fix: in static/sessions.js:
+  - _formatSourceTag() returns null for unknown/unrecognised tags
+    (previously returned the raw tag string, surfacing 'N/A' etc.)
+  - metaBits push is guarded: only push if _formatSourceTag returns
+    a non-null value
+  - [SYSTEM:] title fallback uses _SOURCE_DISPLAY map only, falls
+    back to 'Gateway' -- never surfaces an unknown raw source_tag
+
+Tests verify via JS source inspection (structural) only — no live
+server needed.
+"""
+import pathlib
+import re
+
+REPO_ROOT = pathlib.Path(__file__).parent.parent
+SESSIONS_JS = (REPO_ROOT / "static" / "sessions.js").read_text()
+
+
+# ── Source-level structural checks ───────────────────────────────────────────
+
+def test_format_source_tag_returns_null_for_unknown():
+    """_formatSourceTag must return null (not the raw tag) for unrecognised values."""
+    # The fixed function must have a null/falsy fallback, not return the raw tag
+    # Pattern: names[tag] || tag  →  names[tag] || null
+    # Find the _formatSourceTag function body
+    start = SESSIONS_JS.find('function _formatSourceTag(')
+    assert start != -1, "_formatSourceTag not found in sessions.js"
+    fn_window = SESSIONS_JS[start:start+300]
+    # Must NOT return the raw tag as fallback — old pattern was: return names[tag]||tag
+    assert 'return names[tag]||tag' not in fn_window, (
+        "_formatSourceTag must not return the raw tag for unknown values — "
+        "this causes 'N/A' or other garbage to appear in the session list"
+    )
+
+
+def test_format_source_tag_has_null_fallback():
+    """_formatSourceTag must return null (or falsy) for unknown tags."""
+    start = SESSIONS_JS.find('function _formatSourceTag(')
+    assert start != -1
+    fn_window = SESSIONS_JS[start:start+500]  # wider to cover full function body
+    # Should have: return names[tag] || null
+    assert 'return names[tag]||null' in fn_window or 'return names[tag] || null' in fn_window, (
+        "_formatSourceTag should return null for unknown tags to suppress display"
+    )
+
+
+def test_metabits_push_is_guarded():
+    """metaBits push of _formatSourceTag result must be guarded against null."""
+    # The fix uses a temp variable pattern:
+    #   const _stLabel = _formatSourceTag(s.source_tag); if(_stLabel) metaBits.push(_stLabel)
+    idx = SESSIONS_JS.find('_stLabel')
+    assert idx != -1, (
+        "_stLabel guard variable not found — metaBits.push(_formatSourceTag()) "
+        "must check the return value before pushing to avoid null/N/A entries"
+    )
+    context = SESSIONS_JS[idx:idx+120]
+    assert 'if(_stLabel)' in context or 'if (_stLabel)' in context, (
+        f"_stLabel must be checked before pushing. Context: {context!r}"
+    )
+    assert 'metaBits.push(_stLabel)' in context, (
+        f"Expected metaBits.push(_stLabel). Context: {context!r}"
+    )
+
+
+def test_known_platforms_still_display():
+    """Known platform tags (telegram, feishu, weixin, etc.) must still appear."""
+    start = SESSIONS_JS.find('function _formatSourceTag(')
+    assert start != -1
+    fn_window = SESSIONS_JS[start:start+500]  # wider to cover full function body
+    for platform in ('telegram', 'feishu', 'weixin', 'discord', 'slack'):
+        assert platform in fn_window, (
+            f"Platform '{platform}' missing from _formatSourceTag names map"
+        )
+
+
+def test_system_prompt_title_fallback_no_raw_source():
+    """[SYSTEM:] title fallback must use display map or 'Gateway', not raw source_tag."""
+    # Find the [SYSTEM:] guard block
+    idx = SESSIONS_JS.find("cleanTitle.startsWith('[SYSTEM:')")
+    assert idx != -1, "[SYSTEM:] guard not found in sessions.js"
+    block = SESSIONS_JS[idx:idx+200]
+    # The fallback must end with ||'Gateway' and must look up via _SOURCE_DISPLAY
+    # It must NOT just use s.source_tag directly as a fallback
+    # Old broken pattern: (_SOURCE_DISPLAY[s.source_tag]||s.source_tag||'Gateway')
+    # Fixed pattern:      (_SOURCE_DISPLAY[s.source_tag]||'Gateway')
+    assert "||s.source_tag||" not in block, (
+        "System prompt title fallback must not use s.source_tag directly — "
+        "this would surface 'N/A' as a session title for unknown source values. "
+        f"Found: {block!r}"
+    )
+    assert "'Gateway'" in block, (
+        "System prompt title fallback must have 'Gateway' as the final fallback"
+    )
+
+
+def test_source_tag_guard_before_dataset_set():
+    """el.dataset.source assignment must be guarded (only set for known/non-empty tags)."""
+    # This is already guarded in the original: if(s.source_tag) el.dataset.source=...
+    # Verify it's still there
+    idx = SESSIONS_JS.find('el.dataset.source=s.source_tag')
+    assert idx != -1, "dataset.source assignment not found"
+    context = SESSIONS_JS[max(0, idx-40):idx+50]
+    assert 'if(' in context or '&&' in context, (
+        "el.dataset.source assignment must be guarded against null/empty source_tag"
+    )
+
+
+def test_na_string_not_in_known_names():
+    """'N/A' must not appear as a value in the _formatSourceTag names map."""
+    start = SESSIONS_JS.find('function _formatSourceTag(')
+    assert start != -1
+    fn_window = SESSIONS_JS[start:start+500]
+    # Find where the const names = {...} map ends (closing brace)
+    map_start = fn_window.find('const names={')
+    map_end = fn_window.find('};', map_start)
+    names_map = fn_window[map_start:map_end+2] if map_end != -1 else fn_window[map_start:map_start+200]
+    assert "'N/A'" not in names_map and '"N/A"' not in names_map, (
+        f"'N/A' must not be a value in the source tag names map. Found: {names_map!r}"
+    )

tests/test_sprint40_ui_polish.py

@@ -182,9 +182,14 @@ class TestFormatSourceTagHelper(unittest.TestCase):
             "sessions.js should map slack -> 'via Slack'")
 
     def test_metabits_uses_format_helper(self):
-        """The metaBits push for source_tag should use _formatSourceTag."""
-        self.assertIn("metaBits.push(_formatSourceTag(s.source_tag))", SESSIONS_JS,
-            "metaBits push should wrap source_tag with _formatSourceTag()")
+        """The metaBits push for source_tag should use _formatSourceTag with a null guard."""
+        # Fix #429: the push now uses a temp variable guard to suppress null/N/A results:
+        #   const _stLabel=_formatSourceTag(s.source_tag); if(_stLabel) metaBits.push(_stLabel)
+        # The old direct push pattern is gone; verify the guarded pattern is present.
+        self.assertIn("_formatSourceTag(s.source_tag)", SESSIONS_JS,
+            "metaBits push should still use _formatSourceTag() for source_tag display")
+        self.assertIn("metaBits.push(_stLabel)", SESSIONS_JS,
+            "metaBits push should use guarded _stLabel variable (fix #429)")
 
     def test_raw_source_tag_not_pushed_directly(self):
         """The old raw metaBits.push(s.source_tag) should not exist."""