| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100 |
- """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'))
|