webhook_delivery.py 5.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100
  1. """Validated webhook destinations live in the owner's admitted input, not a TTL cache."""
  2. from copy import deepcopy
  3. import hashlib
  4. import json
  5. from hermes_state_runtime import RuntimeStoreError
  6. def route_digest(adapter, chat_id):
  7. from gateway.platforms.webhook import _WebhookDeliveryIdentity
  8. adapter._reload_dynamic_routes()
  9. try:
  10. route_name = _WebhookDeliveryIdentity.route_from_chat_id(chat_id)
  11. except (ValueError, TypeError, IndexError):
  12. raise RuntimeStoreError('not_found') from None
  13. route = adapter._routes.get(route_name)
  14. if route is None:
  15. raise RuntimeStoreError('not_found')
  16. return hashlib.sha256(json.dumps(route, sort_keys=True, separators=(',', ':')).encode()).hexdigest()
  17. def validate_destination(delivery):
  18. from gateway.platforms.webhook import _is_known_platform, _REPO_RE
  19. if (not isinstance(delivery, dict)
  20. or not {'deliver', 'deliver_extra'} <= set(delivery)
  21. or set(delivery) - {'deliver', 'deliver_extra', 'profile', 'mirror', 'route'}
  22. or (delivery.get('profile') is not None and not isinstance(delivery['profile'], str))
  23. or not isinstance(delivery.get('mirror', False), bool)
  24. or (delivery.get('route') is not None and not isinstance(delivery['route'], str))):
  25. raise RuntimeStoreError('invalid_params')
  26. target, extra = delivery['deliver'], delivery['deliver_extra']
  27. if not isinstance(target, str) or not isinstance(extra, dict):
  28. raise RuntimeStoreError('invalid_params')
  29. if target == 'github_comment':
  30. repo, number = extra.get('repo'), extra.get('pr_number')
  31. if not isinstance(repo, str) or not _REPO_RE.fullmatch(repo) or not str(number).isdigit() or int(number) <= 0:
  32. raise RuntimeStoreError('invalid_params')
  33. elif target != 'log' and not _is_known_platform(target):
  34. raise RuntimeStoreError('invalid_params')
  35. # Configuration extras may contain credentials or whole rendered payloads.
  36. # Persist only fields the selected sender actually consumes.
  37. fields = {'log': (), 'github_comment': ('repo', 'pr_number')}.get(
  38. target, ('chat_id', 'message_thread_id', 'thread_id'))
  39. result = {'deliver': target, 'deliver_extra': deepcopy({key: extra[key] for key in fields if key in extra})}
  40. # Omit the unbound defaults to preserve pre-profile receipt fingerprints.
  41. if delivery.get('profile'):
  42. result['profile'] = delivery['profile']
  43. # Route opt-in (``mirror_to_session: true``): the delivered text is mirrored into the target chat's
  44. # session; the destination row carries it so a replayed delivery mirrors exactly like the first.
  45. if delivery.get('mirror') is True:
  46. result['mirror'] = True
  47. if delivery.get('route'):
  48. result['route'] = delivery['route'] # the mirror's label only
  49. return result
  50. def snapshot_destination(adapter, delivery):
  51. from gateway.config import Platform
  52. result = validate_destination(delivery)
  53. if result['deliver'] not in {'log', 'github_comment'} and not result['deliver_extra'].get('chat_id'):
  54. profile = result.get('profile')
  55. with adapter._profile_scope(profile):
  56. home = adapter._delivery_config(profile).get_home_channel(Platform(result['deliver']))
  57. if home is None:
  58. raise RuntimeStoreError('not_found')
  59. result['deliver_extra']['chat_id'] = home.chat_id
  60. return result
  61. def retained_destination(adapter, chat_id):
  62. """Readback also checks today's connector and authorization; retained data is not a grant."""
  63. from gateway.session_envelope import restore_native, _validate_native
  64. runner = adapter.gateway_runner or getattr(adapter._message_handler, '__self__', None)
  65. from gateway.session_authorities import active_authority, all_authorities, serving_authorities
  66. if not all_authorities(runner):
  67. return validate_destination(adapter._delivery_info.get(chat_id))
  68. # The reply leg runs in the routed profile's scope; that ledger holds the destination. A
  69. # delivery id is unique per route, so an unscoped caller may search every served ledger (a
  70. # parked profile's retained store is not served: reading it could fail every other profile's).
  71. scoped = active_authority(runner)
  72. candidates = [scoped] if scoped is not None else serving_authorities(runner)
  73. # Only the signed ingress admission carries the destination; later automation rows
  74. # (process/watch completions) on the same chat share its source but never compete.
  75. query = """SELECT payload_json FROM session_admissions
  76. WHERE json_extract(payload_json, '$.native_text_v1.source.chat_id')=?
  77. AND json_extract(payload_json, '$.native_text_v1.source.platform')='webhook'
  78. AND json_extract(payload_json, '$.native_text_v1.automation') IS NULL"""
  79. rows = [row for authority in candidates for row in authority.db._read_all(query, (chat_id,))]
  80. if len(rows) != 1:
  81. raise RuntimeStoreError('not_found')
  82. payload = json.loads(rows[0]['payload_json'])
  83. envelope = payload['native_text_v1']
  84. event = restore_native(payload, runner)
  85. _validate_native(runner, event, envelope.get('provenance'))
  86. if runner._adapter_for_source(event.source) is not adapter:
  87. raise RuntimeStoreError('permission_denied')
  88. if envelope.get('webhook_route') != route_digest(adapter, chat_id):
  89. raise RuntimeStoreError('admission_conflict')
  90. return validate_destination(envelope.get('webhook_delivery'))