run_heartbeat_acceptance.py 3.4 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879
  1. """Accounting at completion of an exact heartbeat admission attempt.
  2. Execution means entering the gateway's agent runner after turn preparation,
  3. not reserving an adapter slot, successful model completion, or outbound delivery.
  4. The done callback retains the watch's profile ContextVars and manager claim.
  5. """
  6. import logging
  7. logger = logging.getLogger("gateway.run")
  8. async def resolve_heartbeat_owner(runner, event, entry):
  9. """Keep normal reset/topic resolution, then admit only the original lineage."""
  10. expected = getattr(event, "_heartbeat_session_id", None)
  11. if not expected:
  12. return True
  13. resolved = entry.session_id
  14. if resolved != expected:
  15. def compression_tip():
  16. return runner.session_store._db_for_key(entry.session_key).get_compression_tip(expected)
  17. tip = await runner._run_in_executor_with_context(compression_tip)
  18. if tip != resolved:
  19. return False
  20. # Keep a value, not the mutable routing entry: preparation and hooks can yield
  21. # to /new or /stop before the agent runner starts.
  22. event._heartbeat_resolved_session_id = resolved
  23. return heartbeat_owner_is_current(runner, event, entry.session_key)
  24. def heartbeat_owner_is_current(runner, event, session_key):
  25. expected = getattr(event, "_heartbeat_resolved_session_id", None)
  26. if not expected:
  27. return True
  28. current = runner.session_store.lookup_by_session_key(session_key)
  29. return current is not None and not current.suspended and current.session_id == expected
  30. def settle_heartbeat_attempt(event, manager):
  31. if not getattr(event, "_heartbeat_execution_started", False):
  32. try:
  33. manager.abandon_fire()
  34. except Exception:
  35. logger.warning("Failed to refund unexecuted heartbeat", exc_info=True)
  36. async def admit_heartbeat(runner, adapter, source, session_id, route):
  37. """Coalesce overdue ticks behind the canonical FIFO, not an adapter-local slot."""
  38. import json
  39. from gateway.platforms.event import MessageEvent
  40. from hermes_cli.heartbeat import HeartbeatManager
  41. from hermes_state_runtime import list_session_admissions
  42. from gateway.session_authorities import active_authority
  43. authority = active_authority(runner)
  44. if authority is None:
  45. return
  46. # Admissions live on the route's logical owner (the compression root), not its transcript tip;
  47. # a LOCAL route's heartbeat rides local_automation_v1.
  48. pending = list_session_admissions(authority.db, session_id=authority.logical_owner(session_id))
  49. if any(row['payload'].get('native_text_v1', {}).get('automation', {}).get('heartbeat')
  50. or row['payload'].get('local_automation_v1', {}).get('heartbeat') for row in pending):
  51. return
  52. manager = HeartbeatManager(session_id)
  53. prompt = manager.due_prompt()
  54. if prompt is None:
  55. return
  56. state = manager.state
  57. identity = json.dumps(['heartbeat', session_id, state.created_at, state.fire_count], separators=(',', ':'))
  58. event = MessageEvent(text=prompt, source=source, internal=True, message_id=identity,
  59. metadata={'gateway_session_key': route, 'gateway_session_id': session_id})
  60. event._heartbeat_session_id = session_id
  61. try:
  62. await authority.admit_automation(adapter, event, identity)
  63. except BaseException:
  64. # Readiness is not a delivery attempt, and cancellation before commit is not ACK.
  65. if getattr(event, '_gateway_accepted', False) is not True:
  66. manager.abandon_fire()
  67. raise