38 lines
1.3 KiB
Python
38 lines
1.3 KiB
Python
"""Hermes-managed Camofox state helpers.
|
|
|
|
With managed persistence enabled, Hermes sends a deterministic userId derived
|
|
from the active profile so Camofox maps it to the same persistent browser
|
|
profile directory across restarts.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
import uuid
|
|
from pathlib import Path
|
|
from typing import Dict, Optional
|
|
|
|
from hermes_constants import get_hermes_home
|
|
|
|
CAMOFOX_STATE_DIR_NAME = "browser_auth"
|
|
CAMOFOX_STATE_SUBDIR = "camofox"
|
|
|
|
|
|
def get_camofox_state_dir() -> Path:
|
|
"""Return the profile-scoped root directory for Camofox persistence."""
|
|
return get_hermes_home() / CAMOFOX_STATE_DIR_NAME / CAMOFOX_STATE_SUBDIR
|
|
|
|
|
|
def get_camofox_identity(task_id: Optional[str] = None) -> Dict[str, str]:
|
|
"""Return the stable Hermes-managed Camofox identity for this profile.
|
|
|
|
The user identity is profile-scoped (same Hermes profile = same userId); the
|
|
session key is scoped to the logical browser task so new tabs within the
|
|
same profile reuse the same identity contract.
|
|
"""
|
|
scope_root = str(get_camofox_state_dir())
|
|
user_digest = uuid.uuid5(uuid.NAMESPACE_URL, f"camofox-user:{scope_root}").hex[:10]
|
|
session_digest = uuid.uuid5(
|
|
uuid.NAMESPACE_URL, f"camofox-session:{scope_root}:{task_id or 'default'}"
|
|
).hex[:16]
|
|
return {"user_id": f"hermes_{user_digest}", "session_key": f"task_{session_digest}"}
|