The agent that grows with you
Python aiai-agentai-agentsanthropicchatgptclaudeclaude-codecodexhermeshermes-agentllmnous-researchopenai
"""Validated webhook destinations live in the owner's admitted input, not a TTL cache."""
from copy import deepcopy
import hashlib
import json
from hermes_state_runtime import RuntimeStoreError
def route_digest(adapter, chat_id):
from gateway.platforms.webhook import _WebhookDeliveryIdentity
adapter._reload_dynamic_routes()
try:
route_name = _WebhookDeliveryIdentity.route_from_chat_id(chat_id)
except (ValueError, TypeError, IndexError):
raise RuntimeStoreError('not_found') from None
route = adapter._routes.get(route_name)
if route is None:
raise RuntimeStoreError('not_found')
return hashlib.sha256(json.dumps(route, sort_keys=True, separators=(',', ':')).encode()).hexdigest()
def validate_destination(delivery):
from gateway.platforms.webhook import _is_known_platform, _REPO_RE
if (not isinstance(delivery, dict)
or not {'deliver', 'deliver_extra'} <= set(delivery)
or set(delivery) - {'deliver', 'deliver_extra', 'profile', 'mirror', 'route'}
or (delivery.get('profile') is not None and not isinstance(delivery['profile'], str))
or not isinstance(delivery.get('mirror', False), bool)
or (delivery.get('route') is not None and not isinstance(delivery['route'], str))):
raise RuntimeStoreError('invalid_params')
target, extra = delivery['deliver'], delivery['deliver_extra']
if not isinstance(target, str) or not isinstance(extra, dict):
raise RuntimeStoreError('invalid_params')
if target == 'github_comment':
repo, number = extra.get('repo'), extra.get('pr_number')
if not isinstance(repo, str) or not _REPO_RE.fullmatch(repo) or not str(number).isdigit() or int(number) <= 0:
raise RuntimeStoreError('invalid_params')
elif target != 'log' and not _is_known_platform(target):
raise RuntimeStoreError('invalid_params')
# Configuration extras may contain credentials or whole rendered payloads.
# Persist only fields the selected sender actually consumes.
fields = {'log': (), 'github_comment': ('repo', 'pr_number')}.get(
target, ('chat_id', 'message_thread_id', 'thread_id'))
result = {'deliver': target, 'deliver_extra': deepcopy({key: extra[key] for key in fields if key in extra})}
# Omit the unbound defaults to preserve pre-profile receipt fingerprints.
if delivery.get('profile'):
result['profile'] = delivery['profile']
# Route opt-in (``mirror_to_session: true``): the delivered text is mirrored into the target chat's
# session; the destination row carries it so a replayed delivery mirrors exactly like the first.
if delivery.get('mirror') is True:
result['mirror'] = True
if delivery.get('route'):
result['route'] = delivery['route'] # the mirror's label only
return result
def snapshot_destination(adapter, delivery):
from gateway.config import Platform
result = validate_destination(delivery)
if result['deliver'] not in {'log', 'github_comment'} and not result['deliver_extra'].get('chat_id'):
profile = result.get('profile')
with adapter._profile_scope(profile):
home = adapter._delivery_config(profile).get_home_channel(Platform(result['deliver']))
if home is None:
raise RuntimeStoreError('not_found')
result['deliver_extra']['chat_id'] = home.chat_id
return result
def retained_destination(adapter, chat_id):
"""Readback also checks today's connector and authorization; retained data is not a grant."""
from gateway.session_envelope import restore_native, _validate_native
runner = adapter.gateway_runner or getattr(adapter._message_handler, '__self__', None)
from gateway.session_authorities import active_authority, all_authorities, serving_authorities
if not all_authorities(runner):
return validate_destination(adapter._delivery_info.get(chat_id))
# The reply leg runs in the routed profile's scope; that ledger holds the destination. A
# delivery id is unique per route, so an unscoped caller may search every served ledger (a
# parked profile's retained store is not served: reading it could fail every other profile's).
scoped = active_authority(runner)
candidates = [scoped] if scoped is not None else serving_authorities(runner)
# Only the signed ingress admission carries the destination; later automation rows
# (process/watch completions) on the same chat share its source but never compete.
query = """SELECT payload_json FROM session_admissions
WHERE json_extract(payload_json, '$.native_text_v1.source.chat_id')=?
AND json_extract(payload_json, '$.native_text_v1.source.platform')='webhook'
AND json_extract(payload_json, '$.native_text_v1.automation') IS NULL"""
rows = [row for authority in candidates for row in authority.db._read_all(query, (chat_id,))]
if len(rows) != 1:
raise RuntimeStoreError('not_found')
payload = json.loads(rows[0]['payload_json'])
envelope = payload['native_text_v1']
event = restore_native(payload, runner)
_validate_native(runner, event, envelope.get('provenance'))
if runner._adapter_for_source(event.source) is not adapter:
raise RuntimeStoreError('permission_denied')
if envelope.get('webhook_route') != route_digest(adapter, chat_id):
raise RuntimeStoreError('admission_conflict')
return validate_destination(envelope.get('webhook_delivery'))