"""Title-keyed local session selection, resolved read-only by the authority.
``hermes chat --resume
`` / ``-c [--create-if-missing]`` used to open
SessionDB in the client; the zero-writer client now sends the name and the owner
applies the classic CLI rule (``hermes_cli.main._resolve_session_by_name_or_id``).
"""
from __future__ import annotations
from hermes_state_runtime import RuntimeStoreError
def resolve_titled_session(authority, actor, name, *, missing_ok=False):
"""Exact session id first, then title (latest ``" #N"`` continuation wins over
the bare title), projected forward to the compression tip. Only a local session the
actor may read is returned, or one a messaging lane took over from a local surface
(``handed_off_ref``); a foreign or other non-local match is ``not_found`` so another
principal's titles are never confirmed."""
if not isinstance(name, str) or not name.strip():
raise RuntimeStoreError('invalid_params')
db = authority.db
row = db.get_session(name)
sid = row['id'] if row else db.resolve_session_by_title(name)
tip = db.get_session(db.get_compression_tip(sid) or sid) if sid else None
if tip is None:
if missing_ok:
return None
raise RuntimeStoreError('not_found')
from gateway.session_route_recovery import handed_off_ref
moved = handed_off_ref(authority, tip['id'])
try:
if moved is not None:
authority.authorize(actor, moved, 'session:read')
return moved
from gateway.session_local_migration import resolve_local_target
ref = resolve_local_target(authority, actor, tip['id'])
except RuntimeStoreError as exc:
if exc.reason == 'permission_denied':
raise RuntimeStoreError('not_found') from None
raise
return ref
def resolve_latest_session(authority, actor, family, workspace=None):
"""The most recently active session of a surface family (``cli`` = classic CLI incl. its finite
one-shot runs, ``tui``), scoped to ``workspace`` (git root / cwd) first and then global: the
classic ``hermes -c`` / ``--resume latest`` rule (``hermes_cli.main._resolve_last_session``),
applied by the owner so the client opens no database. Only a local session the actor may read
counts; another principal's sessions are skipped, never confirmed."""
from agent.session_source import CLI_FAMILY_SOURCES
families = {'cli': sorted(CLI_FAMILY_SOURCES), 'tui': ['tui']}
if family not in families or (workspace is not None and (not isinstance(workspace, str) or not workspace)):
raise RuntimeStoreError('invalid_params')
from gateway.session_local_migration import resolve_local_target
# The owner's own rows are stored ``local``, with the family in ``created_source``.
sources = [*families[family], 'local']
for scope in ([workspace] if workspace else []) + [None]:
# A launch stub (the CLI crashed or a resume failed before the first turn) is the newest row
# and carries the surface from its insert. It has no messages and no admission, so it is never
# "latest"; a session whose first prompt is admitted but not yet written still is.
for row in authority.db.search_sessions(source=sources, local_created_sources=[family], limit=50,
workspace_key=scope, skip_launch_stubs=True):
tip = authority.db.get_compression_tip(row['id']) or row['id']
try:
return resolve_local_target(authority, actor, tip)
except RuntimeStoreError as exc:
if exc.reason not in {'permission_denied', 'not_found', 'profile_mismatch'}:
raise
raise RuntimeStoreError('not_found')
def validate_title(title):
from hermes_state import SessionDB
try:
cleaned = SessionDB.sanitize_title(title) if isinstance(title, str) else None
except ValueError:
cleaned = None
if cleaned is None:
raise RuntimeStoreError('invalid_params')
return cleaned
def title_new_session(authority, ref, title):
"""User-provenance title on a just-created local session (auto-titling never overwrites it).
A concurrent creator that won the unique title is a conflict, not a silent orphan."""
try:
authority.db.set_session_title(ref.session_id, title)
except ValueError:
raise RuntimeStoreError('admission_conflict') from None