Add GUEST_HOSTS explicit guest-to-host pairing for co-host sessions not exposed by public endpoints

app.py

@@ -307,9 +307,32 @@ def observe_session(user,force=False):
         _observation_cache[user]=(time.monotonic(),result)
         return result
 
+def _guest_hosts_map():
+    """GUEST_HOSTS='guest:host,guest2:host2' (Space Variable). Explicit pairing for a guest whose
+    co-host session TikTok's public endpoints do not expose."""
+    out={}
+    for part in (os.getenv('GUEST_HOSTS') or '').split(','):
+        if ':' in part:
+            g,h=part.split(':',1)
+            if g.strip() and h.strip():out[g.strip().lstrip('@').lower()]=h.strip().lstrip('@').lower()
+    return out
+
 def _guest_observation(user):
-    """Account is not live in its own room. Check whether TikTok lists it in the linker_map
-    of another monitored host that is live right now; if so the live show is that room."""
+    """Account is not live in its own room. (1) Explicit GUEST_HOSTS pairing: if the paired host
+    is live, follow that room. (2) Otherwise check whether TikTok lists the account in the
+    linked users of another monitored live host."""
+    forced=_guest_hosts_map().get(str(user).lower())
+    if forced and forced!=str(user).lower():
+        try:
+            hobs=_observe_session(forced)
+        except Exception:
+            hobs=None
+        if hobs and hobs.get('status')=='live' and hobs.get('sources'):
+            if _guest_logged.get(user)!=hobs.get('room_id'):
+                _guest_logged[user]=hobs.get('room_id')
+                log(user,'[GUEST] @%s مقترن بالمذيع @%s (GUEST_HOSTS)؛ نرصد غرفة المضيف'%(user,forced))
+            return {'status':'live','room_id':str(hobs.get('room_id') or ''),'sources':hobs.get('sources') or [],
+                    'nickname':user,'live_title':str(hobs.get('live_title') or ''),'guest_of':forced}
     uid=str(_uid_cache.get(user) or '')
     if not uid.isdigit():return None
     for other in enabled_accounts():