| 1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192 |
- """Pure identity derivations the canonical store and the gateway both need.
- stdlib-only on purpose: ``hermes_state_*`` modules must not import ``gateway/`` to compute a
- digest or parse a key (the gateway imports the store, so the reverse edge is a latent cycle).
- The gateway modules that historically defined these re-export them from here.
- """
- import hashlib
- import json
- import re
- # The profile scheduler's principal admits every cron fire under ``cron:<job>:<execution>``
- # (``gateway/session_cron.py``). That request id is the pre-image of the run's ``local-*`` session
- # id, so its admission row is the run's durable job/execution association. Runs from before the
- # unified runtime were named ``cron_{job_id}_{YYYYmmdd_HHMMSS}`` (``cron/scheduler.py::run_job``).
- CRON_PRINCIPAL_ID = 'cron-owner'
- CRON_REQUEST_PREFIX = 'cron:'
- _LEGACY_CRON_RUN_ID = re.compile(r'^cron_(.+)_\d{8}_\d{6}$')
- def cron_request_id(job_id, execution_id):
- """The admission request id of one cron fire (``execution_id`` is its ledger row id)."""
- return f'{CRON_REQUEST_PREFIX}{job_id}:{execution_id}'
- def prefix_range(prefix):
- """Half-open ``[prefix, hi)`` bounds of every key starting with *prefix*, for an index range
- scan: bump the final character so the range covers exactly the prefix."""
- return prefix, prefix[:-1] + chr(ord(prefix[-1]) + 1)
- def cron_request_range(job_id):
- """Half-open ``[lo, hi)`` bounds of *job_id*'s cron request ids, for an index range scan."""
- return prefix_range(cron_request_id(job_id, ''))
- def cron_run_from_request(request_id, job_id=None):
- """``(job_id, execution_id)`` of a cron fire's request id, else None.
- A fresh fire's execution id never holds ``:``, so a request id with exactly one after the
- prefix splits there. More than one is ambiguous (a job id holding ``:``, or an execution id
- admitted with one before that was refused): only the *job_id* its stored policy names splits
- it, and must prefix it."""
- if not isinstance(request_id, str) or not request_id.startswith(CRON_REQUEST_PREFIX):
- return None
- if job_id is None:
- rest = request_id[len(CRON_REQUEST_PREFIX):]
- if rest.count(':') != 1:
- return None
- job_id, _, execution_id = rest.partition(':')
- else:
- prefix = cron_request_id(job_id, '')
- execution_id = request_id[len(prefix):] if request_id.startswith(prefix) else ''
- return (job_id, execution_id) if job_id and execution_id else None
- def legacy_cron_run_job(session_id):
- """The job id a pre-unified ``cron_{job_id}_{YYYYmmdd_HHMMSS}`` run session names, else None."""
- match = _LEGACY_CRON_RUN_ID.match(str(session_id or ''))
- return match.group(1) if match else None
- def admission_fingerprint(*, canonical_target: str, payload: dict) -> str:
- """Canonical payload identity after authorization and immutable media capture."""
- encoded = json.dumps(
- {'target': canonical_target, 'payload': payload}, ensure_ascii=False,
- sort_keys=True, separators=(',', ':'), allow_nan=False,
- ).encode('utf-8', errors='surrogatepass')
- return hashlib.sha256(encoded).hexdigest()
- def local_identity(profile_id, principal_id, request_id):
- """The deterministic session id of a LOCAL creation receipt."""
- identity = json.dumps([profile_id, principal_id, request_id], separators=(',', ':'))
- return 'local-' + hashlib.sha256(identity.encode()).hexdigest()
- def profile_from_session_key_namespace(namespace: str) -> str:
- """Inverse of ``gateway.session._session_key_namespace`` for the ``<ns>`` slot of a key:
- ``"default"`` for ``main``, ``"main"`` for the marked ``main~``, else the slot is the profile id."""
- if namespace == "main":
- return "default"
- return "main" if namespace == "main~" else namespace
- def profile_from_session_key(session_key):
- """Profile namespace encoded in an ``agent:<ns>:...`` gateway session key, else None."""
- if not session_key:
- return None
- parts = str(session_key).split(":")
- if len(parts) < 2 or parts[0] != "agent":
- return None
- return profile_from_session_key_namespace(parts[1] or "main")
|