"""``session.prune``: the owner runs `hermes sessions prune` for its own store. The CLI computes the filters and shows the preview from a read-only view; the delete itself is this owner's write, through the same ``prune_sessions`` / ``retire_prunable`` path housekeeping uses (busy sessions and the logical owner of a retained reset child are skipped). A CLI writing the store under a live gateway would be a second writer, so it never does. """ import asyncio from pathlib import Path from hermes_state_runtime import RuntimeStoreError _SCALARS = (type(None), bool, int, float, str) def _filters(raw): from hermes_state_maintenance import _PRUNE_FILTER_NAMES if (not isinstance(raw, dict) or set(raw) - (_PRUNE_FILTER_NAMES | {'older_than_days'}) or not all(isinstance(value, _SCALARS) for value in raw.values())): raise RuntimeStoreError('invalid_params') return dict(raw) async def prune(connection, ref, params): authority, actor = connection.authority, connection.actor # Store-wide deletion across every principal's rows: the local operator only (a ticket from # this host's private control socket), never a remote or browser grant. if not connection.native_owner or 'session:operator' not in actor.capabilities: raise RuntimeStoreError('permission_denied') if actor.profile_id != authority.profile_id: raise RuntimeStoreError('profile_mismatch') never_active = params.get('never_active_days') if ('filters' in params) == (never_active is not None) or ( never_active is not None and (isinstance(never_active, bool) or not isinstance(never_active, (int, float)) or never_active < 0)): raise RuntimeStoreError('invalid_params') filters = _filters(params['filters']) if 'filters' in params else None authority._require_admission_open() from gateway.session_runtime_workers import track_mutation task = track_mutation(authority, _apply(authority, filters, never_active)) return await asyncio.shield(task) async def _apply(authority, filters, never_active): from hermes_constants import get_hermes_home from gateway.session_mutations import retire_live_sessions # Same transcript dir the CLI's local prune unlinks under (dispatch runs in the owner's scope). sessions_dir = Path(get_hermes_home()) / 'sessions' deleted_ids = [] if filters is None: deleted, routing, skipped = await asyncio.to_thread( authority.db.prune_never_active_keyed_sessions, older_than_days=float(never_active), sessions_dir=sessions_dir, deleted_ids=deleted_ids) result = {'deleted': deleted, 'routing_deleted': routing, 'skipped': skipped} else: deleted = await asyncio.to_thread( authority.db.prune_sessions, sessions_dir=sessions_dir, exclude_active_write_guards=True, deleted_ids=deleted_ids, **filters) result = {'deleted': deleted} retire_live_sessions(authority, deleted_ids) return result