session_finite.py 3.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081
  1. """Admission-scoped finite consumers, independent of viewer or daemon lifetime."""
  2. from contextlib import contextmanager
  3. from contextvars import ContextVar
  4. from hermes_state_runtime import RuntimeStoreError
  5. _finite_turn = ContextVar('finite_turn', default=None)
  6. _unattended_turn = ContextVar('unattended_turn', default=False)
  7. def finite_turn_required():
  8. # None preserves legacy standalone CLI's marker. A bound owner turn must
  9. # never inherit process launch flags from another viewer.
  10. return _finite_turn.get()
  11. FINITE_CLARIFY_NOTICE = (
  12. "single-query mode: no user available to answer. Pick the best choices using your own "
  13. "judgment, or make the most reasonable assumption you can, and continue.")
  14. def finite_clarify_reply():
  15. """clarify_tool's reply on a finite turn (``chat -q`` / ``-z``): main's headless answer."""
  16. return {"answers": {}, "outcome": "undelivered", "notice": FINITE_CLARIFY_NOTICE}
  17. def unattended_turn():
  18. # `hermes -z`: nobody can answer a prompt, so the classic one-shot contract auto-approves
  19. # (legacy oneshot.py set HERMES_YOLO_MODE). `-q` stays single-query (approvals.single_query_mode).
  20. return _unattended_turn.get()
  21. @contextmanager
  22. def finite_turn_scope(finite, unattended=False):
  23. token = _finite_turn.set(finite)
  24. unattended_token = _unattended_turn.set(bool(finite and unattended))
  25. try:
  26. yield
  27. finally:
  28. _unattended_turn.reset(unattended_token)
  29. _finite_turn.reset(token)
  30. def admit_finite(params, *, submitter=None):
  31. """Validate a submission's finite flags. *submitter* ``(connection, ref)`` marks a wire client: it may
  32. ask for an unattended (auto-approving) turn only as the local CLI principal on its own CLI session."""
  33. if 'unattended' in params and (type(params['unattended']) is not bool
  34. or (params['unattended'] and params.get('finite') is not True)):
  35. raise RuntimeStoreError('invalid_params')
  36. if params.get('unattended') and submitter is not None and not _may_run_unattended(*submitter):
  37. raise RuntimeStoreError('invalid_params')
  38. if 'finite' not in params:
  39. return {}
  40. if type(params['finite']) is not bool:
  41. raise RuntimeStoreError('invalid_params')
  42. return {'finite': params['finite'], **({'unattended': True} if params.get('unattended') else {})}
  43. def _may_run_unattended(connection, ref):
  44. """``hermes -z`` parity: main auto-approved only inside the one-shot's own process. Over the wire that
  45. is the private local bootstrap ticket (no dashboard / remote identity), the session's creator (no
  46. operator attach) and a CLI-surface session (never a Desktop, TUI, ACP or Bot Chat others watch)."""
  47. from gateway.session_policy import policy_for_source
  48. source = connection.authority.sessions[ref.session_id].source
  49. if not connection.native_owner or source is None or source.user_id != connection.actor.subject:
  50. return False
  51. policy = policy_for_source(connection.authority.runner, source)
  52. return policy is not None and policy.platform == 'cli'
  53. async def execute_finite_admission(authority, ref, row):
  54. from gateway.session_ingress import execute_admission
  55. from gateway.session_display import display_turn_scope, submission_turn_scope
  56. from gateway.session_surface import surface_turn_scope
  57. from gateway.session_cli_turn import cli_turn_scope
  58. with finite_turn_scope(row['payload'].get('finite', False), row['payload'].get('unattended') is True), \
  59. surface_turn_scope(row['payload'].get('surface_v1')), \
  60. display_turn_scope(row['admission_id'], row['payload'].get('display_v1')), \
  61. submission_turn_scope(row['admission_id'], row.get('request_id')), \
  62. cli_turn_scope(row['admission_id'], row['payload'].get('cli_turn_v1')):
  63. return await execute_admission(authority, ref, row)